-
-
-
-
Optional Parameter: separator string. Default: " :: "
-
Creates a path represented by a categories by joining the items with a separator.
-
Each path item will be coerced to unicode, so you can pass a list of category instances, if required.
-
Example using a list of categories:
-
{{ some_list|category_path }}
-
-
-
If some_list is [ <Category: Country>, <Category: Country pop>, <Category: Urban Cowboy>] the result will be:
-
Country :: Country pop :: Urban Cowboy
-
-
Example using a category node and optional separator parameter:
-
{{ some_node.get_ancestors|category_path:" > " }}
-
-
-
If some_node was category “Urban Cowboy”, the result will be:
-
Country > Country pop > Urban Cowboy
-
-
-
-
-
Optional Parameter: "ancestors"
-
Given a list of categories, it iterates over the list, generating a tuple of the current category and a dict containing information about the tree structure around it, with the following keys:
-
-- 'new_level'
-- True if the current item is the start of a new level in the tree, False otherwise.
-- 'closed_levels'
-- A list of levels which end after the current item. This will be an empty list if the next category’s level is the same as or greater than the level of the current item.
-
-
Provide the optional argument, "ancestors", to add a list of unicode representations of the ancestors of the current category, in descending order (root node first, immediate parent last), under the key ‘ancestors’.
-
For example: given the sample tree below, the contents of the list which would be available under the ‘ancestors’ key are given on the right:
-
Country -> []
- Country pop -> [u'Country pop']
- Urban Cowboy -> [u'Country', u'Country pop']
-
-
Using this filter with unpacking in a {% for %} tag, you should have enough information about the tree structure to create a hierarchical representation of the tree.
-
{% for node,structure in objects|tree_info %}
- {% if structure.new_level %}<ul><li>{% else %}</li><li>{% endif %}
- {{ node.name }}
- {% for level in structure.closed_levels %}</li></ul>{% endfor %}
-{% endfor %}
-
-
-
-
-
-
Convert a regular category QuerySet into a new, ordered QuerySet that includes the categories selected and their ancestors.
-
This is especially helpful when you have a subset of categories and want to show the hierarchy for all the items.
-
For example, if we add it to the example for tree_info:
-
{% for node,structure in objects|tree_queryset|tree_info %}
- {% if structure.new_level %}<ul><li>{% else %}</li><li>{% endif %}
- {{ node.name }}
- {% for level in structure.closed_levels %}</li></ul>{% endfor %}
-{% endfor %}
-
-
-
A list of unrelated categories such as [<Category: Urban cowboy>, <Category: Urban comtemporary>], the above template example will output the two categories and their ancestors:
-
<ul><li>
-Country
-<ul><li>
-Country pop
-<ul><li>
-Urban cowboy
-</li></ul></li></ul></li></ul>
-<ul><li>
-Rhythm and blues
-<ul><li>
-Urban contemporary
-</li></ul></li></ul>
-
-
-
-
Note
-
Categories that have similar ancestors are grouped accordingly. There is no duplication of the ancestor tree.
-
-
-