German | English
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 1.5 Date: 2007-6-5
@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
minislideshow.html (example)
xml.php (will display all items in a specified gallery)
http://www.yoursite.com/gallery2/xml.php?g2_itemId=49
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
xml_dynamic.php (for use with G2's DynamicAlbums Module)
http://www.yoursite.com/gallery2/xml_dynamic.php?g2_view=dynamicalbum.UpdatesAlbum
http://www.yoursite.com/gallery2/xml_dynamic.php?g2_view=dynamicalbum.RandomAlbum
http://www.yoursite.com/gallery2/xml_dynamic.php?g2_view=dynamicalbum.PopularAlbum
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:
<embed width="160" height="160" align="middle" pluginspage="http://www.macromedia.com/go/getflashplayer"
type="application/x-shockwave-flash" name="minislide" wmode="transparent" quality="high" flashvars="xmlUrl=http://www.yoursite.com/gallery2/xml.php?g2_itemId=32&shuffle=true&showDropShadow=true
&delay=3&transInType=Fade&transOutType=Random&showTitle=bottom" src="http://www.yoursite.com/gallery2/minislideshow.swf"></embed>
The above code sample would render something similar to:
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). |
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.