cmsplugin-gallery / docs / quickstart.rst

Full commit

Quick start guide

Basic configuration

For a more detailed guide on how to configure cmsplugin-gallery, please consult :ref:`the configuration section <configuration>`.


In order to use cmsplugin-gallery you obviously need to have setup and configured django and django-cms. If you didn't yet, please refer to the Django documentation and the Django-cms documentation.

Required settings

The only required operation in your settings file is to add easy_thumbnails and cmsplugin_gallery to INSTALLED_APPS like this:

    # you installed applications here
    # ...


Setting up the database

To set up the tables that cmsplugin-gallery uses you'll need to type:

python syncdb

Setting up your templates

It is recommended that you add two template blocks in your base template:
  • cmsplugin_gallery_css
  • cmsplugin_gallery_js

For example, your base template could look like this:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<html xmlns="" xml:lang="en" lang="fr">
    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
    {% block cmsplugin_gallery_css %}{% endblock %}
    {% block cmsplugin_gallery_js %}{% endblock %}
    {% block content %}{% endblock %}

You're done !

Congrats! At this point you should have a working installation of cmsplugin-gallery. Now you can just login to your admin site and add a gallery to one of your CMS pages.

cmsplugin-gallery is fully customizable, but this is out of the scope of this quickstart. To learn how to customize cmsplugin-gallery please read :ref:`the customization section<customization>`.