django-gizmo 0.0.4

安装

1. 将gizmo添加到您的INSTALLED APPS设置中。

2. 将ROOT_GIZMOCONF值添加到您的项目设置文件中。这指定了配置gizmo的模块，例如。

   ROOT_GIZMOCONF = 'project.gizmos'

   在这种情况下，我们有一个名为project的模块，其中包含一个gizmos.py文件。

3. 创建您的gizmo配置（在这种情况下命名为gizmos.py）文件，形式为

   gizmos = (
       ('<loader name>', '<tag name>', '<slot name>', [['<url_name'>, ]]),
   )

其中

• <loader name>是您通常传递给Django的load标签的名称，例如，对于{% load myapp_inclusion_tags %}，为myapp_inclusion_tags。

• <tag name>是要包含的标签的名称，例如，对于{% advert %}，为advert。

• <slot name>是要显示标签的插槽的名称，例如，为home。

• <url_name> 可选 是要显示标签的url的名称，例如，为home。

用法

Gizmo是标准的Django包含标签。唯一的不同之处在于，您不是在模板中指定标签，而是通过使用gizmo配置文件和gizmos标签从远处指定标签。

例如，假设我们在myapp的包含标签中指定了一个广告标签，我们只想在名为advert的gizmo槽中调用它，用于名为home的url。

1. 正常创建您的标签。

2. 以以下形式创建您的gizmos配置文件：

   gizmos = (
       ('myapp_inclusion_tag', 'advert', 'advert', ['home', ]),
   )

3. 在home视图的模板中加载gizmo包含标签，并包含一个具有广告槽名称的gizmos标签。

   {% load gizmo_inclusion_tags %}
   
   ...some html...
   
   {% gizmos 'home_advert' %}
   
   ...some more html...