Introduction

This page documents the TypePad template tags used by Advanced Template designs. You can learn more about Advanced Templates and template tag syntax in the TypePad Knowledge Base.

Last updated on August 14, 2009.

Archive

Archive tags display information about your blog archives.

MTArchiveList

A container tag representing a list of the archives in your blog. Takes attribute archive_type to specify which set of archives to link to. This takes the values Monthly, Weekly, Daily, Category.

<MTBlogIfArchives>
    <div class="module-archives module">
        <h2 class="module-header"><a href="<$MTBlogURL$>archives.html"><$MTTrans phrase="Archives"$></a></h2>
        <div class="module-content">
            <ul class="module-list">
                <MTArchiveList best_archive_type="Monthly" lastn="10">
                    <li class="module-list-item"><a href="<$MTArchiveLink$>"><$MTArchiveTitle$></a></li>
                </MTArchiveList>
            </ul>
        </div>
    </div>
</MTBlogIfArchives>

MTBlogIfArchives

A container tag that only displays its contents if archives are enabled for your blog. This prevents an empty archive list from being displayed if you do not have archives. Takes attribute archive_type to specify which set of archives to link to. This takes the values Monthly, Weekly, Daily, and Category.

MTArchivePrevious

A container tag that changes the context to the previous archive. This is used on your archive templates to create navigation links.

<MTArchivePrevious>
    <a href="<$MTArchiveLink$>">&laquo; <$MTArchiveTitle$></a> |
</MTArchivePrevious>

MTArchiveNext

A container tag similar to MTArchivePrevious, except that it changes the context to the next archive.

<MTArchiveNext>
    | <a href="<$MTArchiveLink$>"><$MTArchiveTitle$> &raquo;</a>
</MTArchiveNext>

MTArchiveHasHeader

A container tag that displays a header in category and date based archives.

<MTArchiveHasHeader>
    <h2 class="content-header"><$MTArchiveHeader$></h2>
</MTArchiveHasHeader>

MTArchiveLink

The URL of the archive that is being linked to.

MTArchiveTitle

The title of the archive.

MTArchiveCategory

The category of the archive; this only makes sense if you have enabled Category Archiving for your blog.

MTArchiveCount

The number of posts in a given date-based archive.

MTArchiveDate

The date of a date-based archive. For weekly archives, this gives the start date.

MTArchiveDateEnd

The end date of a weekly archive.

MTArchiveHeader

The label for the archive header.

Blog

Blog tags display information about your blog. Most of these options are set on the Configure tab, or when you created your account or blog.

MTBlogName

Your blog name.

MTBlogDescription

Your blog description.

MTBlogID

Your blog ID number.

MTBlogLanguage

Your blog language.

MTBlogURL

Your blog URL, in the form: http://example.typepad.com/blog/

MTBlogArchiveURL

Your blog archive URL, in the form: http://example.typepad.com/blog/

MTBlogHost

Your blog hostname, in the form: example.typepad.com

MTBlogRelativeURL

Your blog's relative URL, in the form: /blog/

MTBlogDirname

Your blog directory, in the form: blog

MTBlogSitePath

Your blog site path, in the form: blog/

MTBlogEntryCount

The number of posts in your blog.

MTBlogCommentCount

The number of comments posted to your blog.

MTWeblogPortalURL

The link to portal for TypePad in Powered By link.

MTBlogMetaKeywords

Your blog's meta keywords.

MTBlogMetaDescription

Your blog's meta description.

MTBlogIfPrivate

If your blog is set to not be public, the contents of this container tag will be displayed.

<MTBlogIfPrivate>
    <meta name="robots" content="noindex,nofollow" />
</MTBlogIfPrivate>

MTBlogIfDescription

Conditional container tag used around MTBlogDescription so that it only displays if a description is set for the blog on Weblogs → Configure.

<MTBlogIfDescription>
    <$MTBlogDescription$>
</MTBlogIfDescription>

MTWeblogIfFullRSSContent

Container tag used in Atom feed around MTEntryAtomContent and in RSS feed around MTEntryBody and MTEntryMore. Takes setting from Weblogs → Configure → Feeds.

See the sample below for information on how to use this tag.

MTWeblogOwnerHas

Use with field="feeds_full_content" around MTWeblogIfFullRSSContent and around MTEntryBody and MTEntryMore; takes setting from Weblogs → Configure → Feeds.

<MTWeblogOwnerHas field="feeds_full_content">
    <MTWeblogIfFullRSSContent>
        <$MTEntryAtomContent$>
    </MTWeblogIfFullRSSContent>
</MTWeblogOwnerHas>

MTWeblogIfCommentsModerated

Use in Individual Archive template comment form around elements only shown if comment moderation turned on. Takes setting from Weblogs → Configure → Preferences.

<MTWeblogIfCommentsModerated>
    Comments are moderated, and will not appear on the weblog until the author has approved them.
</MTWeblogIfCommentsModerated>

MTWeblogIfRegistrationEnabled

Use in Individual Archive template comment form around elements only shown if comment authentication turned on (optional or required). Takes setting from Weblogs → Configure → Preferences.

<MTWeblogIfRegistrationEnabled>
    If you have a TypeKey or TypePad account, please sign in.
</MTWeblogIfRegistrationEnabled>

MTWeblogIfRegistrationRequired

Use in Individual Archive template comment form around elements only shown if comment authentication is required. Takes setting from Weblogs → Configure → Preferences.

<MTWeblogIfRegistrationRequired>
    This blog only allows comments from registered users. To comment, please sign in.
</MTWeblogIfRegistrationRequired>

Calendar

Calendar tags display the sidebar calendar on your blog.

