Manual:Extension/BlueSpiceSmartList

The extension SmartList allows to insert a list of pages in a wiki page using the tags smartlist, newbies, or toplist. The selection criteria can be set using a dialog box.

The extension SmartList allows to insert a list of pages in a wiki page using the tags smartlist, newbies, or toplist. The selection criteria can be set using a dialog box.

Available tags

Magic word smartlist in VisualEditor

The extension SmartList offers three different tags:

• <bs:smartlist /> - display a list of pages based on different criteria
• <bs:newbies /> - display a list of recentrly registered users
• <bs:toplist /> - display a list of most visited pages

All of the tags listed above can be added through the menu Insert > Magic word in VisualEditor. For more information on how to insert magic words, see InsertMagic.

Smartlist

Options of the smartlist tag

Parameters

The SmartList can be limited or extended with the following parameters:

Count -count	The number of articles to be shown. Default value: 5
Namespaces - ns	Only articles from given namespace will be listed. The namespaces can be entered by IDs or by names. Several namespaces can be named with pipes: ns="0|2|5" or ns="Help|User|Test". Default: All namespaces are included.
Exclude NS - excludens	Articles from given namespaces will not be shown. The namespaces can be entered by IDs or by names. Several namespaces can be named with pipes: ns="0|2|5" or ns="Help|User|Test". Default: All namespaces are included.
Category - cat	Only articles from given category will be listed. Selecting several categories is not possible. Default: All categories.
Show minor - nominor	Minor changes (changes marked with an "m" in the recent changes) will not be listed. Default: Minor changes are listed.
Period - period	Only changes within given period are shown. Possible values: 'month', 'week', 'day'. Default: No limit.
Show only new articles - new	Only new pages will be listed. Default: All pages are shown
Trim - trim	Long article names are not cropped. Default: The title is cut off after 30 characters.
Show text showtext	With this option, a line of the article contents will be shown alongside the title.
Trim text - trimtext	"trimtext" sets the number of characters of an article's content shown. This is only relevant when showtext="true"). Note: trimtext="0" is not possible.

Example output in source code:

<bs:smartlist mode="recentchanges" new="true" count="7" ns="104" trim="false" />

Newbies

The tag <bs:newbies /> shows recently registered wiki users.

Parameters

Count - count

The number of users to be shown; the default value is 10.

Example in wikicode

<bs:newbies count="7"/>

Toplist

This tag shows a list of the most visited pages.

Parameters

Count - count	The number of articles to be shown; the default value is 10.
Namespaces - ns	Only articles from these namespace will be shown. You can put several namespaces here, separated by commas.
Category - cat	Only articles from this category will be shown. You can put several categories here, separated by commas.
Period - period	The period that should be used (alltime or month). The default is alltime.

Example in wikicode

<bs:toplist count="7" ns="Help|QM" />

Related info

• Reference:BlueSpiceSmartList
• Reference:BlueSpiceInsertMagic