Skip to main content

A File gallery application for Django

Project description

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.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

porticus-1.0.1.tar.gz (19.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page