Skip to main content

A gallery/slideshow product for Plone that can aggregate from Picasa (add and Flickr (add or use Plone images.

Project description

collective.plonetruegallery Documentation


collective.plonetruegallery is a Plone add-on that implements a very customizable and sophisticated gallery.

Plone Version Compatibility

Works with Plone 4.3 and earlier. For not-yet-working Plone 5 support, see the plone5 branch and issue #66.

How It Works

collective.plonetruegallery adds a Gallery View to Folders and Collections.

For any Folder or Collection containing or showing images, use the Display toolbar menu and select Gallery View.

Once that is done, a Gallery Settings toolbar menu is enabled for the type. With this, you can customize the various settings for the Gallery.

Supported Display Types

To install any of the various extra display types, you need to install the dependent package in buildout

  • galleria (included in default installation of collective.plonetruegallery)

  • contact sheet (collective.ptg.contactsheet)

  • thumbnail zoom gallery (collective.ptg.thumbnailzoom)

  • presentation (collective.ptg.presentation)

  • galleriffic (collective.ptg.galleriffic)

  • highslide (collective.ptg.highslide)

  • fancybox (collective.ptg.fancybox)

  • pikachoose (collective.ptg.pikachoose)

  • s3slider (collective.ptg.s3slider)

  • nivo slider (collective.ptg.nivoslider)

  • nivo gallery (collective.ptg.nivogallery)

  • content flow (collective.ptg.contentflow)

  • supersized (collective.ptg.supersized)

Buildout configuration

eggs =

Installing all galleries

If you want to install all available galleries, you could add

eggs =

to buildout’s egg section.

This will also install some galleries that are “under development”.


  • Flickr and Picasa Support!

  • Dexterity “Lead Image behaviour” support

  • Works with ‘Image’, ‘News Item’ and other content types that has a Image Field (provides IImageContent).

  • Also works with redturtle.smartlink and collective.contentleadimage (install )

  • Customize gallery size, transition(limited transitions right now), timed and other settings

  • Can use nested galleries

  • searching and category selection for nested galleries

  • Galleria, Galleriffic, Highslide JS, s3slider, Pikachoose and Fancybox display types

  • display gallery inline

  • Products.Collage integration

  • Compatible with new-style Plone collections

  • Provides base settings configlet

Flickr and Picasa Web Album Support

  • to add support for these type of galleries you must install additional packages

  • install for Flickr support

  • install collective.ptg.picasa for Picasa Web Album Support(tested with 1.3.3 and 2.0.12)

  • on Plone 3.x you must also manually install hashlib for picasa support

  • these can just be added to your buildout or installed with easy_install or you can add the package to your egg section like

Pop-up effect

you could do this:

1) Install
2) Mark the link to the gallery with "prettyPhoto" style (which
   has now been added) from Kupu or TinyMCE

Troubleshooting safe-html

If you have trouble, do this: Go to safe_html in portal_transforms tool Make sure param and object are valid tags (not nasty tag).

After that, you should flush the cache of ZODB by going to 1. Zope root app ZMI 2. Control Panel 3. Database 4. main (or whatever zodb you have) 5. Flush Cache tab 6. Press “Minimize” button

This will remove from ZODB cache all cooked texts. This procedure is mentioned at the top of safe_html in portal_transforms.


From 0.8*

The upgrade to version 0.8* is an important and large update. Basically, it gets rid of the Gallery type, replaces it with the regular Folder type along with a new view applied to the folder, namely the “Gallery View.”

You can only successfully upgrade from the 0.8* series by first upgrading to a 1.x series release and then upgrading to the 2.x series.

From 1.x to 2.x

No longer support Slideshow 2 gallery which has been replaced with galleria.

From * to 3.x

You’ll be required to change your respective collective.js dependencies to collective.ptg dependencies in buildout, re-run buildout.


Since this product depends on, you’ll need to add a few overrides for products versions in your buildout if you aren’t using recent versions of Plone. Good news is that is you’re using any other product that uses, you’ll already be good to go.

Basically, you’ll need to add these to your buildout versions section ONLY IF you’re running a plone < 4.1.

For Plone 4.0:

z3c.form = 2.3.2 = 0.5.0
plone.z3cform = 0.6.0
zope.schema = 3.6.0

and Plone 3.x:

