Extension:IIIF

MediaWiki extensions manual
IIIF
Release status: stable
Implementation API
Description API services and other tools for working with IIIF.
Latest version 0.4 (2025-06-14)
MediaWiki 1.39
License GNU General Public License 2.0 or later
Download
README

The IIIF extension offers a number of API services and associated tools for working with IIIF (International Image Interoperability Framework), such as integrating annotations, creating collections and using image files from MediaWiki sites. Beginning with v0.3, it also provides an image annotation tool based on OpenSeadragon and Annotorious. Some of its features support integration with Extension:Semantic MediaWiki.

The most up to date and detailed guide on usage and configuration is included with the extension on the special page Special:IIIF. A blog about initial development can be found on https://codecs.vanhamel.nl/Show:Lab/IIIF.

Installation

edit
  • Download and place the file(s) in a directory called IIIF in your extensions/ folder.
  • Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See T173141 for potential complications.)
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'IIIF' );
    
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

IIIF

edit

IIIF (International Image Interoperability Framework) refers to a set of open web standards for delivering digital resources, such as images and audio/visual files, along with their metadata. Adopted across the GLAM sector and perhaps further afield, it has significantly contributed to the dissemination of cultural heritage assets in digital form and to engagement with them in research and education. Central to IIIF standards is a set of APIs, notably the Presentation API and Image API. This extension focuses on the implementation of IIIF APIs within the MediaWiki context as well as tools can make use of them.

See the IIIF website for a general introduction and further information.

Example

edit
 
Example of the annotation tool, using a Manifest that is generated by one of the Action API modules to create a series of image resources from Wikimedia Commons. The image here selected is a photo of Jan van Kessels’s painting Noah's Family Assembling Animals before the Ark. Multiple shapes are drawn on top of the image to capture specific details of the painting. The one here selected marks out two ostriches and a custom form, configured in a JSON scheme on the wiki, allows the user to add a description and link the depiction to a relevant item on Wikidata.

See also

edit