Simple photo gallery plugin for DjangoCMS
Clone or download
Latest commit e657a70 May 24, 2018

README.md

Cmsplugin Gallery

Build Status

cmsplugin_gallery is the most versatile gallery plugin for djangoCMS. It has support for both Python2 and Python3.

Features:

  • Latest version of the plugin supports filer.
  • 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.

Requirements

Supports Django version 1.8+ and latest Django CMS version. Follow individual installation instructions before installing cmsplugin_gallery. Please note that cmsplugin_gallery requires:

IMPORTANT

If you are using version later than 1.1.4, Please update all your templates to use image_src instead of src. image_src is the new FilerImageField instead of the old src which was the ImageField. Check this diff for the change in sample template.

Installation

  • pip install cmsplugin_gallery
  • Add 'cmsplugin_gallery' to INSTALLED_APPS (if necessary)
  • Run Migrations

Usage

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 settings.py using following setting:

CMSPLUGIN_GALLERY_TEMPLATES = (
    ('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.

Report New Issue

Contributors

Contributors