z3c.form = 1.9.0 = 0.4.8
plone.z3cform = 0.5.10
zope.i18n = 3.4.0
zope.testing = 3.4.0
zope.component = 3.4.0
zope.securitypolicy = 3.4.0 = 3.4.3

These versions are not the exact versions plonetruegallery requires, it’s just a known working set. If you already have installed under different versions or wish to upgrade versions, you’re fine doing so.

Then once you run buildout with this configuration, install collective.plonetruegallery via the the add-on product configuration. Also, make sure Plone z3cform support is installed too. If you experience issues where no settings appear in the Gallery Settings tab, reinstall Plone z3cform support.


First uninstall the collective.plonetruegallery product just like you would any other product. Then, go to portal_setup in the zmi and click on the Import tab. Once there, select the collective.plonetruegallery Uninstall Profile profile and run all the steps. Once that is done, you can remove the egg from your buildout.

Fetching of Images Explained

  • When rendering a picasa or flickr gallery, it checks if the images have been fetched within a day. If they have not, then it re-fetches the images for the gallery.

  • You can also force a specific gallery to be re-fetched by appending @@refresh to the gallery url

  • You can manually refresh all galleries on the site by typing in a url like This means you can also setup a cron-like job to refresh all the galleries whenever you want to, just so it isn’t done while a user is trying to render a page.

License Notes

This Plone product is under the GPL license; however, the Highslide JS display type uses the Creative Commons Attribution-NonCommercial 2.5 License and is only for non-commercial use unless you have purchased a commercial license from the Highslide website. collective.ptg.pixelentity gallery (under construction) also requires a license


Coding Contributions

  • Patrick Gerken - huge help with 0.8 release

  • Espen Moe-Nilssen

  • Harald Friessnegger

  • Sylvain Bouchard


  • French - Sylvain Boureliou

  • Norwegian - Espen Moe-Nilssen

  • Brazilian Portuguese - Diego Rubert

  • Finnish - Ilja Everila

  • German - Jens W. Klein, Harald Friessnegger

  • Italian - Mirto Silvio Busico

  • Spanish - Enrique Perez Arnaud

  • Dutch - Rob Gietema, Martijn Schenk, Fred van Dijk



3.4.9 (2020-09-09)

  • Updated Spanish translation. [macagua]

  • Updated the Gettext files. [macagua]

  • Extend the uninstall profile. [thet]

  • Fix CSS resource cooking in Plone >= 5.1 [petschki]

3.4.8 (2017-02-26)

  • Document re-using gallery in page template [khink]

  • mention Plone 5.0 compatibility, tweak README, add screen shots [tkimnguyen]

  • Refactored __getattr__ in settings, for clarity and possibly some speed. [maurits]

  • Respect folder sort order for showing subgalleries on the galleryview just as we do for images in the normal galleryview. Suggallery ordering was semi random until now because no order was passed into the catalog query for subgalleries. [fredvd]

  • Don’t show the message “There are no images in this gallery.” if we enable showing subgalleries and there are actual subgalleries to display. [fredvd]

  • Add option to disable the random lead image from galleries so that always the first image is returned. Also useful with subgalleries. [dveeze, fredvd]

  • Updated Dutch translations. [fredvd]

  • Updated vocabulary so it works with Plone 5

3.4.7 (2016-02-01)

  • Use root navigation path for finding gallery for portlets. That’s fix portlet with [bsuttor]

3.4.6 (2015-11-04)

  • Added dexterity folder to classes implementing IGallery to work with dexterity types and Plone 5. [sandrarum]

  • Updated portuguese pt-br translation. [lccruz]

3.4.5 (2014-11-28)

  • Add destinations to old upgrade-steps to prevent steps all -> all. [pbauer]

3.4.4 (2014-06-05)

  • Exclude our own sizes when building the size vocabulary. [witsch]

3.4.3 (2014-05-12)

  • Remove requirements for which likely broke a lot of buildouts on a minor version bump. [vangheem]

3.4.2 (2014-05-11)

  • fix thumbnails… [vangheem]

3.4.1 (2014-04-30)

  • Remove version fix. [thet]

3.4.0 (2014-02-08)

  • Added behavior [jaroel]

  • Support’ Image [jaroel]

  • Drop support for Plone 3.3 and 4.0. [hvelarde]

  • The Topic type is now deprecated [ale-rt]

