porticus 1.0.1

A File gallery application for Django

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 have thumbnails, Ressources have a thumbnail and a file but the file can be a real uploaded file on your server or just an url to link to. Also Ressources have optional tags.

Note that Albums make usage of mptt, so Albums can have album children.

Shipped templates are basics, you probably will have to override them to suit your needs.

A DjangoCMS plugin is available on cmsplugin_porticus.

Links

• Download his PyPi package;

• Clone it on his Github repository;

Requires

• Django >= 1.7;

  • 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.