jmbo-generic 0.0.2

Jmbo generic behaviour/templates app.

Jmbo Generic

Jmbo generic behavior/templates app.

Contents

• Jmbo Generic

  • Installation

  • Models

    • generic.models.Link

      • Fields

        • title

        • view_name

        • category

        • url

      • Methods & Properties

        • get_absolute_url(self)

        • is_active(self, request)

    • generic.models.LinkPosition

      • Fields

  • Inclusion Tags

    • {% menu %}

    • {% navbar %}

• Authors

• Changelog

  • 0.0.2 (2011-09-27)

  • 0.0.1 (2011-09-21)

Installation

1. Install or add jmbo-generic to your Python path.

2. Install django-preferences as described here.

3. Add generic to your INSTALLED_APPS setting.

4. Add generic URL include to your project’s urls.py file:

   (r'^', include('generic.urls')),

5. jmbo-generic includes a number of template sets allowing you to deliver lightweight(zero), mobile(basic) or desktop/touch(full) specific output. Specifying which template set to use is simply a matter of specifying a TEMPLATE_TYPE setting, and adding generic.loaders.TypeLoader to the TEMPLATE_LOADERS setting. For example to use the basic template set update your settings as follows:

   TEMPLATE_TYPE = "basic"
   
   TEMPLATE_LOADERS = (
       'generic.loaders.TypeLoader',
       ...other template loader classes...
   )

   This causes templates to be loaded from a path prefixed with whatever value was specified as the TEMPLATE_TYPE setting. For example in this case a template specified as generic/home.html would actually be loaded from basic/generic/home.html.

   Note

   You have to add TypeLoader as the first loader for it to resolve templates correctly.

6. jmbo-generic includes static media resources which you need to configure as described in Django`s managing static files documentation.

Models

generic.models.Link

Used in conjunction with {% menu %} and {% navbar %} to provide an admin configurable navbar and menu.

Fields

title

A short descriptive title for link.

view_name

View name to which this link will redirect. This takes precedence over category and url fields.

category

Category to which this link will redirect. This takes precedence over url field.

url

URL to which this menu link will redirect. Only used if view_name is not specified.

Methods & Properties

get_absolute_url(self)

Returns URL to which link should redirect based on a reversed view name as specified in view_name field or category view for category specified in category field or otherwise an explicitly provided URL as specified in url field.

is_active(self, request)

Determines whether or not the link can be consider active based on the request path. True if the request path can be resolved to the same view name as is contained in view_name field. Otherwise True if request path starts with URL as resolved for category contained in category field. Otherwise True if request path starts with URL as contained in url field.

generic.models.LinkPosition

Used to determine position/order of elements in {% menu %} and {% navbar %} inclusion tags.

Fields

position

Specifies position/order of link in {% menu %} and {% navbar %} inclusion tags.

Inclusion Tags

generic.templatetags.generic_inclusion_tags

Provides generic inclusion tags like {% menu %} and {% navbar %}. Load these tags by including {% load generic_inclusion_tags %} in your templates.

{% menu %}

Renders a navigation menu normally used as part of footer navigation element. Utilizes generic.models.Link objects configurable via Menu Preferences in admin to provide a flexible menu navigation system. Elements are ordered using position values as specified on generic.models.LinkPosition objects via admin. You can customize the resulting HTML by overriding the generic/inclusion_tags/menu.html template file. The template receives an object_list context variable, which is a collection of ordered generic.models.Link elements to display.

{% navbar %}

Renders a navigation bar normally used as part of main navigation element positioned at top of pages. Utilizes generic.models.Link objects configurable via Navbar Preferences in admin to provide a flexible navbar system. Elements are ordered using position values as specified on generic.models.LinkPosition objects via admin. You can customize the resulting HTML by overriding the generic/inclusion_tags/navbar.html template file. The template receives object_list and active_link context variables. object_list is a collection of ordered generic.models.Link elements to display and active_link is an generic.models.Link object determined to be active for the requested path.

Authors

Praekelt Foundation

• Shaun Sephton

• Hedley Roos

Changelog

0.0.2 (2011-09-27)

1. Detail view.

2. Element preferences.

0.0.1 (2011-09-21)

1. Initial release.