Skip to main content

A reusable Django app adding filer-based galleries to Django-CMS.

Project description

CMSplugin Image Gallery
====================

A Django application adding filer-based galleries to Django-CMS.


Installation
------------

You need to install the following prerequisites in order to use this app::

pip install Django
pip install django-cms
pip install django-filer
pip install Pillow

If you want to install the latest stable release from PyPi::

$ pip install cmsplugin-image-gallery

If you feel adventurous and want to install the latest commit from GitHub::

$ pip install -e git://github.com/bitmazk/cmsplugin-image-gallery.git#egg=image_gallery

Add ``image_gallery`` to your ``INSTALLED_APPS``::

INSTALLED_APPS = (
...,
'image_gallery',
)


Usage
-----

First create a gallery object with a filer folder.

Using the apphook
+++++++++++++++++

Simply create a django-cms page and select it in the ``Application`` field of
the ``Advanced Settings``.

Using the cmsplugin
+++++++++++++++++++

Create a CMS page with a placeholder and simply insert the plugin
``Filer Gallery``.

Using the template tags
+++++++++++++++++++++++

You can also use our template tag to display a list of pictures::

{% render_pictures %}

...for the last 3 uploaded pictures. You can use the selection parameters
``recent`` (default) and ``random`` and set an amount of pictures to display::

{% render_pictures 'random' 10 %}


Settings
--------

GALLERY_PAGINATION_AMOUNT
+++++++++++++++++++++++++

Default: 10

Amount of galleries to display in the list view.


Contribute
----------

If you want to contribute to this project, please perform the following steps::

# Fork this repository
# Clone your fork
$ mkvirtualenv -p python2.7 cmsplugin-image-gallery
$ pip install -r requirements.txt
$ ./logger/tests/runtests.sh
# You should get no failing tests

$ git co -b feature_branch master
# Implement your feature and tests
# Describe your change in the CHANGELOG.txt
$ git add . && git commit
$ git push origin feature_branch
# Send us a pull request for your feature branch

Whenever you run the tests a coverage output will be generated in
``tests/coverage/index.html``. When adding new features, please make sure that
you keep the coverage at 100%.


Roadmap
-------

Check the issue tracker on github for milestones and features to come.

Project details


Release history Release notifications

History Node

0.7.2

History Node

0.7.1

History Node

0.7.0

History Node

0.6.3

History Node

0.6.2

History Node

0.6.1

History Node

0.6

History Node

0.5

History Node

0.4

History Node

0.3.2

This version
History Node

0.3.1

History Node

0.3

History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
cmsplugin-image-gallery-0.3.1.tar.gz (16.6 kB) Copy SHA256 hash SHA256 Source None Jun 16, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page