Handbuch:Erweiterung/BlueSpiceSmartList: Unterschied zwischen den Versionen

Aktuelle Version vom 27. Februar 2024, 09:56 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 als Inhalts-Droplets v4.3+(bzw. frühere BlueSpice-Versionen: VisualEditor: Einfügen > Magisches Wort. -v4.3) eingefügt werden.

Smartlist[Bearbeiten | Quelltext bearbeiten]

Das Tag <bs:smartlist /> zeigt standardmäßig eine Liste von geänderten Seiten an (<90 Tage).

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 Inhalts-Droplets "Letzte Änderungen"

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

mode=stablepages
mode=whatlinkshere

Parameter[Bearbeiten | Quelltext bearbeiten]

Die SmartList-Inspektor berücksichtigt folgende Parameter:

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 Inhalts-Namensräume sind enthalten. Hinweis: Nur Inhaltsnamensräume werden berücksichtigt.
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]

Wenn Sie das smartlist-Tag direkt im Quellbearbeitung einsetzen, können die modi "stablepages" oder "whatlinkshere" gesetzt werden

Im folgenden Beispiel werden 15 der Seiten aus der Kategorie ISO9001, 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" />

Wenn die Freigabe-Funktion für Seiten im Wiki aktiviert ist, kann die Anzeige der Seiten auf die zuletzt freigegebenen Seiten beschränkt werden:

<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[Bearbeiten | Quelltext bearbeiten]

 <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[Bearbeiten | Quelltext bearbeiten]

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

Technische Referenz: BlueSpiceSmartList

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

@@ Zeile 4: / Zeile 4: @@
 ==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 and, 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 als Inhalts-Droplets {{Bsvs|bsvFrom=4.3}}(bzw. frühere BlueSpice-Versionen:[[Handbuch:Erweiterung/VisualEditor|  VisualEditor]]: ''Einfügen > Magisches Wort.'' {{Bsvs|bsvTo=4.3}}) eingefügt werden.
-Weitere Informationen zum Einfügen magischer Wörter finden Sie unter [[Handbuch:Erweiterung/BlueSpiceInsertMagic| BlueSpiceInsertMagic]].
 ==Smartlist==
-[[File:Smartlist3.png|thumb| Optionen des Tags ''smartlist''|alternativtext=Optionen des Tags smartlist|zentriert|650x650px]]
+Das Tag  <code><nowiki><bs:smartlist /></nowiki></code>   zeigt standardmäßig eine Liste von geänderten Seiten an (<90 Tage).
+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|alt=Dialog der "Letzten Änderungen"  im Bearbeitungsmodus|zentriert|mini|750x750px|Optionen des Inhalts-Droplets "Letzte Änderungen"]]
+Im Quelltext-Bearbeitungsmodus lassen sich [[Handbuch:Erweiterung/BlueSpiceSmartList#Einf.C3.BCgen .C3.BCber Wikitext|zusätzliche Modi]] einstellen (nicht vorhanden für Inhalts-Droplets):
+* mode=stablepages
+* mode=whatlinkshere
 ===Parameter===
-Die SmartList kann mit folgenden Parametern begrenzt oder erweitert werden:
+Die SmartList-Inspektor berücksichtigt folgende Parameter:
 {| class="contenttable" style="width:100%;" cellspacing="0" cellpadding="5" border="0"
@@ Zeile 30: / Zeile 38: @@
 |Zahl
 | style="" |
-Die Anzahl der Artikel, die angezeigt werden sollen
+Die Anzahl der Artikel, die angezeigt werden sollen.
 Standard: 5
@@ Zeile 40: / Zeile 48: @@
 |Zahl,Zahl, Name
 | style="" |
-Es werden nur Artikel aus den angegebenen Namensräumen aufgelistet. Die Namensräume können durch IDs oder durch Namen komma-separiert
+Es werden nur Artikel aus den angegebenen Namensräumen aufgelistet. Die Namensräume können durch IDs oder durch Namen kommasepariert eingegeben werden.
-eingegeben werden.
+Standard: Alle Inhalts-Namensräume sind enthalten.
-Standard: Alle Namensräume sind enthalten.
+'''Hinweis:''' Nur Inhaltsnamensräume werden berücksichtigt.
 |-
@@ Zeile 80: / Zeile 88: @@
 |Monat, Woche, Tag
 | style="" |
-Es werden nur Änderungen innerhalb eines bestimmten Zeitraums angezeigt. Mögliche
+Es werden nur Änderungen innerhalb eines bestimmten Zeitraums angezeigt.
-Standard: Keine Begrenzung.
+Standard:  < 90Tage (maximal anzeigbare Tage)
 |-
@@ Zeile 107: / Zeile 115: @@
 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 171: / Zeile 181: @@
 |}
+=== Einfügen über Wikitext ===
+Wenn Sie das smartlist-Tag direkt im Quellbearbeitung einsetzen, können die modi "stablepages" oder "whatlinkshere" gesetzt werden
-'''Beispiel in Wikicode''':<pre><bs:smartlist sort="title" cat="ISO9001" count="15" heading="Seiten zu ISO 9001" /></pre>
+Im folgenden Beispiel werden 15 der Seiten aus der Kategorie ''ISO9001'', 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>
+Wenn die Freigabe-Funktion für Seiten im Wiki aktiviert ist, kann die Anzeige der Seiten auf die zuletzt [[Handbuch:Erweiterung/ContentStabilization|freigegebenen Seiten]] beschränkt werden:<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 193: / Zeile 212: @@
 Die Anzahl der anzuzeigenden Benutzer.
-Der Standardwert ist 10.
+Der Standardwert ist 5.
 |}
-'''Beispiel in Wikicode''':<pre> <bs:newbies count="7" /> </pre>
+=== Beispiel in Wikicode ===
+<pre> <bs:newbies count="7" /> </pre>
 ==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 222: / Zeile 245: @@
 Namensraum/Name
 |'''ns'''
-|<nowiki>Text|Text</nowiki>
+|Text,Text
 | style="" |
 Es werden nur Artikel aus diesem Namensraum angezeigt. Sie können hier mehrere über senkrechten Strich getrennte Namensräume angeben.
@@ Zeile 244: / Zeile 267: @@
 |}
-'''Beispiel in Wikicode''':<pre> <bs:toplist count="7" ns="Hilfe|QM" /> </pre>{{Box Links|Thema2=[[Referenz:BlueSpiceSmartList]]|Thema1=[[Handbuch:Erweiterung/BlueSpiceInsertMagic]]}}
+=== Beispiel in Wikicode ===
-{{Translation}}
+<pre> <bs:toplist count="7" ns="Hilfe|QM" /> </pre>{{Translation}}
 [[Category:Organisation]]