<div id="calendar">
    <table summary="<$MTTrans phrase="Monthly calendar with links to each day's posts"$>">
        <caption><$MTDate format="%B %Y"$></caption>
        <tr>
            <MTCalendarWeekDays>
                <th><$MTCalendarWeekDay$></th>
            </MTCalendarWeekDays>
        </tr>
        <MTCalendar>
            <MTCalendarWeekHeader>
                <tr>
            </MTCalendarWeekHeader>
            <td>
                <MTCalendarIfEntries>
                    <MTEntries lastn="1">
                        <a href="<$MTEntryPermalink$>"><$MTCalendarDay$></a>
                    </MTEntries>
                </MTCalendarIfEntries>
                <MTCalendarIfNoEntries>
                    <$MTCalendarDay$>
                </MTCalendarIfNoEntries>
                <MTCalendarIfBlank>
                </MTCalendarIfBlank>
            </td>
            <MTCalendarWeekFooter>
                </tr>
            </MTCalendarWeekFooter>
        </MTCalendar>
    </table>
</div>

It is possible to list multiple recent calendars:

<MTArchiveList lastn="N" archive_type="Monthly">
    <div id="calendar">
        <table summary="<$MTTrans phrase="Monthly calendar with links to each day's posts"$>">
            <caption><$MTArchiveDate format="%B %Y"$></caption>
            <tr>
                <MTCalendarWeekDays>
                    <th><$MTCalendarWeekDay$></th>
                </MTCalendarWeekDays>
            </tr>
            <MTCalendar month="this">
                <MTCalendarWeekHeader>
                    <tr>
                </MTCalendarWeekHeader>
                <td>
                    <MTCalendarIfEntries>
                        <MTEntries lastn="1">
                            <a href="<$MTEntryPermalink$>"><$MTCalendarDay$></a>
                        </MTEntries>
                    </MTCalendarIfEntries>
                    <MTCalendarIfNoEntries>
                        <$MTCalendarDay$>
                    </MTCalendarIfNoEntries>
                    <MTCalendarIfBlank>
                    </MTCalendarIfBlank>
                </td>
                <MTCalendarWeekFooter>
                    </tr>
                </MTCalendarWeekFooter>
            </MTCalendar>
        </table>
    </div>
</MTArchiveList>

N is the number of recent calendars to display. Note the use of MTArchiveList container and that MTArchiveDate is used instead of MTDate in the caption. It is currently not possible in TypePad to display a calendar from a specified month, only one or more recent calendars.

MTCalendar

A container tag that holds the other calendar tags.

MTCalendarWeekDays

A container tag that cycles through the days of the week to create the calendar headers.

MTCalendarWeekHeader

A container tag that creates the calendar structure.

MTCalendarWeekFooter

A container tag that creates the calendar structure.

MTCalendarIfEntries

A container tag that displays its contents if there was a blog post on that day.

MTCalendarIfNoEntries

A container tag that displays its contents if there were not blog posts on that day.

MTCalendarIfBlank

A container tag that creates the structure for blank spaces on the calendar.

MTCalendarIfToday

A container tag that displays its contents if the date on the calendar is the same as the date the blog was last published.

MTCalendarWeekDay

Displays the calendar header for each day of the week.

MTCalendarDay

Displays the date (day of the month) on the calendar.

Category

Category tags display information about your blog categories.

Display a list of the categories:

<div class="module-categories module">
    <h2 class="module-header"><$MTTrans phrase="Categories"$></h2>
    <div class="module-content">
        <ul class="module-list">
            <MTCategories>
                <MTBlogIfArchives archive_type="Category">
                    <li class="module-list-item"><a href="<$MTCategoryArchiveLink$>"><$MTCategoryLabel$></a></li>
                <MTElse>
                    <li class="module-list-item"><$MTCategoryLabel$></li>
                </MTElse>
                </MTBlogIfArchives>
            </MTCategories>
        </ul>
    </div>
</div>

MTCategories

A container tag representing a list of the categories in your blog. For each category, you can use any of the tag variables below; in addition, you can use an MTEntries tag to display information about each of the entries in this category. Categories will be listed in alphabetical order and there isn't another option for their display.

When a category does not contain any posts, by default that category will not be included in the list of categories; this is the default behavior because it mirrors the behavior of MTArchiveList. Note that this is advised if you are including links to your category archive pages, because archive pages are not generated for empty categories. Thus, the archive link for an empty category will be a broken link.

If you would like to override this default behavior, you can provide this tag with the show_empty attribute. For example, this will display a list of all of your categories, even those that are empty:

<MTCategories show_empty="1">
    <$MTCategoryLabel$>
</MTCategories>

MTEntryIfCategories

A conditional container tag that will only display its contents if the blog post is assigned to one or more categories.

If you have some code that you would like to display only if the post is assigned to a category — such as category information — then wrap the code in MTEntryIfCategories container tags.

MTEntryCategories

A container tag that loops through each of the post's categories and displays information about them.

For example, this will display a list of all the categories that a post is assigned to:

<MTEntryIfCategories>
    in
    <MTEntryCategories glue=", ">
        <MTBlogIfArchives archive_type="Category">
            <a href="<$MTCategoryArchiveLink$>"><$MTCategoryLabel$></a>
        <MTElse>
            <$MTCategoryLabel$>
        </MTElse>
        </MTBlogIfArchives>
    </MTEntryCategories>
</MTEntryIfCategories>

MTCategoryID

Deprecated. Apply the dirify attribute to MTCategoryLabel if you need a category ID.

<$MTCategoryLabel dirify="1"$>

MTCategoryLabel

The category label.

MTCategoryArchiveLink

A link to the archive page for this category. This only works if you have enabled Category Archiving for your blog; if you have not, you will get an error message when rebuilding your pages.

MTCategoryCount

The number of posts in this category.

Comment

Comment tags display the comments posted by visitors to your blog.

Display a list of recent comments on the blog, for your sidebar:

<div class="module-recent-comments module">
    <h2 class="module-header"><$MTTrans phrase="Recent Comments"$></h2>
    <div class="module-content">
        <ul class="module-list">
            <MTComments lastn="10" sort_order="descend">
                <li class="module-list-item"><MTCommentEntry><a href="<$MTEntryPermalink$>#comment-<$MTCommentID$>"><$MTCommentAuthor$></a> <$MTTrans phrase="on"$> <a href="<$MTEntryPermalink$>"><$MTEntryTitle generate="1"$></a></MTCommentEntry></li>
            </MTComments>
        </ul>
    </div>
</div>

Display the comments form:

<MTEntryIfCommentsOpen>
    <script type="text/javascript" src="<$MTStaticWebPath$>js/comments.js"></script>
    <script type="text/javascript">hostName = '<$MTBlogHost$>';</script>
    <form id="comment-form" method="post" action="<$MTCGIPath$><$MTCommentScript$>">
        <input type="hidden" name="entry_id" value="<$MTEntryID$>" />
        <div class="comments-open">
            <h2 class="comments-open-header"><$MTTrans phrase="Post a comment"$></h2>
            <div class="comments-open-content">
                <MTWeblogIfCommentsModerated>
                    <p class="comments-open-moderated"><$MTTrans phrase="Comments are moderated, and will not appear on this blog until the author has approved them."$></p>
                </MTWeblogIfCommentsModerated>
                <MTWeblogIfRegistrationEnabled>
                    <script type="text/javascript" src="<$MTCGIPath$><$MTCommentScript$>?__mode=check_login"></script>
                    <p id="comments-open-login" style="display: block;">
                        <MTWeblogIfRegistrationRequired>
                            <$MTTrans phrase="This blog only allows comments from registered users."$>
                            <$MTTrans phrase="To comment, please"$>
                            <a href="<$MTEntrySignInURL$>"><$MTTrans phrase="Sign In"$></a>.
                        <MTElse>
                            <$MTTrans phrase="If you have a TypeKey or TypePad account, please"$>
                            <a href="<$MTEntrySignInURL$>"><$MTTrans phrase="Sign In"$></a>
                        </MTElse>
                        </MTWeblogIfRegistrationRequired>
                    </p>
                    <p id="comments-open-logout" style="display: none;">
                        <$MTTrans phrase="You are currently signed in as"$>
                        <span id="commenter-name">(nobody)</span>.
                        <a href="<$MTEntrySignOutURL$>"><$MTTrans phrase="Sign Out"$></a>
                    </p>
                </MTWeblogIfRegistrationEnabled>
                <MTWeblogIfRegistrationRequired>
                <MTElse>
                    <div id="comments-open-data">
                        <p>
                            <label for="comment-author"><$MTTrans phrase="Name:"$></label>
                            <input id="comment-author" name="author" size="30" />
                        </p>
                        <p>
                            <label for="comment-email"><$MTTrans phrase="Email Address:"$></label>
                            <input id="comment-email" name="email" size="30" />
                        </p>
                        <p>
                            <label for="comment-url"><$MTTrans phrase="URL:"$></label>
                            <input id="comment-url" name="url" size="30" />
                        </p>
                        <p>
                            <label for="comment-bake-cookie"><input type="checkbox" id="comment-bake-cookie" name="bakecookie" value="1" />
                            <$MTTrans phrase="Remember personal info?"$></label>
                        </p>
                    </div>
                </MTElse>
                </MTWeblogIfRegistrationRequired>
                <p id="comments-open-text"<MTWeblogIfRegistrationRequired> style="display: none;"</MTWeblogIfRegistrationRequired>>
                    <label for="comment-text"><$MTTrans phrase="Comments:"$></label>
                    <textarea id="comment-text" name="text" rows="10" cols="30"></textarea>
                </p>
            </div>
            <div id="comments-open-footer" class="comments-open-footer"<MTWeblogIfRegistrationRequired> style="display: none;"</MTWeblogIfRegistrationRequired>>
                <input type="submit" name="preview" id="comment-preview" value="<$MTTrans phrase="Preview"$>" />
                <input type="submit" name="post" id="comment-post" value="<$MTTrans phrase="Post"$>" />
            </div>
        </div>
    </form>
    <MTWeblogIfRegistrationEnabled>
        <script type="text/javascript">
            commentSignIn();
        </script>
        </MTWeblogIfRegistrationEnabled>
    <MTElse>
        <p class="comments-closed"><$MTTrans phrase="The comments to this entry are closed."$></p>
    </MTElse>
</MTEntryIfCommentsOpen>

MTComments

A container tag representing a list of the comments posted by visitors to your blog. For each comment, you can use any of the tag variables below.

<MTComments>
    <a id="c<$MTCommentID$>"></a>
    <$MTCommentBody$>
    <p class="posted"><$MTTrans phrase="Posted by:"$> <$MTCommentAuthorLink spam_protect="1"$> | <$MTCommentDate$></p>
</MTComments>

The MTComments tag is located in the comment-list module within the entry-individual module in the Individual Entry Archives template.

Note: Using the MTComments tag in an advanced template without a lastn value and outside the context of an entry, will default to showing only 50 comments from the last 30 days instead of all comments.

MTCommentEntry

A container tag used to display information about the post to which the comment is attached; you can use Post Tags here. Note that the MTCommentDate tag must be used outside of this container or it will display the post date instead of the comment date.

MTEntryIfAllowComments

A container tag whose contents will only be shown if the comment setting for the post is Allow.

In the Main Index, DateBased Archives, and Category Archives templates, the MTEntryIfAllowComments tag is used to in the entry-list module to display links to the comment posting form on the individual post page.

<MTEntryIfAllowComments>
    | <a href="<$MTEntryPermalink$>#comments"><$MTTrans phrase="Comments"$> (<$MTEntryCommentCount$>)</a>
</MTEntryIfAllowComments>

In the Individual Entry Archive template, the MTEntryIfAllowComments tag is used to display the comment posting form.

