1 Date: Thu, 9 Dec 2010 14:51:45 +0000
2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
4 Content-Type: application/x-phpwiki;
5 pagename=Help%2FPhotoAlbumPlugin;
6 flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
9 Content-Transfer-Encoding: binary
11 The **~PhotoAlbum** [[Help:WikiPlugin|plugin]] makes an 'album' by displaying a set of photos listed in a text file
12 with optional descriptions.
18 src=http://server/textfile
20 align=[center|left|right]
31 _Only the ='src'= parameter is mandatory._
34 Url or local path to a CSV textfile which separates filename and
35 description of each photo. Photos listed in the text file have to be in same
36 directory as the file. Descriptions are optional.
37 If the the local path points to a directory, is relative from PHPWIKI_DIR,
38 and the main script is in PHPWIKI_DIR, weblocation must not be given, and
39 all pictures from this directory are displayed.
42 defines the the webpath to the srcdir directory (formerly called weblocation)
45 Specifies how the images are arranged.
47 * "normal" - Normal table which shows photos full-size
48 * "thumbs" - WinXP thumbnail style
49 * "tiles" - WinXP tiles style
50 * "list" - WinXP list style
51 * "slide" - slideshow mode, needs javascript on client
54 "none" - No descriptions next to photos %%%
55 "name" - Only filename shown %%%
56 "desc" - Only description (from textfile) shown %%%
57 "both" - If no description found, then filename will be used %%%
61 If true, each image will be hyperlinked to a page where the single
62 photo will be shown full-size. Only works when mode != 'normal'
65 center|right|left. Default is ='center'=.
68 Display any descriptions given in the text file. Default is true.
71 Sort images by file name. By default the order in the text file is
75 Default: #eae8e8 cell bgcolor (lightgrey)
78 Default: #c0c0ff highlight color (lightblue)
81 Height and width are calculated compared to original metrics
82 retrieved by [php-function:getimagesize] and can be absolute (50px)
83 or a percentage (e.g. "50%").
86 attrib arg allows multiple attributes: attrib=sort,nowrap,alt
87 'sort' sorts alphabetically, 'nowrap' for cells, 'alt' to use
88 descs instead of filenames in image ALT-tags
91 cell (auto|equal|image|75|100%)
93 Width of cells in table. Either absolute value in pixels, HTML
94 style percentage, "auto" (no special action), "equal" (where
95 all columns are equally sized) or "image" (take height and
96 width of the photo in that cell).
98 *tablewidth*: (Optional)
102 "displaythissinglephoto.jpg" only
105 "highlightcolorofthisphoto.jpg" only
111 Possible content of a valid text file:
114 photo-01.jpg; My girlfriend and I
116 christmas.gif; Merry Christmas!
119 === Sample Albums ===
122 src="themes/Hawaiian/images/pictures/"
127 src="http://phpwiki.sourceforge.net/demo/themes/Hawaiian/images/pictures/PhotoAlbum.csv"
135 * [Ted Vinke|mailto:teddy@jouwfeestje.com] Original author
136 * [Reini Urban|PhpWiki:ReiniUrban] local fs
137 * [Thomas Harding|PhpWiki:ThomasHarding] slides and thumbs
141 [[PhpWikiDocumentation]] [[CategoryWikiPlugin]]