Known issues

• ZIP functionality doesn’t seem to support Dexterity based images.

See the complete list of bugs on GitHub.

Installation

To enable this package in a buildout-based installation:

1. Edit your buildout.cfg and add add the following to it:

   [buildout]
   ...
   eggs =
       sc.photogallery

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

Go to the ‘Site Setup’ page in a Plone site and click on the ‘Add-ons’ link.

Check the box next to Photo Gallery and click the ‘Activate’ button.

Usage

Original images in a Photo Gallery can be easily downloaded by enabling the display of an explicit link. To use this feature, go to the Photo Gallery control panel configlet and select ‘Enable download?’.

If ftw.zipexport is installed, you will also be able to download all images on a ZIP file.

Internals

Photo Gallery uses Cycle2 slideshow plugin for jQuery and it can load its resources from the Plone JS registry if they are present there.

If you’re using Photo Gallery with other packages that use Cycle2 also (like collective.nitf or covertile.cycle2), it is highly recommended that you register those resources to load them once and avoid conflicts.

You can use a jsregistry.xml file that includes the following:

<javascript id="++resource++collective.js.cycle2/jquery.cycle2.min.js"
    cacheable="True" compression="none" cookable="True" enabled="True" />
<javascript id="++resource++collective.js.cycle2/jquery.cycle2.carousel.min.js"
    cacheable="True" compression="none" cookable="True" enabled="True" />
<javascript id="++resource++collective.js.cycle2/jquery.cycle2.swipe.min.js"
    cacheable="True" compression="none" cookable="True" enabled="True" />

1.0b3 (2018-01-30)

• Fix brown bag release. [hvelarde]

1.0b2 (2018-01-29)

• Remove indirect dependency on five.grok. [hvelarde]

• Add compatibility with Python 3. [hvelarde]

• Fix human readable file sizes (fixes #23). [hvelarde]

• Process static resources using webpack. [rodfersou]

• Fix registration of Photo Gallery views. [hvelarde]

• Use HTML entities in Unicode Normalization Form C to avoid warnings when validating. [hvelarde]

1.0b1 (2016-03-15)

• Remove hard dependency on plone.app.referenceablebehavior as Archetypes is no longer the default framework in Plone 5. Under Plone < 5.0 you should now explicitly add it to the eggs part of your buildout configuration to avoid issues while upgrading. [hvelarde]

• Avoid photo distorting when landscape format is used. [rodfersou]

• The Photo Gallery content type now includes a new allow_download field to restrict the downloading of images on an item (closes #24). [hvelarde]

• Add Brazilian Portuguese and Spanish translations. [hvelarde]

• Make control panel configlet accesible to Site Administrator role (closes #20). [hvelarde]

• Add download functionality to Photo Gallery; if enabled, users will be able to easily download original images by using an explicit link. If ftw.zipexport is installed, they will be also able to download a ZIP file containing all images (closes #14). [rodfersou, hvelarde]

• Implement lead image to be used in folder and collection views (closes #17). [hvelarde]

• Load Cycle2 resources from the JS registry if available (closes #10). [hvelarde]

• Add Photo Gallery tile for collective.cover. [rodfersou, hvelarde]

• Remove dependency on five.grok (closes #7). [hvelarde]

• Update template with carousel pager and more layout control (closes #4). [rodfersou, agnogueira]

• Drop support for Plone 4.2. [hvelarde]

• A Photo Gallery can now be set as the default page view on a container (closes #1). [hvelarde]

1.0a1 (2014-08-04)

• Initial release.