Home

article_custom

Attributes:

• id="article ID number" • Display specific article.
• customfieldname="value" • Restrict to articles with specified value for specified custom field name. Replace "customfieldname" with the name of the custom field. Default is unset.
• section="section name" • Restrict to articles from specified section. Default is unset, retrieves from all sections.
• category="category name" • Restrict to articles from specified category. Default is unset, retrieves from all categories.
• keywords="keyword(s)" • Restrict to articles with specified keyword(s). Default is unset.
• excerpted="value" • Restrict to articles with/without an excerpt. Available values: y (yes, return only those containing an excerpt) or n (no, return all). Default is n (no, return all).
• status="status" • Restrict to articles with specified status. Available values: draft, hidden, pending, live, sticky. Default value is live.
• time="time" • Restrict to articles posted within specified timeframe. Available values: past, future, or any (both past and future). Default is past.
• month="yyyy-mm" • Restrict to articles posted within the specified month. Default is unset.
• author="author's name" • Restrict to articles by specified author. Default is unset.
• sort="sort value(s)" • How to sort resulting list. Available values: ID (article id#), AuthorID (author), LastMod (date last modified), LastModID (author of last modification), Posted (date posted), Title, Category1, Category2, comments_count, Status, Section, Keywords, Image (article image id#), url_title, custom_1 through custom_10, rand() (random). Default is Posted desc.
• offset="integer" • The number of articles to skip. Default is 0.
• limit="integer" • The number of articles to display. Default is 10.
• allowoverride="boolean" • Whether to use override forms for the generated article list. Default is 0 (no).
• form="form name" • Use specified form. Default is default.

Behaviors:

The article_custom tag can be used as either a single or container tag. When used as a container tag, wrapped content will be used as though it were the defined form content. It provides a variety of custom options for sorting, selecting, and displaying articles. Unlike the article tag, article_custom will always return an article list and is not context-sensitive. This means while the article tag can only see posts within the currently viewed section/category/author and so forth, article_custom can see all posts from all sections, categories and authors unless you restrict it via attributes, thus context-sensitive navigation tags, such as older and newer, will not work.