pgsrc/Help%2FPhotoAlbumPlugin

   1 Date: Mon, 16 Jun 2008 14:15:24 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.14-20080124)
   3 X-Rcs-Id: $Id: Help%2FPhotoAlbumPlugin,v 1.3 2008-06-18 01:12:39 vargenau Exp $
   4 Content-Type: application/x-phpwiki;
   5   pagename=Help%2FPhotoAlbumPlugin;
   6   flags=PAGE_LOCKED;
   7   markup=2;
   8   charset=iso-8859-1
   9 Content-Transfer-Encoding: binary
  10
  11 !!! Summary
  12 Makes an 'album' by displaying a set of photos listed in a text file
  13 with optional descriptions.
  14
  15 !!! Usage
  16 <verbatim>
  17 <?plugin PhotoAlbum
  18          src=http://server/textfile
  19          mode=[column|row]
  20          align=[center|left|right]
  21          desc=true
  22          sort=false
  23          height=100%
  24          width=100%
  25          weblocation=>false
  26 ?>
  27 </verbatim>
  28
  29 !!! Arguments
  30 _Only the ='src'= parameter is mandatory._
  31
  32 *src*:
  33   Url or local path to a CSV textfile which separates filename and
  34   description of each photo. Photos listed in the text file have to be in same
  35   directory as the file. Descriptions are optional.
  36   If the the local path points to a directory, is relative from PHPWIKI_DIR,
  37   and the main script is in PHPWIKI_DIR, weblocation must not be given, and
  38   all pictures from this directory are displayed.
  39
  40 *url*:
  41   defines the the webpath to the srcdir directory (formerly called weblocation)
  42
  43 *mode*:
  44   Specifies how the images are arranged.
  45
  46   * "normal" - Normal table which shows photos full-size
  47   * "thumbs" - WinXP thumbnail style
  48   * "tiles"  - WinXP tiles style
  49   * "list"   - WinXP list style
  50   * "slide"  - slideshow mode, needs javascript on client
  51
  52 *showdesc*:
  53   "none"   - No descriptions next to photos %%%
  54   "name"   - Only filename shown %%%
  55   "desc"   - Only description (from textfile) shown %%%
  56   "both"   - If no description found, then filename will be used %%%
  57
  58 *link*:
  59   true or false
  60   If true, each image will be hyperlinked to a page where the single
  61   photo will be shown full-size. Only works when mode != 'normal'
  62
  63 *align*:
  64   center|right|left. Default is ='center'=.
  65
  66 *desc*:
  67   Display any descriptions given in the text file. Default is true.
  68
  69 *sort*:
  70   Sort images by file name. By default the order in the text file is
  71   followed.
  72
  73 *bgcolor*:
  74   Default: #eae8e8  cell bgcolor (lightgrey)
  75
  76 *hlcolor*:
  77   Default: #c0c0ff  highlight color (lightblue)
  78
  79 *height*, *width*:
  80   Height and width are calculated compared to original metrics
  81   retrieved by [php-function:getimagesize] and can be absolute (50px)
  82   or a percentage (e.g. "50%").
  83
  84 *attrib*:
  85   attrib arg allows multiple attributes: attrib=sort,nowrap,alt
  86   'sort' sorts alphabetically, 'nowrap' for cells, 'alt' to use
  87   descs instead of filenames in image ALT-tags
  88
  89 *cellwidth*:
  90   cell (auto|equal|image|75|100%)
  91
  92   Width of cells in table. Either absolute value in pixels, HTML
  93   style percentage, "auto" (no special action), "equal" (where
  94   all columns are equally sized) or "image" (take height and
  95   width of the photo in that cell).
  96
  97 *tablewidth*: (Optional)
  98   table (75|100%)
  99
 100 *p*:    (Optional)
 101   "displaythissinglephoto.jpg" only
 102
 103 *h*: (Optional)
 104   "highlightcolorofthisphoto.jpg" only
 105
 106 !!! Examples
 107 !! Text file
 108 Possible content of a valid text file:
 109
 110 <verbatim>
 111 photo-01.jpg; My girlfriend and I
 112 photo-02.jpg
 113 christmas.gif; Merry Christmas!
 114 </verbatim>
 115
 116 !! Sample Albums
 117 local dir:
 118 <?plugin PhotoAlbum
 119          src="themes/Hawaiian/images/pictures/"
 120 ?>
 121 or via external url:
 122 <verbatim>
 123 <?plugin PhotoAlbum
 124          src="http://phpwiki.sourceforge.net/demo/themes/Hawaiian/images/pictures/PhotoAlbum.csv"
 125 </verbatim>
 126 ?>
 127
 128 [ /Slides ]
 129
 130 !!! Plugin Authors
 131 * [Ted Vinke|mailto:teddy@jouwfeestje.com] Original author
 132 * [Reini Urban|PhpWiki:ReiniUrban] local fs
 133 * [Thomas Harding|PhpWiki:ThomasHarding] slides and thumbs
 134
 135 ----
 136 [PhpWikiDocumentation] [CategoryWikiPlugin]