Article written on 12. marts 2010 by Anders
| Topic | Category | Platform / OS | Related issues... |
|---|
| Customizing simpleGallery | simpleViewer (simple Gallery) add-on | MS Windows | More about the same subject... |
Description of Problem / Solution:
SimpleViewer 1.9 (implemented in g-link CMS as simpleGallery add-on) can be customized by setting the following options.
XML Options
Modify XML Options by editing gallery.xml in any text editor. The XML options are found at the top of the file as attributes of the 'gallery' tag. All of thes items are optional.
| Option Name |
Default Value |
Description |
| maxImageWidth |
480 |
Width of the widest image in the gallery. Used to determine the best layout for your gallery (pixels). |
| maxImageHeight |
480 |
Height of tallest image in the gallery. Used to determine the best layout for your gallery (pixels). |
| textColor |
0xFFFFFF |
Color of title and caption text (hexidecimal color value). |
| frameColor |
0xFFFFFF |
Color of image frame, navigation buttons and thumbnail frame (hexidecimal color value). |
| frameWidth |
20 |
Width of image frame (pixels). |
| stagePadding |
40 |
Width of padding around gallery edge (pixels). To have the image flush to the edge of the swf, set this to 0. |
| navPadding |
40 |
Distance between image and thumbnails (pixels). |
| thumbnailColumns |
3 |
Number of thumbnail columns. To disable thumbnails completely set this value to 0 |
| thumbnailRows |
3 |
Number of thumbnail rows. To disable thumbnails completely set this value to 0. |
| navPosition |
left |
Position of thumbnails relative to image. Can be "top", "bottom","left" or "right". |
| vAlign |
center |
Vertical placment of the image and thumbnails within the SWF. Can be "center", "top" or "bottom".
For large format galleries this is best set to "center". For small format galleries setting this to "top" or "bottom" can help get the image flush to the edge of the swf.
|
| hAlign |
center |
Horizontal placement of the image and thumbnails within the SWF. Can be "center", "left" or "right".
For large format galleries this is best set to "center". For small format galleries setting this to "left" or "right" can help get the image flush to the edge of the swf.
|
| title |
SimpleViewer Gallery |
Text to display as gallery Title |
| enableRightClickOpen |
true |
Whether to display a 'Open In new Window...' dialog when right-clicking on an image. Can be "true" or "false" |
| backgroundImagePath |
|
Relative or absolute path to a JPG or SWF to load as the gallery background.
Relative paths are relative to the HTML document that contains SimpleViewer. For example: "images/bkgnd.jpg".
|
| imagePath |
|
Relative or absolute path to images folder. This value is only required if you don't want to put your images in the 'images' folder.
Relative paths are relative to the HTML document that contains SimpleViewer. Note that this path should include a trailing forward slash. For example: imagePath="my_image_folder/").
|
| thumbPath |
|
Relative or absolute path to thumbnail images folder. This value is only required if you don't want to put your thumbnail images in the 'thumbs' folder.
Relative paths are relative to the HTML document that contains SimpleViewer. Note that this path should include a trailing forward slash. For example: thumbPath="my_thumb_folder/").
|
HTML Options
Modify HTML Options by editing the HTML file that contains SimpleViewer in any text editor. HTML options are set with JavaScript in this format:
fo.addVariable("xmlDataPath", "gallerydata.xml");
The first parameter is the name of the option. The second parameter is the required value. Both parameters require quotation marks.
| Option Name |
Default Value |
Description |
| xmlDataPath |
"gallery.xml" |
Relative or absolute URL of the gallery XML file. Relative paths are relative to the HTML page that contains the swf. |
| firstImageIndex |
0 |
Index of image to display when gallery loads. Images are numbered beginning at zero. You can use this option to display a specific number based on the URL. Check here for details. |
| langOpenImage |
"Open Image in New Window" |
The text displayed for the right-click 'Open Image in New Window' menu option. Can be used to translate SimpleViewer into a non-English language. |
| langAbout |
"About" |
The text displayed for the right-click 'About' menu option. Can be used to translate SimpleViewer into a non-English language. |
| preloaderColor |
0xFFFFFF |
Prloader color (hexidecimal color value). |
|
Article written on 12. marts 2010 by Anders
Article No. #36 |
Return....
