Last edited one month ago
by Margit Link-Rodrigue

Manual:Extension/BlueSpiceSmartList and MediaWiki:Tabberneue-tabbertransclude-category: Difference between pages

(Difference between pages)
VisualWikitext
No edit summary
 
(Created page with "-")
Tag: 2017 source edit
 
Line 1: Line 1:
{{DISPLAYTITLE:Generate page lists (smart lists)}}
-
 
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 includes three different tags:
 
*<code><nowiki><bs:smartlist /></nowiki></code> / <code><nowiki><recentchanges /></nowiki></code> - display a list of pages that were edited in the last 90 days. It can be filtered by namespaces or categories.
**Different modes are possible if the <code><nowiki><bs:smartlist /></nowiki></code> tag is added in source edit mode.
*<code><nowiki><bs:newbies /></nowiki></code> - display a list of recently registered users.
*<code><nowiki><bs:toplist /></nowiki></code> - display a list of most visited pages.
 
The tags can be added as content droplets. {{Bsvs|bsvFrom=4.3}}. Earlier BlueSpice versions contained the menu item ''Insert > Magic word''  in [[Manual:Extension/VisualEditor|VisualEditor]]. {{Bsvs|bsvTo=4.3}}
 
==Smartlist==
The  <code><nowiki><bs:smartlist /></nowiki></code>  tag shows a list of recently changed pages (<90 days) by default.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
The list can be inserted in source edit mode or as a content droplet, in which case it shows up as <code><nowiki><recentchanges /></nowiki></code> tag in the page source..{{Bsvs|bsvFrom=4.3}}
 
In source edit mode, the smartlist tag (not the ''recentchanges'' tag!) additionally accepts the parameter ''mode'' with the following values:
 
* mode=stablepages
 
*mode=whatlinkshere
[[File:Manual:Smartlist3.png|alt=Options of the smartlist tag|center|thumb|325x325px|ptions of the ''smartlist'' tag]]
===Parameters===
The SmartList can be limited or extended with the following parameters:
 
{| class="contenttable" style="width:100%;" cellspacing="0" cellpadding="5" border="0"
|Label
|Parameter
|Values
|Description
|-
| style="" |
Count
|'''count'''
|number
| style="" |
The number of articles to be shown. Default value: 5
 
|-
| style="" |
Namespace(s)
|'''ns'''
|number or name
| style="" |
Only articles from given namespace will be listed. The namespaces can be entered by IDs or by names. Several namespaces can be separated with commas: ns="0,2,5" or ns="Help,User,Test". Default: All namespaces are included.
 
'''Note:''' Only content namespaces are included in the list.
 
|-
| style="" |
Category
|'''cat'''
|name
| style="" |
Only articles from given category will be listed. Selecting several categories is not possible. Default: All categories.
 
|-
| style="" |
Category mode
|'''catmode'''
|AND, OR
| style="" |
Show pages  if they are in at least one of the categories (OR) or show pages if they are tagged with all categories (AND).
 
|-
| style="" |
Show minor
|'''minor'''
|true, false
| style="" |
Minor changes (changes marked with an "m" in the recent changes) will not be listed. Default: Minor changes are listed.
 
|-
| style="" |
Period
|'''period'''
| -, month, week, day
| style="" |
Only changes within given period are shown. Default: No limit.
 
|-
| style="" |
Show only new articles
|'''new'''
|true, false
| style="" |
Only new pages will be listed. Default: All pages are shown
|-
|Heading
|'''heading'''
|text
|Adds a heading above the list
|-
|Sort by
|'''sort'''
|Title, Time
|Sort results by title or by latest edited.
|-
|Sort order
|'''order'''
|asc, desc
|Ascending or descending sort order.
|-
| style="" |
Trim
|'''trim'''
|number
| style="" |
Long article names are not cropped. Default: The title is cut off after 30 characters.
 
|-
| style="" |
Show text
|'''showtext'''
|true, false
| style="" |
With this option, a line of the article contents will be shown alongside the title.
 
|-
| style="" |
Trim text
|'''trimtext'''
|number
| style="" |
"trimtext" sets the number of characters of an article's content shown. This is only relevant when ''showtext="true"''). ''Note'': trimtext="0" is <u>not</u> possible.
|-
|Show namespaces
|'''showns'''
|true, false
|If true, the namespace prefix is shown with the page names.
|-
|Number with text
|'''numwithtext'''
|number
|Anzahl der Artikel die mit Einführungstext angezeigt werden sollen. Nur effektiv wenn ''showtext=true''
|-
|Meta
|'''meta'''
|true
|The username and date for the last edit are shown.
|-
|Target
|'''target'''
| -
|Obsolete
|-
| style="" |
Exclude namespace(s)
|'''excludens'''
|number or name
| style="" |
Articles from given namespaces will not be shown. The namespaces can be entered by IDs or by names (comma-separated). Default: All namespaces are included.
 
|}
 
=== Wikitext editing ===
Here you see a syntax example with some parameters. These can only be added in source edit mode.
 
15 of the pages from the category ''ISO9001'' that were changed in the last 90 days are displayed in alphabetical order.
<pre><bs:smartlist sort="title" cat="ISO9001" count="15" heading="Pages about ISO 9001" / ></pre>
If the approval feature is activated, the list can be set to include the latest [[Manual:Extension/ContentStabilization|approved pages]] (instead of edited pages:
<pre><bs:smartlist period="week" sort=" time" showns="0" mode="stablepages" count="8" /></pre>
Alternatively, the smartlist can also display a list of pages that link to a wiki page. The corresponding page name is specified as <code>target</code>:<pre>
<bs:smartlist mode="whatlinkshere" target="Main Page" /></pre>
 
 
==Newbies==
The tag <code><nowiki><bs:newbies /></nowiki></code> shows  recently registered wiki users.
===Parameters===
 
{| class="contenttable" style="width:100%;" cellspacing="0" cellpadding="5" border="0"
|Label
|Parameter
|Values
|Description
|-
| style="" |
Count - '''count'''
|
|
| style="" |
The number of users to be shown; the default value is 10.
 
|}
 
===Example in wikicode===
<pre><bs:newbies count="7"/></pre>
 
==Toplist==
This tag shows a list of the most visited pages.
 
<recentchanges count="4" period="-" sort="time" showns="1" ns="user,manual" cat="Organization" />
 
===Parameters===
 
{| class="contenttable" style="width:100%;" cellspacing="0" cellpadding="5" border="0"
!Label
!Paramter
!Values
!Description
|-
| style="" |
Count
|'''count'''
|number
| style="" |
The number of articles to be shown; the default value is 10.
 
|-
| style="" |
Namespaces
|'''ns'''
|text, text
| style="" |
Only articles from these namespace will be shown. You can put several namespaces here, separated by commas.
 
|-
| style="" |
Category
|'''cat'''
|text, text
| style="" |
Only articles from this category will be shown. You can put several categories here, separated by commas.
 
|-
| style="" |
Period
|'''period'''
|month, alltime
| style="" |
The period that should be used. The default is alltime.
 
|}
 
===Example in wikicode===
<pre><bs:toplist count="7" ns="Help|QM" /></pre>
 
{{Translation}}
__FORCETOC__
 
[[Category:Organization]]

Latest revision as of 09:54, 16 April 2024

-

Technical Reference: BlueSpiceSmartList


To submit feedback about this documentation, visit our community forum.

Retrieved from "https://en.wiki.bluespice.com/w/index.php?title=Manual:Extension/BlueSpiceSmartList&oldid=8586"
No categories assignedEdit

Discussions