Benutzer:Rene/SGPack

<user>*</user>

Beschreibung

SGPack ist eine Sammlung von Mediawiki Erweiterungen die speziell für Stargate-Wiki programmiert wurden. Es ist möglich auch nur einzelnen dieser Erweiterungen zu benutzen. Die Vorgehensweise wird im Abschnitt Installation erklärt.

Installation

Die Erweiterung muss in ein eigenes Verzeichnis zB SGPack im Verzeichnis extensions abgelegt werden. Dann muss die Datei Localsettings.php um die Zeile

include_once("$IP/extensions/SGPack/SGPack.php");

ergänzt werden.

Es ist auch möglich/erlaubt nur einzelne Teile der Sammlung zu benutzen. Da alle Erweiterungen als Klassen definiert sind reicht es nur die entsprechende Klasse in SGP_Setup bzw. SGP_Magic einzubinden. Die nicht gewünschte Zeilen in diesen Funktionen kann man entweder entfernen oder auskommentieren. Die nicht benutzen Klassen können in der Datei verbleiben.

Copyright

Die Erweiterung unterliegt der GPL (Version 2). Das bedeutet der Einsatz in anderen MediaWikis ist erlaubt solange der Hinweis auf den Author und die GPL erhalten bleibt. Dazu genügt, in diesem Falle, bereits der von der Erweiterung selbst erzeugte Link auf der System Seite Spezial:Version. Natürlich kann die Erweiterung auch in anderen System benutzt werden, unter Beachtung der GPL.

Über einen kleinen Hinweis (auf der Diskussionsseite) in welchem Wiki die Erweiterung eingesetzt wird würde ich mich freuen, ist aber keine Pflicht.

BlockSpammer

Beschreibung

BlockSpammer ist eine Mediawiki Erweiterung die verhindert das unangemeldete Benutzer (IPs) externe Links in Artikel eintragen. Die Erweiterung prüft Änderungen von nicht angemeldeten Benutzern. Wenn diese einen verdächtigen Eintrag machen wird die Übername der Änderungen verweigert. Momentan prüft die Erweiterung nur auf externe Links.

NewArticle

Beschreibung

Die Erweiterung NewArticle erzeugt, immer wenn ein neuer Artikel angelegt wird, eine Auswahl an Vorlagen. Wird eine dieser Vorlagen ausgewählt so wird die Vorlage in das Editorfeld eingefügt. Sinn ist es das Erstellen von Artikeln nach den Artikelvorlagen zu erleichtern.

Technik

NewArticle ist eine MediaWiki Erweiterung die sich an den Hook AlternateEdit anhängt. Dabei wird bei jedem Aufruf des Editors geprüft ob es sich um einen neuen Artikel handelt. Ist dies der Fall so wird geprüft ob es zum Namensraum, in dem der neue Artikel erstellt werden soll, eine Steuerdatei MediaWiki:NewArticle-<NS> gibt. <NS> steht dabei für die Nummer des Namensraums. In dieser Datei kann neben einem Einleitungstext auch eine Liste an möglichen Vorlagen definiert werden. Das Einfügen einer gewählten Vorlage erfolgt dann über eine Javascriptfunktion.

Hinweis Es wird geprüft ob es sich um einen neuen Artikel handelt, d.h. ein bereits gespeicherte Artikel ohne Inhalt wird nicht als neu angesehen.

MediaWiki:NewArticle-<NS>

In der Steuerdatei kann ein Text definiert werden der als Einleitung über dem neuen Artikel angezeigt wird. Der Platzhalter <NS> wird dabei durch die Nummer des Namensraumes ersetzt für den die Steuerdatei gültig ist. Der Text kann die normale Mediawiki Syntax benutzen. Das bedeutet das zB auch Vorlagen eingebunden werden können. Zur Erstellung der Auswahlliste der möglichen Vorlagen werden diese nach dem folgenden Schema definiert:

 [[[ Einleitung , Vorlage|Beschreibung , Vorlage|Beschreibung , ...]]]