MTEntryIfCommentsOpen

A container tag whose contents will only be shown if the comment setting for the post is Open and is used to display the comment posting form. The MTEntryIfCommentsOpen tag is located in the comment-form module within the entry-individual module in the Individual Entry Archives template.

MTCommentID

The numeric ID of the comment.

MTCommentBody

The text of the comment.

MTCommentAuthorLink

The name of the comment author, linked to their URL if they submitted one, otherwise to their email address. Takes attribute spam_protect which will encode the contents against spam harvesters using the values 0 (no spam protection) and 1 (spam protection). Takes attribute show_email to indicate whether the email address will be displayed if no URL is entered for the comment author using the values 0 (email address is never displayed) and 1 (email address will be displayed if no URL entered).

MTCommentDate

The date that the comment was posted, can be formatted with date and time tags.

MTCommentAuthor

The name of the comment author.

MTCommentEmail

The email address of the comment author. Takes attribute spam_protect which will encode the contents against spam harvesters using the values 0 (no spam protection) and 1 (spam protection).

MTCommentURL

The URL submitted by the comment author, if one was.

MTCommentOrderNumber

The numeric order of a particular comment in the list of comments for an entry, starting at 1. Note that the order is dependent on the sort order (ascending or descending).

MTCommentPermalink

A permanent link to an individual comment on a post.

Benefits:

  • Redirects to the right page if the comment is on a post with several pages of comments.

  • Jumps to the comment anchor on the page.

  • Provides a shorter (and future-proof) way of writing:

    <$MTEntryPermalink$>?cid=<$MTCommentID$>#comment-<$MTCommentID$>
    

Gallery

MTGalleriesInclude

The MTGalleriesInclude tag displays a list of your photo albums in an advanced template. This listing will display a thumbnail image for each album that links to that photo album. The thumbnail is of the most recent image uploaded to that album.

This tag will create a display that is the same as the one you see in basic templates.

Related

If you would like display individual Photo Albums in your sidebar, you can use include tags in the following format:

<!--#include virtual="/photos/my_album/module.inc"-->

where "my_album" is the name of the Photo Album.

You can find the name and format of each Photo Album under the Photo Albums tab. Each Photo Album displays the published location of an album in the format of:

http://example.typepad.com/photos/my_album/

Include

MTInclude

Includes a template module and outputs the result.

Attributes

  • module: The name of the template module to include.

    <$MTInclude module="Module Name"$>
    

Page

MTPages

Container tag used for listing links to the pages associated with a blog.

MTPageTitle

The title of the page.

MTPageBody

The body of the page.

MTPageDate

The date the page was published. Can be formatted with date and time tags.

MTPageFilename

The file path to the page.

<a href="<$MTBlogURL$><$MTPageFilename$>"><$MTPageTitle remove_html="1"$></a>

MTPageSidebarModuleTitle

Used as a header in a sidebar listing of links to each page, default is "Pages".

Sidebar listing to each page associated with a blog:

<div class="module-archives module">
    <h2 class="module-header"><$MTPageSidebarModuleTitle encode_html="1"$></h2>
    <div class="module-content">
        <ul class="module-list">
            <MTPages use_sidebar_module_options="1">
                <li class="module-list-item"><a href="<$MTBlogURL$><$MTPageFilename$>"><$MTPageTitle remove_html="1"$></a></li>
            </MTPages>
        </ul>
    </div>
</div>

Post

Post tags display information about your blog posts.

Simple code to display posts on the main page of your blog, and can be used on date-based and category archive pages as well:

<MTEntries>
    <MTWeblogPostIfShow field="date_header">
        <MTDateHeader><h2 class="date-header"><$MTEntryDate format_weblog_date="1"$></h2></MTDateHeader>
    </MTWeblogPostIfShow>
    <div class="entry" id="entry-<$MTEntryID$>">
        <MTWeblogPostIfShow field="post_title">
            <h3 class="entry-header"><$MTEntryTitle$></h3>
        </MTWeblogPostIfShow>
        <div class="entry-content">
            <div class="entry-body">
                <$MTEntryBody$>
            </div>
            <MTEntryIfExtended>
                <p class="entry-more-link">
                    <a href="<$MTEntryPermalink$>#more"><$MTTrans phrase="Continue reading"$> "<$MTEntryTitle$>" &raquo;</a>
                </p>
            </MTEntryIfExtended>
        </div>
        <p class="entry-footer">
            <$MTEntryPostFooter$>
            <MTEntryIfAllowComments>
                | <a href="<$MTEntryPermalink$>#comments"><$MTTrans phrase="Comments"$> (<$MTEntryCommentCount$>)</a>
            </MTEntryIfAllowComments>
            <MTEntryIfAllowPings>
                | <a href="<$MTEntryPermalink$>#trackback"><$MTTrans phrase="TrackBack"$> (<$MTEntryTrackbackCount$>)</a>
            </MTEntryIfAllowPings>
        </p>
    </div>
</MTEntries>

The default code to display a listing of the ten most recent posts in a sidebar:

<MTBlogIfArchives>
    <div class="module-archives module">
        <h2 class="module-header"><$MTTrans phrase="Recent Posts"$></h2>
        <div class="module-content">
            <ul class="module-list">
                <MTEntries lastn="10">
                    <li class="module-list-item"><a href="<$MTEntryPermalink$>"><$MTEntryTitle remove_html="1" generate="1"$></a></li>
                </MTEntries>
            </ul>
        </div>
    </div>
</MTBlogIfArchives>

MTEntries

A container tag representing a list of the posts in your blog.

This is the primary tag to use whenever you want to display your blog posts, whether on your Main Index page, your DateBased or Category archives, or a listing on your sidebar. The MTEntries tag can take attributes that specify which posts to display and what order to display them in.

<MTEntries lastn="10">
    <p><a href="<$MTEntryPermalink$>"><$MTEntryTitle$></a></p>
</MTEntries>

This will display the 10 most recent posts in the blog as a list of the post titles, each one linked to the post in the archives.

Attributes

  • lastn: Displays a specified number of the most recent posts, as long as the posts are within the last 30 days; otherwise, displays as many of the posts as are within 30 days. (lastn="10")
  • offset: Used with lastn, it starts the count by the offset amount, for instance to count ten posts starting ten posts back. (offset="10")
  • days: Displays posts from a specified number of the most recent days. (days="10")
  • category: Displays posts from a specified category, where Category is the name of the category. (category="Category")
  • author: Displays posts from a specified author, where username is the login name of the author. (author="username")
  • sort_by: Sorts posts for display by a field, where the options are title, status, modified_on, author_id, and excerpt. Does not work in combination with lastn. (sort_by="title")
  • sort_order: Sets the display order, where the options are ascend and descend. Does not work in combination with lastn. (sort_order="ascend")

MTEntryIfExtended

A container tag that will display its contents if the post has content in the post continuation field.

<MTEntryIfExtended>
    <p class="extended"><a href="<$MTEntryPermalink$>#more"><$MTTrans phrase="Continue reading"$> "<$MTEntryTitle$>"</a></p>
</MTEntryIfExtended>

MTEntryIfAllowComments

A container tag that will display its contents if the post has the allow comments option turned on, used to display information about the comments.

MTEntryIfAllowPings

A container tag that will display its contents if the post has the accept TrackBacks option turned on, used to display information about the TrackBacks.

MTEntryNext

A container tag that changes the context to the next post, used on Individual archives to create navigation links.

<MTEntryNext>
    | <a href="<$MTEntryPermalink$>"><$MTEntryTitle$> &raquo;</a>
</MTEntryNext>

MTEntryPrevious

A container tag similar to MTEntryNext, except that it changes the context to the previous post.

<MTEntryPrevious>
    <a href="<$MTEntryPermalink$>">&laquo; <$MTEntryTitle$></a> |
</MTEntryPrevious>

MTDateHeader

A container tag that will display its contents if the post marks a new day in the list of posts. This must be used within the MTEntries container.

<MTDateHeader>
    <h2><$MTEntryDate format_weblog_date="1"$></h2>
</MTDateHeader>

MTDateFooter

A container tag that will display its contents if the post is the last one in a given day in the list of posts. This must be used within the MTEntries container.

MTEntriesHeader

A container tag that will display its contents if the post is the first one in the listing. This must be used within the MTEntries container.

MTEntriesFooter

A container tag that will display its contents if the post is the last one in the listing. This must be used within the MTEntries container.

MTWeblogPostIfShow

A container tag that will display its contents if a specified field is set to be displayed, such as the post title. Takes attribute field which specifies the post field to check if it is set on Weblogs → Design → Content to be displayed. This takes the values date_header and post_title.

<MTWeblogPostIfShow field="post_title">
    <h3><$MTEntryTitle$></h3>
</MTWeblogPostIfShow>

MTEntryEnclosures

Used in RSS 2.0 feed to list enclosures for each post; contains other tags.

<MTEntryEnclosures>
    <enclosure url="<$MTEntryEnclosureURL$>" type="<$MTEntryEnclosureMIMEType$>" length="<$MTEntryEnclosureLength$>" />
</MTEntryEnclosures>

MTWeblogIfExposeTags

A conditional container tag used to check if Technorati Tags are enabled on a blog; see below for other tags.

MTEntryIfTagged

A conditional container tag used to check if Technorati Tags are used in a post. See below for other tags.

MTEntryTags

A container tag used to display each Technorati Tag in a post.

<MTWeblogIfExposeTags>
    <MTEntryIfTagged>
        <a href="http://www.technorati.com/search/<$MTEntryPermalink$>" title="<$MTTrans phrase="Find related items at Technorati."$>"><$MTTrans phrase="Technorati Tags"$></a>: <MTEntryTags glue=", "><a href="http://technorati.com/tag/<$MTTagLabelClean encode_url="1"$>" rel="tag"><$MTTagLabel$></a></MTEntryTags>
    </MTEntryIfTagged>
</MTWeblogIfExposeTags>

MTEntryTrackbackData

Adds invisible code to the post so that it can accept TrackBacks.

MTEntryDate

The date the post was created, can be formatted with date and time tags.

MTEntryID

The unique ID for the post.

MTEntryBody

The content of the post.

MTEntryPermalink

A permanent link to the post in your archives that people can use to link to it. Takes attribute archive_type to specify which set of archives to link to. This takes the values Monthly, Weekly, Daily, Category, Individual and combinations; e.g. Monthly|Daily|Weekly.

MTEntryCommentCount

The number of comments on this post.

MTEntryTrackbackCount

The number of TrackBacks sent to the post.

MTEntryLink

Similar to MTEntryPermalink.

MTEntryTitle

The title of the post. Takes attribute generate which will generate a title from the first characters of the post if no title is set by the user. This takes the values 0 (no title generated) and 1 (title generated).

MTEntryDateModified

If the post was edited after being created, the date it was last modified.

MTEntryExcerpt

An excerpt of the post.

MTEntryAuthor

The author of the post.

MTEntryAtomContent

The content of the post, in the format needed in an Atom feed.

MTEntryMore

The extended post or post continuation.

MTEntryTrackbackLink

The TrackBack URL that people can use to send a TrackBack to the post.

MTEntryAuthorEmail

The email address of the author of the post. Takes attribute spam_protect, which will encode the contents against spam harvesters. This takes the values 0 (no spam protection) and 1 (spam protection).

MTEntryAuthorURL

The web address for the author of the post.

MTEntryAuthorLink

The name of the author of the post, linked to their web address if available and otherwise to their email address. Takes attribute spam_protect, which will encode the contents against spam harvesters. This takes the values 0 (no spam protection) and 1 (spam protection).

MTEntryAuthorNickname

The nickname of the author of the post, which is set on the author profile page.

MTEntryKeywords

Keywords for the post.

MTEntryPermalinkRelative

Similar to MTEntryPermalink but as a relative path rather than a URL.

MTEntryStatus

The publication status of the post, Draft, Publish, or Future.

MTEntryPostFooter

Displays the Post Footer set in Weblogs → Design → Content → Post Footer. To modify, replace with the following code, than make desired changes.

<span class="post-footers"><$MTEntryDate$></span>
<span class="separator">|</span>
<a class="permalink" href="<$MTEntryPermalink$>">Permalink</a>

MTEntryAtomContent

Used in Atom feed to display both the post body and the post continuation.

MTEntrySignInURL

Used in Individual Archive template comments form to produce TypeKey sign-in link.

MTEntrySignOutURL

Used in Individual Archive comments form to produce TypeKey sign-out link.

MTEntryEnclosureURL

Used in RSS 2.0 template inside MTEntryEnclosures to produce URL of enclosed file.

MTEntryEnclosureMIMEType

Used in RSS 2.0 template inside MTEntryEnclosures to produce MIME type of file required for podcasting.

MTEntryEnclosureLength

Used in RSS 2.0 template inside MTEntryEnclosures to produce file size of enclosure, required for podcasting.

MTTagLabel

A tag used to display a particular Technorati Tag or label.

MTTagLabelClean

A tag used to encode content in a Technorati Tag.

TrackBack

TrackBack tags display TrackBacks sent to your blog. These tags can be used in main index templates as well as archive templates.

MTPings

A container tag representing a list of the TrackBacks sent to your blog. For each TrackBack, you can use any of the tag variables below.

<MTPings>
    <p>
        <a id="p<$MTPingID$>"></a>
        &raquo; <a href="<$MTPingURL$>"><$MTPingTitle$></a> <$MTTrans phrase="from"$> <$MTPingBlogName$><br />
        <$MTPingExcerpt$> <a href="<$MTPingURL$>">[<$MTTrans phrase="Read More"$>]</a>
    </p>
    <p class="posted"><$MTTrans phrase="Tracked on"$> <$MTPingDate$></p>
</MTPings>

MTPingsSent

A container tag representing a list of the TrackBacks that you have sent.

<MTPingsSent>
    URL: <$MTPingsSentURL$>
</MTPingsSent>

MTPingID

The numeric ID of the TrackBack.

MTPingURL

The URL of the post that sent the TrackBack.

MTPingTitle

The title of the post that sent the TrackBack.

MTPingBlogName

The name of the blog that sent the TrackBack.

MTPingExcerpt

An excerpt of the post that sent the TrackBack.

MTPingDate

The date that the TrackBack was sent, can be formatted with date and time tags.

MTPingIP

The IP address that the TrackBack was sent from.

MTPingsSentURL

The URL of the post that you sent a TrackBack to.

TypeList

The TypeList tags are for displaying data from your TypeLists.

MTListInclude

The MTListInclude tag displays your TypeLists as pre-formatted html code blocks in an advanced template. The list items are enclosed automatically in <li>list item</li> markup and the display of the list is set in the advanced configuration for the TypeList.

Use the name attribute to specify the TypeList to display:

<$MTListInclude name="TypeList Name"$>

The TypeList Name is the name you gave the TypeList and is set in the configuration for the TypeList. The name is case sensitive so use it in the tag exactly as it is entered in the TypeList configuration.

You can also use the MTUserLists container to include all of the lists that you have selected to display on your About Page. The name attribute is not used, the MTListInclude tag is surrounded by the MTUserLists container instead:

<MTUserLists>
    <$MTListInclude$>
</MTUserLists>

MTList

These tags give you full control of the TypeList display. The MTList container loops through the list items and displays each using the MTListItem tag.

Use the name to specify the TypeList to display:

<MTList name="TypeList Name">
    <$MTListItem$><br />
</MTList>

MTListItem

MTListItem Fields

Use field with the MTListItem tag to specify the field that you would like to display from the TypeList. Each list type (People, Link, Reading, Music) has its own set of valid fields:

People TypeList

  • Name: <$MTListItem field="name"$>
  • Site Name: <$MTListItem field="site_name"$>
  • Homepage: <$MTListItem field="htmlurl"$>
  • Email Address: <$MTListItem field="email"$>
  • One-Line Bio: <$MTListItem field="notes"$>

Display a list of people with the Site Name linked and the One-Line Bio as the link tooltip:

<h2>Friends</h2>
<ul>
    <MTList name="TypeList Name">
        <li>
            <a href="<$MTListItem field="htmlurl"$>" title="<$MTListItem field="notes"$>"><$MTListItem field="site_name"$></a>
        </li>
    </MTList>
</ul>

Link TypeList

  • Title: <$MTListItem field="title"$>
  • URL: <$MTListItem field="url"$>
  • Notes: <$MTListItem field="notes"$>

Display a list of links that use the link title as the link and open in a new window:

<h2>Links</h2>
<ul>
    <MTList name="TypeList Name">
        <li>
            <a href="<$MTListItem field="url"$>" target="_blank"><$MTListItem field="title"$></a>
        </li>
    </MTList>
</ul>

Books TypeList

  • Title: <$MTListItem field="title"$>
  • Author: <$MTListItem field="author"$>
  • Notes: <$MTListItem field="notes"$>
  • Rating as 1 - 5: <$MTListItem field="rating"$>
  • Rating as *: <$MTListItemRating$>
  • ASIN: <$MTListItem field="asin"$>
  • Amazon URL: <$MTListItemURL$>
  • Amazon image: <$MTListItemImage$>

Display a list with the thumbnail of the book, the title of the book, and the rating as stars:

