porticus 0.7.5

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',

Also you can find some Sitemap classes in ``sitemaps.py`` that you can mount in your project sitemap like so : ::

from django.conf.urls import patterns
from porticus.sitemaps import PorticusGallerySitemap, PorticusAlbumSitemap, PorticusRessourceSitemap

sitemaps = {
'galleries': PorticusGallerySitemap,
'albums': PorticusAlbumSitemap,
'photos': PorticusRessourceSitemap,
}

urlpatterns = patterns('',
# the sitemap
(r'^sitemap\.xml$', 'django.contrib.sitemaps.views.sitemap', {'sitemaps': sitemaps})
)

See the Django documentation about Sitemaps for more details.