Wikipedia:Lua/Modul/Vorlage:Seitenbewertung

Vorlagenprogrammierung	Diskussionen	Lua			Unterseiten
		Modul	Deutsch	English	Modul:	Dokumentation

Vorlage:Seitenbewertung (BadgesQuery) – Modul zur Abfrage auf Wikidata registrierter Auszeichnungen, insbesondere für Vorlage:Seitenbewertung.

Funktionen für Vorlagen

features

Generiere Verlinkung, ggf. mit Anzeige einer registrierten Seitenbewertung

Parameter des #invoke; optional wo nicht eingefordert:

1: Lokaler Seitenname, dessen Bewertung ermittelt werden soll; Vorgabe: aktuelle Seite
nsTransclude: Namensraum-Nummer einer einzubindenden Seite zur Ergebnisdarstellung; Vorgabe: 10 – „Vorlage“
sTransclude: Titel einer einzubindenden Seite zur Ergebnisdarstellung (Pflichtparameter)
link: 1 – verlinke Seitennamen
long: 1 – ausführliche Ergebnisdarstellung
px: Anzahl der Pixel eines Icons
space: CSS-Breitenabstand zwischen Seitenname und Bewertung
site: Datenbankname eines Wiki, in dem die Bewertung jener Seite ermittelt werden soll, die mit dem lokalen Seitennamen verknüpft ist; Vorgabe: (dewiki)

Rückgabewert: Verlinkung der Seite, ggf. mit Bewertung.

fulfils

Prüfe, ob fragliche Seite mit bestimmter Bewertung registriert ist

Parameter des #invoke:

1: Lokaler Seitenname, dessen Bewertung ermittelt werden soll; Vorgabe: aktuelle Seite
match: Leerzeichen-getrennte Liste der Item-Nummern, deren Zuordnung geprüft werden soll
site: Datenbankname eines Wiki, in dem die Bewertung jener Seite ermittelt werden soll, die mit dem lokalen Seitennamen verknüpft ist; Vorgabe: (dewiki)

Rückgabewert: 1 wenn Bewertung vergeben, sonst leer

failsafe

Versionsbezeichnung: 2022-10-19

Die Failsafe-Schnittstelle erlaubt den damit ausgerüsteten Modulen in globaler Verteilung

sicherzustellen, dass eine von einer Vorlage oder einem Modul benötigte Funktion in der lokalen Kopie eines Bibliotheksmoduls vorhanden ist, und ggf. auch in einer erforderlichen Mindestversion;
die globale Aktualisierung und Verknüpfung von Modulen über Wikidata zu verwalten.

Die Failsafe-Schnittstelle liegt sowohl auf Ebene der Vorlagen wie auch in direktem Lua-Zugriff vor.

Die Funktionen sind im Einzelnen (nicht alle werden bereits überall in vollem Umfang unterstützt):

Parameter
Wert	Ergebnis	aktuell
nichts `false`	lokale Version	»2022-10-19«
Mindestversion	Mindestversionsbezeichnung Datum im ISO-Format Es wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt. leer, falls Mindestversion nicht erfüllt	2001-01-01 → »2022-10-19« 2099-01-01 → »«
`wikidata`	Versionsbezeichnung der globalen Mutter (d:Q114773646) Versionsbezeichnung auf Wikidata lokal, falls dort keine gefunden	»2022-10-19«
`item`	ID des Wikidata-Items leer, falls nicht definiert	»Q114773646«
`~`	Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung leer, falls aktuell Versionsbezeichnung auf Wikidata, falls ungleich	»«
`@`	Ist die aktuelle (Modul-)Seite richtig mit Wikidata verknüpft? leer, falls mit dem richtigen Item verknüpft Item-ID, falls nicht
Der Rückgabewert ist in der Vorlagenprogrammierung leer und per Lua `false`; andernfalls die angegebene Zeichenkette.

Darstellung

Aus features wird eine Seite eingebunden, die die folgenden Parameterwerte erhält; mit fiktiven Beispielen:

subject=lokaler Seitenname
linked=1 falls link=1 außer selbst
space=2em
px=18
long=1
q17437796=1 – exzellent
q17437798=1 – lesenswert
q17506997=1 – informative Liste
q17580674=1 – informatives Portal
site=

Siehe beispielsweise: Vorlage:Seitenbewertung/Darstellung

Verwendung

Vorlage:Seitenbewertung

Allgemeine Hinweise zur Einbindung von Modulen

Eine Einbindung erfolgt jeweils im Format

{{#invoke: Vorlage:Seitenbewertung | Funktionsname | Wert1 | Wert2 | NameX=Wert … }}

Die Parameter können wie bei Vorlagen benannt oder unbenannt sein; deren Regeln gelten analog.

Wenn unbekannte Zeichenketten von außen kommen (als Vorlagenparameter), sollte immer mit der Form 1=Wert gearbeitet werden.

Zu allgemeinen Problemen beachte die Abhilfen wie bei Vorlagen.

Wenn in einer Vorlage ein Modul verwendet wird, sollte auch immer die Vorlage:Dokumentation/Lua in der Dokumentationsseite eingebunden werden.

Das gibt einem Programmierer Aufschluss, dass ein Lua-Modul benutzt wird, welche/s und ggf. welche Einzelfunktion daraus, und verlinkt auf die Dokumentation.
Die Modul-Dokumentationen bekommen ein Link, in welchen Vorlagen sie eingesetzt werden, und wo bei eventuellen Funktionsänderungen Anpassungen erforderlich werden.
Die Vorlage wird zur Übersicht kategorisiert in Kategorie:Vorlage:mit Lua-Programmierung.

Zu weiteren Informationen siehe Hilfe:Lua.

Bei Problemen wende dich bitte an die Vorlagen-Werkstatt, in schweren Fällen hilft auch die Lua-Werkstatt.