Handbuch:Erweiterung/BlueSpiceSmartList: Unterschied zwischen den Versionen

Version vom 26. Februar 2024, 15:43 Uhr

Die Erweiterung SmartList führt eine Reihe von Tags ein, die auf jeder Seite platziert werden können, um eine Liste der relevantesten Seiten basierend auf verschiedenen Kriterien anzuzeigen.

Verfügbare Tags[Bearbeiten | Quelltext bearbeiten]

BlueSpiceSmartList kann über drei verschiedene Tags auf einer Seite eingebunden werden:

<bs:smartlist /> / <recentchanges /> - zeigt standardmäßig eine Liste neuer Seiten an (<90 Tage), die über Kategorien und Namensräume gefiltert ist.
- Unterschiedliche modi sind möglich, wenn das <bs:smartlist />-Tag im Quelltextmodus hinzugefügt wird.
<bs:newbies /> - zeigt eine Liste der neu registrierten Benutzer an
<bs:toplist /> - zeigt eine Liste der am häufigsten besuchten Seiten an

Alle oben aufgeführten Tags können über VisualEditor hinzugefügt werden: Einfügen > Magisches Wort. -v4.3

Smartlist[Bearbeiten | Quelltext bearbeiten]

Das <bs:smartlist /> - zeigt standardmäßig eine Liste neuer Seiten an (<90 Tage).

Im Quelltext-Bearbeitungsmodus lassen sich zusätzliche Modi einstellen (nicht vorhanden für Inhalts-Droplets):

mode=stablepages
mode=whatlinkshere

Das Tag kann als Inhalts-Droplet "Letzte Änderungen" auf einer Seite eingefügt werden. In diesem Fall wird es als <recentchanges />-Tag im Quelltext hinterlegt.

v4.3+

Optionen des Tags smartlist

Parameter[Bearbeiten | Quelltext bearbeiten]

Die SmartList kann mit folgenden Parametern begrenzt oder erweitert werden:

Bezeichnung im Eingabedialog	Parameter	Werte	Beschreibung
Anzahl	count	Zahl	Die Anzahl der Artikel, die angezeigt werden sollen. Standard: 5
Namensraum/Name	ns	Zahl,Zahl, Name	Es werden nur Artikel aus den angegebenen Namensräumen aufgelistet. Die Namensräume können durch IDs oder durch Namen kommasepariert eingegeben werden. Standard: Alle Namensräume sind enthalten.
Kategorie	cat	Name	Es werden nur Artikel der angegebenen Kategorien (komma-separiert) aufgelistet. Standard: Alle Kategorien.
Kategoriemodus	catmode	AND, OR	Seiten anzeigen, wenn sie in mindestens einer der Kategorien sind (OR) bzw. wenn sie mit allen Kategorien gekennzeichnet sind (AND)
Kleine Änderungen anzeigen	minor	true, false	Kleinere Änderungen (Änderungen, die in den letzten Änderungen mit einem "K" gekennzeichnet sind) auflisten Standard: Kleinere Änderungen werden nicht aufgelistet.
Zeitraum	period	Monat, Woche, Tag	Es werden nur Änderungen innerhalb eines bestimmten Zeitraums angezeigt. Standard: < 90Tage (maximal anzeigbare Tage)
Nur neue Artikel anzeigen	new	true, false	Es werden nur neue Seiten aufgelistet. Standard: Alle Seiten werden angezeigt
Überschrift	heading	Text	Wird über der Liste als Überschrift angezeigt.
Sortieren nach	sort	Titel, Zeit	Die Liste kann nach Titel oder nach Zeit der letzten Änderung sortiert werden. Standardsortierung: Zeit Hinweis: auch bei der Sortierung nach Titel werden nur die Artikel der letzten 90 Tage berücksichtigt.
Sortierreihenfolge	order	asc, desc	Aufsteigende oder absteigende Sortierung.
Kürzen	trim	Zahl	Lange Seitennamen werden nicht gekürzt. Standard: Der Titel wird nach 30 Zeichen abgeschnitten.
Text anzeigen	showtext	true, false	Mit dieser Option wird neben dem Titel eine Zeile mit dem Artikelinhalt angezeigt.
Text kürzen	trimtext	Zahl	"trimtext" legt die Anzahl der angezeigten Zeichen eines Artikels fest. (Dies ist nur relevant, wenn showtext = "true" gesetzt wurde.) Hinweis : trimtext = "0" ist nicht möglich.
Namensräume anzeigen	showns	true, false	Wenn aktiv, wird vor dem Seitennamen das Namensraumpräfix angezeigt.
Zahl mit Text	numwithtext	Zahl	Anzahl der aufgelisteten Artikel, die mit Text dargestellt werden sollen (nur relevant, wenn showtext="true").
Meta	meta	true, false	Wenn aktiv, werden Benutzername und Datum der letzten Änderung angezeigt.
Ziel	target	-	obsolet
Namensraum/Name ausschließen	excludens	Name, Name	Artikel aus angegebenen Namensräumen werden nicht angezeigt. Die Namensräume können durch IDs oder durch Namen komma-separiert eingegeben werden. Standard: Alle Namensräume sind enthalten.

