Jump to content

Extension:ReconciliationAPI

From mediawiki.org
MediaWiki extensions manual
ReconciliationAPI
Release status: stable
Implementation API , ContentHandler
Description Enables API modules for entity reconciliation and autocompletion
Author(s) DG
Latest version 0.1
MediaWiki 1.39+
License No license specified
Download
NS_RECON (NS_RECON_TALK)

The Reconciliation API extension lets you set up API modules for entity reconciliation and autocompletion using either 'MediaWiki core' or Semantic MediaWiki. The services for entity reconciliation follow the W3C specifications of the Reconciliation API (v0.2) and in so doing, can help you open up your wiki's data for linking, discovery and collaboration, for instance by facilitating connections to tools like OpenRefine. Using this framework as a basis, it also allows you to set up and finetune API endpoints for autocompletion, whether for external or wiki internal uses.

The extension is developed and maintained for CODECS, a Semantic MediaWiki-driven wiki for Celtic studies.

Features in a nutshell

[edit]
  • The current focus is on two ways of setting up your data: MediaWiki core, using native methods only, and Semantic MediaWiki (tested with v4.1.3 only)
  • Special handling for matching with Full-Text Search
  • About five Action API modules (including metadata for diagnostics or debugging)
  • Many configuration options available
  • Dedicated API profiles managed through JSON schemas in the wiki (namespace: Recon). Comes with simple JSON validation
  • A parser function (#recon-search) for creating typeahead widgets
  • Redirect service through a special page in the wiki. Intended for handling situations in which pages cannot be accessed directly or require an additional check.

Installation

[edit]
  • Download and place the file(s) in a directory called ReconciliationAPI in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'ReconciliationAPI' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration and usage

[edit]

After the extension has been installed successfully, head over the guide available from Special:ReconciliationAPI on your wiki. It includes information about configuration settings, JSON schemas and API modules.

Extensions

[edit]

It is recommended to use this extension with the following extensions:

  • Semantic MediaWiki - although a 'core MediaWiki' mode is supported, which makes use of native MediaWiki functionality, the extension was specifically created for wikis using SMW
  • CodeEditor - for editing JSON schemas

Support is available for:

Screenshot

[edit]
Screenshot showing an example of an API query assisted by the Typeahead widget