3.3.2 (2013-07-05)

  • fix character encoding in portlet image titles (so it works with images on Plone and Flickr) [kysr]

3.3.1 (2013-05-31)

  • give site administrator manage galleries permission [vangheem]

  • fix character encoding in portlet image titles [bouchardsyl]

  • add portlet methods to return all images [bouchardsyl]

3.3.1b1 (2013-05-06)

  • fix getSite [espen]

3.3.1a2 (2013-04-04)

  • provide “download_url” in image data [vangheem]

3.3.0a1 (2013-03-18)

  • provide “original_image_url” image data [vangheem]

  • add ability to provide custom css for gallery to override styles [vangheem]

  • add integration with collective.ptg.galleryimage [vangheem]

  • restore plone 3 compatibility [vangheem]

  • explicitly close the iframe tag in the embedded portlet gallery–fixes some browsers borking on the tag [vangheem]

3.2a (2012-11-07)

  • moved picas and flickr support to their own products [espenmn]

  • added vocabulary for image sizes [espenmn]

3.1 (2012-10-12)

  • be able to show copyright information [eehmke]

3.0 (2012-10-08)

  • make final release

3.0b4 (2012-10-01)

  • fix collage support [vangheem]

3.0b3 (2012-07-24)

  • brown bag previous release [vangheem]

3.0b2 (2012-07-24)

  • get portal root without the getSite hook [vangheem]

  • dexterity compatible changes [vangheem]

3.0b1 (2012-07-04)

  • no longer use collective.js packages since they caused more problems and confusion than anything. All gallery dependencies will now be collective.ptg.* namespaced. [vangheem]

  • move to using collective.ptg.galleria

  • move to using collective.ptg.contactsheet

  • move to using collective.ptg.contentflow

  • move to using collective.ptg.fancybox

  • move to using collective.ptg.galleriffic

  • move to using collective.ptg.highslide

  • move to using collective.ptg.nivogallery

  • move to using collective.ptg.nivoslider

  • move to using collective.ptg.pikachoose

  • move to using collective.ptg.presentation

  • move to using collective.ptg.supersized

  • move to using collective.ptg.thumbnailzoom

2.4b3 (2012-06-25)

  • backward compatible way to use Collection(4.2) [vangheem]

2.4b2 (2012-06-21)

  • Plone 4.1 conditional zcml[Mikko]

2.4b1 (2012-06-19)

  • respect limiting number of items for collections[vangheem]

  • add supersized gallery[espen]

  • Added Basque (eu) translation [erral]

  • Regenerated i18n files [erral]

  • Fixed some i18n issues removing duplicated msgids [erral]

  • added more settings for contactsheet and modified contactsheet to use “speed” setting for how long time the effect takes. Is is now possible to use thumbnail sizes [espen]

  • added more settings for thumbnailzoom [espen]

  • added custom css settings for s3slider [espen]

  • Add ability to have default settings control panel[espen]

  • Add ability to have default settings control panel[espen]

  • fixed Thumbnailzoom, Contactsheet and Presentation to use Batch Size setting.

  • compatible with new-style collections[vangheem]

2.3.1 (2012-05-11)

  • place gallery iframe fixes [espen]

2.3.0b2 (2012-05-11)

  • style fixes [vangheem]

  • portlet fixes [vangheem]

2.3.0b1 (2012-05-09)

  • Added settings for background position for presentation gallery type [espen]

  • move collection text field rendering to below gallery [vangheem]

  • add content flow display type [vangheem]

2.2.0 (2012-05-02)

  • Add presentation display type. [vangheem]

2.1b2 (2012-04-27)

  • be able to position overlay controls of highslide gallery [domruf]

2.1b1 (2012-04-24)

  • add contact sheet and thumbnail zoom gallery [espen]

2.1a2 (2012-02-28)

  • more nivo slider themes [espen]

2.1a1 (2012-02-24)

  • nivo slider and gallery integration [espen]

  • Products.Collage integration(taken from collective.collage.plonetruegallery) [vangheem]

2.0a2 (2012-02-22)

  • allow you to place full gallery in portlet [vangheem]

  • added option for background color for pikachoose [espen]

