Wikipedia:Lua/Modul/UserGroups/de

Vorlagenprogrammierung	Diskussionen	Lua			Unterseiten
		Modul	Deutsch	English	Modul:	Dokumentation

UserGroups – Modul zur Verwaltung und Darstellung von Gruppenzugehörigkeiten (auch außerhalb der Software-definierten) und Mandaten.

Funktionen für Vorlagen

f

Arbeitsfunktion

Der Rückgabewert ist leer, wenn sich keine Treffer ergeben, ansonsten eine Zahl oder Zeichenkette oder ein HTML-Element.

Die nachstehenden Parameter beeinflussen das Ergebnis:

source

Seite mit JSON-Quelltext gemäß Datenstruktur

Beispiel: MediaWiki:Gadget-markAdmins/userGroups.json

JSON

JSON-Quelltext gemäß Datenstruktur

account

Filterbedingung; Benutzerkonto

Vorgabe: alle

pattern

Filterbedingung; Lua-Muster für Benutzerkonten

Vorgabe: alle

codes

Filterbedingung; Leerzeichen-getrennte Liste der Gruppen-Kürzel

Vorgabe: alle

active.state

0 – nur ehemalige Zugehörigkeit

1 – nur aktive Mandate

Vorgabe: alle

type

Art der Ausgabe

• gender – zurzeit keine Implementierung
• graph – zurzeit keine Implementierung
• number – Anzahl der Treffer als Zahl
• ol – nummerierte Liste verlinkter Nicks
• ping – Sammel-Ping
• plain – HTML-Darstellung als unformatierte Liste
• raw – reiner Text
• table – Tabelle
• target – Versandliste für Massennachricht
• timeline – Zeitleiste
• ul – unnummerierte Liste verlinkter Nicks
• Lua – kein Zugang aus Vorlagenprogrammierung

Vorgabe: table

class

class für äußeres HTML-Element

style

style für äußeres HTML-Element

id

id für äußeres HTML-Element

caption

Überschrift für Tabelle oder Zeitleiste

table.columns

Spaltendefinition für type=table

Vorgabe: zwei Spalten, Nick und Aufzählung aller Funktionen

table.number

1 – bei type=table die Anzahl der Nicks anzeigen

table.THclass

class für Kopfzeile bei type=table

table.THstyle

style für Kopfzeile bei type=table

timeline.template

Seite mit Musterumgebung für Zeitleiste

Beispiel und Vorgabe: Wikipedia:Lua/Modul/UserGroups/Timeline

timeline.elected

Beschriftung für aktive Mandate der Zeitleiste

timeline.previous

Beschriftung für ehemalige Zugehörigkeit in der Zeitleiste

failsafe

Versionsbezeichnung: 2022-12-09

Datenstruktur

Siehe hier.

Filtern nach Gruppenzugehörigkeit

Es kann eine Liste von Gruppen-Bezeichnern und Operatoren angegeben werden.

• Mehrere Gruppen-Bezeichner werden durch ODER verknüpft.

Wenn der Status active.state auf „aktiv“ gesetzt ist, gibt es weitere Möglichkeiten:

• Ein (oder mehrere) Elemente & bewirken eine Verknüpfung mit UND.
• Ein dem Kürzel vorangestelltes - bewirkt einen Ausschluss, wenn diese Funktion zurzeit aktiv ausgeübt wird.

Tabelle

Spaltendefinition

Sofern nicht per account genau ein Benutzerkonto spezifiziert wurde, enthält die erste Spalte immer das Benutzerkonto; und würde erforderlichenfalls automatisch vorangestellt werden.

active=1 #account BOA OS CU B Com-A WD-A #details

active=0 #account A#from A#to A#info

#account #gender #groups #details

#groups

#groups#code#see

#groups#from

#groups#to

#groups#info

process cell

#account#alias#dead#process

Verwendung

• [[Vorlage:]]

Serverseitig aktualisieren

Funktionen für Lua-Module

Die oben dokumentierten Funktionen können auch über require() in andere Module eingebunden werden:

local lucky, UserGroups = pcall( require, "Module:UserGroups" )
if type( UserGroups ) == "table" then
    UserGroups = UserGroups()
else
    -- Fehlerfall; UserGroups enthält Fehlermeldung
    return "<span class=\"error\">" .. UserGroups .. "</span>"
end

Danach stehen zur Verfügung:

UserGroups.f( arglist )

Rückgabewert: number oder string oder mw.html oder false

UserGroups.failsafe( atleast )

Versionsbezeichnung

Rückgabewert: string oder false

Abhängigkeiten

• Module:DateTime
• Module:Pinging