Manual:Extension/BlueSpiceSmartList

What is BlueSpiceSmartList?

BlueSpiceSmartList introduces a number of tags that can be placed on any page to show a list of most relevant pages based on different criteriaThe 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

BlueSpiceSmartList

Magic word smartlist in VisualEditor

The extension SmartList offers three different tags:

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

Where to find the function BlueSpiceSmartList?

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

Tag <bs:smartlist>Smartlist

Once

• Recentchanges - shows the most recent changes. This is the default option.
• Changesofweek - shows the articles which have been chosen as a "Change of the week".

Options of the

tag is added to the page, configuration dialog (inspector) is shown. Two modes for showing pages are offered:

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 wikicodeOf course, bs:smartlist tag can be added directly into wikitext: source code:

<bs:smartlist

mode="recentchanges"

new="true"

count="7"

ns="104"

trim="false"

/>

Tag <bs:newbies>Newbies

The

tag <bs:newbies />

tag

shows

the

recently registered

members on the

wiki users.

Parameters

Count - count

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

Example in wikicode

<bs:newbies count="7"/>

Tag <bs:toplist>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