Metadata-Version: 1.0
Name: django-gizmo
Version: 0.0.1
Summary: Django app allowing for configurable targetting of template inclusion tags.
Home-page: http://github.com/praekelt/panya-gallery
Author: Praekelt Foundation
Author-email: dev@praekelt.com
License: BSD
Description: Django Gizmo
        ============
        **Django app allowing for configurable targetting of template inclusion tags.**
        
        Installation
        ------------
        
        #. Add **gizmo** to your **INSTALLED APPS** setting.
        
        #. Add ROOT_GIZMOCONF value to your projects settings file::
            
            ROOT_GIZMOCONF = 'project.gizmos'
        
        #. Create your gizmos config file in the form::
        
            gizmos = (
                ('<loader name>', '<tag name>', '<slot name>', [['<url_name'>, ]]),
            )
        
        With:
        
        * <loader name> being the name you would normally pass to Django's load tag, i.e. **myapp_inclusion_tags** for **{% load myapp_icnlusion_tags %}**.
        * <tag name> being the name of the tag you want to include, i.e. **advert** for **{% advert %}**
        * <slot name> being the name of the slot you want the tag to show up in, i.e. **home**.
        * <url_name> *optional* being the names of the urls you want the tag to show up in, i.e. **home**.
        
        Usage
        -----
        
        Gizmos are stock standard Django inclusion tags. The only diffirence is that instead of specifying tags within a template you specify tags from a distance by using a gizmo conf file in conjunction with the gizmos tag.
        
        For example, lets say we have an **advert** tag specified in **myapp**'s inclusion tags which we only want to call  in gizmo slots named **advert** for the url named **home**:
        
        #. Create your tags as normal.
        
        #. Create your gizmos config file in the form::
            gizmos = (
                ('myapp_inclusion_tag', 'advert', 'advert', ['home', ]),
            )
        
        #. In your template for the home view load the gizmo inclusion tags and include a gizmos tag with a slot name of advert::
        
            {% load gizmo_inclusion_tags %}
        
            ...some html...
        
            {% gizmos 'home_advert' %}
        
            ...some more html...
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
