Cookie consent settingsAccept all
Discussion

Difference between revisions of "Manual:Extension/BlueSpiceSmartList"

[unchecked revision][unchecked revision]
m (Text replacement - "[[Rating" to "[[Reference:Rating")
(Tag: 2017 source edit)

What is SmartListBlueSpiceSmartList?[edit | edit source]

SmartList BlueSpiceSmartList introduces a tag number of tags that can be placed on any page to show a list of most relevant pages . Type of content it will display, as well as number of entries can be configured using different options in the tag. based on different criteria.

Available tags[edit | edit source]

Available tags in "Insert magic" dialog

BlueSpiceSmartList offers three different tags:

- main tag used to display list of pages based on various criteria
  1. Main Page (3453902)
  2. Setup:Installation Guide (206124)
  3. Reference:FlexiSkin (114326)
  4. Help categories (109476)
  5. Reference:BlueSpiceCountThings (104213)
  6. Archive:PasteImage (101064)
  7. Reference:BlueSpiceAuthors (93961)
  8. Wiki (93621)
  9. Archive:Preferences (81211)
  10. Blog (78327)
- displays list of most visited pages

Where to find the function

SmartListRecentchanges or Changesofweek

It is possible to integrate SmartList into an article, the widget bar or the user sidebar.

SmList1.jpg
SmList2.jpg
Save page:
SmList3.jpg

There are two basic options which you can choose using the parameter "mode":

  • Recentchanges
    Options of bs:smartlist tag

    Once the tag is added to the page, configuration dialog (inspector) is shown. If offers configuring:

    • mode - criteria by which to retrieve pages displayed
      • 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".

Example: 

                <smartlist mode="changesofweek" />

Note: The relevant Hallo Welt extension must be activated to use 'changesofweek'.

  • Parameters

for 'recentchanges'

  • [edit | edit source]

    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

these

  • given namespace will be listed. The namespaces can be entered

numerically

  • by IDs or by names. Several namespaces can be named with

commas

  • pipes: ns="0

,

  • |2

,

  • |5" or ns="Help|User|Test". Default:

No limit

  • All namespaces are included.

    Exclude NS - excludens

    Articles from

these

  • given namespaces will not be shown.

At the moment, the

  • The namespaces can be entered

numerically

  • by IDs or by names. Several namespaces can be named with

commas

  • pipes:

excludens

  • ns="0

,

  • |2

,

  • |5" or ns="Help|User|Test". Default:

No limit

  • All namespaces are included.

    Category - cat

    Only articles from

this

  • given category will be listed. Selecting several categories is not possible. Default:

No limit

  • 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

this

  • 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

at

  • after 30 characters.

    Show text showtext

    With this option, a line of the article contents will be shown alongside the title

: showtext="true" This SmartList lists the seven newest articles from a particular namespace without shortening their titles. Parameters for 'changesofweek'

  • .

    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.

The parameters are added to the tag.
Example: 

                <smartlist new="true" count="7" ns="104" trim="false" />
What links here

count

The number of articles to be shown. Default value: 5

period

Only changes within this period are shown. Possible values: 'month', 'week', 'day'. Default: No limit.

Example: 

                <smartlist mode="changesofweek" count="10" />
The number of articles

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

    BlueSpiceSmartList - Error
    The given namespace is invalid: 104.


    Tag bs:newbies[edit | edit source]

A smartlist with the mode mode="whatlinkshere" shows all sites that link to this site - if you don't define a special site through "target" then smartlist will show all links to the page the smartlist-tag is used at. You can use all parameters of the mode 'recentchanges'.

Additional parameters for 'whatlinkshere'[edit | edit source]
target page title - default: site on which the tag is used.

Example: 

                <bs:smartlist mode="whatlinkshere" target="Portal:Test" count="7" ns="0" trim="false"/>

SmartList in the widgets[edit | edit source]

The SmartList in the widgets can only changed by an admin under Preferences.

Ratings[edit | edit source]

If the extension Ratings integrated into the wiki, an overview of the most commonly evaluated pages can be inserted in the wiki code where you want (e.g. the start page) using SmartList. This happens via the wiki tag <smartlist mode="ratings" />. This will show the pages which have been evaluated most often. It does not matter whether they have had positive or negative evaluations. Only the amount of evaluations made is important.

The SmartList of the pages evaluated also has some parameters for customisation:

count

5.

ns

Only articles from these namespace which have been evaluated will be listed.

excludens

No articles from this namespace will be listed.

showtext

With this option, a line of the article contents will be shown alongside the title. (showtext="true")

trimtext

Limits the number of characters shown of the article's contents. (trimtext="50")

showvotes

The number of evaluations made is given alongside the title. (showvotes="true")

Example: 

                <smartlist mode="ratings" count="9" showtext="true" />
In this example, 9 articles will be listed which have been evaluated most often. At the same time, a line of each article will be shown. ApprovalFurther functions

An example for displaying approvals (the right extension is needed): 

                <smartlist mode="flaggedrevisions" ns="502" count="7"/>

Most clicked article[edit | edit source]

The <bs:toplist /> tag creates a list of the most clicked articles in the wiki.

The following are possible parameters:

  • Options of bs:toplist tag

    This tag shows list of most visited pages.

    Parameters[edit | edit source]

    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.

New members

The<bs:newbies/> tag shows the newest members of the wiki.

The following are possible parameters:

count

The number of members to be shown; the default value is 10. 

<bs:bookshelf src="Book:User manual" />
        
        
        
        __TOC__
        
        
        
        ==What is SmartList?==
            
            
            
            '''SmartList''' introduces a tag BlueSpiceSmartList?==
            
            
            
            '''BlueSpiceSmartList''' introduces a number of tags that can be placed on any page to show a list of most relevant pages. Type of content it will display, as well as number of entries can be configured using different options in the tag.
            
            
            
            
         based on different criteria.
            
            
            
            ==Available tags==
            
            [[File:Smartlist2.png|thumb|Available tags in "Insert magic" dialog]]
            
            BlueSpiceSmartList offers three different tags:
            
            * <code><bs:smartlist /></code> - main tag used to display list of pages based on various criteria
            
            * <code><bs:newbies /></code> - displays list of recentrly registered users
            
            * <code><bs:toplist /></code> - displays list of most visited pages
            
            
            
            
        ==Where to find the function SmartList?==
            
            
            
            It is possible to integrate SmartList into an article, the widget bar or the user sidebar.
            
            
            
            ::: [[File:SmList1.jpg|500x307px]]
            
            
            
            
            
            ::: [[File:SmList2.jpg|500x307px]]
            
            
            
            
            
            '''Save page''':
            
            
            
            
            
            ::: [[File:SmList3.jpg|500x302px]]
            
            
            
            ==Recentchanges or Changesofweek==
            
            There are two basic options which you can choose using the parameter "mode":
            
            
            
            * '''Recentchanges''' BlueSpiceSmartList?==
            
            
            
            All of the tags listed above can be added through "Insert magic" menu of [[Manual:Extension/VisualEditor|VisualEditor]]. For more information on how to insert magic words, see [[Manual:Extension/BlueSpiceInsertMagic|BlueSpiceInsertMagic]].
            
            
            
            ==Tag bs:smartlist==
            
            [[File:Smartlist3.png|thumb|Options of bs:smartlist tag]]
            
            Once the tag is added to the page, configuration dialog (inspector) is shown. If offers configuring:
            
            * mode - criteria by which to retrieve pages displayed
            
            ** 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".
        
        
        
        
        '''Example''':
            
            
            
            
            <pre><smartlist mode="changesofweek" /></pre>
            
            
            
            '''Note''': The relevant Hallo Welt extension must be activated to use 'changesofweek'.
            
            
            
            ===Parameters for 'recentchanges'===Parameters===
        
        The SmartList can be limited or extended with the following parameters:
        
        
        
        {| class="contenttable" style="width: 531px; height: 373px;" cellspacing="0" cellpadding="5" border="0"
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Count -'''count'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        The number of articles to be shown. Default value: 5
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Namespaces - '''ns'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Only articles from thesegiven namespace will be listed. The namespaces can be entered numerically by IDs or by names. Several namespaces can be named with commaspipes: ns="0,|2,|5". Default: No limit or ns="Help|User|Test". Default: All namespaces are included.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Exclude NS - '''excludens'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Articles from thesegiven namespaces will not be shown. At the moment, the The namespaces can be entered numerically by IDs or by names. Several namespaces can be named with commas: excludenspipes: ns="0,|2,|5". Default: No limit or ns="Help|User|Test". Default: All namespaces are included.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Category - '''cat'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Only articles from thisgiven category will be listed. Selecting several categories is not possible. Default: No limitAll categories.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Show minor - '''nominor'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Minor changes (changes marked with an "m" in the recent changes) will not be listed. Default: Minor changes are listed.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Period - '''period'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Only changes within thisgiven period are shown. Possible values: 'month', 'week', 'day'. Default: No limit.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Show only new articles - '''new'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Only new pages will be listed. Default: All pages are shown
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Trim - '''trim'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Long article names are not cropped. Default: The title is cut off atafter 30 characters.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Show text '''showtext'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        With this option, a line of the article contents will be shown alongside the title: showtext="true".
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Trim text - '''trimtext'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        "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.
        
        
        
        |}
        
        
        The parameters are added to the tag.<br />'''Example''':
            
            
            
            
            <pre><smartlist new="true" count="7" ns="104" trim="false" /></pre>
            
            
            <br /> This SmartList lists the seven newest articles from a particular namespace without shortening their titles.
            
            
            
            ===Parameters for 'changesofweek'===
            
            {| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''count'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            The number of articles to be shown. Default value: 5
            
            
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''period'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            Only changes within this period are shown. Possible values: 'month', 'week', 'day'. Default: No limit.
            
            
            
            |}
            
            
            
            '''Example''':
            
            
            
            
            <pre><smartlist mode="changesofweek" count="10" /></pre>
            
            
            
            ===What links here===
            
            A smartlist with the mode <code>mode="whatlinkshere"</code> shows all sites that link to this site - if you don't define a special site through "target" then smartlist will show all links to the page the smartlist-tag is used at. You can use all parameters of the mode 'recentchanges'.
            
            
            
            ===Additional parameters for 'whatlinkshere'===
            
            {| class="contenttable-black"
            
            |-
            
            | style="border: 1px solid #ebecec;"|'''target'''
            
            | style="border: 1px solid #ebecec;"|page title - default: site on which the tag is used.
            
            |}
            
            '''Example''':
            
            
            
            
            <pre><nowiki><bs:smartlist mode="whatlinkshere" target="Portal:Test" count="7" ns="0" trim="false"/></nowiki></pre>
            
            
            
            ===SmartList in the widgets===
            
            The SmartList in the widgets can only changed by an admin under [[Preferences]].
            
            
            
            ===Ratings===
            
            If the extension [[Reference:Rating|Ratings]] integrated into the wiki, an overview of the most commonly evaluated pages can be inserted in the wiki code where you want (e.g. the start page) using SmartList. This happens via the wiki tag <nowiki><smartlist mode="ratings" /></nowiki>. This will show the pages which have been evaluated most often. It does not matter whether they have had positive or negative evaluations. Only the amount of evaluations made is important.
            
            
            
            The SmartList of the pages evaluated also has some parameters for customisation:
            
            
            
            
        
            
            ===Example in wikicode===
            
            Of course, bs:smartlist tag can be added directly into wikitext:
            
            
            <code><bs:smartlist mode="recentchanges" new="true" count="7" ns="104" trim="false" /></code>
            
            
            
            
            
            ==Tag bs:newbies==
            
            The<code><bs:newbies/></code> tag shows the recently registered members on the wiki.
            
            
            
            ===Parameters===
            
            
            
            
        {| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Count - '''count'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        The number of articlesusers to be shown; the default value is 5.
            
            
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''ns'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            Only articles from these namespace which have been evaluated will be listed.
            
            
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''excludens'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            No articles from this namespace will be listed.
            
            
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''showtext'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            With this option, a line of the article contents will be shown alongside the title. (showtext="true")
            
            
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''trimtext'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            Limits the number of characters shown of the article's contents. (trimtext="50")
            
            
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''showvotes'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            The number of evaluations made is given alongside the title. (showvotes="true")
            
            
            
            |}
            
            
            
            '''Example:'''
            
            
            
            
            <pre><smartlist mode="ratings" count="9" showtext="true" /> </pre>
            
            
            <br /> In this example, 9 articles will be listed which have been evaluated most often. At the same time, a line of each article will be shown.
            
            
            
            ===Approval===
            
            An example for displaying approvals (the right extension is needed):
            
            
            
            
            <pre><smartlist mode="flaggedrevisions" ns="502" count="7"/> </pre>
            
            
            
            ==Further functions==
            
            ===Most clicked article===
            
            The <nowiki><bs:toplist /></nowiki> tag creates a list of the most clicked articles in the wiki.
            
            
            
            The following are possible parameters:
            
            
            
            
        10.
            
            
            
            |}
            
            
            
            ===Example in wikicode===
            
            
            <code><bs:newbies count="7"/></code>
            
            
            
            
            
            ==Tag bs:toplist==
            
            [[File:Smartlist2.png|thumb|Options of bs:toplist tag]]
            
            This tag shows list of most visited pages.
            
            
            
            ===Parameters===
            
            
            
            
        {| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Count - '''count'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        The number of articles to be shown; the default value is 10.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Namespaces - '''ns'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Only articles from these namespace will be shown. You can put several namespaces here, separated by commas.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Category - '''cat'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        Only articles from this category will be shown. You can put several categories here, separated by commas.
        
        
        
        |-
        
        | style="border: 1px solid #ebecec;"|
            
            
         |
            
            Period - '''period'''
        
        
        
        | style="border: 1px solid #ebecec;" |
        
        The period that should be used (alltime or month). The default is alltime.
        
        
        
        |}
        
        
        
        ===New members===
            
            The<nowiki><bs:newbies/></nowiki> tag shows the newest members of the wiki.
            
            
            
            The following are possible parameters:
            
            
            
            {| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
            
            |-
            
            | style="border: 1px solid #ebecec;"|
            
            '''count'''
            
            
            
            | style="border: 1px solid #ebecec;"|
            
            The number of members to be shown; the default value is 10.
            
            
            
            |}
            
            
            
            ==Example in wikicode===
            
            
            <code><bs:toplist count="7" ns="Help|QM" /></code>
            
            
            
            
            
            ==See also==
        
        
        
        Our [[Reference:SmartList|reference page.]]
