mediawiki/semantic-external-query-lookup

A Semantic Mediawiki extension to seamlessly integrate query results from an external query source.

dev-master / 1.x-dev 2024-01-15 12:13 UTC

Requires

• php: >=5.3.0
• composer/installers: 1.*,>=1.0.1
• mediawiki/semantic-media-wiki: ~3.0
• onoi/http-request: ~1.3

Requires (Dev)

• phpmd/phpmd: ~2.1
• squizlabs/php_codesniffer: ~2.1

GPL-2.0-or-later

• mwjames

• wiki
• mediawiki
• SMW
• Semantic MediaWiki

README

Semantic External Query Lookup (a.k.a. SEQL) is a Semantic Mediawiki extension to seamlessly integrate query results from an external query source to a local repository or wiki.

The following video demonstrates the features of this extension.

Requirements

• PHP 5.3.2 or later
• MediaWiki 1.28 or later
• Semantic MediaWiki 3.0 or later

Installation

The recommended way to install Semantic External Query Lookup is by using Composer with:

{
	"require": {
		"mediawiki/semantic-external-query-lookup": "~1.0"
	}
}

1. From your MediaWiki installation directory, execute composer require mediawiki/semantic-external-query-lookup:~1.0
2. Add wfLoadExtension('SemenaticExternalQueryLookup'); to the bottom of LocalSettings.php
3. Navigate to Special:Version on your wiki and verify that the package have been successfully installed.

Usage

{{#ask:[[Modification date::+]][[~CR*]]
 |?#-
 |?Modification date
 |format=broadtable
 |source=mw-core
 |link=all
 |headers=show
}}

The #ask/#show query only requires to add a source parameter (assuming that a query source has been registered and enabled) to retrieve query results from a selected external endpoint. Special:Ask will provide a selection box to list enabled query sources.

Information about required settings can be found here.

Contribution and support

If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guideline.

• File an issue
• Submit a pull request
• Ask a question on the mailing list
• Ask a question on the #semantic-mediawiki IRC channel on Libera.

Tests

This extension provides unit and integration tests that are run by a continues integration platform but can also be executed using composer phpunit from the extension base directory.

License

GNU General Public License, version 2 or later.