SimpleViewer Frequently Asked Questions

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

Check here first if you have a question about using SimpleViewer or SimpleViewer-Pro. Chances are your question has been answered already.

Troubleshooting

Embedding

Customizing

General

SimpleViewer-Pro Presales

SimpleViewer-Pro

Troubleshooting

When I view my gallery I see the message 'SimpleViewer requires JavaScript and the Flash Player'. Why?

First check here to determine the version of Flash you have installed. If you have Flash 9.0.124 or higher installed and you still see the message, check javascript is not disabled in your browser settings. If not then there is probably an issue with the embed code in the HTML page that embeds SimpleViewer. Check the Embedding Guide here.

My images show locally, but not when I upload them to my webserver. What are possible problems?

If you see crosses where your images should be, check the following:

  • Check your image paths and filenames exactly match the names specified in the XML file. Most servers are Case Sensitive. This means the letter cases in the filename must exactly match those in the XML document (for example ".jpg" is not the same as ".JPG"). Check Troubleshooting Pathing Problems.
  • Check if your webserver has  'Hotlink Protection' enabled. Hotlink Protection breaks SimpleViewer. Check with your webserver administrator.

When I view my gallery online, I see a blank area. Why?

There are 2 possible causes for this:

  • If you are viewing your gallery in Firefox and don't see anything where the gallery should be, it's likely that the CSS in the page is not correctly specifying a height for the gallery SWF. Check here for the solution.
  • Are you using Fetch (an FTP app for Mac) to upload your files? Older versions of Fetch break SWFs on upload. Upgrade Fetch or use a different FTP app, then re-upload your gallery.
  • Right click the area where the gallery should be. If you see the message 'Movie Not Loaded...' this means the SWF has uploaded incorrectly. SWF files should be uploaded as 'Binary', not as 'ASCII'. Try re-uploading the SWF file or using a different FTP application.

When I update my images, the new images do not show up in SimpleViewer. Why?

You may be looking at a cached version of gallery.xml. Browsers will save previously viewed versions of files on the web for faster loading. To avoid this, you can clear your browser cache after making updates. To clear the cache in Internet Explorer go to Tools -> Internet Options -> Delete Files, or press Ctrl-F5 to reload the page without caching.

Visitors to your gallery will almost always see the latest version of your gallery. Most browsers check for newer versions of files on each browser session. Browser caching happens for all websites, so this issue applies to all files on the web.

Non-English characters are not showing in the captions. Why?

To allow non-English characters to show, you must save your XML document with 'UTF-8' encoding (in Windows Notepad you can set this is the 'Save As' dialog). Check the documentation for your text editor.

My images appear smaller than the originals, or image quality is reduced. Why?

SimpleViewer will scale down images to fit in the browser window. This is to allow the whole user-interface to appear in the browser without scrolling. Down-scaled images may appear to be lower quality than the original. To avoid this, either make your images smaller, or increase the size of your browser window. Also, check your maxImageWidth and maxImageHeight value matches the width and height of your largest image in pixel. You may also give your gallery a fixed width and height.

When I view my gallery I see the message 'Gallery XML Not Found'. How do I fix this?

This message means the SimpleViewer SWF cannot find the gallery.xml file that describes the gallery. Make sure the gallery.xml file is in the gallery folder. Check Troubleshooting Pathing Problems.

Why do my image colors look faded when viewed in SimpleViewer?

Image colors may appear faded or washed-out when viewed in SimpleViewer. This is caused by the fact that Flash does not handle ICC Color Profiles. To make the image look the same in Flash and the browser, save your images without a color profile. Note that many browsers (including Internet Explorer) do not handle color profiles, so it is always best remove color profiles when saving images for the web.

To remove a color profile in PhotoShop:

  • Do 'File' -> 'Save for Web'.
  • Uncheck 'Embed Color Profile'.
  • Check 'Convert to sRGB'.

To check if an image has a color profile attached, open it in Photoshop, then click the little right arrow icon at the bottom left of the image. Select 'Show' -> 'Document Profile'. An image without a color profile will show as 'Untagged'.

