Omeka plugin for IIIF image service: used for thumbnails & zoomable viewer. Omeka also serves IIIF Presentation API manifest for use in Mirador or other tools.
PHP CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
controllers
libraries/Iiif/Storage/Adapter
views/public
IiifPlugin.php
README.md
config_form.php
docker-compose.yml
plugin.ini

README.md

Omeka IIIF Plugin

This plugin adds support for IIIF (http://iiif.io/) APIs into Omeka. Items created in Omeka can load images from any existing IIIF server. Each Omeka item with IIIF image exposes the presentation metadata via the IIIF Manifest URL - so the items can be easily displayed and used in other tools such as Mirador, UniversalViewer or Georeferencer. Users can configure in the plugin the IIIFHosting.com service - then the new images such as JPEG or TIFFs uploaded via administration of Omeka website will be turned into IIIF image service automatically and are going to be available in a fullscreen zoomable viewer and in variable pixel size via a responsive image service.

Installation

The content of this repository needs to be copied to /plugins/Iiif/ directory in your Omeka installation.

After the installation of this plugin the Omeka storage adapter must be changed in the main configuration (which is located at /application/config/config.ini). The following line needs to be added there:

storage.adapter = "Iiif_Storage_Adapter_Iiif"

But the plugin must be already enabled before adding this line. In case you want to deactivate or uninstall the plugin - you must first remove this line from the config.ini of your Omeka!

Usage

After installation every item in Omeka will get in the Editing mode a IIIF sidebar, similar to:

screen shot 2015-12-08 at 09 51 01

There it is possible to connect the metadata record of the item in Omeka with a IIIF image. If user provides a link to IIIF info.json, the connected image will appear under "Files" section - and Omeka will automatically use the image service for thumbnails, in exhibitions and also in a fast zoomable viewer in the public website. The Manifest compatible with the IIIF Presentation API for each item (with one image or a sequence of images) going to be available under link ending with /item/show/xxxxx/manifest.json.

The section "Plugins" in the administration (/admin) of your Omeka - the plugin has "Configuration" page.

On this page the user can provide address to his own image server (such as "http://mydomain.com/iiif/"). In such case the items can be linked to images just by providing correct short "identifer" in the sidebar described above.

For complete integration of IIIF with the Omeka - allowing for example direct upload of images (JPEG or TIFF) into a IIIF service, users can purchase a plan on IIIFHosting.com service. provide your customer email which is registered in IIIFHosting.com service (there is a free plan). From IIIFHosting.com administration section "Ingest API" copy secure payload to this module configuration. Check Webhook configuration on IIIFHosting.com if it points to your Omeka installation URL + /iiif_ingest. It is created during Omeka module configuration. If correct configuration is provided Omeka will submit copies of the images to the dedicated hosting storage where these are going to be converted to JPEG2000 and exposed via IIIF.

If the plugin is configured correctly and enabled there will be zoomable images on the item/show public pages for particular items.

Plugin needs to be triggered from [your_theme]/items/show.php. The most useful way to do it follows:

<?php echo get_specific_plugin_hook_output('Iiif', 'public_items_show', array('view' => $this, 'item' => $item)); ?>

Local development with docker-compose

Just clone this folder and run "docker-compose up" on it.

Omeka will run on localhost port 80. There is also phpmyadmin on port 8080, password is in docker-compose.yml