Simple photo gallery plugin for DjangoCMS
Python HTML Shell
Latest commit c2932a2 Aug 23, 2016 @vinitkumar vinitkumar committed on GitHub Merge pull request #24 from centralniak/feature/update-readme
Update maintainer details



cmsplugin_gallery adds simple gallery plugin to your djangoCMS installation


  • Drag&Drop reordering of photos in the plugin admin
  • Unlimited, auto-discovered custom templates - you can change template of given gallery at anytime, use javascript galleries etc.

There is also a django-filer enabled version of this plugin maintained by Ales Zabala Alava under

Contributions and comments are welcome using Github at:

Please note that cmsplugin_gallery requires:

Follow individual installation instructions before installing cmsplugin_gallery.


  1. pip install cmsplugin_gallery
  2. Add 'cmsplugin_gallery' to INSTALLED_APPS (if necessary)
  3. Run syncdb or migrate cmsplugin_gallery if using South


  1. Supports Django version 1.8+ and latest Django CMS version.
  2. Create directory for storing media files - files will be uploaded to MEDIA_ROOT + 'cmsplugin_gallery/images'. Make sure it is writable especially when running in embedded mode on production server.
  3. Very simple template is included with the project. To make it work 100%, install jQueryTOOLS for overlay support using your favorite method


The easiest approach is to use a nice feature of cmsplugin_gallery - the template autodiscovery. In order to take advantage of it, add your custom templates in the cmsplugin_gallery subdirectory of any of template dirs scanned by Django.

If you don't want to use the autodiscovery, you can hardcode available templates in using following setting:

    ('app/template.html', 'Template #1', ),
    ('app/other_template.html', 'Template #2', ),

Embed as a typical plugin.

Bugs & Contribution

Please use Github to report bugs, feature requests and submit your code:

author:Piotr Kilczuk

Current Maintainer:

maintainer:Vinit Kumar