collective.prettyphoto
Advanced tools
.. image:: https://travis-ci.org/collective/collective.prettyphoto.png :target: https://travis-ci.org/collective/collective.prettyphoto
.. contents::
prettyPhoto_ is a jQuery based lightbox clone. It supports images, it also add support for videos, flash, YouTube, iFrames and ajax.
It's a full blown media lightbox. The setup is easy and quick, plus the script is compatible in every major browser.
This plugin has been tested and is known to work in the following browsers:
collective.prettyphoto integrates prettyPhoto 3.1.5 into Plone.
Development focus is now set to Plone 4.x. Currently all 4.x versions
are tested on Travis CI_. Plone 3.x is no longer officially supported.
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.
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.
collective.prettyphoto adds a new view for Collections and Folders: Thumbnail view (prettyPhoto).
To use prettyPhoto for inline elements just add prettyPhoto from the
styles menu in TinyMCE to the link.
collective.prettyphoto can be customized via property sheet (go to ZMI, portal_properties, prettyphoto_properties).
theme:
pp_default (default)
dark_rounded
dark_square
light_rounded
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, the bug (http://bit.ly/eKYdrF) is fixed
since 0.4.1 (pP 3.0.3) but your image url has to contain
(jpg|jpeg|png|gif) somewhere)
slideshow: interval time in ms, 0 to disable slideshow
(default: 0)
autoplay_slideshow: automatically start slideshow?
(default: False, only woks when slideshow > 0)
deeplinking: rewrite the browser location to enable directlinks to
overlay images (default: False)
social_tools: html markup for social links within image overlays (twitter, FB, ...) (default: empty) see http://bit.ly/pDQ19A for detailed information
prettyPhoto_ is developed by Stephane Caron (http://www.no-margin-for-errors.com) and is licensed under Creative Commons Attribution 2.5.
.. _prettyPhoto: http://www.no-margin-for-errors.com/projects/prettyphoto-jquery-lightbox-clone/
.. _buildout: http://pypi.python.org/pypi/zc._buildout
.. _Travis CI: http://travis-ci.org/collective/collective.prettyphoto
Documentation updates [saily]
Upgrade to prettyPhoto 3.1.5 [saily]
Add ui-tests using robotframework to validate views. [saily]
Add travis integration for Plone 4.3.x, Plone 4.2.x, Plone 4.1.x and
Plone 4.0.x. Plone 3.3.x cannot be tested with new layered testing structure
of plone.app.testing and will never be testable on travis because they
don't and will never support Python 2.4.
So we changed primary focus of development to Plone >= 4.0. [saily]
Switchted to plone.app.testing and added some basic installation tests.
[saily]
Add egg-containing buildout and bootstrap.py [saily]
Use zcml:condition="installed plone.app.collection" to switch to a new
GS profile which appends prettyphoto views to Collection instead Topic type.
[saily]
Refactor GS profiles and depend each profile on a 'extended' profile which hold generic stuff as registering css and js. Generic setup takes the first profile which is found in folder, so this has to be alpha-sorted behind 'default'. [saily]
corrected the global js-function [bennyboy]
Made it possible to later (i.e. after ajax calls) bind prettyphoto to images. thus we have a global js-function plonePrettyPhotoEnable now. Also did some housekeeping, added integrated buildout, gitignore, ... [jensens]
browser.view.Javascript.markup)
[fRiSi]Fixed parameter names used to configure prettyPhoto and added autoplay_slideshow.
Previously titles have been shown although show_title has been set to
False in prettyphoto_properties.
[fRiSi]
Finish update to 3.1.2 by updating css and images and adding the new pp_default
theme (which is the new default btw ;-)
[fRiSi]
Upgraded to prettyPhoto 3.0.3 . This fixes thumbnails in overlay_gallery partly because the regular expression now looks for a (jpg|jpeg|png|gif) within the whole url. if your originaly linked images are completely without this, they still wont show up. [petschki]
fixed overlay_gallery property defaults to "False" [petschki]
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 avoids displaying thumbnails not ending on (jpg|jpeg|png|gif). See http://bit.ly/eKYdrF [saily]
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]
Fixed version numbers and missing upgrade steps. [tmassman]
Added custom browserlayer. [tmassman]
Upgrade to prettyPhoto 2.5.6 [tmassman]
Fixed wrong kupu styles. [tmassman]
Added iFrame support (use 'prettyPhoto Iframe Link' for external sites) [tmassman]
FAQs
prettyPhoto integration for Plone.
We found that collective.prettyphoto demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Snyk's use of malicious npm packages for research raises ethical concerns, highlighting risks in public deployment, data exfiltration, and unauthorized testing.
Research
Security News
Socket researchers found several malicious npm packages typosquatting Chalk and Chokidar, targeting Node.js developers with kill switches and data theft.
Security News
pnpm 10 blocks lifecycle scripts by default to improve security, addressing supply chain attack risks but sparking debate over compatibility and workflow changes.