Plone Add-on Gallery

collective.js.galleria

Introduction

This addon register Galleria JQuery plugin in Plone’s resource registries.

version: 1.6.1

About Galleria

Galleria is a JavaScript image gallery framework built on top of the jQuery library. The aim is to simplify the process of creating professional image galleries for the web and mobile devices.

Requirements

  • Plone 5.2 (tested)

  • Python 3.6+, 2.7 (tested)

How to install

https://secure.travis-ci.org/collective/collective.js.galleria.png

To enable this package in a buildout-based installation:

  1. Edit your buildout.cfg and add collective.js.galleria to the list of eggs to install:

[buildout]
...
eggs =
    collective.js.galleria

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 collective.js.galleria and click the ‘Activate’ button.

Have an idea? Found a bug? Let us know by opening a support ticket.

Notes

Galleria in its way to manage theme parse all link tags to find the css attached to the theme. To make it work in production mode you must add themes javascript and css called by the template.

// Patch for Plone
// Escapes \+\+ from the urls \+\+resource\+\+, \+\+plone\+\+ and \+\+theme\+\+
// to avoid errors in RegExp.
_fix_plone_resource_url = (function(url) {
    return url.replace('\+\+plone\+\+', '\\+\\+plone\\+\\+').replace(
        '\+\+resource\+\+', '\\+\\+resource\\+\\+').replace(
            '\+\+theme\+\+', '\\+\\+theme\\+\\+')
});

...

// look for manually added CSS
$('link').each(function( i, link ) {
    // Patch for Plone
    reg = new RegExp( _fix_plone_resource_url(theme.css) );
    if ( reg.test( link.href ) ) {

        // we found the css
        css = true;

        // the themeload trigger
        _themeLoad( theme );

        return false;
    }
});

As you can see the original code has been patched to support ++resource++, ++plone++ and ++theme++ URLs.

Starting from version 1.6.1 this package is compatible only with Plone 5.2

Uglify Javascript

To uglify Javascript, we can use the following commands:

$ cd src/collective/js/galleria/resources
$ yarn install
$ yarn uglifyjs

This will generate galleria.min.js uglify based on galleria.js.

Credits

Companies

makinacom

Authors

Share and Enjoy

collective.js.galleria would not have been possible without the contribution of the following people:

You can find an updated list of package contributors on GitHub.

Development sponsored by Planet Makina Corpus and JeanMichel FRANCOIS aka toutpt <toutpt@gmail.com> .

Changelog

1.6.3 (2022-05-26)

  • Fix AttributeError when trying to create a Plone Site on an instance that has collective.js.galleria available. [wesleybl]

1.6.2 (2022-05-20)

  • Allows using resources with ++plone++ in CSS definition URL of Galleria theme. [wesleybl]

  • Use uglify-js node package to uglify Javascript. [wesleybl]

  • Use plone resource instead of browser resource. [wesleybl]

1.6.1 (2022-02-07)

  • Add support to Python 3.6, 3.7 and 3.8. [cleberjsantos]

  • Add support to Plone 5.2. [cleberjsantos]

  • Drop support for Plone 4.x [cleberjsantos]

  • Update galleria to 1.6.1 [clebejsantos]

  • Add replacement for //resource// links for manually added css back in the 1.6.1 galleria.js as written in the general notes (Based on changes in 0d2b832) [cleberjsantos, fredvd]

  • Add replacement in galleria.js for avoid error with jQuery load [cleberjsantos]

1.2.5 (2013-01-26)

  • Add plugins as browser resources directory [cleberjsantos]

  • Add travis-ci integration with test + python-validation [cleberjsantos][toutpt]

1.2.4 (2013-01-10)

  • Update galleria to 1.2.9

1.2.3 (2012-08-15)

  • Fix typo in previous release

1.2.2 (2012-08-15)

  • Update galleria to 1.2.8

1.2.1 (2012-07-10)

  • Fix CSS path to images loader and map.

1.2 (2012-04-05)

  • upgrade to galleria 1.2.7

1.1 (2012-02-22)

  • upgrade to galleria 1.2.6

1.0 (2012-01-04)

  • Initial release