Django app allowing for configurable targetting of template inclusion tags.
Project 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...
============
**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...
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
django-gizmo-0.0.1.tar.gz
(5.6 kB
view hashes)
Built Distribution
django_gizmo-0.0.1-py2.6.egg
(12.2 kB
view hashes)