JQPrettyPhotoContrib

Yet another nice lightbox plugin

This package integrates the great prettyphoto jquery lightbox clone by Stephane Caron

prettyPhoto is a full blown media lightbox supporting images, videos, flash, YouTube, iframes and ajax. It can be used as a drop-in replacement of JQueryPlugin's version of slimbox, another lightbox clone, shipped with foswiki by default.

prettyPhoto has been integrated by means of minimal invasive markup, that is any DIV element with a class jqPrettyPhoto will be converted into a media lightbox automatically without any extra provisions, similar to the way slimbox is used. Additional parameter to the plugin itself can be passed using JQueryMetadata.

Note that Foswiki:Extensions/TopicInteractionPlugin as well as Foswiki:Extensions/ImageGalleryPlugin will automatically switch from slimbox to prettyPhoto for lightboxing.

Examples

( using Foswiki:Extensions/ImagePlugin )

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -> "Install, Update or Remove extensions" Tab. Click the "Search for Extensions" button. Enter part of the extension name or description and press search. Select the desired extension(s) and click install. If an extension is already installed, it will not show up in the search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)

cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Dependencies

Name	Version	Description
Foswiki::Plugins::JQueryPlugin	>=4.00	Required.
Foswiki::Plugins::ImagePlugin	>=2.40	Recommended.

Change History

13 Jan 2025:	removed depencency on jquery.metadata
23 Jan 2017:	make sure the package is still release-able; deprecated jquery.metadata - use html5 data instead
30 Sep 2011:	upgrading to prettyPhoto 3.1.3; switching off overlay gallery by default for performance reasons
06 Apr 2011:	initial release