New versions of this module and support for Omeka S version 3.0 and above are available on GitLab, which seems to respect users and privacy better than the previous repository.
Diva Viewer is a module for Omeka S that integrates Diva v7, an advanced online viewer specialized in high-resolution images. It can display books, manuscripts, maps, photographs, etc. via the IIIF standard.
Unlike Universal Viewer and Mirador Viewer, Diva is image-only: it does not handle audio, video, PDF or 3D. In return, it offers a rich set of built-in image analysis tools: brightness, contrast and gamma adjustments per channel, color replacement, pseudocolor, PCA color analysis, adaptive thresholds, convolution filters, morphological operations, and colormaps. These tools are particularly useful for studying manuscripts, scientific images, and art conservation.
Diva v7 is built on OpenSeadragon and provides multi-page navigation (single, two-page, book mode), a sidebar with thumbnails and metadata, and fullscreen support. It is served locally, without third-party CDN, so it is GDPR-compliant.
It uses the resources of any IIIF compliant server. The full specification of the "International Image Interoperability Framework" standard is supported (level 2). If you don't have an IIIF-compatible image server, like Cantaloupe or IIP Image server, Omeka S can be one! Just install the modules IIIF Server and Image Server.
See general end user documentation for installing a module.
The module Common must be installed first.
The module uses an external js library Diva, so use the release zip to install it, or use and init the source.
- From the zip
Download the last release Diva.zip from the list of releases (the master does
not contain the dependency), and uncompress it in the modules directory.
- From the source and for development:
If the module was installed from the source, rename the name of the folder of
the module to Diva, and go to the root module, and run:
composer install --no-devThen install it like any other Omeka module.
- For test
The module includes a test suite. Run from the root of Omeka:
vendor/bin/phpunit -c modules/Diva/phpunit.xml --testdox- Access to IIIF images
Diva viewer is based on IIIF, so an image server compliant with this protocol is required to use it. So, install the module Image Server if needed.
If you need to display big images (bigger than 1 to 10 MB according to your server, your network, and your users), use an external image server, or create tiles with Image Server. The tiling means that big images like maps and deep paintings, and any other images, are converted into tiles in order to load and zoom them instantly.
The url of the manifest of the items should be set inside the property specified in the config form of the module. If you don't have an IIIF Server, install the module IIIF Server.
To config Diva:
- in settings (default) and in site settings via a json object. The config is
merged with the default options. Available options:
showTitle: show the manifest title (defaulttrue)showSidebar: show the sidebar with thumbnails and metadata (defaulttrue)setLanguage: set the viewer language (default: auto-detected)acceptHeaders: list of Accept headers for IIIF requests (default[])
- via the theme of the site: copy file
view/common/diva.phtmlin your theme and customize it.
Example config:
{
"showTitle": false,
"showSidebar": true
}If the IIIF Server is installed, all resources of Omeka S are automatically available by the viewer, else the url of the manifest should be set in the configured property.
The viewer is always available at http://www.example.com/item/{item id}/diva.
Furthermore, it is automatically embedded in "item/{id}" show and/or browse
pages. The placement can be configured in site settings with the option "Display
Diva viewer": item show, item browse, item set browse. By default, only the
item show page is enabled.
In Omeka S v4.0+, you can use the block in the resource page theme options. When this feature is used, the viewer is automatically skipped on item show to avoid duplication. The placement option remains useful for browse pages and for themes that do not use resource page blocks (Omeka S < v4.0).
Finally, a block layout is available to add the viewer in any standard page.
To embed Diva somewhere else, just use the helper:
// Display the viewer with the specified item and specified options.
echo $this->diva($item, $options);
// Display the viewer with the specified item set.
echo $this->diva($itemSet);
// Display multiple resources (items and/or item sets).
echo $this->diva($resources);Use it at your own risk.
It's always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed.
See online issues on the module issues page on GitLab.
This module is published under the CeCILL v2.1 license, compatible with GNU/GPL and approved by FSF and OSI.
In consideration of access to the source code and the rights to copy, modify and redistribute granted by the license, users are provided only with a limited warranty and the software's author, the holder of the economic rights, and the successive licensors only have limited liability.
In this respect, the risks associated with loading, using, modifying and/or developing or reproducing the software by the user are brought to the user's attention, given its Free Software status, which may make it complicated to use, with the result that its use is reserved for developers and experienced professionals having in-depth computer knowledge. Users are therefore encouraged to load and test the suitability of the software as regards their requirements in conditions enabling the security of their systems and/or data to be ensured and, more generally, to use and operate it in the same conditions of security. This Agreement may be freely reproduced and published, provided it is not altered, and that no provisions are either added or removed herefrom.
Diva is published under the ISC licence.
Widget Diva:
Module Diva for Omeka S:
- Copyright Daniel Berthereau, 2018-2026
This project was supported in part by the University of California Office of the President MRPI funding MR-15-328710.