BlueSpiceSmartList
-
- Last edited 5 years ago by Lsireta
-
Contents
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
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
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
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
Our reference page.