• Einleitung: Der hier angegebene Text erscheint in der Auswahlliste als Einleitung.
• Vorlage: Der Name der Vorlage ohne den Namensraum, also nicht Vorlage:Name sondern nur Name.
• Beschreibung: Der Text der für diese Vorlage in der Liste angezeigt wird.

Es gibt keine Begrenzung für die Anzahl an Vorlagen die definiert werden können.

Wird nur eine Vorlage angegeben besteht die Möglichkeit statt einer Liste einen Button zu erzeugen. In diesem Falle darf nur keine Einleitung angegeben werden.

 [[[ Vorlage|Beschreibung ]]]

Innerhalb des Steuerdatei können beliebig viele Auswahllisten bzw. Buttons definiert werden.

Beispiel: [[[Bitte wählen,Benutzerseite|Benutzer (Vorlage:Benutzerseite)]]]

SGHtml

Beschreibung

Die Erweiterung verändert der HTML Code der von MediaWiki erzeugt wird. Dabei werden die folgenden Anpassungen gemacht:

• Die JavaScript-Bibliothek jQuery wird eingebunden
• Externe Seiten werden in einem eigenen Fenster aufgerufen
• Alle Überschriften der Stufe 2 (==) erhalten am rechten Rand einen ~^ als Link auf den Seitenanfang.
• Bild Datei:Bearbeiten.png statt Text Bearbeiten um einen Abschnitt zu bearbeiten
• Persönliches Menü erweitert um den Punkt Wer ist online? um die Seite Spezial:Wer ist Online aufzurufen.
• Inhalts Menü erweitert um den Punkt Spoiler aufdecken wenn auf der Seite ein Spoiler benutzt wird.
• Pfeile <~, ~>,~^ und ~V im Artikel durch Bilder (<~,~>,~^,~V) ersetzen.

Hinweis: Die Erweiterung ersetzt die Pfeile auch im Bereich <pre> und <nowiki>. Die einzige Möglichkeit dies zu verhindern besteht darin statt dem Zeichen ~ im Text den Code ~ zu schreiben.

Achtung Veraltet: Die Umwandlung der Pfeile wird nicht mehr unterstützt. Statt dessen gibt es die Vorlagen {{Hoch}} {{Runter}} {{Links}} {{Rechts}}

Installation

Um die Erweiterung zu benutzen müssen die Bilder für die Pfeile in das Verzeichnis skins/common/images/16x16 gespeichert werden. Am einfachsten ist es dazu die Bilder auf dieser Seite mit dem Browser zu speichern und sie dann auf den Server zu laden.

Programmcode

Die Erweiterung benutzt die MediaWiki Hooks OutputPageBeforeHTML, PersonalUrls und BeforePageDisplay.

PageProtection

Beschreibung

Mit dieser Erweiterung können Benutzer bestimmen wer auf ihrer Seiten schreiben darf. Geschützt sind nur die Seiten im Benutzernamensraum (z.B. Benutzer:Name). Möchte man das andere diese Seite bearbeiten können gibt man sie mit dem user-tag frei.

• <user>XYZ</user> gibt die Seite nur für den Benutzer XYZ frei.
• <user>*</user> gibt die Seite für alle angemeldeten Benutzer frei.
• <user>**</user> gibt die Seite für alle angemeldeten Benutzer und IPs frei.

Seiten im Benutzerdiskussionsnamensraum sind normalerweise für alle frei. Um diese zu schützen muss zumindest ein user-tag auf der Seite definiert werden. Um die Seite nur für sich selbst frei zu geben schreibt man also <user>MeinName</user> auf die Seite. Den selben Effekt erreicht man auch mit dem kurzen <user>-</user>.

Der Besitzer einer Seite kann sich nicht selbst aussperren, das gleiche gilt für die Administratoren.

DropDownInsert

Die Idee zu DropDownInsert basiert auf der bekannten CharInsert-Erweiterung. DDInsert geht aber über die Möglichkeiten von CharInsert hinaus. Die Erweiterung stellt die folgenden Befehle bereit:

• <ddselect titel="TITEL" size="SIZE" name="NAME">... ddvalue ...</ddselect>

Definiert eine Dropdown-Auswahl. Dabei bedeuten die Parameter

