Check here for PostcardViewer-Pro support and documentation.
If you have a question about using PostcardViewer-Pro, please check the FAQ first. Chances are your question has already been answered.
PostcardViewer is supported via an online forum. Before posting a new question, please search the forum to see if your question has already been answered.
PostcardViewer-Pro allows you to customize your PostcardViewer galleries.
To create a new PostcardViewer-Pro gallery, first use any of these methods to create a regular PostcardViewer gallery. Then upgrade the gallery to PostcardViewer-Pro by replacing the 'viewer.swf' file in your gallery folder with the one that comes in the Pro download (at '\web\viewer.swf').
To create galleries with a customized version of PostcardViewer-Pro, first create your customized SWF. Once you have a customized SWF, copy it into your existing PostcardViewer gallery folder, as described in the previous paragraph.
To upgrade an existing PostcardViewer gallery to PostcardViewer-Pro or to use PostcardViewer-Pro with a Template or Plugin, check here.
The following folders are in contained in the PostcardViewer-Pro download:
There are 4 ways to customize PostcardViewer-Pro, by modifying:
Customizing PostcardViewer-Pro requires Adobe Flash Professional (CS3 to CS6) authoring software. A free 30-day trial of Flash Professional CS6 can be downloaded here.
PostcardViewer-Pro shares the same XML options as found in PostcardViewer. View the list of XML Options here.
To customize XML Options:
PostcardViewer-Pro ActionScript Options are a set of ActionScript variables that you can edit to customize PostcardViewer behaviour. View the list of ActionScript Options here.
To customize ActionScript Options:
To change the visual appearance of some elements in PostcardViewer-Pro, edit the Library Symbols in the postcardviewer.fla file.
The Library in postcardviewer.fla contains the following folders:
To customize Library Symbols:
For customization not covered by the 3 methods above, you can directly edit the source code. PostcardViewer-Pro source code is AS2. Edit the class files (.as) using a text editor or Flash. Once you have made your changes, you will need to republish your SWF (See 2.5 Republishing PostcardViewer).
Please note that the PostcardViewer-Pro source code is provided 'as-is' to allow people with ActionScript experience to modify as required. Airtight Interactive cannot provide support for all possible modifications to the source code and cannot provide tutorials on how to code ActionScript.
PostcardViewer classes can be found in this folder: \source\com\airtightinteractive\apps\viewers\postcardviewer\
The classes that comprise PostcardViewer are as follows:
Republishing PostcardViewer creates a new version of the viewer.swf file from the source files.
To republish PostcardViewer:
When displaying PostcardViewer on your site you can use the standard full-page HTML template, or you can embed PostcardViewer inside a HTML page or another Flash Movie. Check the Embedding guide here.
Check the \examples\HTML Embed\ folder for examples of embedding PostcardViewer in a HTML document. There are 2 example folders:
Embedding PostcardViewer-Pro in Flash requires the embedding movie to be ActionScript 2 and requires Adobe Flash 8 (or later) authoring software. Embedding PostcardViewer-Pro in Flash requires a basic level of Flash authoring experience.
Check the example file here: \examples\Flash Embed\multiple_galleries.fla. This example shows how to load multiple galleries inside a container Flash movie.
Note that PostcardViewer sets Stage.align to 'TL' and Stage.scaleMode to 'noScale' in the init() function at the top of the 'Main.as' file. You may need to remove this code if the embedding movie uses a different align or scalemode.
To upgrade existing PostcardViewer galleries to PostcardViewer-Pro, you just need to replace the viewer.swf file in your existing gallery folders with the one that comes in the Pro download (at \web\viewer.swf).
To upgrade your Picasa PostcardViewer Template installation to Pro:
To upgrade your Lightroom v2 PostcardViewer Engine to PostcardViewer-Pro:
To upgrade your Photoshop PostcardViewer Script installation to Pro: