Handbuch:Skin-Konfiguration
Diese Seite erklärt die Konfiguration von Wiki-Skins für Administratoren
Diese Dokumentation bezieht sich auf MediaWiki 1.31+.
Für die Verwendung von Oberflächen (Skins), siehe Hilfe:Skins für allgemeine Informationen über Oberflächen.
Für Entwickler, die neue Skins erstellen oder bestehende Skins bearbeiten wollen, gibt es technische Informationen in Handbuch:Wie man einen MediaWiki-Skin erstellt.
Skins herunterladen
Der MediaWiki tarball-Download kommt vorgefertigt mit mehreren Benutzeroberflächen (Skins). Siehe Gebündelte Erweiterungen und Skins#Skins für eine Liste.
Wenn du hingegen MediaWiki von Git heruntergeladen hast, oder du zusätzliche Skins installieren willst, musst du den Code für diese Skin oder Skins separat herunterladen.
Viele MediaWiki Skins sind im Wikimedia Git repository enthalten (siehe die vollständige Liste hier). Du kannst Tar-Archive mit Skins vom Skin-Verteiler herunterladen.
Um eine Skin in dieser Gruppe via Git herunterzuladen, solltest du Folgendes abrufen:
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/[name of skin]
z.B.: Um die Standardskin Vector zu bekommen, solltest du das Folgende vom skins/-Unterverzeichnis deines MediaWiki-Installationsverzeichnisses abrufen:
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector
Wähle eine passende Version des Skins Ändere in den neuen Ordner und führe aus:
git checkout REL1_35
(REL1_35 durch einen anderen Release-Branch oder Tag ersetzen)
Skins installieren
Für jede Skin im /skin Verzeichnis, die du gerne verwenden würdest, musst du eine Zeile mit dem Code require_once in deiner §LocalSettings Datei hinzufügen.
Um z.B. Vector zu installieren, füge Folgendes hinzu.
Sind mehrere Skins vorhanden, muss jedes mit einer separaten Anweisung aktiviert werden:
// MediaWiki 1.24 or less require_once "$IP/skins/Vector/Vector.php"; // MediaWiki 1.25+ wfLoadSkin( 'Vector' );
(Das entspricht "Installieren eine Extension", nur in einem anderen Verzeichnis.)
Je nach Auswahl des Skins können weitere Schritte erforderlich sein. Detaillierte Installationsanweisungen sind auf den Seiten der Skins auf mediawiki.org zu finden, z.B. für Vector auf Skin:Vector#Installation. Anweisungen für alle anderen Skins sind auf den entsprechenden Seiten zu finden.
Standardskin für ein Wiki bestimmen
Eine Standardskin sollte für neue Benutzer eines Wiki gesetzt werden, indem die Variable $wgDefaultSkin in LocalSettings.php mit dem Skinnamen in Kleinbuchstaben gesetzt wird, der in der Skin-Datei definiert ist. Benutzer können dann noch immer ihre Skin ändern, indem sie auf ihre Einstellungen-Seite gehen, es sei denn, du deinstallierst oder unterbindest alle anderen Skins oder deaktivierst die Einstellungen gänzlich (siehe unten). Zum Beispiel:
$wgDefaultSkin = 'vector';
Das Ändern dieses Werts in einem bestehenden Wiki ändert automatisch die Einstellung aller Benutzer, die die vorhergehende Standardskin aktiviert hatten. Es gibt ein Wartungsskript, um die Einstellungen der Benutzer zu verändern (userOptions.php), aber du wirst es wahrscheinlich nicht brauchen.
Wenn du diesen Wert nicht änderst, ist Vector die Standardskin.
Skins deinstallieren
Um eine Skin zu deinstallieren, entferne die Zeile wfLoadSkin (oder require_once für MediaWiki 1.24 oder älter) von deiner LocalSettings.php-Datei.
Du kannst danach die Skin-Dateien aus dem skins/-Verzeichnis entfernen.
Wenn Benutzer die Skin verwendet haben, die du gerade deinstalliert hast, wird sie MediaWiki automatisch auf die Standardskin umstellen.
Skins ausblenden ohne zu deinstallieren
Der Administrator kann die Skin-Auswahl, die im Wiki in den Benutzereinstellungen verfügbar ist, limitieren, indem er sie im $wgSkipSkins array unterdrückt. Das kann nützlich sein, wenn du eine neue Skin testen möchtest, ohne dass Benutzer sie sehen können. Um die Skins dort zu listen, schreibe etwa in LocalSettings.php:
// To remove various skins from the User Preferences choices
$wgSkipSkins = array( "monobook", "timeless" );
Du kannst die Skin mittels des useskin URL Parameters in einer Vorschau ansehen.
Globale CSS-Anpassungen
MediaWiki erlaubt Adminstratoren, CSS-Regeln für das gesamte Wiki zu definieren, die auf jede aufgerufene Seite angewendet werden.
Diese Regeln können mit dem Bearbeiten der Seite $1 (altes MediaWiki:Common.css) im Wiki hinzugefügt werden, wenn $wgUseSiteCss auf "true" gesetzt ist.
Zusätzlich zu einem globalen Stylesheet können auch CSS-Regeln für einzelne Skins definiert werden (siehe Manual:Interface/Stylesheets).
Benutzerdefinierte CSS-Anpassungen
Benutzer können auch ihre eigenen CSS-Regeln definieren, indem sie die Seite "User:Username/common.css" erstellen.
Das CSS wird dann auf die Skin angewendet, die der Benutzer verwendet.
Wenn die Website auf eine andere Standardskin verändert wird, wird das benutzerspezifische CSS weiterhin funktionieren.
Dieses Feature kann aktiviert werden, indem in LocalSettings.php der Wert für $wgAllowUserCss auf "true" gesetzt wird.
Ein Benutzer kann außerdem CSS für eine bestimmte Skin definieren, indem er die Seite "User:Username/skinname.css" erstellt.
Wenn ein Benutzer beispielsweise die Skin MonoBook verwendet, würde er die die Seite Special:MyPage/monobook.css bearbeiten.
Skinauswahl in Benutzereinstellungen deaktivieren
| MediaWiki Version: | ≥ 1.16 |
Der Systemadministrator kann die komplette "Skin" Option entfernen, sodass sie überhaupt nicht mehr in den Benutzereinstellungen aufscheint. Das ergibt dann Sinn, wenn die Website eine angepasste Skin verwendet und nicht richtig in einer anderen Skin aussehen würde.
Um dies zu erreichen, füge eine neue Zeile in LocalSettings.php mit dem folgenden Code hinzu. Das entfernt die "Skin" Option von den Einstellungen und die Möglichkeit, den useskin Parameter in der URL zu verwenden.
$wgHiddenPrefs[] = 'skin';