Metadata-Version: 1.1
Name: porticus
Version: 0.8.0
Summary: 
A File gallery application for Django

Home-page: http://pypi.python.org/pypi/porticus
Author: David Thenon
Author-email: dthenon@emencia.com
License: MIT
Description: .. _DjangoCMS: https://www.django-cms.org
        .. _South: http://south.readthedocs.org/en/latest/
        .. _mptt: https://github.com/django-mptt/django-mptt/
        .. _sorl.thumbnail: https://github.com/sorl/sorl-thumbnail
        .. _django-tagging: https://github.com/brosner/django-tagging
        
        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 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.
        
        Requires
        ********
        
        * Django >= 1.5;
        * `mptt`_;
        * `sorl.thumbnail`_;
        * `django-tagging`_;
        
        Optional
        ---------
        
        * `DjangoCMS`_ 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 ``INSTALLED_APPS`` setting : ::
            
            INSTALLED_APPS = (
                ...
                'mptt',
                'sorl.thumbnail',
                'porticus',
                'tagging',
                ...
            )
        
        Also if you want to use its plugin within `DjangoCMS`_ add this to ``INSTALLED_APPS`` setting : ::
        
            '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 <https://docs.djangoproject.com/en/1.7/ref/contrib/sitemaps/>`_ for more details.
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
