A container tags used for listing all previously assigned entry tags for the blog in context.

Attributes:

• glue

  A text string that is used to join each of the items together. For example

      <mt:Tags glue=", "><$mt:TagName$></mt:Tags>

  would print out each tag name separated by a comma and a space.

• type

  The kind of object for which to show tags. By default the entry tags are shown.

• sort_by

  The tag object column on which to order the tags. Common values are name and rank. By default tags are sorted by name.

• sort_order

  The direction in which to sort tags by the sort_by field. Possible values are ascend and descend. By default, tags are shown in ascending order when sorted by name and descending order when sorted by other columns.

• limit

  A number of tags to show. If given, only the first tags as ordered by sort_by and sort_order are shown.

• top

  A number of tags to show. If given, only the given number of tags with the most uses are shown. For example:

      <mt:Tags top="20">
          <$mt:TagName$>
      </mt:Tags>

  is equivalent to

      <mt:Tags limit="20" sort_by="rank">
          <$mt:TagName$>
      </mt:Tags>

  Note that even when top is used, the tags are shown in the order specified with sort_by and sort_order.

The following code is functional on any template. It prints a simple list of tags for a blog, each linked to a tag search.

    <ul>
        <mt:Tags>
        <li>
            <a href="<$mt:TagSearchLink$>"><$mt:TagName$></a>
        </li>
        </mt:Tags>
    </ul>

Using tags like TagRank and TagCount and proper page styling, you can make this simple code into a powerful looking and useful "tag cloud".

    <ul>
        <mt:Tags top="20">
        <li class="rank-<$mt:TagRank max="10"$> widget-list-item">
            <a href="<$mt:TagSearchLink$>"><$mt:TagName$></a>
        </li>
        </mt:Tags>
    </ul>