Commons:Helferlein
Helferlein sind Benutzerskripte, welche die Funktionalität von MediaWiki, die Software auf der Commons läuft, erweitern und leicht über die Benutzereinstellungen installierbar sind. (Other user scripts sind erhältlich, welche manuell installiert werden müssen. ) Individuelle Helferlein können aktiviert oder deaktiviert werden (manche sind standardmäßig aktiviert), indem man your Preferences (Du musst eingeloggt sein) aufsucht und die jeweiligen Checkboxen anklickt. Die meisten Helferlein benötigen benötigen in deimen Browser aktiviertes JavaScript.
Technische Details
Definition
- MediaWiki:Gadgets-definition ist der Ort, an dem die Helferlein installiert werden, so dass sie in den Einstellungen angezeigt werden.
- Helferlein können auf Benutzer mit bestimmten Benutzerrechten beschränkt werden, indem z. B.
rights=delete
in der Helferlein -Definition hinzugefügt wird. Helferlein werden standardmäßig (auch für nicht angemeldete Benutzer) durch Hinzufügen vondefault
geladen. Helferlein können auf angemeldete Benutzer mitrights=upload
beschränkt werden.
- Helferlein können auf Benutzer mit bestimmten Benutzerrechten beschränkt werden, indem z. B.
- Special:Gadgets stellt eine Übersicht mit Links zu den Helferlein bereit.
- MediaWiki:Common.js lädt einige Skripts automatisch.
Lokalisierung
- Die Lokalisierung innerhalb von Helferlein wird, sofern erforderlich, auf verschiedene Weise gehandhabt. Normalerweise geschieht dies innerhalb jedes Helferleinskripts oder über eine separate Unterseite (z.B. MediaWiki:Gadget-HotCat.js/de), aber in einigen Fällen existieren mehrere Sprachversionen des gesamten Skripts. {{Gadget-talk}} kategorisiert die Lokalisierung und platziert Skripte ggf. in Category:Benutzerskripte, die internationalisiert werden müssen.
- Die Lokalisierung der Helferleinbeschreibungen erfolgt durch die Erstellung von
/xx
-Unterseiten der (englischen) Helferleinbeschreibungs-Hauptseite (z.B. MediaWiki:Gadget-Cat-a-lot und MediaWiki:Gadget-Cat-a-lot/fr). Special:Preferences, via {{Gadget-desc}}, bietet „translate this“-Links, die dies erleichtern.
Vorlagen
- {{Gadget-state}} speichert einige redundante Informationen über Helferlein und sollte erfolgt wird in phab:T51501
- {{Gadget-desc}} standardisiert Beschreibungen von Helferlein (wie in den Einstellungen angezeigt)
- {{Gadget-help}} und {{Gadget-talk}} standardisieren die Kopfzeilen auf Helferlein-Hilfe- und Diskussionsseiten
- {{ActivateGadget}} und {{DeactivateGadget}} erzeugen Links, die beim Laden ein Dialogfeld erzeugen, in dem der Benutzer gefragt wird, ob ein Helferlein aktiviert oder deaktiviert werden soll
- Einige Helferlein dokumentieren Browser-Kompatibilität auf einer Unterseite (z.B. Help:Gadget-PrettyLog/Compatibility); dies ist ein gemeinsames Format, aber keine Vorlage
Einschränkungen
Seit MediaWiki 1.18 werden Helferlein (und Benutzer-CSS/-JS) auf einigen Spezialseiten nicht geladen. Dies schließt Special:Preferences ein, womit es mit den bisherigen Methoden nicht mehr möglich ist, Helferlein in andere Abschnitte der Einstellungen zu verschieben (siehe phab:T20186). phab:T35220 beantragt eine MediaWiki-Funktion als Ersatz für die bisherige Javascript-Anwendung.
Links
- Category:Gadget scripts
- Commons:User Scripts - Projekt zur Verbesserung von Gadgets und Nutzer-Skripten
- MediaWiki talk:Gadgets-definition - Diskussion
- mw:Extension:Gadgets - die MediaWiki-Erweiterung, die Helferlein ermöglicht
- mw:Extension:Gadgets/Scripts - einige Gadgets auf mediawiki.org
- mw:ResourceLoader - Helferlein-Framework; V2, in der Entwicklung, mit wesentlichen Änderungen; siehe auch phab:T31398 und phab:T22153
- Special:GadgetUsage zeigt die Anzahl der aktiven und inaktiven Benutzer an, die verschiedene Helferlein aktiviert haben