Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Simple photo gallery plugin for DjangoCMS

branch: master
README.rst

cmsplugin_gallery

cmsplugin_gallery adds simple gallery plugin to your djangoCMS installation

Features:

  • 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 https://github.com/shagi/cmsplugin_gallery_filer.

Contributions and comments are welcome using Github at: http://github.com/centralniak/cmsplugin_gallery

Please note that cmsplugin_gallery requires:

Follow individual installation instructions before installing cmsplugin_gallery.

Installation

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

Configuration

  1. 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.
  2. Very simple template is included with the project. To make it work 100%, install jQueryTOOLS for overlay support using your favorite method http://flowplayer.org/tools/download/index.html

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: http://github.com/centralniak/cmsplugin_gallery

author: Piotr Kilczuk
date: 2012/08/01
Something went wrong with that request. Please try again.