<h2>Books</h2>
<ul>
    <MTList name="TypeList Name">
        <li>
            <a href="<$MTListItemURL$>"><$MTListItemImage$></a><br />
            <$MTListItem field="title"$><br />
            <$MTListItemRating$>
        </li>
    </MTList>
</ul>

Albums TypeList

  • Song: <$MTListItem field="song"$>
  • Artist: <$MTListItem field="artist"$>
  • Album: <$MTListItem field="album"$>
  • Notes: <$MTListItem field="notes"$>
  • Rating as 1 - 5: <$MTListItem field="rating"$>
  • Rating as *: <$MTListItemRating$>
  • Amazon URL: <$MTListItemURL$>
  • Amazon image: <$MTListItemImage$>

Display a text list of albums with the artist as the tooltip and also display the notes for the item:

<h2>Albums</h2>
<ul>
    <MTList name="TypeList Name">
        <li>
            <a href="<$MTListItemURL$>" title="<$MTListItem field="artist"$>"><$MTListItem field="album"$></a><br />
            <$MTListItem field="notes"$>
        </li>
    </MTList>
</ul>

User

The User tags are for displaying your Author Profile information.

Customizing an Advanced About Page (Pro)

Pro members have the option of selecting to use the About Page default template or using a custom About Page template. With a custom About Page template, enter the HTML and TypePad Tags in the text field to create your design. You can also use the user tags in an advanced index or archive template.

Tip: MTUserSiteURL

An About Page does not "belong" to a specific blog so it does not make sense to use the MTBlogURL tag in an advanced About Page template. Use MTUserSiteURL instead, adding the necessary directory information for the blog that you are referring to.

Important Note: If you're not comfortable writing/editing HTML, you should continue using the default About Page template above.

Sample Template

When creating a custom About Page, you will need to write the HTML for the entire page. If you're also using an Advanced Template Set, you can copy over elements from your regular blog templates and this is the easiest way to do it if you want the page to look like one of your blogs.

For the content of the page, that is, the actual profile information, you can use a format like the following:

<h2>Contact</h2>
<p>
    Email Me: <$MTUserEmail$><br />
    Website: <a href="<$MTUserURL$>"><$MTUserURL$></a><br />
    <a href="<$MTUserWishlist$>">Amazon Wishlist</a><br />
    Location: <$MTUserLocation$>
</p>
<h2>One-Line Bio</h2>
<p><$MTUserMiniBio$></p>
<h2>Interests</h2>
<p><$MTUserInterests$></p>

You can add tags for other profile information that you'd like to display. The available tags are listed below.

MTUserIfShow

This tag takes the attribute field to see if a specific field is set to be displayed on your About Page. If it is checked, then this tag will display that information. The field attribute currently takes the value FOAF.

<MTUserIfShow field="foaf">
    <link rel="meta" type="application/rdf+xml" title="FOAF" href="<$MTUserSiteURL$>foaf.rdf" />
</MTUserIfShow>

MTUserIfPhoto

This is a conditional tag used around MTUserPhoto, so that it will be displayed only if you have uploaded a profile photo.

<MTUserIfPhoto>
    <div class="module-photo module">
        <div class="module-content>
            <img src="<$MTUserPhoto$>" alt="<$MTTrans phrase="My Photo"$>" />
        </div>
    </div>
</MTUserIfPhoto>

MTUserFullName

Name.

MTUserAboutPageTitle

About page title. (Your first and last name is used for the About Page title. If Nickname but not Name is selected to display on about page, Nickname is used. If neither are selected, "About Me" is used.)

MTUserPhoto

Profile photo URL.

MTUserPhotoHeight

Profile photo height.

MTUserPhotoWidth

Profile photo width.

MTUserEmail

Email address. (automatically spam-protected as described above)

MTUserAIM

AIM name.

MTUserICQ

ICQ number.

MTUserYahoo

Yahoo! ID.

MTUserMSN

MSN Messenger.

MTUserURL

Web address (URL).

MTUserLocation

Location.

MTUserBio

Biography.

MTUserMiniBio

One-line bio.

MTUserInterests

Interests.

MTUserWishlist

Amazon Wish List.

MTUserPublicKey

PGP key.

MTUserPublicKeyLink

PGP key link.

MTUserSiteName

Your example.typepad.com address.

MTUserSiteURL

Your http://example.typepad.com/ address.

MTUserStartDate

Your TypePad registration date.

Miscellaneous

MTElse

Container tag used with conditional tags; if the condition is not true, then the content inside MTElse is displayed instead.

MTIfNonEmpty

Conditional container tag whose contents will display if the specified tag has content. The specified tag can be any variable tag used in the appropriate context.

<MTIfNonEmpty tag="MTEntryBody">
    This post has a body.
<MTElse>
    This post does not have a body.
</MTElse>
</MTIfNonEmpty>

MTCGIPath

Used in <head> section of templates to link to RSD and in Atom feed to point to Atom application, also in comments form to point to comment script.

MTRSDScript

Used to generate filename of the RSD script, along with MTCGIPath.

MTStatsScript

Used to place the code for the stats script in a template.

MTStaticWebPath

Used in the comments javascript code in Individual Archive.

MTAtomFeedIDBase

Used in Atom feed header to provide information about the blog.

Trans

You can use the MTTrans tag to add text and headers to your blog templates that will be translated if you change the blog language. For example, if you modify Permalink in your template to <$MTTrans phrase="Permalink"$> then change your blog's language to French, the word "Permalink" will be displayed as "Lien permanent" on the blog.

If you enter a phrase that is not supported, the text will remain in English even if the blog is set to a different language for display.

The MTTrans tag will translate the phrases according to the display language that is set on Weblogs → Configure → Preferences. MTTrans only works with the languages listed as supporting display of localized headers. These are:

  • Dutch
  • French
  • Finnish
  • German
  • Italian
  • Spanish

Global

Global Attributes

Global attributes can be used in conjunction with other tags (like date formatting, post tags, etc.) to force case, strip HTML tags, and so on.