• titel: Name Auswahl. Dieser Wert wird angezeigt wenn noch keine Auswahl erfolgt ist. Vorgabe ist '[ bitte wählen ]'.
• size: Angabe wie viele Zeilen angezeigt werden sollen. Vorgabe ist 1
• name: Der Name der Auswahl. Vorgabe ist „Ausgabe“

Die einzelnen Zeilen werden durch ddvalue definiert.

• <ddvalue show="SHOWTEXT" sample="SAMPLETEXT" picture="NAME">... WERT ...</ddvalue>

Jede ddvalue Definition entspricht einer Zeile in der DropDown-Auswahl. Dabei bedeuten die Parameter:

• show: Dieser Text wird in der Auswahl angezeigt. Die Vorgabe ist WERT
• sample: Der SAMPLETEXT wird beim einfügen als markierter Hinweis angegeben.
• picture: Wird ein Bild angegeben so wird dieses in der Liste angezeigt (als Hintergrund Bild)
• WERT: Gibt an was bei der Auswahl in den aktuellen Text eingefügt werden soll. Mit einem + Zeichen kann man angeben wo der Cursor platziert werden soll.

• <ddbutton show="SHOWTEXT" sample="SAMPLETEXT" picture="NAME">... WERT ...</ddbutton>

Entspricht ddvalue, allerdings werden die Button ohne Auswahlliste, als einzelne Elemente, benutzt.

JSButton

Mit JSButton kann man einen HTML-Button (<button>) erzeugen. Mit diesem Button kann man eine Javascript-Funktion aufrufen welche in Stargate Wiki definiert sein muss.

<jsbutton id="" name="" value="" class="" style="" click="" mover="" mout="">BText</jsbutton>

• id: Id des Buttons
• name: Name des Buttons
• value: Value des Buttons
• class: Klasse des Buttons
• style: Style Definition für den Button
• click: Javascript-Funktion für onclick
• mover: Javascript-Funktion für onmouseover
• mout: Javascript-Funktion für onmouseout
• BText: Beschriftung des Buttons

Hinweis: Momentan wird Wiki-Syntax in BText nur Teilweise unterstützt. Variablen werden erst mit der neuen Mediawiki Version 1.16 ausgewertet. Um Grafiken einzubinden sollten diese selbst keinen Verweis enthalten und müssen daher mit dem Parameter verweis= definiert werden. Beispiel: [[Datei:Bild.jpg|verweis=]]. Wird dies nicht so gemacht funktioniert der Button zwar, erzeugt aber keinen gültigen HTML-Code.

Die Definition der Javascript-Funktion(en) muss entweder in der Datei Mediawiki:<Skin>.js oder Benutzer:<Name>/<Skin>.js erfolgen.

CacheArray

Die Parser-Erweiterung CacheArray ermöglicht das anlegen und auslesen von Arrays. Das besondere dabei ist das diese Arrays nur einmal angelegt werden müssen und dann auch von anderen Seiten benutzt werden können. Hinweis: Natürlich bleibt das Array nicht erhalten wenn die ursprünglich angefragte Seite an den Browser ausgegeben wurde. Es kann nur während des Seitenaufbaus von aufgerufenen Seiten bzw. Vorlagen benutzt werden.

Befehle

• carray

Der Befehl zum setzen, auslesen und löschen der Arrays

• keys

Mehrere Index-Keys zu einem einzigen Verbinden

carray

{{carray:<Name_des_Array>|<Kommando>[''Parameter''…''Array-Werte'']}}

• Name_des_Array

Die Erweiterung ist in der Lage beliebig viele Arrays zu verwalten. Zur Unterscheidung dient dabei der Array-Name.

• Kommando

Die Steuerung von carray erfolgt über die folgenden Kommandos.

• w oder write

Das Kommando write füllt das Array mit den angegebenen Werten. Ist das Array bereits angelegt wird der Befehl ignoriert. Um ein Array erneut anzulegen muss es zuerst gelöscht werden, siehe Befehl delete.

