Benutzer:Rene/SGPack: Unterschied zwischen den Versionen

'''SGPack''' ist eine Sammlung von Mediawiki-Erweiterungen die speziell für Stargate-Wiki programmiert wurden. Es ist zudem möglich die Erweiterungen einzeln zu benutzen. Die Vorgehensweise wird im Abschnitt ''Installation'' erklärt. '''Die Erweiterung benötigt MediaWiki in der Version 1.17 oder später.''' Die Erweiterung SGHtml benötigt die Version 1.24.

<div style="margin-bottom:10px; margin-right: 270px; padding:0.5em; border:1px solid #CDCDC1; background:#C6E2FF;">

<div style="float: right;">[[Datei:Nuvola_apps_kservices.png|80px|verweis=]]</div><h2>Installation</h2>

<div style="text-align:justify;">

Die Erweiterung muss in ein eigenes Verzeichnis z.B. SGPack im Verzeichnis ''extensions'' entpackt werden. Dann muss die Datei Localsettings.php um die Zeile

<code>require_once("$IP/extensions/SGPack/SGPack.php");</code>

ergänzt werden. Standardmäßig sind nach der Installation alle Erweiterungen, außer SGHTML und AddWhosOnline, aktiviert. Um einzelne Erweiterungen auszuschließen muss '''nach''' der <code>require_once</code> Anweisung der entsprechende Parameter auf <code>false</code> gesetzt werden.<br />Die neue Version unterstützt nun vollständig das MediaWiki Messagesystem. Alle Texte sind in der Datei SGPack.i18n.php definiert, momentan in Deutsch und Englisch und daher auch in den [[Spezial:MediaWiki-Systemnachrichten|MediaWiki-Systemnachrichten]] zu finden. ''Die Bezeichnung der einzelnen Texte bitte der Datei SGPack.i18n.php entnehmen.''

===Parameter===

