related_articles
Attributes:
- section="section name" • Restrict to articles from specified section. Default is unset.
- match="value" • Restrict to articles related by specified category. Available values: Category1, Category2, Category1,Category2. Default is Category1,Category2.
- form="form name" • Use specified form. Default is unset.
- no_widow="boolean" • Whether to inhibit line breaks in titles which would leave just a single word on the last line (widows). Default is set in Preferences.
- 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.
- limit="integer" • Number of articles to display. Default is 10.
- label="text" • Label for the top of the list. Default is unset.
- labeltag="tag" • (X)HTML tag (without brackets) to wrap around label. Default is unset.
- wraptag="tag" • (X)HTML tag (without brackets) to wrap around list. Default is unset.
- break="value" • (X)HTML tag (without brackets) or string used to separate list items. Default is br.
- class="class name" • (X)HTML class attribute to be applied to wraptag. Default is related_articles.
Behaviors:
The related_articles tag can be used as either a single or container tag which returns a list of permanent links to related articles. Wrapped content will be treated the same as would form content, and can include article form tags.
Related matches are selected as follows:
- If a match to Cat1 or Cat2 of the individual article being displayed is found in either Cat1 or Cat2 of any other article in the database, it will cause that article to be listed as related.
- If Cat1 of the individual article being displayed is left blank and Cat2 is not blank, then all other articles are selected as being related.
- If both Categories are left blank, then no articles are selected.