Produces a list of categories defined for the current blog.

Categories in this blog:
<mt:Categories glue=", ">
    <a href="<$mt:CategoryArchiveLink$>"><$mt:CategoryLabel$></a>
</mt:Categories>

This tag produces output for every category with no regard to their hierarchical structure. The results are sorted ascending by category label.

The tags mt:TopLevelCategories and mt:SubCategories may be more useful for complex listings of categories.

Attributes ¶

MultiBlog attributes ¶

• include_blogs
• exclude_blogs
• include_websites
• exclude_websites

glue ¶

A string used to join the output of the separate iterations of MTCategories. This can be as simple as a comma and space (“, ”) to list out category labels or complex HTML markup to be inserted between the markup generated by MTCategories.

lastn ¶

Limits output to the first N categories. N is a positive integer.

show_empty ¶

Setting this optional attribute to true (1) will include categories with no entries assigned. The default is false (0), where only categories with entries assigned.

Examples ¶

List out the categories used on at least one blog entry, separated by commas:

Categories: <mt:Categories glue=", "><$mt:CategoryLabel$></mt:Categories>

List all categories and link to categories if the category has one or more entries:

<mt:Categories show_empty="1">
    <mt:If name="__first__">
<ul>
    </mt:If>
    <mt:If tag="CategoryCount" gte="1">
    <li><a href="<$mt:CategoryArchiveLink$>"><$mt:CategoryLabel$></a></li>
    <mt:Else>
    <li><$mt:CategoryLabel$></li>
    </mt:If>
    <mt:If name="__last__">
</ul>
    </mt:If>
</mt:Categories>

Related ¶

• Template Loop Meta Variables offer conditionals for odd, even, first, last, and counter.
• Folders - same as using <mt:Categories class_type="folder"> attribute