2.0a1 (2012-02-22)

  • Remove Slideshow 2 display type (depends on mootools and has loads of conflicts) [vangheem]

  • switch to using collective.js.galleriffic [vangheem]

  • switch to using collective.js.highslide [vangheem]

  • switch to using collective.js.fancybox [vangheem]

  • finally remove remains to gallery content type. Can not upgrade directly to this product version now. [vangheem]

  • fix error with unicode-titled images [silviot]

  • added pikachoose support [espen]

  • added s3slider support [espen]

1.3.3 (2011-09-28)

  • fix placegalleryview [vangheem]

  • fix highslide gallery not auto-playing when pagination is enabled. [vangheem]

1.3.2 (2011-09-20)

  • set thumbnail height on galleriffic

1.3.1 (2011-09-20)

  • fix size and scale problems with galleriffic

1.3.0 (2011-09-20)

  • no longer use silly unique zcml to register display types

  • Add Galleriffic slideshow display type

  • Change the way the display types are used so that they can now be customized through portal_view_customizations

1.2.1 (2011-07-06)

  • add translation for pt_BR [rafabazzanella]

1.2.0 (2011-06-30)

1.1.0 ~ (2011-06-22)

  • fixes for Slideshow 2 in IE9 If you’re using custom styles for the Slideshow 2 gallery, please test this upgrade as some styling changes have been made. [vangheem]

1.0.5 ~ (2011-04-17)

1.0.4 ~ (2011-03-14)

1.0.3 ~ (2011-02-20)

1.0.2 ~ (2011-01-12)

  • Enable re-use of view template macro. collective.collage.plonetruegallery uses this. [khink]

1.0.1 ~ 2010-12-31

  • added spanish translation [Enrique Perez Arnaud]

  • use ViewPageTemplateFile since you can get UnicodeDecodeError with non-ascii characters in the title and description. [Enrique Perez Arnaud]


  • fix picasa support on Plone 4




  • use instead of plone_displayviews for menu declaration since it doesn’t work with > 2.0b3 and zope.browsermenu installed. [vangheem]


  • import Batch directly from PloneBatch since with Zope 2.13 Batch is not available at the package level when plonetruegallery is loaded. [vangheem]


  • made the basic gallery not store it’s cached images since it would never be able to really cache them anyways. This fixes the zodb potentially growing forever on sites that use the gallery portlet since it needed to calculate the gallery on every new image request, which would cause a new write to the database. FYI, packing the database brings it back down to it’s normal size. [vangheem]




  • use getAllowedSizes from instead [vangheem]

  • fixed incompatibility with patches it uses–fixes [vangheem]

  • fixed fancy box not showing correctly occasionally [vangheem]

  • restructured display type code to be a little more compatible with templating. It was a little messy the way it was done before so it is now slightly less customizable for the sake of being more compatible and modular. If any gallery types were defined in the old fashion, they may no longer work without slight modification. That is what this is now tagged as a 0.9 release. [vangheem]

  • compatible with now–Chameleon. [vangheem]

  • gallery portlet now forces the height of the image so it doesn’t flicker if for some reason the image hasn’t finished loading yet. fixes [vangheem]

  • added as dependency profile fixes [vangheem]

  • fixed css on gallery portlet to show title properly [vangheem]

0.8.2b4 ~ March 16

  • annoying extra release since the previous one included extra “._” po files… [vangheem]

0.8.2b3 ~ March 10

  • fixed gallery portlet js to work with Plone 4 [vangheem]

  • fixed max-width screwing up slideshow transition with some css [vangheem]

  • gallery is now aware, reflecting sizes specified there. [vangheem]

  • fixed translations not being added correctly [vangheem]

0.8.2b2 ~ February 10, 2010

0.8.2b1 ~ February 4, 2010

  • Make compatible with Plone 4–fixes page template rendering and css issues [vangheem]

0.8.1b2 ~ January 27, 2010

  • Adapting BasicImageInformationRetriever to IObjectManager does not work in Plone4 anymore. Use IBaseFolder instead which is also generic for ATFolder and ATBTreeFolder. [thet]

  • Added Italian translation [Mirto Silvio Busico]

  • Added z3c.autoinclude support–no more zcml entry in buildout on newer versions of plone. [vangheem]

  • Override button apply method instead of __call__ method to set the status for user warning and to set setting changes. This fixes issue with newer version of plone.z3cform not showing updated status message. [vangheem]

  • Added hashlib to list of install requires for picasa since some versions of gdata fail without it. [vangheem]

