Module articles
Use the Articles module to include a list of articles in a wiki page. Unlike the last_articles and top_articles modules and the plugin PluginArticles, the Articles module will show only the article's title.

Parameters

Lists the specified number of published articles in the specified order.

Go to the source code
Preferences required: feature_articles

Parameters	Accepted Values	Description
`absurl`		If set to "y", some of the links use an absolute URL instead of a relative one. This can avoid broken links if the module is to be sent in a newsletter, for example. Default: "n".
`langfilter`		If set to a language code, only lists the articles in the specified language. Example values: en, fr. Not set by default.
`topic`		If set to a list of article topic names separated by plus signs, only lists the articles in the specified article topics. If the string is preceded by an exclamation mark ("!"), the effect is reversed, i.e. articles in the specified article topics are not listed. Example values: Switching to Tiki, !Switching to Tiki, Tiki upgraded to version 6+Our project is one year old, !Tiki upgraded to version 6+Our project is one year old+Mr. Jones is appointed as CEO. Not set by default.
`type`		If set to a list of article type names separated by plus signs, only lists the articles of the specified types. If the string is preceded by an exclamation mark ("!"), the effect is reversed, i.e. articles of the specified article types are not listed. Example values: Event, !Event, Event+Review, !Event+Classified+Article. Not set by default.
`img`	int	If set, displays an image for each article if one applies, with the given width (in pixels). The article's own image is used, with a fallback to the article's topic image. Not set by default.
`more`	word	If set to "y", displays a button labelled "More" that links to a paginated view of the selected articles. Default: "n".
`start`	int	If set to an integer, offsets the articles list by the given number. For example, if the module was otherwise set to list the 10 articles most recently published, setting the offset to 10 would make the module list the 11th to 20th articles in descending order of publication time instead. Default value: 0
`showcreated`	word	If set to "y", article creation times are shown. Default: "n".
`showpubl`	word	If set to "y", article publication times are shown. Default: "n".
`show_rating_selector`	word	If set to "y", offers the user to filter articles based on a minimum and a maximum rating. Default: "n".
`sort`	any string except for HTML and PHP tags	Specifies how the articles should be sorted. Possible values include created and created_asc (equivalent), created_desc, author, rating, topicId, lang and title. Unless "_desc" is specified, the sort is ascending. "created" sorts on article creation date. Default value: publishDate_desc
`topicId`		If set to a list of article topic identifiers separated by plus signs, only lists the articles in the specified article topics. If the string is preceded by an exclamation mark ("!"), the effect is reversed, i.e. articles in the specified article topics are not listed. Example values: 13, !13, 1+3, !1+5+7. If set to 0, will take the topicId of the article if in an article. Not set by default.
`categId`	int	If set to a category identifier, only lists the articles in the specified category. Example value: 13. Not set by default.

Usage

To use the Articles module in a wiki page:

Copy to clipboard

{MODULE(module=articles,max=XXX,topic=XXX) /}

If you want to show all the articles of the topic a or the topic b, tou need to use topic=a+b. If you want not to display the articles except those with topic a or b, you need to use topic=!a+b. The same feature and syntax applies for topicId and type.

Example

This code:

Copy to clipboard

{BOX(bg=>white)}{MODULE(module=articles, more=y, max=5, start=1, title=Most Recent Articles, topic=!News+Help Wanted) /}{BOX}

Produces on this site:

Most Recent Articles
Come in a decide on Documentation issues! Motions passed and defeated from the last EBM December EB Meeting Underway August EB Meeting Underway July 2007 Editorial Board Meeting Underway More...	Note that article types News and Help Wanted are excluded, the first article of an included type is skipped, and a custom title is used. Click on the "More..." link for the complete list of articles to see how the articles were filtered.

See these pages for information that applies for all modules:

Module — Overall introduction and overview
Module Admin — Introduction to the module admin pages for site-wide and individual module settings
- Assigning Modules — How to select a module to configure it
- Module Settings Interface — Interface for configuring individual module settings
- Module Settings Parameters — Explanation of standard parameter settings for modules
- Creating Custom Modules — How to create user modules
Index of Modules — Links to the documentation of individual modules
User Modules — How (if the feature is active) users can choose and place their modules
Mods Type Modules — Links to modules that are installed as components

Module articles

Parameters

Usage

Example

Most Recent Articles

Related Pages