category
Attributes:
- name="category name" • Display specific category. Default is unset (use current category).
- type="category type" • Available values: article, image, link, file. Default is article.
- title="boolean" • Whether to display category's title. Available values: 1 (yes) or 0 (no, display name). Default is 0 (no, display name).
- link="boolean" • Whether to display as link. Available values: 1 (yes) or 0 (no). Default is 0 (no).
- url="boolean" • Whether to display the url as text, link attribute overrides this setting. Available values: 1 (yes) or 0 (no). Default is 0 (no).
- section="section name" • Restricts category search to named section. Default is current section (for backwards compatibility).
- this_section="boolean" • Only link to articles from the current section. section attribute overrides this setting. Available values: 1 (yes) or 0 (no). Default is 0 (no).
- class="class name" • (X)HTML class attribute, applied to wraptag. Default is unset.
- wraptag="tag" • (X)HTML tag (without brackets) to wrap around output. Default is unset.
Behaviors:
The category tag can be used as either a single or containing tag. It will display information for the category defined by the name attribute, or the one currently being viewed. When used as a containing tag, it will turn the contents into a link to the category.
Attribute priorities:
- If used as a container tag, contained text is linked according to context and current settings, "link" and "url" attributes are disregarded..
- If used as a single tag with "link" set to 1 , the "url" attribute is disregarded.
- If used as a single tag with "url" set to 1 and "link" not set, the current url is returned as text.
- All other attributes are unaffected by this hierarchy.