Für Fortgeschrittene: Konfigurationsordner settings.d

Hinweise zum Dokument

• Beim Editieren von Konfigurationsdateien mit einem Texteditor müssen die Dateien in UTF-8 Kodierung ohne BOM (Byte Order Mark) gespeichert werden.
• Der Platzhalter <installpath-bluespice> steht stellvertretend für den Pfad zu Ihrer BlueSpice-Installation, z.B. C:\bluespice\var\www (Windows bei Beachtung der Dokumentation "Ordnerstruktur unter Windows") oder /var/www/bluespice (Linux).
• Der Platzhalter <tomcat-webapps> steht stellvertretend für den Pfad zum Webapps-Verzeichnis Ihres Tomcat-Servers, z.B. C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps (Windows) oder /var/lib/tomcat9/webapps (Linux).

In diesem Dokument finden Sie Hintergrundinformationen für fortgeschrittene Benutzer. Wir empfehlen Ihnen, keine Änderungen an Ihrer BlueSpice-Installation vorzunehmen, wenn Sie mit den folgenden Informationen nicht vertraut sind.

Erklärung zum Ordner settings.d

Beginnend mit der BlueSpice-Version 2.27.1 sind alle Default-Einstellungen sowie die einzelnen Module von BlueSpice ausgelagert.

Alle Konfigurationen finden sich nun in einzelne Dateien aufgeteilt im Ordner <installpath-bluespice>/settings.d. Die darin enthaltenen Dateien binden die für BlueSpice benötigten Standard-MediaWiki-Erweiterungen ein, nehmen empfohlene Standard-Konfigurationen vor sowie binden BlueSpice und sämtliche zu Ihrem Paket (free oder pro) passenden Erweiterungen ein.

Die im Ordner <installpath-bluespice>/settings.d enthaltenen Dateien werden automatisch in alphabetischer Reihenfolge eingebunden und sind deshalb mit Zahlenfolgen geprefixed.

Wollen Sie selber zusätzliche Konfigurationen hinzufügen so können Sie hier entsprechend eigene Dateien ablegen. Hierfür empfiehlt sich, generell das Prefix 001- zu verwenden.

Zusätzliche Konfigurationen, die nicht standardmäßig paketiert sind, aber gerne Einsatz finden, können Sie auf github.com einsehen.

Updatesicheres Ändern von Default-Konfigurationsdateien

Wenn Sie die standardmäßig ausgelieferten Dateien im Ordner settings.d ändern möchten so wird dringend empfohlen, folgenden Weg zu wählen, um auch nach einem Update diese Konfiguration nicht zu verlieren:

• Erstellen Sie einen eine Kopie der jeweiligen Konfigurationsdatei mit der Endung .local.php - z.B. 020-VisualEditor.local.php
• Editieren Sie ausschließlich diese Datei

Bevorzugt werden im Ladeprozess grundsätzlich Dateien mit dieser Dateiendung.