SimpleViewer-Pro includes a version of the SWF that supports ICC color profiles (Flash player 10 required). Check here for details.

My Flickr Gallery does not run on my local machine. Why?

When running a Flickr gallery locally you may see an error popup: 'Adobe Flash Player has stopped a potentially unsafe operation...'. Flickr galleries will only work when uploaded to a web server. This is due to a security restriction in the Flash Player. If you want to run the gallery locally, you can edit your Flash player security settings. To do this:

  • Click the 'Settings...' button on the warning popup.
  • In the 'Flash Player Global Security Settings' dialog box, select 'Add location' from the 'Edit locations...' drop down.
  • Click 'Browse for folder' and select the folder where your example gallery is located.
  • Click Confirm
  • Reload the webpage.

When I view my gallery I see the message 'Cannot Parse Gallery XML'. How do I fix this?

This message means that SimpleViewer cannot read the gallery.xml file. This is typically caused by syntax error in the XML. To debug the error, open the gallery.xml file in a web browser. Most web browsers will report the specific problem and what line it appears on. A common error is to have a duplicate config option.

When I view my Flickr Gallery, I see the message 'Flickr User Not Found'. How do I fix this?

This message means that Flickr is not able to find the flickrUserName specified in gallery.xml. 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).

If you have the correct user name and still get this message, check the Flickr user's privacy settings. Login into the Flickr account. From the top menu select You -> Your Account -> Privacy & Permissions. Ensure the 'Hide your stuff from public searches' setting is set to 'No'. Note that Flickr users under 18 years of age may not set this value to No, as part of Flickr's privacy policy.

When loading images from a different domain, the images don't load or I see a 'Security Sandbox Violation' error. How do I fix this?

The Flash player does not allow you to load images between different web domains (e.g. www.site1.com and www.site2.com) or different sub-domains (e.g. subdomain.site1.com and www.site1.com). This can be an issue when the SimpleViewer SWF file is on one domain and the images are on a different domain.

The simplest solution is to ensure the SWF file and images are all on the same domain and sub-domain. To allow loading images from a different domain, you need to create a crossdomain.xml file on the web server that is hosting the images. To create a crossdomain.xml file, create a new document in any text editor. Paste the following into the document:

<?xml version="1.0"?><!DOCTYPE cross-domain-policySYSTEM "http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
<allow-access-from domain="www.simpleviewer.net" />
</cross-domain-policy>

Replace www.simpleviewer.net with the domain name that is hosting the SWF file. Save the document as crossdomain.xml. Use FTP to upload the file to the root of the server that is hosting the images. Now Flash will load the images from the specified domain.

Embedding

How do I insert SimpleViewer into a pre-existing HTML page?

View the Embed Guide for details.

How do I add a menu or back button to SimpleViewer?

You can add any HTML page elements such as a back button, menu or logo by editing index.htm in a text or HTML editor. View the Embed Guide for details.

How do I give SimpleViewer a fixed width or height?

Edit index.html and specify the height and width of your gallery in the SWFObject line. Replace the '800' values with the width and height you require in pixels

swfobject.embedSWF("simpleviewer.swf", "flashContent", "800", "800", "9.0.124", false, flashvars, params);

How can I add a vertical scrollbar to my SimpleViewer gallery ?

Remove this line from index.html:

overflow-y: hidden

How do I display SimpleViewer under other elements on my HTML page, for example a drop-down menu?

You can have the SimpleViewer SWF appear under DHTML layers by adding this code above the SWFObject line in the HTML document. Note this may cause issues with certain browsers.

params.wmode = "transparent";

How do I give SimpleViewer a transparent background?

You can give SimpleViewer a transparent background, but it's not recommended. Transparent SWFs may exhibit issues with certain browsers. To make your gallery transparent, add this code above the SWFObject line in the HTML document:

params.wmode = "transparent";

My gallery does not show in Firefox or gets cropped to a small height. Why?

