Getting Started
Creating your own SimpleViewer gallery is easy. There are various ways to create a SimpleViewer gallery:
Common Terms
The following terms are used frequently in this documentation:
- Gallery Folder - this is the folder that contains the SWF, the gallery.xml file and for an XML gallery, the gallery images and thumbnails. Copy the 'web' folder in the download to make a new gallery folder.
- Config Options - a list of options that describes a gallery's behavior. Contained in the gallery.xml file.
- gallery.xml - this is the document that describes how your gallery behaves. All config options are saved to this file, as well as image and caption data. An XML file is a simple text file that can be edited in any text editor. View example.
- XML Gallery - a gallery that specifies the image list in the gallery.xml file. XML galleries load images and thumbnails from the gallery folder.
- Flickr Gallery - a gallery that loads its images, thumbnails and text from Flickr.
Download Folder Contents
- web - this folder contains everything you need to upload to your website
- examples - contains example galleries
- examples/basic_embed.html - Example of basic embed code
- examples/classic.html - v1.9 style gallery
- examples/compact.html - compact mode example
- examples/flickr.html - Example Flickr gallery
- examples/local.html - Loads swfobject locally for running galleries locally without a web connection.
Creating a Flickr Gallery
If you already have images on Flickr, the easiest way to create a SimpleViewer gallery is to load your images and text from Flickr. Set your Flickr user name and/or tags in the gallery.xml file.
Due to Flash Player security restrictions, Flickr galleries will only work when uploaded to a web server. For more details, check here.
To create a Flickr gallery, follow these steps:
- Download and unzip SimpleViewer to your desktop.
- Make a copy of the 'web' folder. This is your gallery folder.
- Edit gallery.xml in your gallery folder using any text editor.
- Set the useFlickr option to true.
- Set your flickr username: flickrUserName="felixturner"
- To show a subset of your Flickr images, use tags. For example, to load all images with tags 'jump' and 'smile': flickrTags="jump,smile"
- Set additional configuration options (optional).
International Language Support
SimpleViewer will automatically detect the user's system language and translate onscreen text for the following languages:
- DA - Danish
- DE - German
- EN - English
- ES - Spanish
- FI - Finnish
- FR - French
- IT - Italian
- JA - Japanese
- NL - Dutch
- NO - Norwegian
- PL - Polish
- PT - Portuguese
- RU - Russian
- SV - Swedish
- TR - Turkish
- VI - Vietnamese
- ZH - Chinese
To display on-screen text in a language other than those above, use the languageList config option.