{| class="wikitable mw-collapsible mw-collapsed" style="width: 100%;"

| $wgSgpBlockSpammer || true || Aktivieren bzw. deaktivieren der Erweiterung BlockSpammer

| $wgBlockSpammerStayEdit || false || Gibt an ob nach einer Spam Erkennung der Editor wieder erscheint oder dieser geschlossen wird und damit die Eingabe gelöscht wird.

| $wgPageProtectOpenNamespaces || array(NS_USER_TALK) || Freie Namensräume. In diesen ist das Schreiben für alle erlaubt.

| $wgSGHTMLImageTop || || Pfad und Name des Bildes für den Sprung nach oben Button z.B. <code>$wgScriptPath.'/skins/common/images/16x16/blue_up.gif'</code>

| $wgSGHTMLImageEdit || || Pfad und Name des Bildes für den Bearbeiten-Button z.B. <code>$wgScriptPath.'/skins/common/images/16x16/edit.png'</code>

| $wgSgpAddWhosOnline || false || Aktivieren bzw. deaktivieren der Erweiterung [[#AddWhosOnline|AddWhosOnline]]

| $wgSgpVideoPlayer || true || Aktivieren bzw. deaktivieren der Erweiterung [[#VideoPlayer|VideoPlayer]]

<div style="margin-bottom:10px; margin-right: 270px; padding:0.5em; border:1px solid #CDCDC1; background:#B9FFC5;">

<div style="float: right;">[[Datei:Green_copyright_shiny.svg|80px|verweis=]]</div><h2>Copyright</h2>

<div style="text-align:justify;">

Die Erweiterung unterliegt der GPL (Version 2). Das bedeutet der Einsatz in anderen MediaWikis ist erlaubt, solange der Hinweis auf den Autor 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 Systemen benutzt werden, unter Beachtung der GPL.

Über einen kleinen Hinweis (auf der [[Benutzer Diskussion:Rene/SGPack|Diskussionsseite]]) in welchem Wiki die Erweiterung eingesetzt wird würde ich mich freuen, ist aber keine Pflicht.

<div style="margin-bottom:10px; margin-right: 270px; padding:0.5em; border:1px solid #CDCDC1; background:#FEFFE0;">

<div style="float: right;">[[Datei:Ark-icon.svg|80px|verweis=]]</div><h2>Download - Aktuell: V 1.5.01</h2>

<div style="text-align:justify;">

[[Datei:Bullet go.png]]'''[http://www.stargate-wiki.de/download/SGPack.zip SGPack.zip]'''<br />

[[Datei:Bullet go.png]]'''[http://www.stargate-wiki.de/download/SGPack.txt SGPack.php]'''<br />

[[Datei:Bullet go.png]]'''[http://www.stargate-wiki.de/download/SGPack.i18n.txt SGPack.i18n.php]'''<br />

''Hinweis: Die Dateien werden jeweils mit der Endung .txt angezeigt bzw. heruntergeladen. Um sie zu benutzen müssen sie mit der Endung .php gespeichert werden''

* '''1.2.95:''' Sonderzeichenfehler in DropDownInsert behoben - Funktion PHP utf8_decode wird benutzt.

* '''1.2.96:''' Funktionsaufruf wfLoadExtensionMessage entfernt - Wird seit 1.16 nicht mehr benötigt, seit 1.21 nicht mehr unterstützt.

:Fehler in NewArticle - Artikelinhalt mit fetchContent() auslesen statt aus Artikel-Objekt.

:Funktion addKeywords wird in MW 1.22 durch addMeta ersetzt

:userinfo: Fehler abfangen wenn HTTP_USER_AGENT nicht gesetzt.

:<nowiki>#rekursiv</nowiki>: Nicht ersetzte Ausdrücke werden jetzt immer in Klammern zurückgegeben. Zusätzliche Parameter werden richtig weitergegeben.

* '''1.5.00:''' Aufteilung des Pack in einige zusätzliche Dateien (Anpassung an MW Vorgaben):

== BlockSpammer ==

BlockSpammer ist eine Erweiterung, die verhindert, dass unangemeldete Benutzer (IPs) unerwünschte Ausdrücke in den Artikeltext oder die Zusammenfassung eintragen.

Die Erweiterung prüft nur Änderungen von nicht angemeldeten Benutzern. Wenn diese einen verbotenen Eintrag machen, wird die Übername der Änderungen verweigert. Die Ausdrücke werden anhand von Regex Anweisungen ermittelt. Die Definition der Anweisungen erfolgt in der Systemnachricht <code>blockspammer-regex</code> (Komma getrennte Liste) [[Mediawiki:blockspammer-regex|Beispiel]].

 

 

Ist dieser Parameter auf <code>true</code> (Vorgabe) gesetzt so bleibt der Editor aktiv, inklusive der bemängelten Eingaben. Ist der Wert des Parameters dagegen <code>false</code> so wird die Eingabe verworfen und der Editor geschlossen.

 

== NewArticle ==

 

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 JavaScript-Funktion.<br />

 

 

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.

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

;Beispiel:

* Bild [[Bild:SGPack_Edit.png]] statt Text '''Bearbeiten''' um einen Abschnitt zu bearbeiten

Die Erweiterung benutzt die MediaWiki-Hooks '''OutputPageBeforeHTML''' und '''BeforePageDisplay'''.

''Da diese Erweiterung speziell für Stargate Wiki geschrieben wurde ist sie in der Grundeinstellung deaktiviert.''

MediaWiki-Version: Die Erweiterung manipuliert das Aussehen der HTML Seite vor der Ausgabe. Das funktioniert nur unter MW 1.24. Daher ist die Erweiterung in früheren Version deaktiviert. Das gilt nicht für die Meta-Keyworte, diese werden immer gesetzt.

In der Grundeinstellung nutzt die Erweiterung zwei PublicDomain Bilder aus diesem [http://www.icojam.com/blog/?p=259 Iconset].

;LocalSettings-Parameter

* <code>$wgSGHTMLImageTop</code>, <code>$wgSGHTMLImageEdit</code>

== PageProtection ==

Diese Erweiterung ermöglicht die Kontrolle darüber wer Seiten bearbeiten darf.

Gedacht ist die Erweiterung hauptsächlich für die Namensräume Benutzer (NS_USER) und Benutzer Diskussion (NS_USER_TALK). In der Grundeinstellung dürfen die Seiten im Benutzernamensraum nur vom Besitzer bearbeitet werden. Die Seiten im Namensraum Benutzer Diskussion sind dagegen frei, können aber vom Besitzer gesperrt werden. Um den Schutz einer Seite einzustellen muss die Anweisung <code><nowiki><user></nowiki></code> benutzt werden.

* <code><nowiki><user>XYZ,ABC</user></nowiki></code> gibt die Seite nur für die Benutzer XYZ und ABC frei.

Um Seiten im Namensraum Benutzer Diskussion zu schützen, muss zumindest eine <code><nowiki><user></nowiki></code>-Anweisung auf der Seite definiert werden. Um die Seite nur für sich selbst frei zu geben, schreibt man <code><nowiki><user>Mein_Benutzername</user></nowiki></code> auf die Seite. Den selben Effekt erreicht man auch mit dem kurzen <code><nowiki><user>-</user></nowiki></code>. Wo auf der Seite die <code><nowiki><user></nowiki></code>-Anweisung steht spielt keine Rolle. Es empfiehlt sich aber, diese gleich an den Anfang der Seite zu setzen.

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

In anderen als den definierten Namensräumen hat die <code><nowiki><user></nowiki></code> Anweisung keine Wirkung und wird einfach ignoriert.

* <code>$wgPageProtectOpenNamespaces</code>

* <code>$wgPageProtectOwnerAlways</code>

: Über diesen Parameter kann eingestellt werden ob ein Benutzer sich aus der eigenen Seite aussperren kann. Die Vorgabe ist <code>true</code>, der Benutzer kann sich nicht selbst aussperren.

* <code>$wgGroupPermissions[Gruppe]['pageprotection']</code>

:Zur Sicherheit sollte es immer eine Gruppe, in der Regel die Gruppe der Administratoren, geben die auch auf geschützte Seiten zugreifen kann. Dies wird über die Gruppenzugriffsrechte <code>$wgGroupPermissions[Gruppe]['pageprotection']</code> geregelt. Als Vorgabe ist die Gruppe der Administratoren berechtigt auf geschützt Seiten zu zugreifen <code>$wgGroupPermissions['sysop']['pageprotection'] = true;</code>

== DropDownInsert ==

Die Idee zu DropDownInsert basiert auf der bekannten [http://www.mediawiki.org/wiki/Extension:CharInsert CharInsert-Erweiterung]. DDInsert geht aber über die Möglichkeiten von CharInsert hinaus. Die Erweiterung stellt die folgenden Befehle bereit:

* <code><nowiki><ddselect titel="TITEL" size="SIZE" name="NAME">... ddvalue ...</ddselect></nowiki></code>

:* <var>titel</var>: Name Auswahl. Dieser Wert wird angezeigt wenn noch keine Auswahl erfolgt ist. Vorgabe ist '[ bitte wählen ]'.

:* <var>size</var>: Angabe wie viele Zeilen angezeigt werden sollen. Vorgabe ist 1

* <code><nowiki><ddvalue show="SHOWTEXT" sample="SAMPLETEXT" picture="NAME">... WERT ...</ddvalue></nowiki></code>

:* <var>show</var>: Dieser Text wird in der Auswahl angezeigt. Die Vorgabe ist WERT

:* <var>picture</var>: 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 dem Pluszeichen <code>+</code> kann man zudem angeben, wo der Cursor platziert werden soll.

* <code><nowiki><ddbutton show="SHOWTEXT" sample="SAMPLETEXT" picture="NAME">... WERT ...</ddbutton></nowiki></code>

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

Mit JSButton kann man einen HTML-Button ([http://de.selfhtml.org/html/formulare/klickbuttons.htm#modern <button>]) erzeugen. Mit diesem Button kann man eine Javascript-Funktion aufrufen, welche in Stargate Wiki definiert sein muss.

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

* <var>click</var>: Javascript-Funktion für onclick

* <var>mover</var>: Javascript-Funktion für onmouseover

: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 <var>verweis=</var> definiert werden. Beispiel: <code><nowiki>[[Datei:Bild.jpg|verweis=]]</nowiki></code>. 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:Common.js|Mediawiki:<Skin>.js]]''' oder '''[[Benutzer:{{userinfo:name}}/common.js|Benutzer:<Name>/<Skin>.js]]''' erfolgen.

Die Parser-Erweiterung CacheArray ermöglicht das Anlegen und Auslesen von Arrays. Das besondere dabei ist, dass 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.''

{{Klappbox

|INHALT =

* '''carray'''

:Der Befehl zum Setzen, Auslesen und Löschen der Arrays

* '''keys'''

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

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

* '''Key'''

* '''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.

<nowiki>{{keys:u: sg1 | 1x01 }}</nowiki>

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

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

Die Erweiterung kann, richtig eingesetzt, den Aufbau von Seiten beschleunigen, die häufig eine Vorlage aufrufen, welche 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, dass 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]]

<nowiki>{{#if: {{carray:EpName|u}} || {{EpName/Zuordnung}} }}{{carray:EpName|r|{{{1}}}}}</nowiki>

Die Vorlage EpName/Zuordnung füllt das Array ''EpName'' mit Werten, die dann von der Vorlage EpName ausgelesen werden.

'''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 ==

<nowiki>{{ #in: ELEMENT | LISTE | TRENNER | MODUS | RÜCKGABE }}</nowiki>

: Auswahl wie gesucht werden soll. Ist der MODUS == '''e''' (oder '''s''') 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.

: 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 == ',')

<nowiki>{{ #in: b,c,d | a,b,c ||e}}</nowiki>

Die Suche (Modus==e) nach b,c,d in der Liste a,b,c liefert: '''{{ #in: b,c,d | a,b,c ||e}}'''

<nowiki>{{ #in: b,d | a,b,c ||e|ja,nein}}</nowiki>

Die Suche (Modus==e) nach b,d in der Liste a,b,c liefert: '''{{ #in: b,d | a,b,c ||e|ja,nein}}'''

<nowiki>{{ #in: b,d | a,b,c |||ja,nein}}</nowiki>

Die Suche nach b,d in der Liste a,b,c liefert: '''{{ #in: b,d | a,b,c |||ja,nein}}'''

{{Anker|trim}}{{Klappbox|TITEL=trim|anfang}}

<nowiki>{{trim:PARAMETER}}}</nowiki>

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, dass der Wert einer Variablen ein führendes Leerzeichen enthält.

{{Klappbox|ende}}

<nowiki>{{userinfo:PARAMETER}}</nowiki>

**'''id''' - Benutzernummer. Die id 0 steht für einen nicht angemeldeten Benutzer.

**'''online{{!}}<name>''' - Prüft ob der Benutzer momentan online ist. Als Resultat liefert der Aufruf: ''online'' bzw. ''offline''.<br>'''Hinweis''' Diese Funktion setzt die Erweiterung [http://www.mediawiki.org/wiki/Extension:WhosOnline WhosOnline] voraus. Ist die Erweiterung nicht installiert, liefert der Aufruf ''unknown''.

**'''browser [{{!}}<kennung>]''' - Ermittelt die Browserkennung des Benutzers. Wird der Parameter angegeben prüft der Befehl ob der Parameter-Text in der Kennung enthalten ist. Ist dies der Fall wird der Parameter zurückgegeben sonst nichts. Wird vom Aufrufer keine Browserinfo geliefert, wird "undefined" zurückgegeben.<br>'''Beispiel''' <code><nowiki>{{userinfo:browser|MSIE 9}}</nowiki></code> liefert ''MSIE 9'' wenn der Internet Explorer in der Version 9 benutzt wird.

{{Anker|#link}}{{Anker|link}}{{Klappbox|TITEL=#link|anfang}}

Mit der Anweisung #link können HTML-Link Anweisungen in den Seitenkopf eingebaut werden. Eine Übersicht der Möglichkeiten findet man auf [http://de.selfhtml.org/html/kopfdaten/beziehungen.htm selfhtml].

<nowiki>{{#link:ART|SEITE[|TITEL]}}</nowiki>

* SEITE: Name der Seite

* TITLE: Wenn angegeben der Titel, sonst wird SEITE benutzt

Man kann diese Anweisung z.B. benutzen um Episoden zu verknüpfen. In den Artikel [[Die Invasion, Teil 3]] wird dazu eingebaut:

<nowiki>{{#link:next|Die_Invasion,_Teil_4}}</nowiki>

Es gibt einige Browser bzw. Browsererweiterungen ''z.B. für [https://addons.mozilla.org/en-US/firefox/addon/link-widgets/ Firefox]'' die diese Angaben auswerten. Außerdem können die Angaben von Maschinen, z.B. der Google-Suche, gelesen und ausgewertet werden.

'''Achtung''' Es erfolgt keine Überprüfung des Parameters Art. Es sollten nur die gängigen Bezeichnungen benutzt werden. Diese findet man z.B. bei Selfhtml.

{{Klappbox|ende}}

{{Anker|#recursiv}}{{Anker|recursiv}}{{Klappbox|TITEL=#recursiv|anfang}}

Wandelt einen Ausdruck so um, dass 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 <code>[[]]</code>, werden nicht beachtet.

<nowiki>{{#recursiv:VORLAGE|TEXT|PARAMETER}}</nowiki>

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

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

:Dieser Parameter wird, falls vorhanden, an die Vorlage weitergegeben. Es ist auch möglich beliebig viele weitere Parameter an zu geben, jeweils durch {{!}} getrennt. Diese werden alle weitergegeben.

<nowiki>{{#recursiv:Kürzel/Organisation|(sgc) (sga)}}</nowiki>

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

<nowiki>{{Kürzel/Organisation|sgc}} {{Kürze/Organisation|sga}}</nowiki>

{{Klappbox|ende}}

{{Anker|#tocmod}}{{Anker|tocmod}}{{Klappbox|TITEL=#tocmod|anfang}}

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

Mit dieser Anweisung wird gesteuert ob und wie das Inhaltsverzeichnis angezeigt wird. Die Erweiterung entspricht den Original Wiki-Befehlen <code><nowiki>__TOC__</nowiki></code>, <code><nowiki>__NOTOC__</nowiki></code>, <code><nowiki>__FORCETOC__</nowiki></code> 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.

:Kein Inhaltsverzeichnis, entspricht <code><nowiki>__NOTOC__</nowiki></code>

:Setzt das Inhaltsverzeichnis an diese Stelle, entspricht <code><nowiki>__TOC__</nowiki></code>

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

* <code><nowiki>{{#tocmod:force,hide}}</nowiki></code>

* <code><nowiki>{{#tocmod:{{{Register|}}}|set,hide}}</nowiki></code>

: Benutzt entweder den Wert der Variable oder wenn diese nicht belegt ist den angegebenen Defaultwert. ''Bei der Variable ist der Trenner {{!}} (also <code><nowiki>{{{Register|}}}</nowiki></code> statt <code><nowiki>{{{Register}}}</nowiki></code>) wichtig, da nur so bei undefinierter Variable auch ein Leerstring übergeben wird.''

{{Klappbox|ende}}

Bei AddWhosOnline handelt es sich um Zusatzfunktionen der Erweiterung [http://www.mediawiki.org/wiki/Extension:WhosOnline 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.

== IE9 Hack ==

;Das Problem

Die MediaWiki JavaScript-Funktion <code>insertTag</code> zeigt mit dem Internet Explorer 9 ein störendes Verhalten. Wird ein Text über die MediaWiki in den Editor eingefügt, so springt der Bildschirm an den Anfang der Seite. Diese Funktion wird von den Modulen NewArticle und DDInsert in SGPack benutzt.

;Die Lösung

Um dies zu umgehen, speichert sich der IE9 Hack die Bildschirmposition vor dem Einfügen und setzt sie danach wieder zurück. Somit kann der Benutzer normal weiterarbeiten.

;Probleme

Mit dem Internet Explorer kann es dadurch zu einem kurzen Flackern der Darstellung kommen, in anderen Browsern geschieht dies normalerweise nicht.

;Hinweis

Die betroffene JavaScript-Funktion wird auch an anderer Stelle, z.B. im Editor, durch die MediaWiki Software benutzt. An diesen Stellen hilft der IE9 Hack nicht, da er nicht eingebunden wird.

== VideoPlayer ==

VideoPlayer erlaubt das einbinden von externen Videoquellen in Mediawiki. Die Ausgabe der Videos erfolgt mit [http://www.jwplayer.com jwplayer]. Das Einbinden erfolgt durch folgende Parser Anweisung.

<nowiki>{{#vplayer:video="VIDEO"}}</nowiki>

* <code>video</code>

: Angabe der Adresse des Videos. Es muss sich um eine vollständige Netzadresse handeln. Videos aus dem Wiki müssen also vorher umgewandelt werden. Dies kann durch die Mediawiki Funktion <nowiki>{{filepath:Datei}}</nowiki> erfolgen.

: Erlaubt die Angabe mehrerer Videos, welche nacheinander abgespielt werden. Rechts vom Video erscheint eine Liste aller Videos aus der eines gewählt werden kann. Die einzelnen Videos werden durch Komma getrennt. ''Da es Netzadressen mit Komma geben kann ist es notwendig die Adressen in " einzuschließen!''.

* <code>width</code>, <code>height</code>

* <code>poster</code>{{Anmerkung|Diese Parameter enthalten bei einer Playliste Komma getrennte Listen der Werte für die einzelnen Videos.|name=Playlist1}}

: Erlaubt die Angabe eines Bildes aus dem Wiki das vor dem Start des Videos gezeigt wird. Die Angabe der Datei erfolgt direkt ohne <code><nowiki>[[Bild:...]]</nowiki></code>

:<code><nowiki>{{vplayer:video="VIDEO"|poster="SamPhoto.jpg"}}</nowiki></code>

* <code>title</code>{{Anmerkung|name=Playlist1}}

* <code>description</code>{{Anmerkung|name=Playlist1}}

: Beschreibung der Videos in der Playliste. Wird in der Titelbar angezeigt

* <code>autostart</code> ''Funktioniert nicht immer''

: Die Wiedergabe startet sofort.

* <code>repeat</code>

* <code>mute</code>

* <code>controls</code> ''Parameter ohne Funktion - Fehler im SGPack''

: Es werden keine Bedienelemente angezeigt. Eine Sterung des Players ist dann nur noch über die [http://support.jwplayer.com/customer/portal/articles/1439411-example-a-chromeless-player Player API] möglich!

* <code>displaytitle</code>

* <code>stretching</code> ''Funktioniert nicht für alle Videos''

: Einstellung wie das Video an den Bereich angepasst werden soll. Mögliche Werte: ''uniform'' (Vorgabe), ''fill'', ''exactfit'', ''none''

* <code>css</code>

: Erlaubt die Angabe einer CSS-Klasse, welche im DIV-Container des Videos gesetzt wird.

* <code>l.position</code>{{Anmerkung|Diese Parameter ist ohne Playliste ohne Funktion.|name=Playlist2}}

: Position der Titelbar. Mögliche Werte: right (Vorgabe), bottom, none

* <code>l.size</code>{{Anmerkung|name=Playlist2}}

: Größe der Titelbar. Vorgabe: 150

* <code>l.layout</code>{{Anmerkung|name=Playlist2}}

: Darstellung der Titelbar. Mögliche Werte: basic, extended (Vorgabe) - extended ist mit Vorschau und Beschreibung, Basic eine reine Textliste mit dem Titel

:;Anmerkungen

<references group="A" />

* <code><nowiki>{{#vplayer:playlist="https://www.youtube.com/watch?v=6xJl1dGdddw","https://www.youtube.com/watch?v=jfNjgOIoo-c"|title="Video 1","Video 2"|description="text text","hallo video"|width="300"|height="300"|l.position="bottom"|l.size=100|l.layout="basic"}}</nowiki></code>

Die Ausgabe erfolgt in einem <code><nowiki><div></nowiki></code>-Bereich. Der Bereich kann mit der CSS-Klasse <code>video_player</code> verändert werden, die in allen Bereichen immer gesetzt ist. Als weitere Möglichkeit kann zu jedem Bereich eine eigene Klasse angegeben werden. Jeder Bereich hat einen eigene ID (<code>video_player_NR</code>, wobei NR die laufende Nummer des Players ist, in der Reihenfolge ihrer Angabe im Artikel).

* <code>$wgSgpVideoPlayerCacheOff</code>

:Wird der Parameter auf <code>true</code> gesetzt so wird der MW-Cache für die Seite mit Videoausgaben deaktiviert. In der Voreinstellung ist der Cache aktiv

* <code>$wgSgpVideoPlayerEngine</code>

:Ermöglicht die Auswahl eines Videoplayers. Momentan ist nur der jwplayer installiert.

  <nowiki><jsbutton click="jwplayer('video_player_1').play();">Start Video 1</jsbutton></nowiki>