Check your CSS. Firefox requires that you explicitly set the height of the html and body tags, plus the div that contains SimpleViewer. Try setting them all to 100% or the height you require in pixels. For an example, check the CSS in the index.html file that comes in the SimpleViewer download.

How do I embed multiple SimpleViewer galleries?

For details on embedding multiple galleries, check here.

Customizing

How do I add HTML formatting to my captions?

Caption text can include a limited set of HTML formatting, including hyperlinks, line breaks, font tags, bold, underline and italics. Click here to view a list of HTML tags supported by Flash. You must wrap HTML formatted text inside a CDATA tag as below:

<caption><![CDATA[<font face="Times" size="20" color="#ffff00"> Big times text</font><b>bold text</b><u><a href="index.html" target="_blank">link text </a></u><br>New line of text]]></caption>

How do I add HTML formatting to the Title text?

Title text can include a limited set of HTML formatting, including hyperlinks, line breaks, font tags, bold, underline and italics. When adding HTML formatting to the title attribute in gallery.xml, you must replace the following special characters with their XML escape sequence:

& (Ampersand) &amp;
< (Left angle bracket) &lt;
> (Right angle bracket) &gt;
" (Straight quotation mark) &quot;
' (Apostrophe) &apos;

So to add a large Times-Roman title use:

title="&lt;font face=&quot;Times&quot; size=&quot;20&quot;&gt; Big Times Title&lt;/font&gt;"

How do I set the background color?

Edit index.html. Enter the hex color like this:

params.bgcolor = "222222";

How do I load the XML data from a different file location than the default?

To specify where the xml data is loaded from, use the galleryURL HTML option.

How do I load my images and thumbs from different folders than the default?

Images and thumbs can be loaded from any URL by setting the image tag's imageURL and thumbURL properties. If you are using the old v1.9 style filename property, set the source folders with the imagePath and thumbPath Config Options.

How do I change the color of the navigation arrows?

Set the frameColor Config Option.

How do I allow users to save gallery images?

To enable image opening and saving, set the showOpenButton config option to true.

You can also add text links in the image captions to open up the jpg in a new window. This will allow users to right-click the image and save it. SimpleViewer-Pro also includes a direct Image download button option.

How do I prevent users from saving gallery images?

To disable image opening and saving, set the showOpenButton config option to false.

How do I add a custom link URL to my images?

By default, clicking the 'Open In New Window' button opens the current image in a new browser window. Alternatively you can specify a custom URL by setting the linkURL attribute for each image tag in gallery.xml. Image tags take the following format:

<image imageURL="images/tall.jpg" thumbURL="thumbs/tall.jpg" linkURL="http://www.google.com" linkTarget="_blank" >
<caption>This is my caption.</caption>
</image>

  • imageURL is the absolute or relative path to the fullsize image.
  • thumbURL is the absolute or relative path to the thumbnail image.
  • linkURL is the absolute or relative path to URL that is navigated to when the user clicks the 'Open In New Window...' button.
  • linkTarget is the window name that is navigated to when the user clicks the 'Open In New Window...' button.
  • caption - this tag contains optional text caption for the image.

General

Will SimpleViewer load things other than JPG images?

SimpleViewer can load JPG, GIFs, PNGs and SWFs. Any other file types (text, video etc) are not supported.

SWFs are loaded in the same way as JPGs, just add the SWF filename to gallery.xml. Note that you will need to add a thumbnail SWF with the same name as the large SWF in the 'thumbs' folder (create a separate SWF that displays a thumbnail preview). Note that SWFs that use complex ActionScripting may not work as expected when loaded into SimpleViewer.

How can I upgrade my existing galleries to version 2?

To convert an existing gallery from v1.9 to v2 check here.

How do I tell which version of SimpleViewer I have?

For SimpleViewer standard version, right click the SWF to see the version number. For SimpleViewer-Pro, check the readme.html file in the top level of the pro download for the version number.

Why are my images cropped when using the Compact Gallery Style?

