collective.prettyphoto 0.4.0

prettyPhoto integration for Plone.

Introduction

prettyPhoto is a jQuery based lightbox clone. Not only does it support images, it also add support for videos, flash, YouTube, iFrames. It’s a full blown media lightbox. The setup is easy and quick, plus the script is compatible in every major browser.

The original implementation can be found here: http://www.no-margin-for-errors.com/projects/prettyphoto-jquery-lightbox-clone/

This plugin has been tested and is known to work in the following browsers

• Firefox 2.0+

• Safari 3.1.1+

• Opera 9+

• Internet Explorer 6.0+

collective.prettyphoto integrates prettyPhoto 3.0.1 into Plone.

Installing

This package requires Plone 3.x or later (tested on 3.3.5 and 4.0.3).

Installing without buildout

Install this package in either your system path packages or in the lib/python directory of your Zope instance. You can do this using either easy_install or via the setup.py script.

Installing with buildout

If you are using buildout to manage your instance installing collective.prettyphoto is even simpler. You can install collective.prettyphoto by adding it to the eggs line for your instance:

[instance]
eggs = collective.prettyphoto

After updating the configuration you need to run the ‘’bin/buildout’’, which will take care of updating your system.

Usage

collective.prettyphoto adds a new view for Topics, Folders and Large Plone Folders: Thumbnail view (prettyPhoto).

To use prettyPhoto for inline elements just add ‘prettyPhoto’ from the styles menu (Kupu and TinyMCE) to the link.

Configuration

collective.prettyphoto can be customized via property sheet (go to ZMI, portal_properties, prettyphoto_properties).

• theme:

  • dark_rounded

  • dark_square

  • facebook

  • light_rounded (default)

  • light_square

• speed:

  • fast

  • normal (default)

  • slow

• opacity: value from 0.0 to 1.0 (default: 0.80)

• show_title: show the title for images? (default: True)

• counter_sep: the separator for the gallery counter 1 “of” 2 (default: “/”)

• autoplay: automatically start videos? (default: True)

• iframe_width: the width of the iframe (must be percantage, default: 75%)

• iframe_height: the height of the iframe (must be percantage, default: 75%)

• overlay_gallery: If set to true, a gallery will overlay the fullscreen image on mouse over (default: False, because of this bug: http://bit.ly/eKYdrF)

• slideshow: false OR interval time in ms (default: False)

Copyright and Credits

prettyPhoto is developed by Stephane Caron (http://www.no-margin-for-errors.com) and is licensed under Creative Commons Attribution 2.5.

Author of collective.prettyphoto: Thomas Massmann ([e-mail]).

Changelog

0.4.0 (2011-02-23)

• Upgraded to prettyPhoto library including it’s css and image sprite to 3.0.1 to fix issues with jQuery 1.4.4 (see http://bit.ly/hxYUrt) which is shipped with latest Plone 4 by default. This fixes #2. [saily]

• Added default thumbnails for ‘overlay_galleries’ feature. [saily]

• Added ‘overlay_gallery’ and ‘slideshow’ as additional configuration options but disabled by default cause of a bug in jquery.prettyPhoto.js which aviods displaying thumbnails not ending on (jpg|jpeg|png|gif). See http://bit.ly/eKYdrF [saily]

0.3.3 (2010-12-20)

• Fixed iframe configuration (width was used for height too) [fRiSi]

0.3.2 (2010-07-10)

• Fixed install issue with Plone 4 (Large Plone Folder was removed). [hpeteragitator]

• Set version in metadata.xml to 1, since this has nothing to do with the package version. [tmassman]

0.3.1 (2010-05-19)

• Fixed version numbers and missing upgrade steps. [tmassman]

• Added custom browserlayer. [tmassman]

• Upgrade to prettyPhoto 2.5.6 [tmassman]

0.3 (2010-05-17)

• Don’t fail when installing on sites w/o kupu (plone4 compatibility). [fRiSi]

0.2 (2010-01-03)

• Fixed wrong kupu styles. [tmassman]

• Added iFrame support (use ‘prettyPhoto Iframe Link’ for external sites) [tmassman]

0.1 (2009-12-29)

• Initial release [tmassman]