Plugin para crear una Galería de Imágenes

• Para crear una galería de imágenes en una página TWiki donde hayamos adjuntado varias imágenes basta escribir
  %MAGEGALLERY% o si se prefiere %ALBUM%
• Es posible especificar parámetros dentro de una llaves a continuación de la palabra IMAGEGALLERY (usando parámetros no funciona la palabra ALBUM), para personalizar la vista de la galería, como en los siguientes ejemplos

• Los parámetros más comunes son
  • size > tamaño =small, medium, large, xlarge, huge
  • web => zona; por defecto es la zona donde estemos usando el plugin
  • topic => tema; por defecto es el tema donde estemos usando el plugin*
  • columns => número de columnas

Configuración

• Nombres y tamaños para la vista de galería

• Nombre y localización de los programas usados (en el servidor) para generar las galerías

• Opciones extras para el programa CONVERT

• Descripción del plugin:
  • Set SHORTDESCRIPTION = Muestra galerías de imágenes generadas a partir de imágenes adjuntas a una página.

• Depurador: (Salida en data/debug.txt)

Información del Plugin

• format => how to format each image (see Variables), default format is:

        <span class="imgGallery"><a href="$imageurl"><img src="$thumburl" title="$sizeK: $comment"/></a></span>$n

• options => additionaly oprins for the CONVERT program, default is "" (empty)
• columns => number of columns default is "0" which means infinity
  if set to some number, the following sequence is generated:
  $rowstart$format$rowinside$format ... $format$rowend
• rowstart => formatted text at start of a row if columns > 0, default is "" (empty)
• rowinside => formatted text inside of a row if columns > 0, default is "" (empty)
• rowend => formatted text at end of a row if columns > 0, default is "" (empty)
• rowinsideempty => formatted text inside of a row if columns > 0 and no more images, default is "" (empty)
• rowendempty => formatted text at end of a row if columns > 0 and no more images, default is "" (empty)

Variables

• $web the %WEB% the image is from
• $topic the %TOPIC% the image is from
• $width width in pixels of the original image
• $height height in pixels of the original image
• $version version number of the ioriginal mage
• $name complete name of the original image (no path)
• $sizeK size of the original image in kilobytes (example: 8k)
• $size size of the original image in bytes (example: 8234)
• $comment the comment of the image attachment
• $wikiusername the WikiName of the user checked in the image
• $username the user name of the user checked in the image
• $thumburl the complete URL of the thumbnail image
• $imageurl the complete URL of the original image
• $date{...} the check in date of the original image, can be formatted like %GMTIME% (see TWikiVariables). The default format is like (if no {} spezified) "31 Dec 2002 - 19:30"
• $n insert a line break
• $imgnr number of the image (starts at 1)

Examples

%IMAGEGALLERY{columns="4" rowstart="|  " rowinside="  |  " rowend="  |$n" rowinsideempty="  |" rowendempty=" |$n" 
  format="<span class='imgGallery'><a href='$imageurl'><img src='$thumburl' title='$tooltip'/></a></span><br/>$imgnr: $comment"}%

1:

2:

Format the Images as a list, images have tool tips.

%IMAGEGALLERY{format="   * <span class='imgGallery'><a href='$imageurl'><img src='$thumburl' title='$tooltip'/></a></span> $wikiusername $date$n"}%

• WillNorris^? 01 Aug 2003 - 23:35
• RicardoDeLosSantos^? 05 Jan 2005 - 19:12

Format the Images as a list, images have tool tips and customized date.

%IMAGEGALLERY{format="   * <span class='imgGallery'><a href='$imageurl'><img src='$thumburl' title='$tooltip'/></a></span> $wikiusername $date{$year$mo$day-$hour:$min:$sec}$n"}%

• WillNorris^? 20030801-23:35:05
• RicardoDeLosSantos^? 20050105-19:12:33

• Additionaly program options for the CONVERT program
  • Set CONVERT_OPTIONS = ""

• • Set DEBUG = 0

• • Set IMAGE_MAGICK = /usr

• • Set IDENTIFY = /usr/bin/identify

• • Set SHORTDESCRIPTION = Displays image gallery with auto-generated thumbnails for attachments.

TWiki Image Gallery Plugin

This plugin offers image galleries... Pages containing %IMAGEGALLERY{"???"}% variables are expanded at view time.

• size > =small, medium, large, xlarge, huge
• web => web; default is %WEB%
• topic => topic; default is %TOPIC%

Example:

%IMAGEGALLERY{ web="%WEB%" topic="%TOPIC%" size="medium" }%


%IMAGEGALLERY{ web="%WEB%" topic="%TOPIC%" size="10x10" }%


%IMAGEGALLERY{ web="Saneasylum" topic="ArtworkGallery" size="x50" }%


ImageGalleryPlugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %SPREADSHEETPLUGIN_SHORTDESCRIPTION%

• Names and sizes for thumbnails (feel free to add additional entries or to modify these defaults)
  • Set TINY = 25x25
  • Set SMALL = 50x50
  • Set MEDIUM = 95x95
  • Set LARGE = 150x150
  • Set XLARGE = 250x250

• Name and location of program used to generate thumbnails
  • Set CONVERT = /usr/bin/convert
  • Set IMAGE_MAGICK = /usr/bin

• One line description, is shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = Displays photo album image gallery for attachments.

• Debug plugin: (See output in data/debug.txt)
  • Set DEBUG = 1

Plugin Installation Instructions

• Download the ZIP file from the ImageGalleryPlugin home
• Unzip = ImageGalleryPlugin.zip= in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/ImageGalleryPlugin.txt	Plugin topic
  data/TWiki/ImageGalleryPlugin.txt,v	Plugin topic repository
  lib/TWiki/Plugins/ImageGalleryPlugin.pm	Plugin Perl module

Plugin Info

Related Topics: TWikiPreferences, TWikiPlugins

-- WillNorris^? - 08 Mar 2002