When setting the galleryStyle option to COMPACT, SimpleViewer scales images differently than the other 2 gallery styles. Compact style resizes images to FILL the available Image Area. An image that has a different aspect ratio to the image area will be cropped to fit. The Image Area is defined by the maxImageWidth and maxImageHeight options and by the size of the SWF. The reason for this is to maximize the size of the image for small size galleries.

There are 3 ways to avoid image cropping:

  • Use images that have the same dimensions as the image area.
  • Switch the galleryStyle to MODERN or CLASSIC. The styles scale large images down to fit the Image Area while maintaining the aspect ratio of the image.
  • Use SimpleViewer-Pro, which allows you to explicitly define the imageScaleMode config option.

How do I change the order of images from Flickr?

By default SimpleViewer returns images sorted by date posted. Change an image's date posted by using Flickr Organize. Select an image and select Dates -> Date Uploaded.

SimpleViewer-Pro allows you to specify various sort orders using the flickrSort option.

How do I change the order of images in a Flickr Photo Set?

Flickr sets are always returned in the order specified on the Flickr set page. To change the order, use the Flickr Organize page.

  • Click 'Sets & Collections', then the name of your set.
  • Drag and drop your images to change the sort order.
  • Click 'Save' when done.

Why do I only see the first 50 images in my gallery?

SimpleViewer standard version is limited to 50 images per gallery. SimpleViewer-Pro has no limit on the number of images per gallery (500 for Flickr galleries).

SimpleViewer-Pro Presales

What is the SimpleViewer-Pro upgrade policy?

Customers who purchase SimpleViewer-Pro are eligible for free upgrades within the same major version number. For example if you buy version 1.2, all 1.x updates are provided free of charge.

To download the latest version of a purchased Airtight product you can re-use the download link sent in your original purchase email. If you cannot locate your original download link, please fill out this form.

Customers who purchased SimpleViewer-Pro v1.9 on or after 9th December 2008 are eligible for a free courtesy upgrade to v2.0. To receive your upgrade please fill out this form.

Is there a limit on how many websites I can create with SimpleViewer-Pro?

No. SimpleViewer-Pro may be used to create an unlimited number of websites. Each purchase provides a single user license.

SimpleViewer-Pro may not be redistributed or resold to other companies or third parties. SimpleViewer-Pro may not be be redistributed as part of a content management system, online hosting solution or desktop application.

Does SimpleViewer-Pro include the Flash Source Code?

No. All config options are now configurable via XML. Flash developers who want complete control over the look and feel of the gallery can embed SimpleViewer-Pro into a Flash movie and use the ActionScript API to create a completely custom user interface.

Do you offer a trial or demo version?

We do not offer a trial version of SimpleViewer-Pro. We do offer a money back guarantee. If for any reason SimpleViewer-Pro does not meet your requirements, email us within 14 days of your order and we’ll try to resolve any issues. If we are not able to resolve your issues, we will give you a 100% refund.

SimpleViewer-Pro

How do I set the preloader color?

Use the preloaderColor HTML Option

How do I add a background image to my gallery?

Use the backgroundURL Config Option to specify a relative or absolute path to a JPG or SWF to load as the gallery background. For example, to add a background image called 'back.jpg', copy the image to your gallery folder and add this at the top of gallery.xml:

backgroundURL = "back.jpg"

How do I link directly to a specific image in a gallery?

Set the firstImageIndex Config Option. View an example of setting the image index based on the URL.

Do I get a free upgrade to SimpleViewer-Pro v2?

Customers who purchased SimpleViewer-Pro v1.9 on or after 9th December 2008 are eligible for a free courtesy upgrade to v2.0. To receive your upgrade please fill out this form.

Why do I see the message 'Embedding in Flash requires SimpleViewer-Pro' when I open a gallery with svBuilder?

This message means you are opening a non-Pro SimpleViewer gallery with svBuilder. svBuilder will only open SimpleViewer-Pro galleries. For how to upgrade an exisiting gallery to Pro, check here.

How do I fix my layout issues or reduce extra spacing in a gallery?

Check the Layout Guide Troubleshooting Section.