Line 3: Line 3:
 
__TOC__
 
__TOC__
  
−
==What is SmartList?==
+
==What is BlueSpiceSmartList?==
  
−
'''SmartList''' introduces a tag that can be placed on any page to show a list of most relevant pages. Type of content it will display, as well as number of entries can be configured using different options in the tag.
+
'''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.
  
−
==Where to find the function SmartList?==
+
==Available tags==
 +
[[File:Smartlist2.png|thumb|Available tags in "Insert magic" dialog]]
 +
BlueSpiceSmartList offers three different tags:
 +
* <code><bs:smartlist /></code> - main tag used to display list of pages based on various criteria
 +
* <code><bs:newbies /></code> - displays list of recentrly registered users
 +
* <code><bs:toplist /></code> - displays list of most visited pages
  
−
It is possible to integrate SmartList into an article, the widget bar or the user sidebar.
+
==Where to find the function BlueSpiceSmartList?==
  
−
::: [[File:SmList1.jpg|500x307px]]
+
All of the tags listed above can be added through "Insert magic" menu of [[Manual:Extension/VisualEditor|VisualEditor]]. For more information on how to insert magic words, see [[Manual:Extension/BlueSpiceInsertMagic|BlueSpiceInsertMagic]].
  
 +
==Tag bs:smartlist==
 +
[[File:Smartlist3.png|thumb|Options of bs:smartlist tag]]
 +
Once the tag is added to the page, configuration dialog (inspector) is shown. If offers configuring:
 +
* mode - criteria by which to retrieve pages displayed
 +
** 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".
  
−
::: [[File:SmList2.jpg|500x307px]]
+
===Parameters===
−
 
 
−
 
 
−
'''Save page''':
 
−
 
 
−
 
 
−
::: [[File:SmList3.jpg|500x302px]]
 
−
 
 
−
==Recentchanges or Changesofweek==
 
−
There are two basic options which you can choose using the parameter "mode":
 
−
 
 
−
* '''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".
 
