porticus 0.7.4

A File gallery application for Django

.. _South: http://south.readthedocs.org/en/latest/
.. _mptt: https://github.com/django-mptt/django-mptt/
.. _sorl.thumbnail: https://github.com/sorl/sorl-thumbnail

porticus
========

Yet another File gallery for Django.

**Galleries** contains **Albums** that contains **Ressources** and ressources are your files items. Usually used like an image gallery, you should also use it like a download center for many file types.

Galleries and Albums has thumbnails, Ressources has thumbnail and a file but the file can be a real uploaded file on your server or jsut an url to link to.

Note that Albums make usage of `mptt`_, so Albums can have album children. Shipped templates are basics.

Requires
********

* Django >= 1.5;
* `mptt`_;
* `sorl.thumbnail`_;

Optionnal
---------

* `django-cms`_ to use Porticus with the cms plugin;
* `South`_ migration is supported. This is not required, but strongly recommended for future updates;

Install
*******

In your urls.py : ::

url(r'^porticus/', include('porticus.urls')),

Or to point out a specific gallery : ::

url(r'^$', 'porticus.views.view_gallery_detail', {'slug':'home-intro'}, name='homepage_gallery_detail'),

Then add the content of ``porticus.settings`` in your settings file.

In your settings.INSTALLED_APPS : ::

'mptt',
'sorl.thumbnail',
'porticus',

And if you want also to use its plugin within `django-cms`_ : ::

'porticus.cmsplugin_porticus',