Vorlage:Abfrage Briefspieltexte Rest

Was macht diese Vorlage?

Mit dieser Vorlage werden zu einem Artikel die jeweiligen Briefspieltexte inklusive Gliederung angezeigt. Sie ist ein Koscher Ersatz für Vorlage:Abfrage Briefspieltexte.

Wesentliche Unterschiede:

• Es werden keine Setzungen abgefragt, die nur für spezifische Artikelarten in Frage kommen.
• Sollte es eindeutig falsch gesetzte Attribute geben, werden diese separat angezeigt - zusammen mit dem Hinweis, sie zu ändern und wie das geht.
• Sollte es zu keinem Treffer kommen, bleibt der jeweilige Teil der Abfrage unsichtbar.

Die Vorlage

• ruft die Vorlage Vorlage:Abfrage Briefspieltexte Kosch auf
• listet die Ergebnisse zweier Abfragen auf, wobei nach dem aventurischen Datum absteigend sortiert wird und die Abfragen auf die letzten 24 bzw. 6 Texte beschränkt werden.
• Mit Hilfe von weiteren Parametern können sowohl die Sortierreihenfolge als auch die Anzahl der Texte angepasst werden.

Wie verwendet man diese Vorlage?

Die Vorlage verwendet Parameter, welche mit Standardwerten versehen werden, falls man nichts weiter angibt.

Im einfachsten Fall reicht es also aus, folgenden Code in eine Seite einzufügen:

{{Abfrage Briefspieltexte Rest}}

Ein Beispiel für den umgekehrten Extremfall, dass alle Parameter angegeben werden:

{{Abfrage Briefspieltexte Rest|Maximale Anzahl Briefspieltext=60|Maximale Anzahl Fehler=3|Sortierung=aufsteigend}}

• Man kann jeden Parameter unabhängig von den anderen verwenden, also auch nur einen oder zwei angeben und den Rest weglassen.
• Es spielt keine Rolle, in welcher Reihenfolge man die Parameter angibt.

Parameter:

• Maximale Anzahl Briefspieltext - maximale Anzahl der Briefspieltexte, in denen das Attribut "Briefspieltext mit::" mit dem Artikel gesetzt wurde. Standardwert beträgt 24. Gibt es mehr als diese maximale Anzahl von Briefspieltexten, erscheint in der letzten Zeile der Tabelle unten rechts ein Link auf (… weitere Ergebnisse). Die Idee dahinter: In vielen Fällen reichen zwei Dutzend Einträge aus. Liegt die Anzahl der gefundenen Briefspieltexte knapp darüber, ist es praktisch, die Grenze anpassen zu können. Ohne eine automatische Grenze wäre es gefährlich, die Vorlage auszuprobieren, weil das Ergebnis dann aus Hunderten von Briefspieltexten bestehen könnte, was die Seite sehr lang machen und deren Ladezeit ernorm in die Höhe treiben würde.

• Maximale Anzahl Fehler - analog zu Maximale Anzahl Briefspieltext, nur dass hier alle anderen möglichen Attribute abgefragt werden (deren Setzung immer ein Fehler ist) und die maximale Anzahl der Ergebnisse auf 6 beschränkt wird.

• Sortierung Optionen: asc/desc/aufsteigend/absteigend - Standardwert ist "desc". Damit wird eingestellt, ob die Suchergebnisse nach aventurischer Zeit aufsteigend oder absteigend sortiert werden sollen und ob gleichzeitig durch den Filter die ältesten oder jüngsten Texte ausgegeben werden sollen. Dabei sind asc und aufsteigend bzw. desc und absteigend gleichwertig.

Einsatzzweck

Dies ist eine Residualvorlage für alle Artikel, die nicht in eine spezifischere Kategorie fallen. Während die anderen Vorlagen dieser Art in verschiedenen Automatik-Vorlagen verwendet werden, wird diese direkt im jeweiligen Artikel eingebunden.

Der Artikel Bier dient als Beispiel dafür, wie die Vorlage eingebunden wird und alle möglichen Parameter gesetzt werden.

Verwandte Vorlagen für spezifischere Artikelarten ( = diese verwenden, wenn sie passen):

• Vorlage:Abfrage Briefspieltexte Darsteller für Personen
• Vorlage:Abfrage Briefspieltexte Akteur für Akteure (insbesondere Familien und Gruppierungen)
• Vorlage:Abfrage Briefspieltexte Ort für Geographie (insbesondere Orte, Lehen und Höfe)

Technische Dokumentation

Absolut unwichtig für normale Benutzer, nur relevant für Vorlagen-Programmierer. Daher folgt reichlich technisches Vokabular!

Die Vorlage besteht grob aus zwei Teilen:

• Definition von Variablen, die Abfragen enthalten
• bedingte Anzeige der Ergebnisse

Zunächst werden zwei Variablen namen Erwähnungen und Unrest definiert, deren Inhalt jeweils über einen Aufruf der Vorlage Vorlage:Abfrage Briefspieltexte Kosch bestimmt wird. Für den Parameter Abfrage wird dabei gefiltert auf Attribute mit dem vollen Seitennamen, von dem diese Vorlage aufgerufen wird. Die Attribute sind zum einen "Briefspieltext mit::" (Residualattribut für alles andere), zum anderen alle anderen besonderen Attribute. Ersteres ist genau das, was in einem Briefspieltext gesetzt werden muss für einen Artikel, der in keiner der oben genannten spezifischen Kategorien ist. Entsprechend ist jedes andere Attribut ein Fehler, so dass auf alle anderen Attribute für die Fehlerauswertung abgefragt wird.

Hierbei wird der Wert des Parameters Sortierung ausgewertet - oder desc verwendet, falls dieser nicht gesetzt wurde. Als Begrenzung für die Abfragen wird entweder die Zahl verwendet, die in der Variable Maximale Anzahl Briefspieltext bzw. Maximale Anzahl Fehler festgelegt wurde, oder 24 bzw. 6.

Falls mindestens eine der beiden Variablen mit Inhalt gefüllt wurde, es also mindestens einen Treffer insgesamt gab, wird entsprechend die Überschrift zweiter Ordnung Briefspieltexte gesetzt zusammen mit den Knöpfen, mit denen die Anzahl der Ergebnisspalten vom jeweiligen Leser flexibel zwischen eins und drei umgeschaltet werden kann.

Falls es mindestens eine Erwähnung bzw. einen Fehler gab, wird das jeweilige Ergebnis ausgegeben zusammen mit der Formatierung, die notwendig ist, um die Anzahl der Ergebnisspalten verändern zu können. Bei falsch gesetzten Attributen gibt es außerdem noch eine Überschrift dritter Ordnung, die auf bestehende Fehler hinweist und wie man sie ändern kann.

Diese Dokumentation ist unter Vorlage:Abfrage Briefspieltexte Rest/Doku hinterlegt.