Knowledge Base / Appnel Solutions 

Feeds.App 3 Template Tags Reference

Feeds

• MTFeed uri='' [lastn='' offset='']

  A container tag that will create a context for a single syndication feed.

  This tag can takes the following attributes:

  • uri

    A required attribute that defines the location of the specific feed to display. This must be an absolute URI. Only the http, https and file protocols will be recoginzed.

  • lastn

    An optional attribute that controls the maximum number of entries to display from the feed in context. When not present this tag will use the value of the Display Entries field defined in the Feeds.App settings for the weblog.

  • offset

    An optional attribute that defines the number of entries to skip over.

• MTFeeds [file='' type='']

  A container tag that will loop through a list of feeds creating an individual context for each.

  This tag can takes the following optional attributes:

  • file

    This attribute defines a file containing a list of feeds to display. If a file name is not absolute it is assumed to be relative to the weblog's site path. When the file attribute is not present the default is to use the feeds listed in the weblogs settings.

  • type

    Used in coordination with the file attribute, type defines the format of the file being read. Recognized values are 'opml', 'csv' and 'list.' When a file attribute is present, 'list' is assumed.

  Previously this tag supported uri and collection and collection attributes. These are now deprecated. Use MTFeed instead of the uri attribute in this tag. Use file instead of collection.

• MTFeedsFooter

  A container tag that will display its contents after all feeds have been listed. This tag must be used in the context of a MTFeeds tag.

• MTFeedsHeader

  A container tag that will display its contents before any feeds have been listed. This tag must be used in the context of a MTFeeds tag.

• MTFeedsLatest [file='' type='']

  A container tag will merge and sort the entries of multiple feeds in one.

  This tag can takes the following optional attributes:

  • file

    This attribute defines a file containing a list of feeds to display. If a file name is not absolute it is assumed to be relative to the weblog's site path. When the file attribute is not present the default is to use the feeds listed in the weblogs settings.

  • type

    Used in coordination with the file attribute, type defines the format of the file being read. Recognized values are 'opml', 'csv' and 'list.' When a file attribute is present, 'list' is assumed.

Feed Elements

• MTFeedAuthors

  A container tag that will create a context for each feed author if defined.

• MTFeedAuthorEmail [spam_protect='']

  Displays the email address of the feed author in context if defined. Like other MT template tags that display an email address, the spam_protect attribute can be applied.

• MTFeedAuthorLink

  Displays a link for the feed author in context if defined.

• MTFeedAuthorName

  Displays the name of the feed author if defined. Most RSS feeds do not seperate email, link and name so it is common for this tag to display more then a name.

• MTFeedCategories [scheme='']

  A container tag that will create a context for each feed category if defined. The scheme attribute can be used to optionally select only categories with a matching scheme that Atom feeds can define.

• MTFeedCategoryLabel

  Displays a human-readable label for the category if defined.

• MTFeedCategoryScheme

  Displays the scheme URI for the category if defined.

• MTFeedCategoryTerm

  Displays the category term if defined. This tag usually return some value if a category has been defined at all.

• MTFeedContributorEmail [spam_protect='']

  Displays the email address of the feed contributor in context if defined. Like other MT template tags that display an email address, the spam_protect attribute can be applied.

• MTFeedContributorLink

  Displays a link for the feed contributor in context if defined.

• MTFeedContributorName

  Displays the name of the feed contributor if defined. Most RSS feeds do not seperate email, link and name so it is common for this tag to display more then a name.

• MTFeedContributors

  A container tag that will create a context for each feed contributor if defined.

• MTFeedIdentifier

  Displays the unique identifier for the feed.

• MTFeedLanguage

  Displays the language code for the feed if defined.

• MTFeedLink

  Displays a link in which the feed is stated to belong. When multiple links are present this tag selects the URL of the link with a relationship of 'alternate.' For the actual link of the feed see MTFeedURI or use MTFeedLinks with the rel filter.

• MTFeedLinkRelation

  Displays the relationship of the link in context if defined.

• MTFeedLinks [type='' rel='']

  A container tag that will create a context for each feed link that is defined. The list of links can be optionally filtered using the type and/or rel attributes.

  • type

    Select links whose MIME type matches this value.

  • rel

    Select links whose rel (relationship) attribute matches this value. If a link does not define a rel attribute is assumed to be 'alternate'.

• MTFeedLinkTitle

  Displays a title associated to the link if defined.

• MTFeedLinkType

  Displays the stated MIME type of the link if defined.

• MTFeedLinkURL

  Displays the URL (href attribute) of the link.

• MTFeedRights [as_text='' as_html='']

  Displays a human-readable string defining the rights for the feed. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedSubtitle

  Displays a human-readable string defining the subtitle or description for the feed. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedTitle

  Displays a human-readable title for the feed. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedUpdated [format=]

  Displays the timestamp when the feed was last said to be updated. Like other MT template tags that displays dates and times, the format attribute can be used to control the output of the timestamp.

• MTFeedURI

  Displays the actual URI of the feed in context. This may not match a link with a relationship of 'self' defined.

Feed Entries

• MTFeedEntries [lastn='' offset='']

  A container tag that will create a context for each entry in a feed.

  This tag can takes the following optional attributes:

  • lastn

    An optional attribute that controls the maximum number of entries to display from the feed in context. When not present, this tagset, depending upon its context, will use either the value of the Display Entries or the Latest Display Entry fields from the weblog's Feeds.App settings.

  • offset

    An optional attribute that defines the number of entries to skip over.

• MTFeedEntriesFooter

  A container tag that will display its contents after all feeds have been listed. This tag must be used in the context of a MTFeedsEntries tag.

• MTFeedEntriesHeader

  A container tag that will display its contents before any feeds have been listed. This tag must be used in the context of a MTFeedsEntries tag.

• MTFeedEntryAuthorEmail [spam_protect='']

  Displays the email address of the entry author in context if defined. Like other MT template tags that display an email address, the spam_protect attribute can be applied.

• MTFeedEntryAuthorLink

  Displays a link for the entry author in context if defined.

• MTFeedEntryAuthorName

  Displays the name of the entry author if defined. Most RSS feeds do not seperate email, link and name so it is common for this tag to display more then a name.

• MTFeedEntryAuthors

  A container tag that will create a context for each entry author if defined.

• MTFeedEntryCategories [scheme='']

  A container tag that will create a context for each entry category if defined. The scheme attribute can be used to optionally select only categories with a matching scheme that Atom feeds can define.

• MTFeedEntryCategoryLabel

  Displays a human-readable label for the category if defined.

• MTFeedEntryCategoryScheme

  Displays the scheme URI for the category if defined.

• MTFeedEntryCategoryTerm

  Displays the category term or 'tag'.

• MTFeedEntryContent [as_text='' as_html='']

  Displays the content of the entry if defined. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedEntryContributorEmail [spam_protect='']

  Displays the email address of the entry contributor in context if defined. Like other MT template tags that display an email address, the spam_protect attribute can be applied.

• MTFeedEntryContributorLink

  Displays a link for the entry contributor in context if defined.

• MTFeedEntryContributorName

  Displays the name of the entry contributor if defined. Most RSS feeds do not seperate email, link and name so it is common for this tag to display more then a name.

• MTFeedEntryContributors

  A container tag that will create a context for each feed contributor if defined.

• MTFeedEntryCount

  Displays the total number of entries defined in the feed.

• MTFeedEntryIdentifier

  Displays the unique identifier for the entry.

• MTFeedEntryLanguage

  Displays the language code for the entry if defined.

• MTFeedEntryLink

  Displays a link in which the feed is stated to belong. When multiple links are present this tag selects the URL of the link with a relationship of 'alternate.' For the actual link of the feed see MTFeedURI or use MTFeedLinks with the rel filter.

• MTFeedEntryLinkRelation

  Displays the relationship of the link in context if defined.

• MTFeedEntryLinks [type='' rel='']

  A container tag that will create a context for each feed link that is defined. The list of links can be optionally filtered using the type and/or rel attributes.

  • type

    Select links whose MIME type matches this value.

  • rel

    Select links whose rel (relationship) attribute matches this value. If a link does not define a rel attribute is assumed to be 'alternate'.

• MTFeedEntryLinkTitle

  Displays a title associated to the entry link if defined.

• MTFeedEntryLinkType

  Displays the stated MIME type of the entry link if defined.

• MTFeedEntryLinkURL

  Displays the URL (href attribute) of the entry link.

• MTFeedEntryPublished [format='']

  Displays the timestamp when the feed was said to been published or created. Like other MT template tags that displays dates and times, the format attribute can be used to control the output of the timestamp.

