Loading...
 

Plugin Articles

Use this wiki plugin, available since Tiki1, to include any number of articles into a wiki page. For a plugin that includes components of a single article, see PluginArticle. This is particularly useful if you want to include the top 2 articles into your homepage, but being anyway able to write some custom Wiki text. For a quick summary of a list of articles you can also use PluginModule to display Module last_articles.

Parameters

Display multiple articles
Introduced in Tiki 1.
Go to the source code
Preferences required: feature_articles, wikiplugin_articles

Parameters Accepted Values Description Default Since
urlparam text 6.0
periodQuantity digits Numeric value to display only last articles published within a user defined time-frame. Used in conjunction with the next parameter "Period unit", this parameter indicates how many of those units are to be considered to define the time frame. If this parameter is set, "Start Date" and "End Date" are ignored. 1
dateEnd date Latest date to select articles from. (YYYY-MM-DD) 5.0
lang lang List only articles in this language 1
max int The number of articles to display in the list (use -1 to show all) 50 1
translationOrphan alpha
separator: |		 User- or pipe-separated list of two-letter language codes for additional languages to display. List pages with no language or with a missing translation in one of the language 1
periodUnit (blank)
hour
day
week
month		 Time unit used with "Period quantity" 1
order digits
separator: |		 List of ArticleId that must appear in this order if present 9.0
dateStart date Earliest date to select articles from. (YYYY-MM-DD) 5.0
start int The article number that the list should start with (starts with first article by default). This will not work if Pagination is used. 0 1
categId digits
separator: |		 Filter articles by category. You can select multiple categories from the dropdown. Only articles in all selected categories will be listed. 1
containerClass CSS class to add to the containing "div.article" (default: "wikiplugin_articles") wikiplugin_articles 1
largefirstimage (blank)
y
n		 If set to y (Yes), the first image will be displayed with the dimension used to view of the article n 6.0
notArticleId digits
separator: |		 List of article IDs to not display, separated by "%0" 5.0
articleId digits
separator: |		 List of article IDs to display, separated by "|" 9.0
overrideDates (blank)
y
n		 Whether to comply with the article type's "show before publish" settings (not complied with by default) n 1
quiet (blank)
y
n		 Whether to not report when there are no articles (no reporting by default) n 1
fullbody (blank)
y
n		 Whether to show the body of the articles instead of the heading (not set by default). n 5
actions (blank)
y
n		 Whether to show the buttons and links to do actions on each article (for the actions you have permission to do n 6.1
sort publishDate_desc| publishDate_asc| title_asc| title_desc| authorName_asc| authorName_desc| articleId_asc| articleId_desc| topicName_asc| topicName_desc| created_desc| created_asc| lang_asc| lang_desc| random Choose how to sort the articles. Default is by publication date (newest first). publishDate_desc 2.0
titleonly (blank)
y
n		 Whether to only show the title of the articles (not set to title only by default) 1
usePagination (blank)
y
n		 Activate pagination when the articles list is long. Default is n n 1
useLinktoURL (blank)
y
n		 Use the external source URL as link for articles. n 1
topicId
separator: +		 Filter articles by topic. You can select multiple topics from the dropdown. Use negation (e.g., !topic1+topic2) to exclude articles from specific topics. 2.0
type
separator: +		 Filter the list of articles by types. Example: !type+type+type 1

Fields displayed with the articles (author, nb of views, etc.)

To choose which fields to display on top of each article, go to Control panels - Articles - Article Types and tick/untick the choosen field -see https://doc.tiki.org/Articles+Listing

Example

In this example below, a wiki page is shown including the articles plugin, so that last articles are shown below the "! News" heading of the page.

This code:

Copy to clipboard
{articles max="5" topicId="!5"}

Produced:

Image

When topic="!New+Events', only the articles that have not a topic News or a topic Events will be displayed. You can put as many topics you want by separating them with the character '+'.The character '!' means not - It can be only on first place. Do not put space around the separator.

Multilingualism

The multilinguism is managed on 2 aspects:

  • If you have selected the multilingualism and best_language features, and when this plugin is inserted in a page that has a defined language, some articles can be filtered out. For each set of translations, when one article of this set has the same language as the page language, only this article in the set will be displayed. Please note that you can still see an article of another language, if this article is not in a set of translations or if this set of translations has no article in the page language.
  • If you use the parameter lang, only the articles in this language will be shown