Imgzoom_XH facilitates presenting very large images (for instance, newspaper scans) in simple image viewers, so that a visitor can view them in full detail.
Please do read this documentation before you encounter any problems!
Imgzoom_XH couldn't be tested so far in various environments. It is a so called beta version. Use with caution!
Imgzoom_XH is a plugin for CMSimple_XH. It requires CMSimple_XH ≥ 1.5.4 and PHP ≥ 5.0.
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Imgzoom" from "Plugins".
Localization is done under "Language". You can translate the character strings to your own language, or customize them according to your needs.
The look of Imgzoom_XH can be customized under "Stylesheet".
Images that shall be displayed in an Imgzoom_XH viewer have to be placed in CMSimple_XH's image folder (usually userfiles/images/ or images/) or in a subfolder thereof.
You can either link to the image viewer from the content or the template, or you can embed it in an IFrame. However, in either case you don't use the URL of the image directly, but instead request the image viewer:
?imgzoom_image=%IMAGE_FILENAME%
An example: say you have the file userfiles/images/scan.jpg. To create a link, write the following in HTML mode (resp. produce this HTML with the WYSIWYG editor):
<a href="?imgzoom_image=scan.jpg" target="_blank">
To embed an image viewer in a page write the following in HTML mode:
<iframe src="?imgzoom_image=scan.jpg" frameborder="0"
width="500" height="500"></iframe>
(Adjust the width and height according to your needs.)
If the image to display is in a subfolder of the image folder, you have to add the subfolder in the URL, for instance:
?imgzoom_image=scans/imgage.jpg
On contemporary desktop browsers with JavaScript support the image will be resized to be shown completely when the image viewer is displayed. To zoom in, you have to click on the desired place; to zoom-out simply press the SHIFT key while clicking.
On older browsers and on browsers without JavaScript support the image will be displayed in its full size. You have to scroll to the desired section of the image. Zooming can be done with the browser's controls for stand-alone viewers.
On mobile browsers you can use the customary pan, pinch-to-zoom and double tap gestures. Zooming will not generally work for embedded viewers, besides zoom-in with a long press.
Imgzoom_XH is licensed under GPLv3.
© 2014 Christoph M. Becker
This plugin has been inspired by Korvell.
The plugin icon is designed by Alessandro Rei. Many thanks for publishing this icon under GPL.
And last but not least many thanks to Peter Harteg, the "father" of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.