Zoom OpenSeadragon

August 19, 2017

Zoom OpenSeadragon Plugin

Create zoomable galleries from standart wordpress images as well as from deepzoom images.

Zoom OpenSeadragon is an implementation of OpenSeadragon, an open-source, web-based viewer for high-resolution zoomable images, implemented in pure JavaScript, for desktop and mobile.

It allows to create zoomable galleries from standart wordpress images as well as from deepzoom images.

You can see live demo here

Zoom OpenSeadragon is released under the New BSD license

Installation

Extract the zip file and just drop the contents in the wp-content/plugins/ directory of your WordPress installation and then activate the Plugin from Plugins page.

To replace wordpress gallery with Zoom OpenSeadragon gallery you need to add openseadragon="true" to gallery shortcode. You can also use Media options to replace all galleries with Zoom OpenSeadragon gallery.

To show zoomable images, e.g. Deep Zoom images, you need to add paths of them to zoomimages attribute of shortcode, for example

[gallery openseadragon="true" zoomimages="/example.com/zoom/zoom1.dzi,/example.com/zoom/zoom2.dzi"] 

Other attributes:

  • width – width of Seadragon Zoom, 600px by default
  • height – height of Seadragon Zoom, 600px by default
  • columns – number of columns in grid view
  • noattachments – do not use images, attached to post (for example, when you need to display only DeepZoom images)
  • captions – display captions

Several OpenSeadragon parameters are also supported, see http://openseadragon.github.io/docs/OpenSeadragon.html#Options for description of these parameters.

  • shownavigationcontrol – show zoom in/out/home/full buttons, true by default
  • showzoomcontrol – show zoom buttons, true by default
  • showhomecontrol – show home button, true by default
  • showfullpagecontrol – show fullscreen button, true by default
  • showrotationcontrol – show rotation buttons, false by default
  • sequencemode – display pictures in sequence mode, one by one instead of grid
  • showsequencecontrol – show next/prev buttons for sequence mode, true by default
  • shownavigator – show navigator minimap
  • navigatorid – id of navigator div, autocreated if left empty
  • navigatorposition – position of navigator minimap, TOP_RIGHT is default
  • showreferencestrip – show thumbnails of images, false by default
  • referencestripsizeratio – ratio of thumbnails sizes to deepzoom size, 0.2 by default
  • referencestripposition – position of reference strip, BOTTOM_LEFT by default
  • referencestripscroll – type of reference scroll, ‘horizontal’ by default

Screenshots

  1. Options for Zoom OpenSeadragon galleries. First gallery links to precreated DeepZoom image, second and third use standart wordpress media files

    Options for Zoom OpenSeadragon galleries. First gallery links to precreated DeepZoom image, second and third use standart wordpress media files

  2. Single zoomable image

    Single zoomable image

  3. Tiled gallery, collection mode

    Tiled gallery, collection mode

  4. Sequence mode

    Sequence mode

FAQ

Installation Instructions

Extract the zip file and just drop the contents in the wp-content/plugins/ directory of your WordPress installation and then activate the Plugin from Plugins page.

To replace wordpress gallery with Zoom OpenSeadragon gallery you need to add openseadragon="true" to gallery shortcode. You can also use Media options to replace all galleries with Zoom OpenSeadragon gallery.

To show zoomable images, e.g. Deep Zoom images, you need to add paths of them to zoomimages attribute of shortcode, for example

[gallery openseadragon="true" zoomimages="/example.com/zoom/zoom1.dzi,/example.com/zoom/zoom2.dzi"] 

Other attributes:

  • width – width of Seadragon Zoom, 600px by default
  • height – height of Seadragon Zoom, 600px by default
  • columns – number of columns in grid view
  • noattachments – do not use images, attached to post (for example, when you need to display only DeepZoom images)
  • captions – display captions

Several OpenSeadragon parameters are also supported, see http://openseadragon.github.io/docs/OpenSeadragon.html#Options for description of these parameters.

  • shownavigationcontrol – show zoom in/out/home/full buttons, true by default
  • showzoomcontrol – show zoom buttons, true by default
  • showhomecontrol – show home button, true by default
  • showfullpagecontrol – show fullscreen button, true by default
  • showrotationcontrol – show rotation buttons, false by default
  • sequencemode – display pictures in sequence mode, one by one instead of grid
  • showsequencecontrol – show next/prev buttons for sequence mode, true by default
  • shownavigator – show navigator minimap
  • navigatorid – id of navigator div, autocreated if left empty
  • navigatorposition – position of navigator minimap, TOP_RIGHT is default
  • showreferencestrip – show thumbnails of images, false by default
  • referencestripsizeratio – ratio of thumbnails sizes to deepzoom size, 0.2 by default
  • referencestripposition – position of reference strip, BOTTOM_LEFT by default
  • referencestripscroll – type of reference scroll, ‘horizontal’ by default

How to replace specific gallery with Zoom OpenSeadragon gallery?

To replace wordpress gallery with Zoom OpenSeadragon you need to add openseadragon=”true” to gallery shortcode.

How to replace all galleries with Zoom OpenSeadragon gallery?

Use Zoom OpenSeadragon Options section in Settings => Media.

How to create really big zoomable image?

See http://openseadragon.github.io/examples/creating-zooming-images/

Changelog

1.4

  • Updated OpenSeadragon library to version 2.3.0 and changed script to go to photo in multiimage configuration accordingly

1.3

  • Updated OpenSeadragon library to version 2.2.0

1.2

  • Fixed reading of attachment sizes

1.1

  • Updated Russian localization

1.0

  • Initial release

Details

  • Version: 1.4
  • Active installations: 100
  • WordPress Version: 4.0.0
  • Tested up to: 4.8.25

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars