Manual:LocalSettings.php/de

Die Datei   stellt grundlegende Konfigurationseinstellungen (basierend auf der Datei ) einer MediaWiki-Installation zur Verfügung. Diese Konfigurationsdatei sollte aufmerksam durchgegangen werden. Diese Datei wird standardmäßig vom MediaWiki-Webinstaller erstellt, aber die Parameter können optimiert werden, u. U. in Abhängigkeit von den Apache-Einstellungen. Für MediaWiki-Installationen, die als Wiki-Familie konfiguriert sind, steht die Datei  zur Verfügung.

Speicherort auf dem Server
Die -Datei ist keine Seite im Wiki und kann nicht über den Webbrowser aufgerufen werden.

Stattdessen handelt es sich um eine Datei aus dem Dateisystem des Servers. Ihre Inhalte werden während des ersten Setups des Wikis generiert und müssen manuell auf den Server kopiert werden. Die Datei muss in dem Ordner enthalten sein, in dem du MediaWiki installiert hast, auf einer gemeinsamen Ebene mit Ordnern wie  und   und Dateien wie. Wenn diese Datei dort nicht existiert, wird das Wiki unter keinen Umständen funktionieren – wenn das Wiki funktioniert, ist die Datei dort vorhanden. Wenn du nicht weißt, wo sie sich befindet, kannst du einen Befehl wie etwa find / -iname LocalSettings.php -print in ein Terminal-Fenster eingeben, um sie zu orten.

(Wenn du Vagrant benutzt, siehe auch MediaWiki-Vagrant#MediaWiki_settings.)

Sicherheitsaspekte
enthält üblicherweise sensible Daten wie z. B. die Zugangsdaten für eine Datenbank. Diese Daten sollten nie der Öffentlichkeit zugänglich gemacht werden! Aufgrund einer Sicherheitslücke irgendwo auf dem Server könnte es passieren, dass andere Benutzer die Fähigkeit erhalten, die Inhalte von dort abgelegten Dateien zu sehen. Um die Sicherheit deiner Daten zu erhöhen, solltest du UNIX-Berechtigungen für diese Datei wie folgt setzen: Der Webserver-Benutzer muss Zugriff auf diese Datei haben. Wenn dies das gleiche Benutzerkonto ist, das die Datei besitzt, kannst du die Berechtigungen auf 600 stellen. Manchmal ist der Webserver-Benutzer nicht der Besitzer der Datei, aber er ist in der UNIX-Benutzergruppe des Besitzers. In diesem Fall sollte die Berechtigung 640 in Ordnung sein. Für verbesserte Sicherheit solltest du Berechtigungen so sehr wie möglich einschränken.

Zusätzlich kannst du ein MySQL-Benutzerkonto anlegen, welches nur Zugriff auf die vom Wiki verwendete Datenbank hat, und dessen Zugangsdaten in  zur Verfügung stellen. Du kansst deinen Datenbankserver auch so konfigurieren, dass er nur Verbindungen von localhost akzeptiert – dies sollte Zugriff von außen im Falle vom Öffentlichwerden von Zugangsdaten verhindern.

Siehe auch für eine Methode, wie du die sensiblen Daten aus   in eine andere Datei in einem anderen Verzeichnis verschieben kannst.

Dateiinhalte
Wenn du  bearbeitest, gehe sicher, dass du die Datei wieder in der richtigen Codierung speicherst. Du solltest die Codierung „ANSI as UTF-8“ benutzen – das ist die UTF-8-Codierung ohne die Byte-Reihenfolge-Markierung (BOM).

beinhaltet PHP-Code; hauptsächlich die Definition von Variablen und deren Werten. Eine Einstellung zu verändern bedeutet normalerweise, den Wert einer PHP-Variablen umzuändern. Deine Änderungen werden sofort wirken, nachdem die Datei wieder auf dem Server gespeichert wird. Es ist nicht erforderlich, manuell irgendetwas neu zu starten. Jedoch könnte es sein, dass du in einigen Fällen deinen Browser-Cache leeren musst, um tatsächlich die Änderungen zu sehen, die du gemacht hast.

Die Standardwerte von vielen weiteren Einstellungen sind in  gesetzt, welche nicht bearbeitet werden sollten. Wenn die Variable, die du verändern möchtest, nicht schon in deiner -Datei vorhanden ist, kopiere die betroffene Zeile von   und modifiziere sie entsprechend in. Am Ende von  kannst du neue Zeilen hinzufügen.

In der Datei können auch mehrere Zeilen wie etwa ' ' enthalten sein, welche Erweiterungen einbinden. Diese Zeilen aktivieren die jeweilig zugehörige Erweiterung in dem Wiki. Diese Erweiterungen benötigen eventuell das Einstellen von weiteren Variablen in ; überprüfe die Dokumentation der entsprechenden Erweiterung für weitere Anweisungen.

Wie die meisten PHP-Dateien in MediaWiki endet  nicht mit dem schließenden PHP-Tag. Dies hindert Administratoren daran, versehentlich neue Informationen hinter diesem Tag hinzuzufügen. PHP funktioniert auch ohne einen schließenden Tag korrekt.

Wer ein Wiki in einer MediaWiki-Wikifarm betreibt, besitzt eventuell keinen Schreibzugriff (oder sogar keinen Lesezugriff) auf die Datei  (siehe z. B. ). Der Betreiber der Wiki-Farm kann bereit sein, die gewünschten Änderungen vorzunehmen, muss es aber nicht. Möglicherweise besteht er darauf, dass die meisten Einstellungen für alle Wikis der Wikifarm gleich bleiben.

Übersicht über verfügbare Einstellungen
Siehe den Index zu Konfigurationseinstellungen und lies die Kommentare in der -Datei, um eine Übersicht darüber zu erhalten, was jede Variable macht. Eine kurze Auflistung der wichtigsten Variablen sowie der am häufigsten angefragten Funktionen befindet sich hierunter.

Installationsverzeichnis
Die Variable  (install path) enthält den lokalen Dateipfad zur Basisinstallation deines Wikis. Seit MediaWiki 1.18 stellt das System $IP automatisch ein. Das manuelle Festlegen von  in   ist nicht mehr notwendig. stellt sich standardmäßig auf das aktuelle Arbeitsverzeichnis ein und kann genutzt werden, ohne manuell definiert werden zu müssen. Attempting to set  (or  ) in   may produce unexpected results.

Die Datei wird vom durch die Variable IP vorgesehenen Verzeichnis geladen.

Seitenname
 enthält den Namen des Wikis. Dieser Name wird viele Male im ganzen System verwendet, etwa in MediaWiki:Pagetitle. Beispielsweise macht der Wikipedia-Slogan „Aus Wikipedia, der freien Enzyklopädie“ Gebrauch von dieser Einstellung.

Deklinierung des Seitennamens
Einige Übersetzungen der Oberfläche ermöglichen die Flexion des Seitennamens. Du kannst angepasste Wordformen in der Variable  einstellen. (Für Beispiele lese bitte die Dokumentation zu .)

Seitensprache
 stellt die Sprache der Benutzeroberfäche des Wikis ein. Während Benutzer die Sprache, die sie sehen, in den Benutzereinstellungen wechseln können, legt die Variable die Standardsprache für alle anonymen Benutzer und die meisten registrierten Benutzer fest.

Skriptpfad
 ist das Präfix im URL-Pfad, unter welchem auf das MediaWiki-Hauptskript, dem zentral arbeitenden Code von MediaWiki, zugegriffen wird. Diese Einstellung sollte mit den Apache-Einstellungen korrespondieren, insbesondere dann, wenn du Apaches Rewrite-Engine benutzt.

Servername
 enthält die Basis-URL des Servers, einschließlich des Protokolls, aber ohne den schließenden Schrägstrich und ohne jegliche Unterverzeichnisse, sollten diese existieren. Wenn das Wiki vom localhost aufgerufen wird, auf dem es läuft, von einem Intranet oder dem Internet, würden E-Mail-Benachrichtigungen und ein paar andere generierte Nachrichten normalerweise von verschiedenen URLs geliefert werden.

Ab MediaWiki 1.34 muss  in LocalSettings.php definiert werden. Davor versuchte MediaWiki, den Servernamen automatisch zu erkennen und  war optional zum Überschreiben der automatischen Erkennung.

Wenn z. B. www.example.com die Serveradresse deines Wikis vom Internet aus gesehen ist, füge eine solche Zeile hinzu:

Das Magische Wort  kann auf Seiten im Wiki verwendet werden; es gleicht dem Wert von  ; allerdings wird es in einem Wiki, das wie die Wikis der Wikimedia-Familie relative URLs benutzt, nicht vollständig ausgegeben; hier zeigt es z. B. an, was in dieser Form weder angeklickt noch in die Addresszeile des Browsers kopiert werden kann.

You can also use a protocol relative URL as shown below. When using a protocol relative URL, be sure to set. is needed for some places in the code where an origin with a protocol and hostname is needed.

Skriptname
 ist der Name des MediaWiki zugrundelegenden PHP-Skripts (index), normalerweise benannt. Diesen Skriptnamen zu ändern ist meistens keine gute Idee. Wenn du aber das Verlangen hast, dies zu tun, ist das die Stelle, die du ändern solltest. Gehe sicher, dass du weißt, was du tust.

Artikelpfad
 ist der zu nutzende Pfad, wenn eine Seite in MediaWiki aufgerufen wird. Der Pfad sollte den Pfad zum Hauptskript beinhalten (in der Regel unter der Nutzung von ) und den Platzhalter   für den Artikelnamen verwenden.

Wenn du die Apache Rewrite Rules benutzt, um schöne und kurze URLs zu erstellen, wirst du  wahrscheinlich so anpassen müssen, dass es auf den richtigen Pfad zeigt. Beachte, dass wgArticlePath benutzt wird, um URLs innerhalb von MediaWiki zu konstruieren. Wenn du hier einen Fehler machst, werden inkorrekte interne Links auftauchen, während du die Hauptseite aber möglicherweise noch aufrufen kannst, indem du die richtige URL manuell spezifizierst. Siehe Manual:Short URL/de für mehr Informationen zur URL-Konfigurierung. Note that wgArticlePath is used to construct URLs from within MediaWiki. If you make a mistake here, internal links will show up incorrectly while you still may be able to access the main page by specifying the correct URL manually. See for more information on URL configuration.

Typische Werte sind:

Ort des Stylesheets
Benutze , um den URL-Pfad zum Ablageort der Stylesheets (CSS) für die MediaWiki-Installation einzustellen.  sollte auf den gleichen Ort zeigen; aber beachte, dass dies der Pfad eines lokalen Dateisystems ist, der in internen Skripten, die auf das Dateisystem zugreifen, genutzt wird.

Speicherort von hochgeladenen Dateien
Das Upload-Verzeichnis ist der Ort, an dem die von Benutzern hochgeladenen Dateien aufbewahrt werden. ' spezifiziert den URL-Pfad, ' zeigt auf den lokalen Dateisystempfad.

Logo
 legt fest, welche Grafik als Logo in der oberen linken Ecke auf allen Seiten im MediaWiki angezeigt wird. Die folgenden Schritte ersetzen das Standardlogo im Verzeichnis /wiki/skins/common/images/, wobei /wiki durch den Pfad zum Verzeichnis, in dem du die MediaWiki-Software installiert hast, ersetzt wird.

Kopiere zuerst das Logo, das du haben möchtest, in das Verzeichnis /wiki/skins/common/images/ (ersetze /wiki durch den Pfad, in dem du die MediaWiki-Software installiert hast).

Versuche dann, eine Zeile in  zu finden, die folgendermaßen aussieht:

Wenn es keine solche Zeile gibt, kannst du die obenstehende Zeile kopieren und am Ende der Datei einfügen.

Modifiziere anschließend diese Zeile, sodass sie auf dein Logo verweist. Das Logo muss im Web zugänglich sein. Der Wert dieser Variable wird an den Webbrowser weitergegeben, welcher ihn benutzt, um das Logo zu laden. Wenn du dir unsicher bist, was hier hineingehört, kannst du in deinem Webbrowser zum Logo navigieren (bspw. ist in diesem Wiki die URL des Logos http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png ) und die vollständige URL als Wert in diese Variable packen.

Einige Leute ersetzen bloß die Datei skins/common/images/wiki.png durch ihr Logo. Das wird nicht empfohlen, da das auf diese Weise angepasste Logo bei einem Upgrade überschrieben werden würde.

MediaWiki 1.35 introduced , which allows multiple versions of the same logo. An example of using multiple logos is shown below.

Kontaktinfo
 ist die E-Mail-Adresse des Benutzers, der zu kontaktieren ist, wenn etwas schief geht. An diese E-Mail-Adresse werden interne Fehlermeldungen gesendet. Als ein Administrator der Webseite solltest du deine E-Mail-Adresse hierin mit aufnehmen.

 ist die E-Mail-Adresse, von der E-Mails losgesendet werden, wenn Passwörter an Benutzer gesendet werden, die dieses vergessen haben. Wähle eine Adresse, an die Leute im Fall von Problemen oder Verwirrung Antworten senden können.

Datenbankeinstellungen
MediaWiki benötigt Zugriff auf die Datenbank (zurzeit entweder MySQL oder PostgreSQL), um Seiten, Modifikationen, Benutzerinformationen und viele weitere Dinge zu speichern.

 enthält den Namen des Hosts, auf dem die Datenkbank gehostet ist. In den meisten Fällen wird das einfach nur „localhost“ sein, da die Datenbank auf dem gleichen System läuft; aber für verteilte Installationen musst du den vollqualifizierten Namen der Domain des Computers angeben, der die Datenbank betreibt.

 ist der Datenbankname der Datenbank, die von MediaWiki genutzt werden soll. Eine einzelne MySQL- oder PostgreSQL-Installation kann mehr als eine Datenbank lagern und du kannst sogar mehrere MediaWiki-Installationen auf einem einzigen Server betreiben. Gehe sicher, dass du hier den richtigen Datenbanknamen festlegst und benutze unterschiedliche Datenbanknamen für verschiedene Wiki-Installationen mit dem gleichen Datenbankserver.

' und ' enthalten den Login-Namen und das Login-Password, das von MediaWiki genutzt wird, um Zugriff auf die Datenbank zu erhalten. Gehe sicher, dass der angegebene Benutzer die benötigten Rechte hat, um die Tabellen des Wikis auf dem Datenbankserver bearbeiten zu können.

Also see for a method to move the sensitive parts of   to a different file in a different directory.

Benutzerrechte
 ist ein assoziatives Array, das die Befugnisse für die Erstellung und das Bearbeiten von Seiten für deine verschiedenen Benutzergruppen kontrolliert. In diesem Array können benutzerdefinierte Berechtigungsebenen erstellt werden und Berechtigungsebenen für die verschiedenen Benutzergruppen können eingestellt werden. Siehe für mehr Informationen zu den verschiedenen verfügbaren Berechtigungen und Benutzergruppen.

Großgeschriebene Links erzwingen
Standardmäßig kann kein Seitenname mit einem Kleinbuchstaben des lateinischen Alphabets anfangen: Bei dem Versuch, eine Seite mit einem solchen Namen zu erstellen, wird der erste Buchstabe automatisch in einen Großbuchstaben konvertiert. Wenn ein Linkziel, eine eingebundene Seite oder eine Kategorie oder ein eingebundenes Bild mit einem Kleinbuchstaben als Anfangsbuchstaben angegeben wird, ist das tatsächliche Ziel etc. die Seite beginnend mit einem korrespondierenden Großbuchstaben.

Alternativ können Seitennamen mit einem Kleinbuchstaben beginnen, zusätzlich zu den Möglichkeiten, den Namen mit einem Großbuchstaben, Ziffer, etc. beginnen zu lassen. Dafür musst du  anpassen. Wenn es auf false gestellt wird, werden Kleinbuchstaben erlaubt, true wählt das Standardverhalten aus.

Unterseiten aktivieren
In  werden Unterseiten aufgeteilt nach Namensräumen mittels  aktiviert. Beispielsweise für das Aktivieren von Unterseiten im Hauptnamensraum:

Dateiupload
Bevor Benutzer die Möglichkeit haben, Dateien zum MediaWiki-System hochzuladen, musst du dieses Feature aktivieren. Gehe sicher, dass das Upload-Verzeichnis richtig konfiguriert ist und vom Apache-Webserver-Prozess beschrieben werden kann. Setze dann  auf true, um Uploads in der Web-Benutzeroberfläche zu erlauben.

Hier ist ein Beispielcode aus includes/DefaultSettings.php zum Einfügen in :

Wenn du die Möglichkeit haben möchtest, auf die Schnelle die Größe von Bildern für Thumbnails zu ändern, braucht MediaWiki eine funktionierende Installation von ImageMagick. Stelle  auf true ein, nachdem du ImageMagick auf deinem System installiert und getestet hast. Stelle sicher, dass ' auf den richtigen Ort des -Befehls deiner Installation zeigt, dass der Befehl durch den Webserver-Prozess ausführbar ist und dass ' groß genug ist. Siehe für detaillierte Informationen und Problembehebung.

Zusätzlich kannst du auch die Liste der erlaubten Dateinamenserweiterungen modifizieren, welche in  aufbewahrt wird:

Sollte ImageMagick eine Fehlermeldung ähnlich wie folgende auswerfen:
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506

dann versuche, folgende Zeile zu  hinzuzufügen:

Interwiki-Support
Unterstützung von Interwiki-Links ist in MediaWiki eingebaut, aber du musst das Präfix, das für deine internen Links verwendet werden soll, konfigurieren. Dieses Präfix ist normalerweise dem Wert von gleich, aber für den Fall, dass du das ändern musst, kannst du in die Variable  den bevorzugten Namen schreiben.

Sprache der Benutzeroberfläche
MediaWiki erlaubt eine Varietät an lokalisierten Benutzeroberflächen anstelle der englischen Standardversion. Wenn du dein Wiki nicht in der englischen Sprache betreiben möchtest, setze in die Variable den richtigen Sprachcode (z. B. „de“ für Deutsch, „es“ für Spanisch und so weiter).

Du kannst jede beliebige Sprache mit einer Datei im Verzeichnis verwenden. Wenn du z. B.  findest, dann kannst du „ “ für Spanisch benutzen. Verwende nicht „ “ mit einem Großbuchstaben. Auch wenn es zu funktionieren scheint, sind nicht alle Texte übersetzt.

Nicht alle Sprachen werden unterstützt. Siehe hier für eine Liste der Übersetzungsstatistiken für. Siehe translatewiki.net für die Statistiken pro veröffentlichter Version.

Copyright für die Seite setzen

 *  ist die Seite im Wiki, die das Copyright, unter das dieses fällt, abdeckt. Normalerweise ist das Projekt:Copyrights.
 *  ist die Webseite, welche die vollständigen Details zu deiner Lizenz beschreibt. (Für die GNU FDL, bspw., wäre das .)
 *  ist der Text im Footer, der auf „Der Inhalt ist verfügbar unter der Lizenz“ folgt. Er verlinkt auf die in  festgelegte Seite.
 *  ist die URL des Bildes links im Footer.

Um die Copyright-Erklärung deiner Seite zu bearbeiten, füge etwas in dieser Art zu  dazu:

Bearbeite danach MediaWiki:Copyright, um eine angemessene Nachricht bereitzustellen, benutze dabei „ “, um die Position, bei welcher sich der Link zu deiner Copyright-Seite befinden soll, anzugeben.

Beispiel: eine Creative Commons-Lizenz einstellen

Um eine Creative Commons-Lizenz einzustellen, mache Folgendes:


 * Wähle deine Lizenz: http://creativecommons.org/choose/
 * Untersuche den zurückgegebenen HTML-Code, bspw.:


 * Gib für  die href-Information aus dem ersten Hyperlink ein:
 * Füge in  den Text des zweiten Links ein (hier ist ein „a“ für eine grammatikalisch korrektere Version vorangestellt)
 * Füge in  die src-Information des img-Verweises innerhalb des ersten Hyperlinks ein. Du solltest das Schild zu deiner eigenen Seite kopieren, anstatt das der Creative Commons-Seite zu verwenden.
 * Um RDF-Metadaten über das Copyright zu verwenden, füge eine oder beide Zeilen zu  zu:

Benutzerdefinierte Namensräume
Durch die Deklaration von ' und die Modifikation von ' und ' können zusätzliche Namensräume zu einer MediaWiki-Installation hinzugefügt werden; und durch die Deklaration des Arrays ' können Namensraum-Aliasse hinzugefügt werden. Gib acht, dass du nicht bereits Seiten mit Titeln in diesem Namensraum hast. Wenn du etwa eine Seite mit dem Namen „Technisch:Support“ hättest und du nun den Namensraum Technisch: erstelltest, dann wäre die Seite nicht nur verloren, sondern du kannst sie auch nicht von Spezial:Alle Seiten entfernen. Um das Problem zu beheben, lösche den Namensraum, verschiebe „Technisch:Support“ dann zu „Support“ im Hauptnamensraum, lösche die Weiterleitung, füge den Namensraum wieder ein und verschiebe die Seite zurück nach „Technisch:Support“. Siehe für mehr Informationen, wie man das macht.

Skins
Der Standardskin deiner Seite kann via  geändert werden.

Siehe auch

 * Quellcode, der die ersten Inhalte von  während der Installation generiert.
 * Wiki-Familien können sich eine gemeinsame teilen.
 * - Eine Anleitung zum Sichern deiner Datenbankpasswörter und -Datei.