Extension:Gadgets/de

Die Gadgets-Erweiterung stellt eine Weise für Benutzer zur Verfügung, um JavaScript oder CSS-basierte "Gadgets" auszuwählen, welche andere Wiki-Benutzer anbieten. Gadgets werden aus JavaScript und/oder CSS Stückchen zusammengesetzt, die auf Seiten im MediaWiki Namensraum vorhanden sind. Jedes Gadget wird durch eine Linie in der MediaWiki:Gadgets-Definition definiert, einen Namen und Beschreibung für das Gadget, und eine Liste des JS und der CSS Schnipsel zur Verfügung stellend, die es verwendet (siehe Abschnitt Verwendung unten).

Da sich Gadgets im MediaWiki-Namensraum (die Liste der Definition des Gadgets als auch die tatsächlichen Code-Schnipsel) befinden, können nur Sysops (aka Wiki-Admins) den Code bearbeiten. Dies ist, wie es sein soll: Nur von der Wiki-Gemeinschaft besonders vertraute Benutzer sollten im Stande sein, JavaScript-Code zu editieren, der von anderen Benutzern verwendet wird, da JavaScript leicht verwendet werden kann, um Zugangsdaten oder Leute zu auszuspionieren.

Installation
Entweder laden oder navigieren Sie zu dem Gadgets Ordner im SVN Lager. Kopieren Sie das Gadgets-Verzeichnis in den Ordner Ihrer MediaWiki-Installation. Dann fügen Sie die folgende Zeile in Ihrer LocalSettings.php Datei (am Ende) ein:

Verwendung
Die Liste der verfügbaren Gadgets wird definiert in MediaWiki:Gadgets-definition. Gadgets die dort definiert sind, werden im Gadgets Abschnitt der Seite Special:Preferences aufgelistet, sodass Benutzer dort die Gadgets auswählen können, die sie verwenden möchten. Eine Übersicht über die in MediaWiki:Gadgets-definition definierten Gadgets, wird auch auf Special:Gadgets aufgelistet. Dort werden auch die zugehörigen Systemtexte für eine einfache Bearbeitung angezeigt.

Format
Jede Zeile in MediaWiki:Gadgets-definition die mit einem oder mehreren "*" Zeichen beginnt (asterisks), definiert ein Gadget; es muss die folgende Form haben: * gadget_name [Einstellungen (kann weggelassen werden)] | Seitennamen

Das erste Feld (" gadget_name " im Beispiel) ist der interne Name des Gadgets, und verweist auf eine System-Nachricht (MediaWiki:Gadget- gadget_name  im Beispiel), die eine kurze Beschreibung des Gadgets enthält, durch Verwendung von Wiki-Syntax.

Der interne Name wird als ein Teil des Namens eines Form-Feldes verwendet und muss den Regeln der für NAMEN-Attribut-Werte definierten Regeln folgen. Das bedeutet, dass es mit einem Buchstabe ([A-Za-z]) beginnen muss und von jeder Zahl von Buchstaben, Ziffern ([0-9]), Bindestriche (" - ") gefolgt werden kann, unterstreicht ("_"), Doppelpunkte (":"), und Punkten (".").

Options-Format: [option1 | option2 | ... optionN] whitespace can be omitted. Single option can either consist of single option name (in this case it is a flag option), or contain a comma-separated list of values: option = value1, value2, value3

Beispiele: * mygadget|mygadget.js|mygadget.css oder * mygadget[ResourceLoader]|mygadget.js|mygadget.css oder * mygadget[rights=foo,bar]|mygadget.js|mygadget.css oder * mygadget[ ResourceLoader | rights=foo, bar ] | mygadget.js | mygadget.css

Optionen
Sie können zusätzliche Abhängigkeiten für Ihre Gadgets angeben, z. B.:

* mygadget[ResourceLoader|dependencies=jquery.ui, jquery.effects.clip]|mygadget.js|mygadget.css

Hier bitten wir ResourceLoader, um die Module jquery.ui und jquery.effects.clip mit mygadget zu laden. Beachten Sie, dass Gadgets kann nicht auf Skripte von Seiten, statische Dateien oder externe URLs abhängig sein kann, nur auf Module die bereits in ResourceLoader registriert sind.

Um das Gadget nur für Benutzer mit entsprechenden Berechtigungen verfügbar zu machen, setzen Sie die Rechte-Option. Zum Beispiel,

* ImprovedDeletion [rights=delete] | ImprovedDeletion.js macht das Gadget nur Benutzern bereit, die wirklich Seiten löschen können. Beachten Sie, dass Beschränkungen auf der Erlaubnis, nicht den Benutzergruppen wie Administratoren oder Bürokraten beruhen. Hier sind einige konkrete Beispiele: * modrollback[ResourceLoader|rights=rollback]|modrollback.js * UTCLiveClock[ResourceLoader|rights=purge]|UTCLiveClock.js * Ajax_sysop[ResourceLoader|rights=patrol,rollback,markbotedits,delete]|Ajax_sysop.js

ResourceLoader Unterstützung
All gadget's CSS is always loaded via the ResourceLoader. However, older JavaScript is often incompatible with RL, so every gadget must be explicitly marked as compatible in order to have its scripts loaded by RL. Otherwise, plain old &lt;script src="/w/index.php?title=MediaWiki:Gadget- gadget_name.js &action=raw"&gt; will be used.

Every gadget that at least partially uses ResourceLoader (that is, that has styles or comatible scripts) has its own RL module. The modules are named ext.gadget.&lt;gadget name&gt;.

Seiten
The remaining fields on the line refer to the JavaScript or CSS code that makes up the gadget, contained in system messages (MediaWiki:Gadget-mygadget.js and MediaWiki:Gadget-mygadget.css in the example); the names of those messages must end with ".js" or ".css", respectively. A gadget can use any number of code messages, specifically, common code can be put into a code message used by several gadgets, in addition to their own specific code, e.g:

* frobinator|commonStuff.js|frob.js|frob.css|pretty.css * l33t|commonStuff.js|tools.js|l33t.js

Sektionen
The list of gadgets in MediaWiki:Gadgets-definition can be broken into sections using lines that start and end with two or more "=" (equals) characters, enclosing the name of a system message that defines the section's name - for example:

== interface-gadgets ==

This would define a new section, with the title defined on the page MediaWiki:Gadget-section-interface-gadgets.

ToDo

 * Fulfill Basic gadgets

Siehe auch

 * known bugs at Bugzilla
 * /Rewrite
 * Gadget Studio
 * Extension:SecureWidgets
 * Extension:SimpleScript
 * Extension:Widgets