Knowledge Base / Appnel Solutions 

Tags.App 2 Template Tags Reference

Tags

• MTEntryIfTagged

  A conditional tag that displays its contents if the entry in context has tags. This is an MT core tag that Tags.App overloads to provide its own eqivalent functionality.

• MTIfTagDelimiter
• MTTagCount

  Outputs the number of entries with the tag in context.

• MTTagEntropy

  Returns an integer representing a rating based on last use of the specified tag. The rating is relative to the number of steps. The closer the entropy is to the total number of steps the fresher the tag's usage.

• MTTagGradient [low=#000000 high=#000000]

  Outputs a hexadecimal color string based on the entropy of the tag in context. The color is a shade between the low and high colors. The default value of the low and high attributes are CCCCCC (light grey) and 000000 (black) respectively.

  SETTINGS

• MTTagID

  Returns the normalized form of the tag in context.

• MTTagLastUsed [format=]

  Outputs a timestamp to when the tag in context was last used. This tag can be formatted using the standard MT date specifiers.

• MTTagLink [scope=]

  Outputs a URL to the tags script for listing entries with the tag in context. c is an optional argument that defines what the link will be generated for. A value of system will generate the link for a system search. Likewise a value of blog will generate the link for a search of the weblog in context. The default is blog.

• MTTagName [normalized=]

  Return the tag name. If used in an entry context the tag will be displayed as it was input. In other contexts were the tag is part of a summarized list the normalized form is always displayed. The normalized form of a tag can be forced in an entry context by using the normalized argument with a true value such as 1 or using MTTagID.

• MTTagRank

  This tag is an alias to MTTagVolume. This is a MT core tag that Tags.App overloads.

• MTTags [steps= days= top= latest= scope=]

  A container tag that lists all of the tags for the weblog in context. This tag supports the following optional arguments.

  CONTEXT

  • steps

    The number of levels to use when calculating cloud attributes such as volume and entropy. The higher the steps the greater the detail of the tag cloud. The default is 32.

    SETTINGS

  • days

    Only list tags with at least one entry in the past N days.

  • top

    Only list the top N tags based on count. Cannot be used with latest.

  • latest

    Only list the last N tags based on their latest use. Cannot be used with top.

  • scope
• MTTagSearchLink [scope=]

  This tag is an alias to MTTagLink. This is a MT core tag that Tags.App overloads.

• MTTagSize [min_size=]

  Outputs an integer representing the point size of a font. min_size specifies the lowest point size that can be returned. The default is 8.

• MTTagsScript

  Outputs an absolute URL to the tag search script according to the Tag Alias settings.

  EXPAND

• MTTagVolume

  Returns an integer representing a rating based on the relative count of the specified tag amongst other tags and the number of steps.

Search Tags

• MTIfTagIntersection

  A conditional tag that displays its contents of two or more tags are being searched.

• MTIfSearchHasRelatedTags

  A conditional tag that displays its contents if there are related tags to the search being performed.

• MTIfSearchBlogContext

  A conditional tag that displays its contents if a weblog is in context. This tag is useful for creating one template that can be reused for weblog and system tag search.

• MTIfSearchResults

  A conditional tag that displays its contents if any search results were returned.

• MTRelatedTags [steps= days= top= latest=]

  A container tag that lists any tags that are related to the current search. This tag mayu only be used in the context of a tag search. Other then the scope of the tags considered, its function is identical to the MTBlogTags container.

• MTSearchResults

  A container tag for all the search results and navigation.

• MTSearchResultCount

  Inserts the total number of results returned from the search.

• MTSearchString [decode_url=0|1]

  Inserts the search string used to fetch the results.

• MTSearchHeader

  A container tag that renders its contents before the search results.

• MTSearchFooter

  A container tag that renders its contents after the search results.

• MTNoSearch

  A container tag the renders its contents if the tempalte was loaded without a search being performed.

• MTNoSearchResults

  A container tag that renders its contents if no results were returned from the search.

• MTSearchNavigation

  Container tag that holds all of the following navigational tags.

• MTSearchPreviousLink

  Generates a URL to the previous page of results.

• MTSearchNextLink

  Generates a URL to the next page of results.

• MTSearchFirstLink

  Generates a URL to the first page of results.

• MTSearchLastLink

  Generates a URL to the last page of results.

• MTSearchAllLink

  Generates a URL to display all results in one page.

• MTSearchPreviousNotFirst

  A conditional tag that only renders its contents if the previous page is not the first page of results.

• MTSearchNextNotLast

  A conditional tag that only renders its contents if the next page is not the last page of results.

• MTSearchHasPrevious

  A conditional tag that only renders its contents if the current page has a predecessor.

• MTSearchHasNext

  A conditional tag that only renders its contents if there are more results (pages) after the current page.

• MTSearchPageLinks

  Creates a context for generating a list of links to a page. Pages are based on the limit and offset params applied to the search.

• MTSearchPageIndex

  Inserts the page number (an integer).

• MTSearchPageLink

  Inserts a URL to generate the page number (managed by MTSearchPageLinks) currently in context.

• MTSearchPageIndexNotCurrent

  A conditional tag that renders its contents if the MTSearchPageLinks index in context does not match the current page of results being rendered.

• MTSearchPageIndexCurrent

  A conditional tag that renders its contents if the MTSearchPageLinks index in context matches the current page of results being rendered.

• MTTagSearch

  Outputs the tag search that was executed. For use on the Tags.App Results template.

• MTTagSearchBlogID

  Outputs the ID number of the weblog being searched.

Layout Tags

• MTTag

  Outputs the tag in context.

• MTDeliciousTag

  Outputs the tag in context hyperlinked to del.icio.us.

• MTFlickrTag

  Outputs the tag in context hyper-linked to Flickr.

• MTTagsList

  A widget tag that displays a list of linked tags for the entry in context. These links will have a rel attribute of tag in order to work with distributed tagging systems such as Technorati.

• MTTechnoratiTag

  Outputs the tag in context linked to Technorati.

• MTTagCloud [scope= days=N top=N latest=N glue=]

  A widget tag for quickly inserting a tag cloud into a template. This tag supports the following optional arguments.

  • scope

    Defines the scope of the tag data to generate the cloud with. Recognized values are system, related and blog. If omitted the default value is blog. WHAT ABOUT DATE??? NO RELATED.

  • days

    Renders the cloud with tags that have at least one entry in the past N days.

  • top

    Renders the cloud with the top N tags based on count. Cannot be used with latest.

  • latest

    Renders the cloud with the last N tags based on their latest use. Cannot be used with top.

Deprecated Tags

• MTBlogTags
• MTEntryTags
• MTSystemTags
• MTTagQuery
• MTTagQueryBlogID

Removed Tags

• MTFeedEntryTags (experimental)