Die Definition der Array-Werte erfolgt analog zur {{#switch:}} Definition. Ein Beispiel:

{{carray:EpName|w
| #default = <span class="error">Episodencode {{K}} ist unbekannt</span>
| SGA_1x01/02 = Aufbruch in eine neue Welt
| SGA_1x01 = Aufbruch in eine neue Welt, Teil 1
| SGA_1x02 = Aufbruch in eine neue Welt, Teil 2
| SGA_1x03 = Dunkle Schatten
| SGA_1x04 = 38 Minuten
}}

Das Array-Element #default wird immer dann ausgegeben wenn die Anfrage nach einem nicht definierten Wert gestellt wird, siehe Befehl read. Der Parameter {{K}} im default-Wert wird durch den Index ersetzt.

• r oder read

Mit dem Kommando read erfolgt die Abfrage des Arrays. Das folgende Beispiel

{{carray:EpName|r|SGA_1x01}}

würde nach der oben angegebenen Definition den Wert

Aufbruch in eine neue Welt, Teil 1

zurück liefern. Ist kein Wert definiert wird entweder nichts oder, wenn definiert, der Inhalt der Zeile #default ausgegeben.

• rw oder readwrite

Mit der Kombination der Kommandos read und write wird das Array zuerst gefüllt und dann die entsprechende Zelle ausgelesen. Der Aufruf muss daher lauten:

{{carray:EpName|rw|SGA_1x01
| #default = <span class="error">Episodencode ungültig</span>
| SGA_1x01/02 = Aufbruch in eine neue Welt
| SGA_1x01 = Aufbruch in eine neue Welt, Teil 1
| SGA_1x02 = Aufbruch in eine neue Welt, Teil 2
| SGA_1x03 = Dunkle Schatten
| SGA_1x04 = 38 Minuten
}}

• f oder file

Das Kommando entspricht write und erzeugt ebenfalls ein Array. Der Unterschied ist das die Daten aus einer anderen Seite gelesen werden. Es wird vor dem erzeugen geprüft ob das Array schon vorhanden ist und nur wenn dies nicht der Fall ist wird die Datei geladen. Siehe auch #Hinweise zum Einsatz.

{{carray|EpName|f|Vorlage:EpName/Fill}}

• fr oder fileread

Das Kommando ist eine Kombination aus file und read

{{carray|EpName|fr|Vorlage:EpName/Fill|SG1_1x10}}

• u oder used

Um zu prüfen ob ein Array bereits angelegt ist sollte das Kommando used benutzt werden. Ist das Array bereits vorhanden liefert die Anfrage die Anzahl der definierten Array-Elemente, ansonsten wird nichts zurück geliefert.

{{carray:EpName|u}}

• c oder count

Das Kommando gibt die Anzahl der definierten Array-Elemente zurück. Ist das Array noch nicht definiert ist das Ergebnis 0.

{{carray:EpName|c}}

• d oder delete

Mit dem Kommando delete wird das Array gelöscht. Dies ist immer dann nötig wenn das Array neu geschrieben werden soll, da das Überschreiben nicht möglich ist.

{{carray:EpName|d}}

keys

{{keys:[<Mod>:]<Key>[|[<Mod>:]<Key>…]}}

• Key

Der Key ist entweder direkt ein Text oder eine Variable. Vor dem Key kann ein Modifierer (Mod) angegeben werden.

• Mod

Mit dem Modifier kann der Key verändert werden. Definiert sind die Modifier l zum umwandeln des Keys in Kleinbuchstaben und u zum umwandeln in Großbuchstaben.

Das Kommando wandelt die Keys entsprechend der Modifier um, entfernt Leerzeichen und fügt zwischen den einzelnen Keys einen Unterstrich _ ein. Das Ergebnis wird dann zurückgeliefert.

{{keys:u: sg1 | 1x01 }}

Ergibt: SG1_1x01

Hinweis Damit nicht definierte Variablen als solche auch erkannt werden, müssen diese nach dem folgenden Muster eingesetzt werden: Nicht {{{1}}} sondern {{{1|}}}.

Hinweise zum Einsatz

Die Erweiterung kann, richtig eingesetzt, den Aufbau von Seiten beschleunigen die häufig eine Vorlage aufrufen die aus einer großen Anzahl an Werten einen Wert liefert. Dazu sollte eine eigene Seite angelegt werden die nur das Array füllt. Auf der eigentlichen Vorlagenseite sollte mit dem Befehl used geprüft werden ob das Array bereits gesetzt wurde. Wenn nicht kann die "Full"-Vorlage aufgerufen werden. Sonst sollte immer nur das Array ausgelesen werden.

Durch diese Konstruktion erreicht man das die große, daher langsame, 'Füll'-Vorlage nur einmal abgearbeitet werden muss und alle weiteren Zugriffe auf das Cache-Array erfolgen.

Die entsprechende Anweisung sollte wie folgt aussehen, definiert in Vorlage:EpName

{{#if: {{carray:EpName|u}} || {{EpName/Fill}} }}{{carray:EpName|r|{{{1}}}}}

Die Vorlage EpName/Fill füllt das Array EpName mit Werten die dann von der Vorlage EpName ausgelesen wird.

Wichtiger Hinweis

Die oben angegebene Vorgehensweise führt zu Problemen bei gesichteten Versionen. Wird diese Erweiterung benutzt sollte alternativ der Befehl file bzw. fileread eingesetzt werden.

Kleine Parser Erweiterungen

#in

Ermittelt ob Elemente in einer Menge enthalten sind. Je nach Suchmodus ist die Suche erfolgreich wenn alle oder mindestens ein Element gefunden wird. Sowohl das Trennzeichen der Elemente als auch die Rückgabe kann definiert werden.

{{ #in: ELEMENT | LISTE | TRENNER | MODUS | RÜCKGABE }}

• ELEMENT

Eine List der zu suchenden Elemente. Getrennt werden die Elemente durch das TRENNER-Zeichen.

• LISTE

Ein Aufzählung von Elementen, getrennt durch Komma oder durch den in TRENNER angegebene Ausdruck

• TRENNER

Definiert das Trennzeichen für die Listen. Wird keine Zeichen angegeben so wird das Komma benutzt

• MODUS

Auswahl wie gesucht werden soll. Ist der MODUS == e genügt es wenn ein Element gefunden wird. Wird kein Wert für MODUS angegeben oder a so müssen alle Elemente in der Liste vorkommen damit die Suche erfolgreich ist.

• RÜCKGABE

Eine Liste, getrennt durch TRENNER, der möglichen Rückgabewerte. Der erste Wert wird im Erfolgsfall zurückgegeben der zweite Fall wenn die Suche erfolglos war. Es ist möglich auch nur einer der Werte anzugeben. Um nur einen Wert für den Misserfolg anzugeben muss dieser wie folgt definiert werden: ,WERT (wenn TRENNER == ',')

• Ausgabe

Ist die Suche erfolgreich so werden alle gefundenen Werte als Liste ausgegeben. Bei einer erfolglosen Suche liefert die Funktion einen leeren String. Dieses Verhalten kann mit dem Parameter RÜCKGABE geändert werden.

Beispiele

{{ #in: b,c,d | a,b,c ||e}}

Die Suche (Modus==e) nach b,c,d in der Liste a,b,c liefert: b,c

{{ #in: b,d | a,b,c ||e|ja,nein}}

Die Suche (Modus==e) nach b,d in der Liste a,b,c liefert: ja

{{ #in: b,d | a,b,c |||ja,nein}}

Die Suche nach b,d in der Liste a,b,c liefert: nein

trim

Entfernen von führenden oder nachfolgenden Leerzeichen.

{{trim:PARAMETER}}}

• PARAMETER

Der Parameter kann ein Text oder sinnvoller eine Variable sein.

Als Rückgabe erhält man den angegebenen Wert ohne führende oder nachfolgende Leerzeichen. Der Einsatz der Funktion ist bei der Übergabe des Arraykeys sinnvoll da es vorkommen kann das der Wert einer Variablen ein führendes Leerzeichen enthält.

userinfo

Liefert einige Informationen zum aktuellen Benutzer.

{{userinfo:PARAMETER}}

• PARAMETER - Auswahl der gewünschten Information. Folgende Werte sind erlaubt

name - Benutzername

id - Benutzernummer

realname - Wirklicher Benutzername

email - Emailadresse

home - Verweis auf die Benutzerseite

talk - Verweis auf die Diskussionsseite des Benutzers

groups - Liefert eine Komma getrennte Liste aller Gruppen des Benutzers

group|<gname> - Prüft ob der Benutzer der Gruppe <gname> angehört. Ist der Benutzer in der Gruppe wird der Gruppenname <gname> zurück gegeben sonst ist die Rückgabe leer.

online|<name> - Prüft ob der Benutzer momentan online ist. Als Resultat liefert der Aufruf: online bzw. offline.

Hinweis Diese Funktion setzt die Erweiterung WhosOnline voraus. Ist die Erweiterung nicht installiert liefert der Aufruf unknown.

#recursiv

Wandelt einen Ausdruck so um das eine Vorlage auch mehrfach aufgerufen wird, wenn dies nötig ist. Dazu müssen die Werte die an die Vorlage übergeben werden sollen in () geschrieben werden. Erkennt die Vorlage einen Wert nicht so wird der Wert in das Ergebnis kopiert. Geklammerte Ausdrücke in Verweisen, d.h. Ausdrücke in [[]], werden nicht beachtet.

{{#recursiv:VORLAGE|TEXT|PARAMETER}}

• VORLAGE

Name der eigentlichen Vorlage. An diese werden alle ermittelten Werte übergeben.

• TEXT

Einer oder mehrere Werte die an die Vorlage übergeben werden sollen. Handelt es sich um mehrere Werte so müssen dies in Klammern () geschrieben werden. Nicht beachtet werden Ausdrücke in [[]].

• PARAMETER

Dieser Parameter wird, falls vorhanden, an die Vorlage weitergegeben.

Beispiel

{{#recursiv:Kürzel/Organisation|(sg1) (sga)}}

Ergibt: Stargate-Kommando Atlantis-Expedition

Dieser Aufruf entspricht dem folgenden

{{Kürzel/Organisation:sg1}} {{Kürze/Organisation:sga}}

#tocmod

{{#tocmod:<Parameter>|<Default>}}

Mit dieser Anweisung wird gesteuert ob und wie das Inhaltsverzeichnis angezeigt wird. Die Erweiterung entspricht den Original Wiki Befehlen __TOC__, __NOTOC__, __FORCETOC__ und ermöglich das Ein- bzw. Ausblenden des Inhaltsverzeichnisses. Die Ausgabe wird über die folgenden Parameter gesteuert. Sollen mehrere Parameter angegeben werden müssen diese mit Komma getrennt angegeben werden. Wird der erste Parameter leer übergeben so wird statt dessen der Defaultwert benutzt. Ist auch dieser nicht angegeben wird als Parameter set benutzt.

• no

Kein Inhaltsverzeichnis, entspricht __NOTOC__

• force

Erzwingt das Inhaltsverzeichnis, entspricht __FORCETOC__

• set

Setzt das Inhaltsverzeichnis an diese Stelle, entspricht __TOC__

• hide

Das Inhaltsverzeichnis wird verdeckt ausgegeben, unabhängig von den Benutzereinstellungen.

• show

Das Inhaltsverzeichnis wird aufgedeckt ausgegeben, unabhängig von den Benutzereinstellungen.

Beispiel

• {{#tocmod:force,hide}}

Erzwingt das Inhaltsverzeichnis und verdeckt es.

• {{#tocmod:{{{Register|}}}|set,hide}}

Benutzt entweder den Wert der Variable oder wenn diese nicht belegt ist den angegebenen Defaultwert. Bei der Variable ist der Trenner | wichtig da nur so bei undefinierter Variable auch ein Leerstring übergeben wird.

AddWhosOnline

Bei AddWhosOnline handelt es sich um Zusatzfunktionen der Erweiterung WhosOnline. Die AddWhosOnline erkennt wenn ein Benutzer sich abmeldet und setzt ihn entsprechend auf offline. Außerdem wird ein Eintrag im Persönlichen Menü erzeugt der auf die WhosOnline Spezialseite verweist.

Code

Download des Codes: SGPack.php, SGPack.i18n.php