====== SimpleViewer Plugin ======
---- plugin ----
description: Display Airtight Simpleviewer
author : Randy Wijnants
email : randy@tty32.org
type : Syntax
lastupdate : 2011-04-15
license : GPL 2 (http://www.gnu.org/licenses/gpl.html)
compatible : 2012-01-25 "Angua"
compatible : 2010-11-07a "Anteater"
depends : cache
conflicts :
similar : slideshow,gallery,autoviewer
tags : !obsolete, images slideshow flash gallery
downloadurl: https://github.com/TTy32/sviewer/zipball/master
bugtracker : https://github.com/TTy32/sviewer/issues
sourcerepo : https://github.com/TTy32/sviewer
----
Flash is not available anymore in browsers.
===== Installation =====
:!: **External requirements:** This plugin requires the following additional components that must be installed separately:
* [[plugin:cache]] (Used for xml generation for simpleviewer)
Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
==== Installation Fix ====
:!: This plugin actually can be made working with Angua. It is a beautiful alternative to the gallery-plugin. Gallery currently has problems within Angua. It kind of works but it hangs up my browser when using keyboard-shortcuts in lightbox-mode to browse through the pictures. May be due to the switch of the java-script library. But Simple Viewer can be an even better alternative, depending on the context. [[user> Harald |Harald Ronge]] //2012/09/10 08:37//
=== Instructions ===
- Install [[plugin:cache]] as described
- Install the Simple Viewer plugin with the extension manager. It will install as "TTy32-sviewer-68eac18", rename this folder in "/lib/plugins" to "sviewer" with FTP
- Within /lib/plugins/sviewer create a new sub-directory /lib/plugins/sviewer/simpleviewer
- get the viewer here [[http://www.simpleviewer.net/downloads/simpleviewer.zip]] and unpack on your local computer.
- copy simpleviewer.js, swfobject.js and simpleviewer.swf to /lib/plugins/sviewer/simpleviewer
Voilá!
== Addendum ==
All directories mentioned here may change in the future, so if anybody notices this please change this description accordingly so it stays valid! If you prefer other locations in your plugin-folder change
$this->swfLoc = DOKU_BASE.'lib/plugins/sviewer/simpleviewer/simpleviewer.swf';
$this->swfJsPath = DOKU_BASE.'lib/plugins/sviewer/simpleviewer/simpleviewer.js';
in /lib/plugins/sviewer/syntax.php to your liking.
===== Examples/Usage =====
See the plugin in action [[http://tty32.org/sviewer|here]]. FIXME Broken!
This plugin takes input images from a given namespace or a list of given images. It then generates a XML file which the simpleviewer SWF uses to show the gallery.
Almost all simpleviewer attributes can be defined for a gallery. If you do not specify these, then default values are taken from the Configuration Page.
**The plugin in its most simplest form (use root namespace):**
{{:}}
**Custom simpleviewer attributes:**
{{:image1.jpg}}
{{:image2.jpg}}
===== Syntax =====
{{namespace or images}}
Attributes explained (also written in the configuration page):
^ Attribute ^ Explaination ^
| width | SimpleViewer width |
| height | SimpleViewer height |
| align | SimpleViewer alignment (LEFT/RIGHT/NOALIGN) |
| galleryStyle | Gallery Style (MODERN/COMPACT/CLASSIC) |
| textColor | Color of title and caption text |
| frameColor | Color of image frame, thumbnail frame, image navigation arrows and thumb navigation arrows |
| frameWidth | Width of image frame |
| thumbPosition | Position of thumbnails relative to main image (TOP/BOTTOM/RIGHT/LEFT/NONE) |
| thumbColumns | Number of thumbnail columns |
| thumbRows | Number of thumbnail rows |
| showOpenButton | Whether to show "Open Image in New Window" button and right-click menu option (TRUE/FALSE) |
| showFullscreenButton | Whether to show "Go Fullscreen" button and right-click menu option (TRUE/FALSE) |
| maxImageWidth | Width of the widest image in the gallery. Used to determine the best layout for your gallery |
| maxImageHeight | Height of tallest image in the gallery. Used to determine the best layout for your gallery |
| captionMode | Captionmode, 0=No caption, 1=Filename as caption, 2=Filename as caption without extension |
| title | SimpleViewer title |
===== Development =====
The original plugin was made by Ikuo Obataya (see his AutoViewer plugin [[plugin:autoviewer|here]]). Thanks for your effort Ikuo!
I modified his plugin to work with SimpleViewer.
**Syntax.php modifications**
* SWFobject javascript removed, used