−
 
 
−
'''Example''':
 
−
 
 
−
<pre><smartlist mode="changesofweek" /></pre>
 
−
 
 
−
'''Note''': The relevant Hallo Welt extension must be activated to use 'changesofweek'.
 
−
 
 
−
===Parameters for 'recentchanges'===
 
 
The SmartList can be limited or extended with the following parameters:
 
The SmartList can be limited or extended with the following parameters:
  
 
{| class="contenttable" style="width: 531px; height: 373px;" cellspacing="0" cellpadding="5" border="0"
 
{| class="contenttable" style="width: 531px; height: 373px;" cellspacing="0" cellpadding="5" border="0"
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''count'''
+
Count -'''count'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
The number of articles to be shown. Default value: 5
 
The number of articles to be shown. Default value: 5
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''ns'''
+
Namespaces - '''ns'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
Only articles from these namespace will be listed. The namespaces can be entered numerically or by names. Several namespaces can be named with commas: ns="0,2,5". Default: No limit.
+
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="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''excludens'''
+
Exclude NS - '''excludens'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
Articles from these namespaces will not be shown. At the moment, the namespaces can be entered numerically or by names. Several namespaces can be named with commas: excludens="0,2,5". Default: No limit.
+
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.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''cat'''
+
Category - '''cat'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
Only articles from this category will be listed. Selecting several categories is not possible. Default: No limit.
+
Only articles from given category will be listed. Selecting several categories is not possible. Default: All categories.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''nominor'''
+
Show minor - '''nominor'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
Minor changes (changes marked with an "m" in the recent changes) will not be listed. Default: Minor changes are listed.
 
Minor changes (changes marked with an "m" in the recent changes) will not be listed. Default: Minor changes are listed.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''period'''
+
Period - '''period'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
Only changes within this period are shown. Possible values: 'month', 'week', 'day'. Default: No limit.
+
Only changes within given period are shown. Possible values: 'month', 'week', 'day'. Default: No limit.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''new'''
+
Show only new articles - '''new'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
Only new pages will be listed. Default: All pages are shown
 
Only new pages will be listed. Default: All pages are shown
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''trim'''
+
Trim - '''trim'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
Long article names are not cropped. Default: The title is cut off at 30 characters.
+
Long article names are not cropped. Default: The title is cut off after 30 characters.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''showtext'''
+
Show text '''showtext'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
With this option, a line of the article contents will be shown alongside the title: showtext="true".
+
With this option, a line of the article contents will be shown alongside the title.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''trimtext'''
+
Trim text - '''trimtext'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
"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.
 
"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.
  
 
|}
 
|}
−
The parameters are added to the tag.<br />'''Example''':
 
−
 
−
<pre><smartlist new="true" count="7" ns="104" trim="false" /></pre>
 
−
<br /> This SmartList lists the seven newest articles from a particular namespace without shortening their titles.
 
−
 
−
===Parameters for 'changesofweek'===
 
−
{| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|
 
−
'''count'''
 
−
 
−
| style="border: 1px solid #ebecec;"|
 
−
The number of articles to be shown. Default value: 5
 
−
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|
 
−
'''period'''
 
−
 
−
| style="border: 1px solid #ebecec;"|
 
−
Only changes within this period are shown. Possible values: 'month', 'week', 'day'. Default: No limit.
 
−
 
−
|}
 
−
 
−
'''Example''':
 
−
 
−
<pre><smartlist mode="changesofweek" count="10" /></pre>
 
−
 
−
===What links here===
 
−
A smartlist with the mode <code>mode="whatlinkshere"</code> shows all sites that link to this site - if you don't define a special site through "target" then smartlist will show all links to the page the smartlist-tag is used at. You can use all parameters of the mode 'recentchanges'.
 
−
 
−
===Additional parameters for 'whatlinkshere'===
 
−
{| class="contenttable-black"
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|'''target'''
 
−
| style="border: 1px solid #ebecec;"|page title - default: site on which the tag is used.
 
−
|}
 
−
'''Example''':
 
  
−
<pre><nowiki><bs:smartlist mode="whatlinkshere" target="Portal:Test" count="7" ns="0" trim="false"/></nowiki></pre>
+
===Example in wikicode===
 +
Of course, bs:smartlist tag can be added directly into wikitext:
 +
<code><bs:smartlist mode="recentchanges" new="true" count="7" ns="104" trim="false" /></code>
  
−
===SmartList in the widgets===
 
−
The SmartList in the widgets can only changed by an admin under [[Preferences]].
 
  
−
===Ratings===
+
==Tag bs:newbies==
−
If the extension [[Reference:Rating|Ratings]] integrated into the wiki, an overview of the most commonly evaluated pages can be inserted in the wiki code where you want (e.g. the start page) using SmartList. This happens via the wiki tag <nowiki><smartlist mode="ratings" /></nowiki>. This will show the pages which have been evaluated most often. It does not matter whether they have had positive or negative evaluations. Only the amount of evaluations made is important.
+
The<code><bs:newbies/></code> tag shows the recently registered members on the wiki.
  
−
The SmartList of the pages evaluated also has some parameters for customisation:
+
===Parameters===
  
 
{| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
 
{| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''count'''
+
Count - '''count'''
−
 
 
−
| style="border: 1px solid #ebecec;"|
 
−
The number of articles to be shown; the default value is 5.
 
  
−
|-
+
| style="border: 1px solid #ebecec;" |
−
| style="border: 1px solid #ebecec;"|
+
The number of users to be shown; the default value is 10.
−
'''ns'''
 
−
 
 
−
| style="border: 1px solid #ebecec;"|
 
−
Only articles from these namespace which have been evaluated will be listed.
 
−
 
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|
 
−
'''excludens'''
 
−
 
 
−
| style="border: 1px solid #ebecec;"|
 
−
No articles from this namespace will be listed.
 
−
 
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|
 
−
'''showtext'''
 
−
 
 
−
| style="border: 1px solid #ebecec;"|
 
−
With this option, a line of the article contents will be shown alongside the title. (showtext="true")
 
−
 
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|
 
−
'''trimtext'''
 
−
 
 
−
| style="border: 1px solid #ebecec;"|
 
−
Limits the number of characters shown of the article's contents. (trimtext="50")
 
−
 
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|
 
−
'''showvotes'''
 
−
 
 
−
| style="border: 1px solid #ebecec;"|
 
−
The number of evaluations made is given alongside the title. (showvotes="true")
 
  
 
|}
 
|}
  
