category

This model can retrieve information about the resource category hierarchy in different ways.

Categories are the principal categorization (typing) system of resources. Every page is assigned to exactly one category. Categories themselves are organized in a tree-like hierarchy.

A category is a resource with a special category record attached to it to store metadata related to the category hierarchy. The m_category model provides accessors to this category tree and individual category information.

An example of a category tree, as returned by {% print m.category.tree %}:

[[{id,101},
  {parent_id,undefined},
  {level,1},
  {children,[]},
  {path,"e"},
  {left,1000000},
  {right,1000000}],
 [{id,104},
  {parent_id,undefined},
  {level,1},
  {children,[[{id,106},
              {parent_id,104},
              {level,2},
              {children,[[{id,109},
                          {parent_id,106},
                          {level,3},
                          {children,[]},
                          {path,"hjm"},
                          {left,4000000},
                          {right,4000000}]]},
              {path,"hj"},
              {left,3000000},
              {right,4000000}]]},
  {path,"h"},
  {left,2000000},
  {right,4000000}],
  ...]

About the complete category tree

The following m_category model properties are available in templates:

Property	Description	Example value
tree	Return the complete forest of category trees as nested property lists.	See above.
tree2	Return the forest of category trees as nested property lists. Up to the children of the children.	See above.
tree_flat	Return a list of tuples for the category tree. This list is intended for select lists. There is a special field for the indentation. The returned list consists of proplists. The list does not contain the “meta” category, which contains the categories “predicate”, “category” etc.	See above entries.
tree_flat_meta	Same as tree_flat but with the categories in the meta category.	See above entries.

About a single category

The m_category has some special properties defined when fetching a category, they are accessed by id or category name. For example:

{{ m.category[104].tree }}
{{ m.category.text.tree }}

Property	Description	Example value
tree	The category tree below and including the indexing category.	See above.
tree1	The list of direct children below the indexing category.	See above.
tree2	The category tree below and including the indexing category, up to the children of the children.	See above.
tree_flat	The category tree below and including the indexing category, up to the children of the children. As a flattened list.	See above.
path	List of parent category ids from the root till the category, excluding the indexing category.	[ 104, 106 \]
is_a	List of the parent category names form the root till the category, including the current category.	[ text, article, news \]
image	A random depiction for this category. The returned image filename comes from one of the pages within this category.	<<”2009/10/20/flat-world-proof.jpg”>>
parent_id	The page id of the parent category. Returns an integer or, for a root category, undefined.	104
nr	The category nr. Used for building the tree, will change when categories are added or removed. An integer.	2
level	The depth of the category. Level 1 is the root, 2 and more are below the root.	1
left	The lowest value of the nr range of this category, including its sub categories.	2
right	The highest value of the nr range of this category, including its sub categories.	8
name	The unique page name of this category. A binary.	<<”text”>>
path	The path through the hierarchy of categories to this category.	[104, 106\]

Edit on GitHub