SiteTree template tags¶
To use template tags available in SiteTree you should add {% load sitetree %} tag to the top of chosen template.
Tree tag argument (part in double quotes, following ‘from’ word) of SiteTree tags should contain the tree alias.
Hints:
Tree tag argument could be a template variable (do not use quotes for those).
Optional template argument could be supplied to all SitetTree tags except sitetree_page_title to render using different templates. It should contain path to template file.
Examples:
{% sitetree_menu from "mytree" include "trunk,topmenu" template "mytrees/mymenu.html" %} {% sitetree_breadcrumbs from "mytree" template "mytrees/mybreadcrumbs.html" %}
sitetree_breadcrumbs¶
This tag renders breadcrumbs path (from tree root to current page) based on sitetree.
Usage example:
{% sitetree_breadcrumbs from "mytree" %}
This command renders breadcrumbs from tree named ‘mytree’.
sitetree_tree¶
This tag renders entire site tree.
Usage example:
{% sitetree_tree from "mytree" %}
This command renders sitetree from tree named ‘mytree’.
sitetree_page_title¶
This tag renders current page title resolved against definite sitetree. Title is taken from a sitetree item title resolved as current for the current page.
Usage example:
{% sitetree_page_title from "mytree" %}
This command renders current page title from tree named ‘mytree’.
sitetree_page_description¶
This tag renders current page description resolved against definite sitetree. Description is taken from a sitetree item description resolved as current for the current page.
That can be useful for meta description for an HTML page.
Usage example:
{% sitetree_page_description from "mytree" %}
This command renders current page description from tree named ‘mytree’.
sitetree_page_hint¶
This tag is similar to sitetree_page_description, but it uses data from tree item hint field instead of a description fields.
Usage example:
{% sitetree_page_hint from "mytree" %}
SITETREE_RAISE_ITEMS_ERRORS_ON_DEBUG¶
DEFAULT: True
There are some rare occasions when you want to turn off errors that are thrown by sitetree even during debug.
Setting SITETREE_RAISE_ITEMS_ERRORS_ON_DEBUG = False will turn them off.