SimpleViewer Standard Config Options

This document applies to SimpleViewer version 2.0. SimpleViewer has been upgraded to version 2.2.0. View upgrade information.

The following is a complete list of all the configuration options that are settable for SimpleViewer Standard version.

XML Options

Set these options by editing the gallery.xml file directly in any text editor. To add an option by editing the XML, add a line inside the opening simpleviewergallery tag. XML options are set in this format:

optionName = "optionValue"

If an option is missing from the XML, it will default to the value specified below. View an example gallery.xml file.

Option Name Default Value Description
title "" Text to display as gallery Title
textColor
#FFFFFF

Color of title and caption text.

Hexadecimal color value.

frameColor #FFFFFF

Color of image frame, thumbnail frame, image navigation arrows and thumb navigation arrows.

Hexadecimal color value.

frameWidth 20 Width of image frame (pixels).
galleryStyle MODERN

Gallery Style defines some of the gallery look and feel. Can be:

  • MODERN - Default style.
  • COMPACT- Designed to work for small size galleries such as when embedding in a blog. Overlay caption and button bar.
  • CLASSIC - SimpleViewer v1.9 style.
thumbPosition LEFT

Position of thumbnails relative to main image. Can be:

  • TOP
  • BOTTOM
  • RIGHT
  • LEFT
  • NONE

Replaces old navPosition option.

thumbColumns 3

Number of thumbnail columns.

Replaces old thumbnailColumns option.

thumbRows 4

Number of thumbnail rows.

Replaces old thumbnailRowsoption.

showOpenButton TRUE

Whether to show 'Open Image in New Window' button and right-click menu option.

Replaces old enableRightClickOpen option.

showFullscreenButton TRUE

Whether to show 'Go Fullscreen' button and right-click menu option.

Note: For fullscreen mode to work the 'allowfullscreen' flash param must be set to true in the HTML doc.

maxImageWidth 640 Width of the widest image in the gallery. Used to determine the best layout for your gallery (pixels).
maxImageHeight 640 Height of tallest image in the gallery. Used to determine the best layout for your gallery (pixels).
useFlickr FALSE

Whether to use Flickr as the source of the images and text. Set to false for an XML gallery.

If set to true and no user name or tags are specified, SimpleViewer will fetch Flickr's current most interesting images.

flickrUserName ""

The Flickr user name of the photos to display. If this parameter isn't passed then everybody's public photos will be searched.

To get your flickr user name, login to flickr and look for the 'signed in as...' text at the top right. You can also get a Flickr username from a Flickr photostream url here (second field down).

Example: "felixturner"

flickrTags ""

A comma serrated list of tags. Photos with one or more of the tags listed will be returned.

Example: "jump,smile"

languageCode AUTO

[Advanced] Language to use for display text. This is best left as "AUTO". Only required if you want to force the display language. Can be:

  • AUTO - Language detected automatically from user's system (Recommended).
  • 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
languageList "Previous,Next,Start AutoPlay,Stop AutoPlay,Play Audio,Pause Audio,Go FullScreen,Exit FullScreen,Open Image in New Window,Download Image,About,AutoPlay ON,AutoPlay OFF"

[Advanced] Used to specify a custom language for display text. This can be used to specify a language not handled by the languageCode above. Using this option overrides languageCode. Specify text as a comma delimited list as shown left.

HTML Options

These options are set in the HTML document that contains SimpleViewer. To modify these options, edit the HTML doc with any text editor. HTML options are set with JavaScript in this format:

flashvars.galleryURL = "myGallery.xml";

Option Name Default Value Description
galleryURL gallery.xml

[Advanced] Relative or absolute URL of the gallery XML file. Relative paths are relative to the HTML page that contains the swf. Replaces old xmlDataPath option.

Useful if you want to load gallery xml data from somewhere other than the default location.

baseURL ""

[Advanced] If set, all relative URLs (e.g. to images and thumbnails) will be relative to this URL. This is useful if the embedding HTML document is in a separate folder to the gallery folder or when embedding SimpleViewer on a seprate web domain (e.g. MySpace, eBay etc). View more info here.