PhotoAlbumPlugin

Summary

Makes an 'album' by displaying a set of photos listed in a text file with optional descriptions.

Usage

<?plugin PhotoAlbum
         src=http://server/textfile
         mode=[column|row]
         align=[center|left|right]
         desc=true
         sort=false
         height=100%
         width=100%
         weblocation=>false
?>

Arguments

Only the ='src'= parameter is mandatory.

src

Url or local path to a CSV textfile which separates filename and description of each photo. Photos listed in the text file have to be in same directory as the file. Descriptions are optional. If the the local path points to a directory, is relative from PHPWIKI_DIR, and the main script is in PHPWIKI_DIR, weblocation must not be given, and all pictures from this directory are displayed.

weblocation

Optional path if the src points to a local dir, and the links on the photos don't work.

mode

Specifies how the images are arranged, 'column' means vertically, 'row' means horizontally. Default is 'row'.

align

Only applicable to column mode. Default is 'center'.

desc

Display any descriptions given in the text file. Default is true.

sort

Sort images by file name. By default the order in the text file is followed.

height, width

Height and width are calculated compared to original metrics retrieved by php-function:getimagesize and can be absolute or a percentage (e.g. "50%").

Examples

Text file

Possible content of a valid text file:

photo-01.jpg; My girlfriend and I
photo-02.jpg
christmas.gif; Merry Christmas!

Sample Album

local dir:

BeachPalmDusk.jpg	Coastline.jpg	HawaiiMauiFromSpace.jpg
LavaTwilight.jpg	LoihiSeamount.jpg	SteamVolcanoDusk.jpg
SubmersiblePiscesV.jpg	SwimmingPoolWater.jpg	Waterfall.jpg
WhaleRainbow.jpg

or via external url:

<?plugin PhotoAlbum
         src="http://phpwiki.sourceforge.net/demo/themes/Hawaiian/images/pictures/PhotoAlbum.csv"

?>

Plugin Author

Ted Vinke <teddy@jouwfeestje.com>

PhpWikiDocumentation WikiPlugin