XML Mini Slideshow for Gallery2
Copyright (C) 2007 Wayne Patterson http://www.flashyourweb.com

This program is freeware.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

@version 2.0.1 RC1 Date: 2007-9-30
@author Wayne Patterson <suprsidr@gmail.com>

Download

The MiniSlideShow communicates with your Gallery2 or Media Gallery website via an external XML generator, and is not part of the official Gallery2 package.

The MiniSlideShow will start loading gallery item thumbs - after 5 it will start displaying while loading the rest in the background.

FileList:
minislideshow.swf

*Note the addition of mode to the xmlUrl.

xml.php
http://www.yoursite.com/gallery2/xml.php?g2_itemId=49

*Note on Gallery style urls and Flash
Flash interprets &(ampersand) as a break, so you will need to replace them with the unicode equivelent %26 in the url only.
Continue adding your additional vars with the &(ampersand).

http://www.yoursite.com/gallery2/xml.php?mode=dynamic%26g2_view=dynamicalbum.UpdatesAlbum
http://www.yoursite.com/gallery2/xml.php?mode=dynamic%26g2_view=dynamicalbum.RandomAlbum
http://www.yoursite.com/gallery2/xml.php?mode=dynamic%26g2_view=dynamicalbum.PopularAlbum

http://www.yoursite.com/gallery2/xml.php?mode=dynamic%26g2_view=keyalbum.KeywordAlbum%26g2_keyword=yourKeyword

http://www.yoursite.com/gallery2/xml.php?mode=dynamic%26g2_view=tags.VirtualAlbum%26g2_tagName=yourTagName

For now I'm including xml_all.php, I will incorporate this into xml.php before release.

xml_all.php (will display all items in all galleries)
If there is no g2_itemId given, it will list every album and its contents.(be careful on big sites)
http://www.yoursite.com/gallery2/xml_all.php
If you give it a g2_itemId it will show the contents of that album and its subalbums only.(not recursive)
http://www.yoursite.com/gallery2/xml_all.php?g2_itemId=49


Usage:
1. upload minislideshow.swf and your xml(.php) files to your gallery2 base directory.
(if you have previous version of xml.php, there have been some changes)

2. edit line 5 of your xml(.php) to reflect your setup (default will work for most).

$ret = GalleryEmbed::init(array('fullInit' => true, 'embedUri' => '/gallery2/main.php', 'g2Uri' => '/gallery2/'));

*Hint: If your gallery is embedded the embedUri needs to reflect you CMS' embedUri

3. place the following in your webpage where you want the mini slideshow to appear:


Edit the g2_itemId in the xmlUrl to reflect the album you want to be displayed and also the site url.
*Hint: If you have url rewrite enabled, you may have to temporarily disable it to see the g2_itemId in your album's url.


External Variables(case sensitive)

External Variable	Description/Possible Value
shuffle	true or false
showDropShadow	true or false
delay	number in seconds to display a slide
transInType	Transition in. Default Fade. (see Available Transitions below)
transOutType	Transition out. Default Fade. (see Available Transitions below)
noLink	Can be true. Default false.
showTitle	top or bottom. Default false.
altLink	Replace all links with a single alternate link for the whole slideshow. Default false.
linkTarget	Specify the target for all links in the slideshow. Default _parent.
titleColor	Title text color. Default FFFFFF(white).
titleBgColor	Title text background color. Default 333333(charcoal).
Masks	circleMask, roundedMask, starMask example: &starMask=true

Add your external variables to your xmlUrl separated with an ampersand (&) ie.
xmlUrl=http://yoursite.com/gallery2/xml.php?g2_itemId=1486&shuffle=true&showDropShadow=true&delay=3
&transInType=Fade&transOutType=Random

Available Transitions(case sensitive)

Transition	Description
Blinds	Reveals the movie clip object by using appearing or disappearing rectangles.
Fade	Fades the movie clip object in or out.
Fly	Slides the movie clip object in from a specified direction.
Iris	Reveals or hides the movie clip object by using an animated mask of a square shape or a circle shape that zooms in or out.
Photo	Causes the movie clip object to appear or disappear like a photographic flash.
PixelDissolve	Reveals or hides the movie clip object by using randomly appearing or disappearing rectangles in a checkerboard pattern.
Rotate	Rotates the movie clip object.
Squeeze	Scales the movie clip object horizontally or vertically.
Wipe	Reveals or hides the movie clip object by using an animated mask of a shape that moves horizontally.
Zoom	Zooms the movie clip object in or out by scaling it in proportion.
Random	A mix of all.

* Hints
No longer has to be 180x180, it will resize the thumbs to fit say 160x160 or 150x150...
as large as you want, but you may need to increase your thumb size in G2.
I would not go to big though as the thumbs will pixelate.

Any questions, comments, or suggestions are welcome.