0.8.1b1 ~ December 17, 2009

  • add german translation [jensens]

  • add extra requires to Now one can set as dependency “collective.plonetruegallery[flickr], collective.plonetruegallery[picasa]” or collective.plonetruegallery[all] – [jensens]

  • removed logging statement in porltet js code [vangheem]

  • fixed bug with upgrading older versions during version check [vangheem]

  • fixed unicode decode error with picasa albums that have none-standard letters in them. [vangheem]

0.8.1a3 ~ December 3, 2009

  • added gallery portlet [vangheem]


  • fixed slideshow gallery css so that the green bar does not get covered up by the gallery when logged in. [vangheem]

  • fixed sub-gallery css issues [vangheem]

  • fixed ordering of images in gallery–now gallery images reorder when they are reordered in the container. [vangheem]

  • links now point to the view view of images if a user is logged in [vangheem]

  • fixed ?start_image parameter to work with batching. [vangheem]

  • highslide and fancybox slideshow will start slideshow automatically only if number of images fits in one batch page [do3cc]

  • highslide image slides now have a title that consists of the image title and link to the image [do3cc]


  • removed Gallery content type

  • allows you to display gallery for Folder, Large Folder, and Collections

  • moved to using

  • remove event subscriptions and do not cook basic galleries

  • removed classic display type–don’t feel like maintaining anymore..

  • added fancybox and highslide display types

  • slideshow 2 now pans without zooming in on image and distorting it

  • added more styling to slideshow 2’s type

  • fixed issue with slideshow 2 gallery type where image would show up a little blurry because of image scaling…

  • updated flickr size settings

  • no longer support private picasa albums(I don’t want to store passwords obviously…)


  • fixed tests

  • added finnish translations[Ilja Everila]

  • added translatable sub-images


  • added “Refresh Gallery” button in case you change a gallery and need to re-cook the gallery images before it automatically does it for you. Especially useful for reordering of images in a basic gallery.

  • added go to image support via url like /url/to/gallery?start_image=theTitle. Not exactly perfect, but should work most of the time. No other way to know what image it is since I don’t keep ids on flickr and picasa galleries. make sure to url encode the title though.


  • because translations had .mo files, it broke some systems–removed.


  • added brazilian translation


  • updated french translation

  • added norwegian translation(Espen Moe-Nilssen)

  • added some message factories to places where it wasn’t used


  • add css class to no images message


  • changed the small picasa gallery size to be 320x320


  • bug fixes

  • gallery type registration changes


  • fixed bug that prevented subgalleries from being displayed [deo]

  • made sure to always display the gallery images even when there are subgalleries in the current gallery [deo]

  • removes dependency on simplejson and elementtree

  • now flickrapi and gdata are optional add-ons

  • added support for slideshow 2 - now gives option of what gallery type to use

  • reorganization of gallery schema(simple)

  • pre-fetches gallery images to speed rendering time(especially for flickr and picasa). Fetching occurs at a timed interval, can be setup to use clock server or can manually be fetched.

  • css fixes

  • better design for sub-galleries


  • fixed dependencies to be more flexible


  • fixed really dumb basic image sizing problem


  • added French translation(thanks to Sylvain Boureliou)


  • removed kss dependency

  • fixed flickr issues with api version–just pinned the version number(should have done from the start)

  • moved all javascript to portal_javascripts

  • fixed safari bug when carousel is hidden

  • packed all javascript

  • even though this is beta, this is a recommended upgrade as there are many improvements and some major fixes

  • implemented new timing mechanism


  • fixed bug with picasa galleries where it was retrieving all the galleries sometimes

  • added better error handling


  • fixed picasa bugs


  • moved all gallery types to adapters.

  • fixed opera support

  • plone 3.0 support fixes


  • fixed opera bug

  • flickr gallery now supports name or id for user an sets


  • minor bug fixes


  • removed dependency of mooTools and smooth gallery

  • dynamically grabs images

  • better controls

  • better cross browser support


  • added basic flickr support


  • refactored code to easily add new gallery types

  • fails gracefully if gdata isn’t installed

  • Now you choose the gallery type

0.3 - Beta

  • added support for picasa web albums

  • fixed a few bugs

.2beta-r67403 - Beta

  • added content type icons

  • cleaned up gallery views

.1 - Initial

  • Initial release

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collective.plonetruegallery-3.4.9.tar.gz (1.3 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page