• MTFeedEntryRights [as_text='' as_html='']

  Displays a human-readable string defining the rights for the entry if defined. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedEntryTitle [as_text='' as_html='']

  Displays the title of the entry. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedEntrySourceTitle [as_text='' as_html='']

  If an entry is defined as coming from another source, this tag will display the title of the feed in which it comes from. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedEntrySourceLink

  If an entry is defined as coming from another source, this tag will display a link to the source. This is the equivalent of of feed's 'alternate' link.

• MTFeedEntrySourceFeedLink

  If an entry is defined as coming from another source, this tag will display a link to the syndication feed in which it comes from. This is the rough equivalent of of feed's 'self' link.

• MTFeedEntrySummary [as_text='' as_html='']

  Displays a summary, excerpt or description of the entry. The as_text and as_html converters can be applied to intelligently control the encoding of its content. See "Standard Type Converters" for more.

• MTFeedEntryUpdated [format='']

  Displays the timestamp when the feed was said to been last modified. Like other MT template tags that displays dates and times, the format attribute can be used to control the output of the timestamp.

Conditional Tags

• MTIfFeedCategorized

  A conditional tag that will display its contents if the feed in context has categories defined.

• MTIfFeedLinked

  A conditional tag that will display its contents if the feed in context has any links defined.

• MTIfFeedText name=''

  A conditional tag that will display its contents if the feed in context has a text element defined by the required name attribute. Recognized values for name are 'title', 'subtitle' and 'rights'.

• MTIfFeedEntryCategorized

  A conditional tag that will display its contents if the entry in context has any categories defined.

• MTIfFeedEntryLinked

  A conditional tag that will display its contents if the entry in context has any links defined.

• MTIfFeedEntryPublished [minutes= days=]

  A conditional tag that will display its contents if the feed entry in context was published in the defined period of time. A minute or days attribute is required.

• MTIfFeedEntrySourced

  A conditional tag that will display its contents if the entry in context has a source defined. All feeds created by the MTFeedsLatest tag will.

• MTIfFeedEntryText name=''

  A conditional tag that will display its contents if the entry in context has a text element defined by the required name attribute. Recognized values for name are 'title', 'summary', 'rights' and 'content'.

• MTIfFeedEntryUpdated [minutes= days=]

  A conditional tag that will display its contents if the feed entry in context has been updated in the defined period of time. A minute or days attribute is required.

• MTIfFeedsLatest

  A conditional tag that will display itself contents if used in the context of a MTFeedsLatest tagset.

• MTIfFeedUpdated [minutes= days=]

  A conditional tag that will display its contents if the feed in context has been updated in the defined period of time. A minute or days attribute is required.

Layout Tags

• MTFeedInclude uri='' [lastn='' offset='' description='']

  This tag will produce a layout of a single feed as an HTML unordered list.

• MTFeedItemInclude [description='']

  Produces a HTML list item out of the entry in context. A description (summary) can be optionally displayed using the description attribute. Recognized values are 'paragraph', 'tooltip' and 'none', the default.

• MTFeedsInclude [file='' lastn='' offset='' description='']

  This tag will produce a layout of a HTML unordered lists from multiple feeds.

• MTFeedsLatestInclude [file='' lastn='' offset='' description='' title='']

  This tag will produce a layout of multiple feeds merged and sorted into one HTML unordered list.

Miscellaneous Tags

• MTFeedsAppVersion

  Inserts the Feeds.App version number.

• MTFeedsAppSlug

  Inserts Feeds.App and version number that is linked to the plugins home page.

Deprecated Tags

• MTFeedIf

  This tag has been broken into multipel tags. See "Conditional Tags".

• MTFeedDescription

  Use MTFeedEntryContent instead.

• MTFeedCreatorEmail

  Use MTFeedAuthorEmail instead.

• MTFeedCreatorLink

  Use MTFeedAuthorLink instead.

• MTFeedCreatorName

  Use MTFeedAuthorName instead.

• MTFeedCreatorName

  Use MTFeedAuthorName instead.

• MTFeedModified

  Use MTFeedUpdated instead.

• MTFeedEntryModified

  Use MTFeedEntryUpdated instead.

• MTFeedEntryCreated

  No equivalent. Inserts a blank.

• MTFeedEntryIssued

  Use MTFeedEntryPublished instead.

• MTFeedEntrySourceName

  Use MTFeedEntrySourceTitle instead.

• MTFeedsVersion

  Use MTFeedsAppVersion instead.

• MTFeedsVersionSlug

  Use MTFeedsAppSlug instead.

• MTFeedsIncludeLatest

  Use MTFeedsLatestInclude instead.