Skip to topic | Skip to bottom
Web attivi: Reteisi | Pmb
user: TWikiGuest
Mappa | Indice | Cambiamenti | Cerca | Vai a | Calcolatrice

Sei qui: TWiki > PhotoarchivePlugin

Start of topic | Skip to actions


PhotoarchivePlugin is a nice plugin to show your photo archive or album in different views. You can add a description to each picture and define the picture size for individual views.

  • Future releases will get something like templates to have full control over the layout.
  • Now a multiplatform offline Photoarchive application is in work. It will become the user interface for simple storing, describing and uploading to your TWiki Photoarchive. But it needs time.

Syntax Rules

These are the rules to add a Photoarchive to your twiki web.

  • Add %PHOTOARCHIVEPLUGIN% to a twiki topic or
  • ... add %PHOTOARCHIVEPLUGINRANDOM% for single random image including.
  • Create a new topic with name <TOPICNAME>Photoarchive
  • Attach your pictures to <TOPICNAME>Photoarchive
  • Add your picture definitions in the following form to this topic:

... etc.

  • Each tag must start at the beginning of the line (no spaces) and end with a newline!
  • You can overwrite the preferences for images and layout in the topic where you add the %PHOTOARCHIVEPLUGIN% or %PHOTOARCHIVEPLUGINRANDOM% placeholder. To use overwriting from topics you have to add PhotoarchivePlugin_ in front of each settingname. E.g. instead RANDOMWIDTH you have to use PhotoarchivePlugin_RANDOMWIDTH


  • This is a sample entry for <TOPICNAME>Photoarchive

My first image in Photoarchive
This is my first image which is shown by PhotoarchivePlugin.
It has no special purpose but you can see how it works.

Plugin Settings

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

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

  • The default view is the view which is shown without any parameters:
    There is a thumbs, detailed and descripted view.
    • Set DEFAULTVIEW = thumbs

  • A few programs of netpbm software package are required to resize images.
    The default entries are /usr/bin/{anytopnm, pnmscale, pnmtopng, pnmtojpeg}.
    • Set ANYTOPNM = /usr/bin/anytopnm
    • Set PNMSCALE = /usr/bin/pnmscale
    • Set PNMTOPNG = /usr/bin/pnmtopng
    • Set PNMTOJPEG = /usr/bin/pnmtojpeg

  • The number of images in row and column for thumbs view
    • Set THUMBSROW = 4
    • Set THUMBSCOL = 3

  • The thumbnail image width and height. If you set both values the images will change their width-height-ratio.
    • Set THUMBSHEIGHT = 120

  • The pixel space around thumbnail images.
    • Set THUMBSSPACE = 5

  • The descripted images width and height. If you set both values the image will change its width-height-ratio.

  • The pixel space around the header and images descripted view.

  • The number of images per page in descripted view.

  • The detailed image width and height. If you set both values the image will change its width-height-ratio.
    • Set DETAILEDWIDTH = 600

  • The pixel space around the header, image and description in detailed view.

  • The default width and height for random images. If you specify both values the image has a new side ratio.
    • Set RANDOMHEIGHT = 120

  • For randomly choosed images you can specify the web and topic where the image archive can be found. The topic with the attached images must end with Photoarchive. You must remove "Photoarchive" at the RANDOMTOPIC setting.
    • Set RANDOMWEB =

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

  • Download the ZIP file from the Plugin web (see below)
  • Unzip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/PhotoarchivePlugin.txt Plugin topic
    data/TWiki/PhotoarchivePlugin.txt,v Plugin topic repository
    data/TWiki/PhotoarchivePluginPhotoarchive.txt Plugin test photoarchive topic
    data/TWiki/PhotoarchivePluginPhotoarchive.txt,v Plugin test photoarchive topic repository
    data/TWiki/PhotoarchivePluginPhotoarchive/testimage.jpg Attached test image
    data/TWiki/PhotoarchivePluginPhotoarchive/testimage.jpg,v Attached test image repository
    pub/TWiki/PhotoarchivePlugin Directory for future plugin internal data (empty)
    lib/TWiki/Plugins/ Plugin Perl module
  • Test if the installation was successful:
    • You see here a sample image included with %PHOTOARCHIVEPLUGINRANDOM%

    • image: This is the testimage which you should see after installation

Plugin Info

Plugin Author: TWiki:Main/MarkusKolb
Plugin Version: 30 Sep 2021 (V1.002)
Plugin Id: $Id: PhotoarchivePlugin.txt,v 1.3 2021/08/09 04:14:36 www-data Exp www-data $
Change History:  
30 Sep 2004: V1.002 overwriting of plugin preferences in topic now possible
29 Sep 2004: V1.001 patch against Internet Explorer <img>-tag incompatibility
29 Sep 2004: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.024
CPAN Dependencies: none
Other Dependencies: netpbm
Perl Version: 5.005
TWiki:Plugins/Benchmark: GoodStyle 98%, FormattedSearch 96%, PhotoarchivePlugin 96%
Plugin Home:
Feedback: [email protected]

Related Topics: TWikiPreferences, TWikiPlugins

-- MarkusKolb? - 30 Sep 2021

TWiki.PhotoarchivePlugin r1.3 - 09 Aug 2021 - 04:14 - Main.www-data
Copyright © 1999-2006 degli autori degli articoli. Tutto il materiale presente su questa piattaforma collaborativa Ŕ di proprietÓ di chi l'ha prodotto. Idee, richieste, problemi relativi a TWiki? Invia feedback