The AvantZoom plugin provides image zooming capability using OpenSeadragon.
See the documentation for zoomable images to learn how to make an image zoomable.
AvantZoom has no configuration options.
See also the documentation for installing AvantZoom.
AvantZoom depends on the following open source library which is included in the
Click the link below to see its copyright and license.
- Download the latest release from https://github.com/gsoules/AvantZoom
AvantZoom-master.zipinto your Omeka
- Rename the folder to
- Activate the plugin from the Omeka
- In the Omeka
filesfolder, create a
- Copy the
imagesfolder from the
plugins/AvantZoomfolder to the
imagesfolder contains icon used by the OpenSeadragon viewer for the zoom in, zoom out, and other controls AvantZoom does not use the folder
- If not using AvantTheme, edit your theme's
show.phpfile as explained below
Skip these steps if you are using AvantTheme which has built in support for AvantZoom.
The AvantZoom plugin provides everything you need to start using OpenSeadragon, but you must edit your theme's
items/show.php file to insert code at both the top and the bottom of the file. The code adds the OpenSeadragon viewer to the Item
page and also makes calls to the AvantZoom logic that configures OpenSeadragon to display an item's image.
The instructions that follow are using the
show.php from the Seasons theme.
You might need to make different edits for other themes.
First edit the code at the top of
show.php by replacing the first four lines in the file (shown below) ...
<?php echo head(array('title' => metadata('item', array('Dublin Core', 'Title')),'bodyclass' => 'items show')); ?> <h1><?php echo metadata('item', array('Dublin Core', 'Title')); ?></h1> <div id="primary"> <?php if ((get_theme_option('Item FileGallery') == 0) && metadata('item', 'has files')): ?>
... with the lines that follow. Note the insertion of
!$zoom && in the last line. This condition determines
whether or not to display the OpenSeadragon viewer. When
$zoom is false, the item's image is not zoomable in which
case, the orgiginal HTML is rendered to display the image in the usual (non-zoomable) manner.
<?php $zoomScript = ImageZoom::generateOpenSeadragonViewer($item); $zoom = !empty($zoomScript); if ($zoom) queue_js_file('openseadragon.min'); echo head(array('title' => metadata('item', array('Dublin Core', 'Title')),'bodyclass' => 'items show')); echo '<h1>' . metadata('item', array('Dublin Core', 'Title')) . '</h1>'; if ($zoom) echo '<div id="openseadragon"></div>'; ?> <div id="primary"> <?php if (!$zoom && (get_theme_option('Item FileGallery') == 0) && metadata('item', 'has files')): ?>
At the end of
show.php, insert code just above the call to
foot() so that the end of the file looks like this:
<?php if ($zoom) echo $this->partial('avantzoom-script.php', array('viewerScript' => $zoomScript)); ?> <?php echo foot(); ?>
Use this software at your own risk.
This plugin is published under [GNU/GPL].
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.