Handbuch:Erweiterung/BlueSpiceSmartList

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

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 als Inhalts-Droplets   v4.3+(bzw. frühere BlueSpice-Versionen: VisualEditor: Einfügen > Magisches Wort.   -v4.3) eingefügt werden.

Smartlist

Das <bs:smartlist /> - zeigt standardmäßig eine Liste von geänderten 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

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

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

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

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

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

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" /> 

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.

Wird im Wiki von einem "Artikel" gesprochen, so ist damit in der Regel der Inhalt einer Einzelseite gemeint. Im Zusammenhang mit im Wiki erstellten Büchern ist ein Artikel oft gleichbedeutend mit einem Buchkapitel.

Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Kategorien helfen, Seiten im Wiki zur organisieren. Jede Kategorie ist im gesamten Wiki verfügbar.

Formatierungssprache für Wikiseiten. Der Wikitext kann im Quelltextmodus angesehen und bearbeitet werden.

Technische Referenz: BlueSpiceSmartList

---

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