Einfügen über Wikitext[Bearbeiten | Quelltext bearbeiten]

Ein Syntaxbeispiel mit einigen Parametern sieht so aus. Hier werden 15 der Seiten, die in den letzten 90 Tagen geändert wurden, alphabetisch sortiert ausgegeben.

<bs:smartlist sort="title" cat="ISO9001" count="15" heading="Seiten zu ISO 9001" />

Die Anzeige der Seiten kann auf die zuletzt freigegebenen Seiten beschränkt werden (Angabe nur über Quelltext möglich):

<bs:smartlist period="week" sort="time" showns="0" mode="stablepages"  count="8" />

Alternativ kann die Smartlist auch eine Liste der Seiten anzeigen, die auf eine Wikiseite verlinken. Hierbei wird als target der entsprechende Seitenname angegeben:

<bs:smartlist mode="whatlinkshere" target="Main Page" />

Newbies[Bearbeiten | Quelltext bearbeiten]

Das <bs:newbies />-Tag zeigt die kürzlich registrierten Benutzer als kommaseparierte Liste an.

Das Tag kann als Inhalts-Droplet "Neue Benutzer" auf einer Seite eingefügt werden. v4.3+

Parameter[Bearbeiten | Quelltext bearbeiten]

Bezeichnung
im Eingabedialog

Parameter

Werte

Beschreibung

Anzahl

count

Zahl

Die Anzahl der anzuzeigenden Benutzer.

Der Standardwert ist 5.

Beispiel in Wikicode:

 <bs:newbies count="7" />

Toplist[Bearbeiten | Quelltext bearbeiten]

Dieses Tag zeigt eine Liste der am häufigsten besuchten Seiten und wie oft diese besucht wurden.

Das Tag kann als Inhalts-Droplet "Meistbesuchte Seiten" auf einer Seite eingefügt werden. v4.3+

Parameter[Bearbeiten | Quelltext bearbeiten]

Bezeichnung im Eingabedialog	Parameter	Werte	Beschreibung
Anzahl	count	Zahl	Die Anzahl der anzuzeigenden Artikel Der Standardwert ist 10.
Namensraum/Name	ns	Text\|Text	Es werden nur Artikel aus diesem Namensraum angezeigt. Sie können hier mehrere über senkrechten Strich getrennte Namensräume angeben.
Kategorie	cat	Text, text	Es werden nur Artikel aus dieser Kategorie angezeigt. Sie können hier mehrere Kategorien eingeben, die durch Kommas getrennt sind.
Zeitraum	period	month, day, week	Der Zeitraum, der verwendet werden soll (ganzjährig oder monatlich). Die Standardeinstellung ist alltime.

Beispiel in Wikicode:

 <bs:toplist count="7" ns="Hilfe|QM" />

Technische Referenz: BlueSpiceSmartList

Feedback zur Dokumentation ist im Community-Forum möglich.

@@ Zeile 2: / Zeile 2: @@
 Die Erweiterung '''SmartList''' führt eine Reihe von Tags ein, die auf jeder Seite platziert werden können, um eine Liste der relevantesten Seiten basierend auf verschiedenen Kriterien anzuzeigen.
-{{Hinweisbox|boxtype=Hinweis|icon=|Note text=SmartList zeigt nur Seiten an, die in den letzten 90 Tagen erstellt oder bearbeitet wurden. Sollten Sie alle Seiten anzeigen wollen, unabhängig vom Bearbeitungszeitraum, so können Sie alternativ eine [[SMW-Abfragen|SMW-Abfrage]] nutzen.|bgcolor=}}
 ==Verfügbare Tags==
-[[File:Smartlist2.png|thumb|Magisches Wort ''smartlist'' im visuellen Editor|alternativtext=Magisches Wort smartlist im visuellen Editor|zentriert|450x450px]]
 BlueSpiceSmartList kann über drei verschiedene Tags auf einer Seite eingebunden werden:
-*<code><nowiki><bs:smartlist /></nowiki></code> -  zeigt eine Seitenliste neuer Seiten an (<90 Tage), die über Kategorien und Namensräume gefiltert ist
+*<code><nowiki><bs:smartlist /></nowiki></code> / <code><nowiki><recentchanges /></nowiki></code> -  zeigt standardmäßig eine Liste neuer Seiten an (<90 Tage), die über Kategorien und Namensräume gefiltert ist.
+**Unterschiedliche modi sind möglich, wenn das <code><nowiki><bs:smartlist /></nowiki></code>-Tag im Quelltextmodus hinzugefügt wird.
 *<code><nowiki><bs:newbies /></nowiki></code> - zeigt  eine Liste der neu registrierten Benutzer an
 *<code><nowiki><bs:toplist /></nowiki></code> - zeigt eine Liste der am häufigsten besuchten Seiten an
