Links

• Download his PyPi package;
• Clone it on his Github repository;

Requires

• Django >= 1.8;
  • Last release for Django<1.6 and DjangoCMS 2.4 is available on repository branch djangocms_2;
  • Last release for Django<1.7 and DjangoCMS 3.0 is available on repository branch djangocms_1-6;
• mptt;
• django-tagging;
• django-filebrowser-no-grappelli >= 3.5.6;

Warning: Since 1.0.0, database migration has been switched to Django 1.7 migrations system and South support has been dropped. The South migration files are still there but moved to south_migrations, resulting in you need south==1.x to use them. This is only needed if you need to migrate project datas to the last Porticus version, you don’t have to care about this if you just start a new project.

Install

Install package from PyPi:

pip install porticus

In your urls.py :

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

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 and the apps in your INSTALLED_APPS setting :

INSTALLED_APPS = (
    ...
    'mptt',
    'tagging',
    'filebrowser',
    'porticus',
    ...
)

Then add its settings :

from porticus.settings import *

See the app settings.py file to see what setting you can override.

Then some django-filebrowser-no-grappelli basic settings (see its documentation for more details) :

FILEBROWSER_VERSIONS_BASEDIR = '_uploads_versions'

FILEBROWSER_MAX_UPLOAD_SIZE = 10*1024*1024 # 10 Mb

FILEBROWSER_NORMALIZE_FILENAME = True

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.