−
'''Example:'''
+
===Example in wikicode===
−
 
+
<code><bs:newbies count="7"/></code>
−
<pre><smartlist mode="ratings" count="9" showtext="true" /> </pre>
 
−
<br /> In this example, 9 articles will be listed which have been evaluated most often. At the same time, a line of each article will be shown.
 
−
 
 
−
===Approval===
 
−
An example for displaying approvals (the right extension is needed):
 
  
−
<pre><smartlist mode="flaggedrevisions" ns="502" count="7"/> </pre>
 
  
−
==Further functions==
+
==Tag bs:toplist==
−
===Most clicked article===
+
[[File:Smartlist2.png|thumb|Options of bs:toplist tag]]
−
The <nowiki><bs:toplist /></nowiki> tag creates a list of the most clicked articles in the wiki.
+
This tag shows list of most visited pages.
  
−
The following are possible parameters:
+
===Parameters===
  
 
{| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
 
{| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''count'''
+
Count - '''count'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
The number of articles to be shown; the default value is 10.
 
The number of articles to be shown; the default value is 10.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''ns'''
+
Namespaces - '''ns'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
Only articles from these namespace will be shown. You can put several namespaces here, separated by commas.
 
Only articles from these namespace will be shown. You can put several namespaces here, separated by commas.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''cat'''
+
Category - '''cat'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
Only articles from this category will be shown. You can put several categories here, separated by commas.
 
Only articles from this category will be shown. You can put several categories here, separated by commas.
  
 
|-
 
|-
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
−
'''period'''
+
Period - '''period'''
  
−
| style="border: 1px solid #ebecec;"|
+
| style="border: 1px solid #ebecec;" |
 
The period that should be used (alltime or month). The default is alltime.
 
The period that should be used (alltime or month). The default is alltime.
  
 
|}
 
|}
  
−
===New members===
+
===Example in wikicode===
−
The<nowiki><bs:newbies/></nowiki> tag shows the newest members of the wiki.
+
<code><bs:toplist count="7" ns="Help|QM" /></code>
−
 
 
−
The following are possible parameters:
 
−
 
 
−
{| class="contenttable" style="width: 531px; height: 65px;" cellspacing="0" cellpadding="5" border="0"
 
−
|-
 
−
| style="border: 1px solid #ebecec;"|
 
−
'''count'''
 
−
 
 
−
| style="border: 1px solid #ebecec;"|
 
−
The number of members to be shown; the default value is 10.
 
  
−
|}
 
  
 
==See also==
 
==See also==
  
 
Our [[Reference:SmartList|reference page.]]
 
Our [[Reference:SmartList|reference page.]]
Retrieved from "https://bs3-en.wiki.bluespice.com/w/index.php?title=Manual:Extension/BlueSpiceSmartList&oldid=11236"

Attachments

Discussions