The article_custom tag is a Single Tag which provides a variety of custom options for article sorting, selecting, and display. Textpattern will replace this tag with one or more articles.
Unlike txp:article, article_custom will always return an article list, and is not context-sensitive. This means that, while txp:article can only see posts within the currently viewed section/category/author, etc, article_custom can see all posts from all sections, categories and authors, unless you restrict it via attributes (see below), and that context-sensitive navigation tags, such as txp:older and txp:newer, will not work.
The article_custom tag has the following syntactic structure…
<txp:article_custom />
Tag will accept the following attributes (case-sensitive):
Display specific article.
Restrict to articles with specified value for specified custom field name. Replace “customfieldname” with the name of the custom field. Default is unset.
Restrict to articles from specified section. Default is unset, retrieves from all sections.
Restrict to articles from specified category. Default is unset, retrieves from all categories.
Restrict to articles with specified keyword(s). Default is unset.
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).
Restrict to articles with specified status. Available values: draft, hidden, pending, live, sticky. Default value is live.
Restrict to articles posted within specified timeframe. Available values: past, future, or any (both past and future). Default is past.
Restrict to articles posted within the specified month. Default is unset.
Restrict to articles by specified author. Default is unset.
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.
The number of articles to skip. Default is 0.
The number of articles to display. Default is 10.
Whether to use override forms for the generated article list. Default is 0 (no).
Use specified form. Default is default.
<txp:article_custom form="month_list" sort="Section asc" month="2004-10" />
<txp:article_custom sort="Posted desc" keywords="One" />
<txp:article_custom form="author_list" author="Parkling" />
the author_list article form might go thus.
<p><txp:permlink><txp:title /></txp:permlink></p><
<txp:article_custom colour="red" />
<txp:article_custom sort="AuthorID asc, Posted asc" />