Package contents

The package you downloaded contains the following files:
- documentation.html
- xmlPhotoGallery.fla
- xmlPhotoGallery.swf
- data.xml
- index.html
- swfobject.js
- Images (containing sample images)

Settings

In the .xml file that comes with the package, you can set a number of variables in the <settings /> tag. They are shown in the table below:

Variable name	Variable type	Value range	Variable description
Thumbnails
thumbWidth	Number	> 0	Width of the thumbnail images.
thumbHeight	Number	>0	Height of the thumbnail images.
marginX	Number	any	Horizontal spacing between thumbnail images.
spanX	Number	> 0	Width of the thumbnail row shown.
borderWidth	Number	any	Width of the border around the big image.
orientationType	Number	0/1	The way the thumbnail row is controlled, either 0 for relative movement (move to a position depending on cursor position) or 1 for absolute movement (move at a certain speed depending on cursor position).

How to add images

The xml file has the following structure:

[...]

<photos>

	<gallery galleryName="">

		<photo [...] >

  			<description><![CDATA[<p>[...]</p>]]></description>

		</photo>

  </gallery>
</photos>

To add more galleries, simply copy the gallery tag and choose a name for it. To add images, copy the photo tag and provide the required information. The attributes of the photo tag are explained in the table below.

Variable name	Variable type	Value range	Variable description
Image
ImageURL	String	any	URL of the image to load
ThumbURL	String	any	URL of the thumnail image to load
Linkage
linkData	String	any	Either a URL to visit when clicked, a frame number, a frame label or a movie to load.
linkType	String	"URL", "frameNumber", "frameLabel" or "loadMovie"	A command to tell what to do with the linkData and linkTarget. See below for examples.
linkTarget	String	A html target or the movieclip from which linkData is defined.	Telling what the linking command applies to. See below for examples.
Caption text
captionText	String	any	The caption text of the image

The description tags contain the long description of every image, which may be html. To avoid problems while parsing any html, please keep the CDATA tags in it, and put your html between the <p></p> tags.

Linking examples

The example below would visit http://www.google.com in a new browser window.
linkData="http://www.google.com" linkType="URL" linkTarget="_blank"

The example below would make the root timeline go to frame number 2
linkData="2" linkType="frameNumber" linkTarget="_root"

The example below would make the root timeline go to the frame with label myFrameLabel
linkData="myFrameLabel" linkType="frameLabel" linkTarget="_root"

The example below would make the movieclip myMovieClip in the root timeline go to frame number 2
linkData="2" linkType="frameNumber" linkTarget="myMovieClip"

Copyright notices

You may use this file in any of your projects, either commercial or non-commercial. You may not resell this file as is, or as part of a package. You may though use this file as part of a custom project (e.g. website) for which you earn a payment.

Credits

I would appreciate it if you'd put my name and a link to my website (www.jurgenvisser.nl) somewhere in the project where you used this file, but of course you don't have to. Also I love to see how my files are being used, so if you have finished your project I would really appreciate it if you would send me a link at flashden@jurgenvisser.nl.

Thank you for purchasing this file,

JurgenV