TIP LightboxPlugin is not installed on Foswiki.org.

Lightbox Plugin

Lightbox is set of Javascript and CSS files that provides improved image viewing functionality. When a user clicks on the image, the full size image will display without advancing the browser to a new page.

ALERT! On recent Foswiki installations (>=1.1.x) the functionality of this plugin is replaced with JQuerySlimbox. The Lightbox Plugin will only properly initialize if TWiki Plugin Version <1.2, so if you still want or have to use it, then you also must enable the TWikiCompatibilityPlugin.


  • Attach images and thumbnails to a topic
  • Use one of the lightbox Foswiki tags to display the thumbnail image.


To add lightbox functionality to a Foswiki topic, use

   %LIGHTBOX{ _options_ }%
   %BEGINLIGHTBOX{ _options_ }%

If successful, a dotted box with a clickable thumbnail should appear.

option default comments
image '' The large display image
thumbnail '' The click-able thumbnail image
float 'right' thumbnail placement on topic page
border see below thumbnail border style
caption '' caption to appear in thumbnail img alt tag and under large image

Note, Foswiki-wide defaults can be set using
  • Set LIGHTBOXPLUGIN_BORDER = 1px dashed #22638C

  • IDEA! If your text is to short, the thumbnail will overlap use height to fix this.
   <div style="border:1px dashed #22638c;padding:4px;height:200px; ">


%LIGHTBOX{ image="img-test.jpg"  thumbnail="tmb-test.jpg" caption="This is a test"}%

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 Foswiki is running.

  • Download the ZIP file from the Plugin Home (see below)
  • Unzip LightboxPlugin.zip in the root of your Foswiki installation
    File: Description:
    data/System/LightboxPlugin.txt plugin description
    lib/Foswiki/Plugins/LightboxPlugin.pm plugin perl code
    pub/System/LightboxPlugin/lightbox.css stylesheet
    pub/System/LightboxPlugin/lightbox.js javascript
    pub/System/LightboxPlugin/blank.gif empty image
    pub/System/LightboxPlugin/close.gif close image button
    pub/System/LightboxPlugin/loading.gif image loading animation
    pub/System/LightboxPlugin/overlay.png overlay image
    pub/System/LightboxPlugin/ScreenShot001.jpg thumbnail example
  • Enable the plugin in configure or LocalSite.cfg
  • Test if the installation was successful:
    • A dotted box with a clickable thumbnail should appear.

Plugin Info

  • Set SHORTDESCRIPTION = Foswiki hooks to the Lightbox Javascript package for better thumbnail image click-through

This Foswiki extension includes v1.0 of Lightbox.

Plugin Author: TWiki:Main.HenriAanstoot, Foswiki:Main.ScottHoge
Copyright: © 2006, TWiki:Main.HenriAanstoot
License: GPL (GNU General Public License)
Release: 26 Nov 2010
Version: 10078 (2010-11-26)
Change History:  
26 Nov 2010: Fixed release numbering
25 Nov 2010: Documented alternative usage of JQuerySlimbox and base requirements on a recent Foswiki
8 Oct 2009: Ported to Foswiki codebase
5 Apr 2007: Added blank.gif to the package
23 Mar 2007: Added Plugin code with TWiki Tags
22 Sep 2006: Initial version
Foswiki Dependency: $Foswiki::Plugins::VERSION 1.1 (Foswiki 1.0.x)
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
Plugin Home: http://foswiki.org/Extensions/LightboxPlugin
Feedback: http://foswiki.org/Support/LightboxPlugin

Related Topic: Foswiki:Extensions.ImageGalleryPlugin

Contributors: TWiki:Main/HenriAanstoot, Foswiki:Main/ScottHoge
Topic attachments
I Attachment Action Size Date Who Comment
LightboxPlugin.md5md5 LightboxPlugin.md5 manage 165 bytes 26 Nov 2010 - 16:09 IngoKappler  
LightboxPlugin.sha1sha1 LightboxPlugin.sha1 manage 189 bytes 26 Nov 2010 - 16:09 IngoKappler  
LightboxPlugin.tgztgz LightboxPlugin.tgz manage 21 K 26 Nov 2010 - 16:08 IngoKappler  
LightboxPlugin.zipzip LightboxPlugin.zip manage 24 K 26 Nov 2010 - 16:08 IngoKappler  
LightboxPlugin_installerEXT LightboxPlugin_installer manage 4 K 26 Nov 2010 - 16:09 IngoKappler  
Topic revision: r3 - 26 Nov 2010, IngoKappler - This page was cached on 16 Jan 2020 - 11:54.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy