a basic interface to allow Simpleviewer (http://www.airtightinteractive.com/simpleviewer/) to load its pictures from a Gallery2 installation. Simpleviewersource is a small module that produces the xml output that simpleviewer uses, and provides an interface to download an item according to permissions.
There are two basic modes of operation: to use the Simpleviewer application within your own website but displaying pictures stored within Gallery - or - to offer Gallery visitors the opportunity to use Simpleviewer within the Gallery environment.
To use the first mode, you can install Simpleviewer anywhere in your own website, and follow the instructions below for how to configure it to show contents of the album of your choice.
To use the second mode, you must install the Simpleviewer code in a new directory called "xml_slideshow" in your Gallery's lib/directory. So the path to the swfobject.js file should look like ".../lib/xml_slideshow/swfobject.js". Then make sure to enable the Offer Slideshow setting in the module's Admin page.
The module allows Gallery to source the XML data for Simpleviewer such that the images are served back from the Gallery installation.
All parameters are set in the Simpleviewer Tab of the Edit Album page. They include the basic options as shown, as well as a per-album limit on the number of files to download, and an enable/disable switch. All options carry through to sub albums, and override settings higher up. Custom options can also be set; enter the name as well as the value in the boxes at the bottom of the page. If custom options are set in any other albums, you will see the names offered to you as a convenience.
To direct Simpleviewer towards the Gallery installation follow the instructions on this page for customizing the XML data source: http://www.airtightinteractive.com/simpleviewer/customize.html
Use syntax as in the following example:
fo.addVariable("xmlDataPath", "http://www.myGalleryWebsite.com/main.php?g2_view=simpleviewersource.XMLOut%26g2_itemId=xxxx");
The correct path to use for each album is displayed in the Simpleviewer tab of the edit album page, where the parameters are set.
Thumbnails are drawn from Gallery's thumbnails; "main" images are sourced as the smallest resize (or original or thumbnail) that is as large as or larger than the maxImageHeight/maxImageWidth parameters active for that album, and for which view permission is available at the time the image is downloaded by Simpleviewer. If no maxImageHeight/maxImageWidth is set for the album or its parents, then the largest available image is used. If your browser's permissions change during the downloading (you log in to the Gallery as Administrator, for instance) the size of image downloaded can change from one image to the next across the gallery. The images are also cached by the browser, so you may need to empty the cache before you see the 'correct' image for your permissions.
Bug reports, questions, comments, suggestions etc in this thread please: http://galleryproject.org/node/67310
Carbon theme customization: http://galleryproject.org/node/84786#comment-297354
