This is an extension to the Kotti CMS that allows you to add galleries with images to your Kotti site.
It uses Bootstrap Carousel for the gallery view.
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.
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.
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:
<image_scale> can be:
- a predefined image scale (see below)
- a string of the form
- a URL path segment of the form
If the last URL path segment is
download, the image will be served with
Content-disposition: attachment otherwise it will be served with
Predefined image scale sizes
You may define image scale sizes in your
.ini file by setting values for
kotti_image_gallery.scale_<scale_name> to values of the form
kotti_image_gallery.scale_thumb = 160x120 with the resulting scale name
thumb (160x120) and
carousel (560x420) are always defined (because they are used in the default templates), but their values can be overwritten by setting
kotti_image_gallery.scale_carousel to different values in your .ini file.
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.
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
kotti_image_gallery has 100% test coverage.
Please make sure that you add tests for new features and that all tests pass before submitting pull requests.
Running the test suite is as easy as running
py.test from the source directory.