How to setup and use IIIF

How to configure the International Image Interoperability Framework built into fylr

Activating IIIF

  1. In the base configuration of fylr, go to the section "Export & Deep Links"

  2. Under Deep Links Settings, enable the service by checking the respective checkbox

Refer to the documentation on Export & Deep Links for further explanation on the individual options.

Activate Rights-Management for versions in the File Worker

When an asset is uploaded to fylr, the File Worker creates different versions (renditions) defined in the Base Configuration.

Inside the renditions table of the File Worker, choose the appropriate class (audio, image, office, video) and inside the configuration for a given rendition check the "rights management" checkbox to allow sharing of that version via Deep Links.

Make sure to save and reload the instance to apply your changes.

In fylrs right management section, we need to setup correct rights for the system user deep_link.This user is included in a fylr instance per default.

It's likely you'll set these permissions for a Pool managing more than one Object Type. Depending on your usage of the datamodel, it's possible the deep_link user permissions have to be set for an Object Type directly.

Rights Management > Permissions Tab: example configuration for deep_link user permissions

The required Permissions are:

  • View Records

    • select the Object Types you want to share with the deep_link user

  • Allowed Masks

    • for those Object Types, select the Masks you want the deep_link user to have access to

  • View Versions

    • the versions the deep_link user is allowed to see

    • Only versions with checked rights management checkbox are listed here: see File Worker ( Base Configuration > File Worker > renditions tables "rights management" checkbox)

  • Download Versions

    • mark the versions the deep_link user should be able to download (required for deep linking versions)

Using the three-dot menu at a records file field to access deep links.

To enable sharing URLs for the deep_link user, we need to also assign the permissions:

  • View Versions

    • select the versions of your object types corresponding file class you want the deep_link user to have access to (this example uses images only)

  • Download Versions

    • select the you want the deep_link user to be allowed to download

If you cannot see a sharable link to copy, it's likely the version is not configured to be present in the rights management in the file worker. Refer to Activate Rights-Management for versions in the File Worker to allow sharing of more versions.

To assert a working deep_link, paste the copy into a incognito tab.

Adding custom IIIF viewers

In the base config, we can add custom IIIF viewers using template replacement for fylr to generate manifests and embeddable templates.

The default viewer used in fylr is the Mirador Viewer

This example uses the Curation Viewer.

Label:

A name for the label, such as "Universal Viewer", "Curation Viewer," would be appropriate.

HTML Code:

We define a template used by the server to generate an HTML snippet that embeds a standalone IIIF viewer (e.g., Mirador or Curation Viewer). This snippet can then be externally integrated.

<iframe 
    width="100%" 
    height="600" 
    src="https://codh.rois.ac.jp/software/iiif-curation-viewer/demo/?manifest=%iiif_presentation_manifest.url%">
</iframe>

The fylr server will replace the template %iiif_presentation_manifest.url% with the actual manifest URL.

Usage

FInd the custom IIIF viewer in the sharing dialog
  • You can copy the generated code from the sharing dialog of a dataset and test it by putting inside the W3Schools iframe test and pressing "Run."

  • This link can also be integrated into other web pages

Last updated