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 criteria.

Available tags

Available tags in "Insert magic" dialog

BlueSpiceSmartList offers three different tags:

• <bs:smartlist /> - main tag used to display list of pages based on various criteria
• <bs:newbies /> - displays list of recentrly registered users
• <bs:toplist /> - displays 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 VisualEditor. For more information on how to insert magic words, see BlueSpiceInsertMagic.

Tag <bs:smartlist>

Options of bs:smartlist tag

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

• 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".

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 in wikicode

Of course, bs:smartlist tag can be added directly into wikitext:

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

Tag <bs:newbies>

The

<bs:newbies/>

tag shows the recently registered members on the wiki.

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>

Options of bs:toplist tag

This tag shows list of 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" />

See also

Reference page for this extension.

Related info

• Reference:BlueSpiceSmartList