-<br />Alle oben aufgeführten Tags können über[[Handbuch:Erweiterung/VisualEditor| VisualEditor]] hinzugefügt werden: ''Einfügen > Magisches Wort.''
+<br />Alle oben aufgeführten Tags können über[[Handbuch:Erweiterung/VisualEditor| VisualEditor]] hinzugefügt werden: ''Einfügen > Magisches Wort.'' {{Bsvs|bsvTo=4.3}}
 ==Smartlist==
-[[Datei:smartlist.png|alternativtext=Optionen des Tags smartlist|zentriert|mini|650x650px|Optionen des Tags ''smartlist'']]
+Das <code><nowiki><bs:smartlist /></nowiki></code> - zeigt standardmäßig eine Liste neuer Seiten an (<90 Tage).
+Im Quelltext-Bearbeitungsmodus lassen sich zusätzliche Modi einstellen (nicht vorhanden für Inhalts-Droplets):
+* mode=stablepages
+* mode=whatlinkshere
+Das Tag kann als [[Handbuch:Erweiterung/ContentDroplets|Inhalts-Droplet]] "Letzte Änderungen" auf einer Seite eingefügt werden. In diesem Fall wird es als <code><nowiki><recentchanges /></nowiki></code>-Tag im Quelltext hinterlegt.
+{{Bsvs|bsvFrom=4.3}}[[Datei:smartlist.png|alternativtext=Optionen des Tags smartlist|zentriert|mini|650x650px|Optionen des Tags ''smartlist'']]
 ===Parameter===
@@ Zeile 31: / Zeile 39: @@
 |Zahl
 | style="" |
-Die Anzahl der Artikel, die angezeigt werden sollen
+Die Anzahl der Artikel, die angezeigt werden sollen.
 Standard: 5
@@ Zeile 106: / Zeile 114: @@
 Zeit
 |Die Liste kann nach Titel oder nach Zeit der letzten Änderung sortiert werden.
+Standardsortierung: Zeit
+'''Hinweis:''' auch bei der Sortierung nach Titel werden nur die Artikel der letzten 90 Tage berücksichtigt.
 |-
 |Sortierreihenfolge
@@ Zeile 172: / Zeile 182: @@
-'''Beispiel in Wikicode''':<pre><bs:smartlist sort="title" cat="ISO9001" count="15" heading="Seiten zu ISO 9001" /></pre>Die Anzeige der Seiten kann auf die zuletzt [[Handbuch:Erweiterung/ContentStabilization|freigegebenen Seiten]] beschränkt werden (Angabe nur über Quelltext möglich):<pre><bs:smartlist period="week" sort="time" showns="0" mode="stablepages"  count="8" /></pre>
+=== Einfügen über Wikitext ===
+Ein Syntaxbeispiel mit einigen Parametern sieht so aus. Hier werden 15 der Seiten, die in den letzten 90 Tagen geändert wurden, alphabetisch sortiert ausgegeben.<pre><bs:smartlist sort="title" cat="ISO9001" count="15" heading="Seiten zu ISO 9001" /></pre>Die Anzeige der Seiten kann auf die zuletzt [[Handbuch:Erweiterung/ContentStabilization|freigegebenen Seiten]] beschränkt werden (Angabe nur über Quelltext möglich):<pre><bs:smartlist period="week" sort="time" showns="0" mode="stablepages"  count="8" /></pre>
+Alternativ kann die Smartlist auch eine Liste der Seiten anzeigen, die auf eine Wikiseite verlinken. Hierbei wird als <code>target</code> der entsprechende Seitenname angegeben:<pre>
+<bs:smartlist mode="whatlinkshere" target="Main Page" /></pre>
 ==Newbies==
 Das <code><nowiki><bs:newbies /></nowiki></code>-Tag zeigt die kürzlich registrierten Benutzer als kommaseparierte Liste an.
+Das Tag kann als [[Handbuch:Erweiterung/ContentDroplets|Inhalts-Droplet]] "Neue Benutzer" auf einer Seite eingefügt werden.{{Bsvs|bsvFrom=4.3}}
 ===Parameter===
@@ Zeile 192: / Zeile 207: @@
 Die Anzahl der anzuzeigenden Benutzer.
-Der Standardwert ist 10.
+Der Standardwert ist 5.
 |}
@@ Zeile 199: / Zeile 214: @@
 ==Toplist==
 Dieses Tag zeigt eine Liste der am häufigsten besuchten Seiten und wie oft diese besucht wurden.
+Das Tag kann als [[Handbuch:Erweiterung/ContentDroplets|Inhalts-Droplet]] "Meistbesuchte Seiten" auf einer Seite eingefügt werden.{{Bsvs|bsvFrom=4.3}}
 ===Parameter===
@@ Zeile 243: / Zeile 260: @@
 |}
-'''Beispiel in Wikicode''':<pre> <bs:toplist count="7" ns="Hilfe|QM" /> </pre>{{Box Links|Thema2=[[Referenz:BlueSpiceSmartList]]|Thema1=[[Handbuch:Erweiterung/BlueSpiceInsertMagic]]}}
+'''Beispiel in Wikicode''':<pre> <bs:toplist count="7" ns="Hilfe|QM" /> </pre>{{Translation}}
-{{Translation}}
 [[Category:Organisation]]