Generating page lists (smart lists)
-
- Last edited 4 years ago by MLR
-
Contents
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
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
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" />