decode_html

Decodes all HTML entities in the tag value to their corresponding characters.

For example, a <$MTEntryBody$> tag with the value &lt;b&gt;bold&lt;/b&gt; normally displays as <b>bold</b>. Using <$MTEntryBody decode_html="1"$> causes it to display as bold.

decode_xml

Decodes all XML entities in the tag value to their corresponding characters.

<$MTEntryBody decode_html="1"$>

dirify

Transforms the tag value into a format suitable for use in a file or directory name. Characters are lower-cased, non-alphanumeric characters are stripped, and whitespace characters are converted to underscores.

<$MTCategoryLabel dirify="1"$>

encode_html

Encodes special characters in the tag value into their corresponding HTML entities.

For example a <$MTEntryBody$> tag with the value <b>bold</b> normally displays as bold. Using <$MTEntryBody encode_html="1"$> causes it to display as <b>bold</b>.

encode_js

Encodes the tag value into a format suitable for use as a JavaScript string value.

<$MTEntryTitle encode_js="1"$>

encode_url

Encodes the tag value into a format suitable for use in a URL. Non-alphanumeric characters are encoded into their hexadecimal equivalents.

<$MTEntryTitle encode_url="1"$>

encode_xml

Encodes special characters in the tag value into their corresponding XML entities. These are: &, ", < and >. The difference between this and encode_html is that the latter encodes a much wider set of special characters into HTML entities.

<$MTEntryBody encode_xml="1"$>

lower_case

Transforms the tag value into lower case characters.

<$MTArchiveDate format="%B" lower_case="1"$>

Tip: This tag is good for making AM/PM display as am/pm.

remove_html

Strips all HTML from the tag value.

<$MTEntryBody remove_html="1"$>

sanitize

Strips all HTML from the tag value except for the specified exceptions.

For example, <$MTEntryBody sanitize="em"$> will strip all HTML except the <em> tags.

trim_to

Trims the tag value to the first N characters, where N is specified as the value of the attribute.

<$MTEntryTitle trim_to="N"$>

upper_case

Transforms the tag value into upper case characters.

<$MTEntryTitle upper_case="1"$>

zero_pad

Pads the tag value with zeros so that the total length is N characters, where N is specified as the value of the attribute.

<$MTEntryID zero_pad="N"$>

Dates

Date formatting can be used to format dates and times in a variety of different configurations to suit your needs and preferences. You can use date formatting in conjunction with other tags such as MTEntryDate, MTPingDate, and MTCommentDate.

Without a format set, the date tags default to what is set on Weblogs → Configure → Preferences.

Format Characters

  • %a: The abbreviated weekday name. Example: Thu.
  • %A: The full weekday name. Example: Thursday.
  • %b: The abbreviated month name. Example: Sep.
  • %B: The full month name. Example: September.
  • %d: The two-digit day of the month padded with leading zeroes if applicable. Example: 09.
  • %e: The day of the month space padded if applicable. Example: 9.
  • %H: The two-digit military time hour padded with a zero if applicable. Example: 16.
  • %I: The two-digit hour on a 12-hour clock padded with a zero if applicable. Example: 04.
  • %j: The three-digit day of the year padded with leading zeroes if applicable. Example: 040.
  • %k: The two-digit military time hour padded with a space if applicable. Example: 9.
  • %l: The hour on a 12-hour clock padded with a space if applicable. Example: 4.
  • %m: The two-digit month padded with a leading zero if applicable. Example: 09.
  • %M: The two-digits minute padded with a leading zero if applicable. Example: 02.
  • %p: Either AM or PM. Language dependent.
  • %S: The two-digit second padded with a zero if applicable. Example: 04.
  • %w: The numeric day of the week ranging from 0 to 6 where 0 is Sunday. Example: 0
  • %x: The language-aware standard date representation. For most languages, this is just the same as %B %d, %Y. Example: September 06, 2002. Shows same as default.
  • %X: The language-aware time representation. For most languages, this is just the same as %I:%M %p. Example: 04:31 PM. Shows same as default.
  • %y: The two-digit year padded with a leading zero if applicable. Example: 01.
  • %Y: The four-digit year. Example: 2006

Attributes

  • format

    <$MTEntryDate format="%A"$>
    
  • language

    Applies to weekday names (%a, %A), month names (%b, %B, and in %X), and am/pm code (%p).

    <$MTEntryDate format="%A" language="fr"$>
    

    You can set the language for date display in Weblogs → Configure → Preferences, and this is used as the default if no language is specified for the tag.

    • ar (Arabic)
    • zh (Chinese)
    • hr (Croatian)
    • cs (Czech)
    • da (Danish)
    • nl (Dutch)
    • en (English)
    • fa (Farsi)
    • fi (Finnish)
    • fr (French)
    • de (German)
    • el (Greek)
    • he (Hebrew)
    • hi (Hindi)
    • hu (Hungarian)
    • is (Icelandic)
    • id (Indonesian)
    • it (Italian)
    • ja (Japanese)
    • ko (Korean)
    • lt (Lithuanian)
    • no (Norwegian)
    • pl (Polish)
    • pt (Portuguese)
    • ru (Russian)
    • ro (Romanian)
    • sr (Serbian)
    • sk (Slovak)
    • sl (Slovenian)
    • es (Spanish)
    • sv (Swedish)
    • th (Thai)
    • tr (Turkish)
    • vi (Vietnamese)
  • timezone

    Values used: UTC, use offset in format ±hhmm to specify other time zones.

    For instance, PST is GMT -8 so the offset in Perl format is -0800. Australian Central Daylight Time (GMT +10:30) would be +1030.

  • format_weblog_date

    Sets the tag to use the Date Format set in Weblogs → Configure → Preferences.

    Values used: 1, 0

  • format_name

    Value used: W3CDTF (format required for RSS feeds).