|
|
| Line 1: |
Line 1: |
| {{DISPLAYTITLE:Generate page lists (smart lists)}} | | {{BSExtensionInfobox |
| | | |desc=Create and manage blacklists based on URL patterns to avoid spam in the wiki. |
| 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.
| | |status=stable |
| | | |developer=Tim Starling |
| {{Messagebox|boxtype=note|icon=|Note text=Smart lists will only include pages that have been created or edited within the last 90 days. If you need to show all pages instead of recent pages, use an [[SMW queries|SMW query]] instead.|bgcolor=}}
| | |type=MediaWiki |
| | | |edition=BlueSpice free (deactivated), BlueSpice pro (deactivated), BlueSpice Farm (deactivated) |
| ==Available tags==
| | |compatible=MediaWiki |
| [[File:Smartlist2.png|Magic word ''smartlist'' in VisualEditor|alt=Magic word smartlist in VisualEditor|center|450x450px|thumb]]
| | |category=Security |
| | | |license=GPL v2+ |
| | | |docu=https://www.mediawiki.org/wiki/Extension:SpamBlacklist |
| The extension SmartList offers three different tags:
| | |features= |
| | | '''SpamBlacklist''' prevents edits that contain URLs whose domains match regular expression patterns defined in specified files or wiki pages. When someone tries to save a page, SpamBlacklist checks the text against a (potentially very large) list of illegal host names. If there is a match, the extension displays an error message to the user and refuses to save the page. |
| *<code><nowiki><bs:smartlist /></nowiki></code> - display a list of pages based on different criteria
| | }} |
| *<code><nowiki><bs:newbies /></nowiki></code> - display a list of recentrly registered users
| | {{wcagCheck |
| *<code><nowiki><bs:toplist /></nowiki></code> - display a list of most visited pages
| | |wcagStatus=2-testing complete |
| | | |wcagCheckedfor=Authoring tool |
| All of the tags listed above can be added through the menu ''Insert > Magic word'' in [[Manual:Extension/VisualEditor|VisualEditor]]. For more information on how to insert magic words, see [[Manual:Extension/BlueSpiceInsertMagic|InsertMagic]].
| | |wcagTestdate=2022-08-05 |
| | | |wcagLevel=AA |
| ==Smartlist==
| | |wcagSupport=supports |
| [[File:Manual:Smartlist3.png|alt=Options of the smartlist tag|center|thumb|325x325px|ptions of the ''smartlist'' tag]]
| | |wcagComments=allows to create text-based blocking lists in the MediaWiki namespace. |
| | | |extensionType=core |
| ===Parameters===
| | |extensionFocus=admin |
| 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 named with pipes: ns="0|2|5" or ns="Help|User|Test". Default: All namespaces are included.
| |
| | |
| |- | |
| | 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.
| |
| | |
| |}'''Example output in source code:'''
| |
| <nowiki><bs:smartlist category="ISO9001" new="true" count="7" ns="104" trim="false" /></nowiki>
| |
| ==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.
| |
| | |
| ===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>
| |
| | |
| | |
| {{Box Links-en|Topic1=[[Reference:BlueSpiceSmartList]]|Topic2=[[Reference:BlueSpiceInsertMagic]]}}
| |
| | |
| {{Translation}}
| |
| __FORCETOC__
| |
| | |
| [[Category:Organization]]
| |
Discussions