kotti_image_gallery 0.3.2

Compatibility

As of Kotti 0.7 the image type from kotti_image_gallery has been moved to the Kotti core. Please use the kotti_gallery package, which supersedes this package with Kotti versions >= 0.7.

Setup

To activate the kotti_image_gallery add-on in your Kotti site, you need to add an entry to the kotti.configurators setting in your Paste Deploy config. If you don’t have a kotti.configurators option, add one. The line in your [app:main] section could then look like this:

kotti.configurators = kotti_image_gallery.kotti_configure

With this, you’ll be able to add gallery and image items in your site.

Image URLs

kotti_image_gallery provides on-the-fly image scaling by utilizing plone.scale (thanks to Tom Lazar for the hint).

Images (including arbitrary scales) can be referenced by this URL schema: /path/to/image_content_object/image[[/<image_scale>]/download] where <image_scale> can be:

• a predefined image scale (see below)

• a string of the form <max_width>x<max_height> or

• a URL path segment of the form <max_width>/<max_height>

If the last URL path segment is download, the image will be served with Content-disposition: attachment otherwise it will be served with Content-disposition: inline.

Work in progress

kotti_image_gallery is considered alpha software, not suitable for use in production environments. The current state of the project is in no way feature complete nor API stable. If you really want to use it in your project(s), make sure to pin the exact version in your requirements. Not doing so will likely break your project when future releases become available.

Development

Contributions to kotti_image_gallery are highly welcome. Just clone its Github repository and submit your contributions as pull requests.

Note that all development is done on the develop branch and master is reserved for “production-ready state”. Therefore make sure to always base your work on the current state of the develop branch.

This follows the highly recommended A successful Git branching model pattern, which is implemented by the excellent gitflow git extension.

TODO

• cleanup HTML/CSS

• add support for remote galleries (e.g. flickr photosets)

• add tests

CHANGES