OptiYummy-Update 1.39 auf 1.44

Vorhaben

Nach Supportende von Version 1.39.1 des Mediawikis sollte auch dieses System auf die neue Version umgestellt werden. Der Prozess ist sehr ähnlich zum vorherigen Update. Dort finden sich weitere Details und Hintergründe. Hier werden hauptsächlich Änderungen erläutert und sonstige Schritte nur kurz dokumentiert. Es erfolgte eine komplette Neuinstallation mit anschließendem Übertragen der bisherigen Konfiguration und Inhalte. Folgende Daten wurden zuvor gesichert:

• Kopie des gesamten Ordners mediawiki_ab (ab = alte Version) vom Server des Hosters per SFTP. Dieser Schritt ist nicht unbedingt notwendig. Die alte Installation sollte auf dem Server bestehen bleiben und Daten daraus extrahiert werden können.
• Export der Datenbank über Strato-Webseite und PhpMyAdmin. Ausführliche Informationen dazu im vorletzten Update.
• Export der Datenbank über Datenbankübersicht bei Strato > Backups. Dort werden Daten zum Download per SFTP auf Port 22 bereitgestellt. (Kleinere Dateigröße als PhpMyAdmin!, Details siehe unten)
• Packen des gesamten image-Ordners mit anschließendem Download des Archivs per SFTP:

cd STRATO-apps/mediawiki_ab
tar -vczhf image_backup.tgz app/images

Theoretisch wäre ein Update auch möglich (aber nicht empfohlen), wenn man nur die nötigsten Dateien sichert:

• Backup der Datenbank bei Strato per SFTP.
• Packen und sichern des aktuellen image-Ordners mit allen Dateien und Unterordnern.
• Sichern der beiden Dateien robot.txt und php.ini aus dem Ordner mediawiki_ab/app, statt Sicherung des gesamten Ordners.

Für den SFTP-Zugriff wurde FileZilla genutzt. Kopiervorgänge und das Bearbeiten von Dateien sind damit sehr komfortabel möglich.

Installation des MediaWiki-Systems mit STRATO-AppWizard

Das Web-Interface für Hosting-Pakete wird von STRATO kontinuierlich modifiziert. Diese Beschreibung entspricht dem Stand vom Oktober 2025:

• Damit eine Domain (hier: optiyummy.net) für das neue Wiki-System verwendet werden kann, darf sie nicht extern umgeleitet oder von anderen Anwendungen belegt sein! Dies ist über die Domain-Verwaltung des Webhosting-Paketes zu realisieren (interne Umleitung z.B. auf /.
• Auf der Startseite des Kundenlogin findet man unten in der Navigationsleiste den Eintrag WordPress & Co.
• Nach Wählen dieser Funktion findet man in der Kategorie Community-Software die Möglichkeit zur MediaWiki-Installation.
• Die Domäne optiyummy.net wurde infolge des Einhaltens der obigen Bedingungen in der Liste zur Auswahl angeboten
• Nach dem Ausfüllen der geforderten Angaben betätigt man "Fertigstellen":
  • Administrator-Benutzername + Passwort
  • Administrator E-Mail
  • Titel der Webseite

Das erstellte MediaWiki-System besitzt folgende Konfiguration:

• Version 1.44.2
• Es wurde ein Ordner "/STRATO-apps/mediawiki_xx/app" (xx = neue Version) angelegt
• Danach steht ein MediaWiki-System in seiner Grundeinstellung zur Verfügung.
• Die Datenbank ist jetzt eine MariaDB. Das Vorgehen hat sich gegenüber der alten SQL-Datenbank dadurch aber zum Glück nicht verändert.

Wiki-System individuell konfigurieren

Die Konfiguration des Wikis erfolgt bis zum Einspielen der alten Datenbank sehr ähnlich wie bisher. Weitere Details sind bei Unklarheiten im letzten Update nachzulesen. Neuerungen und Anpassungen in dieser Version werden auf dieser Seite explizit hier erläutert.

Die folgenden Einstellungen sind in der Datei LocalSettings.php vorzunehmen, welche sich im Wiki-Verzeichnis mediawiki_xx befindet. Alle hier beschriebenen Änderungen sollten ganz am Ende der Datei im vorgesehenen bereich erfolgen. Die vordefinierten Standardeinstellungen werden dabei überschrieben, bleiben aber bei Problemen in der Datei erhalten und sind nicht verloren.

Die Konfiguration kann komplett per SSH über Kommandozeile oder die "Datei Bearbeiten"-Funktion von FileZilla per SFTP erfolgen. Dabei wird die Datei heruntergeladen, lokal unter AppData/.../FileZilla gespeichert und beim Speichern im Texteditor automatisch (nach expliziter Bestätigung) von FileZilla zurück zum Server übertragen.

• Server: ssh.strato.de
• Benutzername: Domän-Name (im Beispiel: www.optiyummy.net)

Vergeben von Nutzerrechten

Wichtig: Standardmäßig können auch anonyme Nutzer Wiki-Seiten editieren! Deshalb sollte man als erste Aktionen die Nutzerrechte ändern.

##----------------------------------------------------------
## Benutzerverwaltung
## Nur noch angemeldeten Benutzern das Bearbeiten erlauben
$wgGroupPermissions['*']['edit'] = false;
## Neuanmeldungen verbieten
$wgGroupPermissions['*']['createaccount'] = false;
## Anlegen neuer Seiten nur für angemeldete Nutzer
$wgGroupPermissions['*']['createpage'] = false;
## Anlegen neuer Diskussionen nur für angemeldete Nutzer
$wgGroupPermissions['*']['createtalk'] = false;
## Verstecken der Edit-Section-Links vor nichtangemeldeten Nutzern
$wgDefaultUserOptions['editsection'] = false;
## Ausschalten der Links auf IP-Diskussionsseiten rechts oben
$wgShowIPinHeader = false;

Es wird ein Creative Commons Lizenzmodell für die Inhalte benutzt. Zulässig ist folgende Verwertung der Inhalte:

• Verteilung: kopieren, verbreiten und öffentlich Aufführen
• Modifikation: Anpassung der Inhalte an die eigene Arbeit
• Kommerzielle Verwertung

Unter der Bedingung:

• der Namensnennung des Autors oder des Lizenzsgebers,
• ohne den Eindruck zu erwecken, bei der Verwertung Unterstützung erhalten zu haben.

Dazu sind folgenden Variablen in LocalSettings.php zu ergänzen:

$wgRightsUrl = "https://creativecommons.org/licenses/by/3.0/";
$wgRightsText = "Creative Commons";
$wgRightsIcon = "https://i.creativecommons.org/l/by/3.0/88x31.png";

Indizierung durch Suchmaschinen reglementieren

Man sollte für Suchmaschinen die zuvor aus dem alten Wiki gesicherte Datei robots.txt in den Ordner mediawiki_xx/app kopieren. Weitere Hinweise dazu im vorletzten Update.

Anpassen des Erscheinungsbildes

Wahl eines Skins

• Standardmäßig ist in der Version 1.44 der Skin "vector-2022" eingestellt.
• Für dieses Update wurde der moderne Skin beibehalten.
• Alle Einstellungen sind auch mit dem alten Skin "monobook" kompatibel und gestet. Dieser könnte über $wgDefaultSkin = "monobook"; wieder aktiviert werden.
• Durch Einfügen folgender Zeilen in LocalSettings.php kann man "vector-2022" geeignet konfigurieren:

##Anpassungen fuer Vector-2022 Skin
# Hauptmenue per default in Sidebar anpinnen fuer eingeloggte user, leider nciht fuer anonym verfuegbar
$wgVectorDefaultSidebarVisibleForAuthUsers = true;
$wgVectorDefaultSidebarVisibleForAnonUsers = true;
$wgDefaultUserOptions['vector-main-menu-pinned'] = 1;
$wgDefaultUserOptions['vector-page-tools-pinned'] = 0;
$wgDefaultUserOptions['vector-toc-pinned'] = 1;
$wgDefaultUserOptions['vector-appearance-pinned'] = 0;
# Responsive mobile aktivieren
$wgVectorResponsive = true;
# Darkmode als Option aktivieren, Standard bleibt heller Modus
$wgVectorNightMode['logged_out'] = true;
$wgVectorNightMode['logged_in'] = true;
# fuer darkomde css des vector-2022 anpassen:
function efDisableLogoInversion( OutputPage &$out, Skin &$skin ) {
	$out->addInlineStyle( '.mw-logo-container { filter: none !important;' ); // class mw-logo-container nicht invertieren
}
$wgHooks['BeforePageDisplay'][] = 'efDisableLogoInversion';

Wie den Kommentaren zu entnehmen ist werden folgende Anpassungen und Konfigurationen am Skin vorgenommen:

• Für Authentifizierte Nutzer werden Hauptmenü und Inhaltsverzeichnisse standardmäßig angepinnt. Die Nutzer können dies individuell anpassen. Für Annoynme Nutzer ist leider keine Voreinstellung möglich.
• Responsive Design für die mobile Ansicht wird aktiviert. Bei Bedarf kann dies auf Ausgabegeräten durch die Option "Desktopwebseite anzeigen" im Browser deaktiviert werden.
• Darkmode wird als Option aktiviert. Standardmäßig ist dieser nicht aktiv, kann aber vom User eingeschaltet werden.
• Für den Darkmode wird eine Funktion ergänzt, die verhindert, dass das Logo des Wikis farblich invertiert wird.

Eigenes Logo und Favicon

• Die erforderlichen Daten kommen später aus dem importierten image-Ordner. Zu Testzwecken können Sie jetzt schon in den noch leeren Ordner kopiert werden.
• Alternativ kann man auch warten, bis der gesamte Ordner wieder hergestellt wurde (siehe unten). Dann funktionieren nachfolgende Änderungen nicht sofort. Alternativ kann auch jetzt schon der gesamte Ordner importiert werden.
• Einfügen in LocalSettings.php:

## Eigenes Logo 135x135 Pixel einbinden
$wgLogos = [
'1x' => "/images/logo.gif",
'icon' => "/images/logo.gif",
'wordmark' => [
		'src' => "/images/wordmark.png",
		'width' => 135,
		'height' => 40,
	],
];
$wgFavicon = "/images/favicon.ico";

• Das neue Array enthält einen Eintrag 'icon' für das Logo im Vector-2022 Skin. monobook greift auf den alten Wert 1x zu.
• Zusätzlich wurde das wordmark ergänzt, um die Wiedererkennbarkeit, insebsondere in der mobilen Ansicht zu erhöhen. Hier wird das Icon nicht angezeigt. Das wordmark wurde neu erstellt und in den images-Ordner hochgeladen.
• Die neue Variante ist eine Kombination des Arrays für das große Logo und $wgFavicon für die Anzeige im Browsertab.

• Achtung: Die Darstellung der Bilder funktioniert nur, wenn der Direktzugriff im image-Ordner durch die .htaccess-Datei erlaubt ist. Dazu die alte Datei mit einfügen bzw. gleich komplett mit dem gesicherten image-Ordner importieren.

Hochladen von Dateien konfigurieren

Für das Wiki-System muss man die Konfiguration der Datei-Größe und die zu verwendende Verzeichnis-Struktur über LocalSettings.php vornehmen. Dazu folgende Konfiguration anfügen:

$wgEnableUploads       = true;
$wgMaxUploadSize = 1024*1024*200; # 200MB
$wgUploadSizeWarning = 1024*1024*10; # 10MB
$wgUseImageResize = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'zip', 'pdf', 'hlp', 'swf', 'wmv', 'svg' );
##fix for thumbnail error 25:
$wgMaxImageArea = 3e7;
$wgMaxShellMemory = 1024000;
$wgMaxShellFileSize = 204800;
## Directories images/archive, images/thumb and images/temp werden automatisch angelegt!
$wgHashedUploadDirectory = false; # nicht Bilder-Verzeichnisstruktur "/a/ab/foo.png" verwenden

• Außerdem muss man die zuvor gesicherte Datei php.ini in das Wurzelverzeichnis des Wiki-Systems speichern (dort, wo auch LocalSettings.php liegt).

Uebertragen der Inhalte

Hintergründe und Details zu den hier verwendeten Methoden finden sich wieder im letzten Update. Aktuelle Änderungen sind mit aufgeführt. Zunächst die wichtigsten Schritte zum Sichern des Vorgängersystems:

Sichern der Datenbank:

• Das kompakteste Backup der Datenbank kam aus dem Strato-eigenen Backupsystem.
• Der Zugriff erfolgt über die Weboberfläche > Datenbanken und Webspace > Datenbankverwaltung > Backups anzeigen (entsprechende Datenbank des alten Wikis wählen)
• Man wählt anschließend "Sichern und herunterladen" für die aktuellste Version. Achtung: Sehr kurzfristige Änderung <24h sind unter Umständen noch nicht enthalten!
• Strato stellt anschließend Zugangsdaten für einen SFTP-Server (Port: 22) bereit. Der Download kann z.B. per FileZilla erfolgen.
• Das erzeugte Archiv ist nur etwa halb so groß wie beim Export über PhpMyAdmin.

Bilder: Vor dem erneuten Einlesen der Datenbank sollte spätestens jetzt die alten Bilddateien wieder hinzugefügt werden.

• Umbenennen des bestehenden image-Ordners (z.B. image_original). Dieser kann dann später gelöscht werden.
• Zum Einfügen des zuvor exportierten, archivierten Ordners gibt es verschiedene Wege. Wegen der großen Datenmenge ist der direkte Weg über SFTP sehr zeitaufwändig.
• Schneller ist es, das erzeugte Archiv hochzuladen und per SSH (z.B. mit PUTTY) auf dem Server selbst zu entpacken.
• Der hier beschriebene Weg ist dabei nicht der schnellste, beugt aber Fehlern bei mangelnder Erfahrung im Umgang mit den Consolen-Programmen vor. Eine große Menge Bilder vom falschen Ort wieder sauber zu entfernen kann sonst unter Umständen aufwändig sein.
• Zunächst wird das Archiv per SFTP auf den Server in ein freies Verzeichnis geladen, hier im Beispiel /TEMP.
• Dort kann man das Archiv ohne Risiko mit seiner bestehenden Ordnerstruktur entpacken:

cd TEMP
tar -xpf image_backup.tgz

• Anschließend kopiert man nur den image-Ordner und dessen Inhalt an die korrekte Stelle im neuen Wiki-System:

cd ..
cp -rp TEMP/app/images STRATO-apps/mediawiki_xx/app

• Die Dateien in /TEMP kann man löschen.

Erneutes Einlesen der Datenbank:

• Zur Sicherheit sollte man die Original-Datenbank der "nackten" Installation mit PhpMyAdmin sichern. Diese ist nur bei unvorhergesehenen Fehlern nötig, dann aber evtl. hilfreich.
• Seit Version 1.35 werden den Datenbankeinträgen Präfixe vorangestellt. Diese mussten dann beim Import ergänzt werden.
• Bei einem Update auf Version 1.39 muss man nicht unbedingt die Datenbankeinträge anpassen, sondern kann in der neuen LocalSettings.php das Präfix entsprechend der bereits bestehenden Datenbank definieren (Am Ende der Datei einfügen):

## Datenbank mit altem Praefix einbinden
# MySQL specific settings
$wgDBprefix = "ab12_";

• Achtung: Der Platzhalter ab12_ ist durch das korrekte Präfix zu ersetzen.
• Die entpackte *.sql Datei sollte man für den erneuten Import dann in den neuen Ordner mediawiki_xx hochladen (dort entpacken ist per Kommandozeile natürlich auch möglich).
• In diesem Ordner führt man dann per SSH folgenden Befehl mit den entsprechenden Zugangsdaten der Datenbank aus:

mysql -h rdbms -u BENUTZERNAME -pPASSWORT dbxxxxxx < optiyummy_export.sql

• Achtung: hierbei steht links die neue Datenbank des frisch installierten Wikisystems und rechts die exportierte Datei der alten. Kein Leerzeichen vor dem Passwort der Datenbank!

Die Datenbank-Strukturen der Versionen 1.39 und 1.44 sind unterschiedlich. Deshalb muss bei jedem MediaWiki-Update auch ein Update der Datenbank erfolgen:

• Die fehlerhaften Datenbank-Einträge für die aktuelle Version 1.44 werden durch Ausführen des Update-Script im Web-Browser generiert nach Aufruf von:

 https://www.optiyummy.net/mw-config/index.php 

1. Bestätigen der Spracheinstellungen mit Weiter.
2. Wert des $wgUpgradeKey für das vorhandene Wiki als Aktualisierungsschlüssel eingeben (ohne die ""), danach Weiter.
3. MediaWiki-Tabellen aktualisieren mit Weiter bestätigen.

Nach dem Datenbankupdate kann die Setupseite verlassen werden. Danach läuft das MediaWiki wie gewünscht mit den portierten Inhalten.

Weitere Anpassungen

Im vorherigen Update musste die Druckversion der Seite angepasst werden. Diese Änderung ist scheinbar nicht mehr notwendig.

Extensions

Für die genutzten Erweiterungen finden sich Hinweise im letzten Update. Prinzipiell ist es ausreichend die aktuellen Quelldateien herunterzuladen und jeweils den entpackten Ordner auf dem Server im Pfad /STRATO-apps/mediawiki_x/app/extensions hinzuzufügen. Der Ordnername entspricht dabei der Erweiterung (ohne Suffixe wie "-master" oder ähnlichem). Es empfiehlt sich die Daten lokal zu entpacken und nur den Ordner mit den eigentlichen Inhalten korrekt benannt auf den Server zu laden.

• Extension:WikiEditor → bereits in der Standardinstallation vorhanden
• Extension:HitCounters → nur per git clone
• Extension:EmbedVideo → nur per git clone
• Extension:SimpleMathJax → normaler Download und entpacken

• Zwei Erweiterungen ließen sich nicht mehr über den Browser herunterladen. Stattdessen kann man per SSH in das extensions-Verzeichnis auf dem Server navigieren und dort git clone mit den jeweils auf den Websieten der extensions angegebenen URLs ausführen.

Die Erweiterungen werden dann in LocalSettings.php eingefügt:

## Extensions:
wfLoadExtension( 'WikiEditor' );
wfLoadExtension( 'EmbedVideo' );
wfLoadExtension( 'SimpleMathJax' );
$wgSmjSize = 125;
wfLoadExtension( 'HitCounters' );

Auf der Wikiseite Spezial:Version wird angezeigt, ob die Erweiterungen erfolgreich installiert wurden.

Ausblenden von Links fuer nicht angemeldete Nutzer

Nachfolgend werden Anpassungen der Darstellung vorgenommen. Gegenüber dem letzten Update wurde hier eine Vereinfachung vorgenommen und alles in LocalSettings.php definiert.

Ausblenden von Registerkarten für nicht angemeldete Nutzer

Die nachfolgende Funktion kann ans Ende von LocalSettings.php eingefügt werden und sorgt dafür, dass entsprechende Navigationselemente für nicht angemeldete Nutzer nicht mehr angezeigt werden:

## Tabs vor nicht eingeloggten Nutzern verbergen
function efAddSkinStylesAnon( OutputPage &$out, Skin &$skin ) {
	global $wgUser;
        if($wgUser->isAnon()) {
		$out->addInlineStyle( '#ca-history { display:none !important; }' ); // Hide history tab
		$out->addInlineStyle( '#ca-viewsource { display:none !important; }' ); // Hide source tab
		$out->addInlineStyle( '#ca-talk { display: none !important; }' ); // hide discuccion tab
		$out->addInlineStyle( '#ca-nstab-main { display: none !important; }}' );
		$out->addInlineStyle( '#ca-nstab-project { display: none !important; }' );
		$out->addInlineStyle( '#ca-nstab-special { display: none !important; }' );
               // zusaetzlich Werkzeuge und Navigation mit Spezialseiten ausblenden
		$out->addInlineStyle( '#p-tb { display: none !important; }' );
		$out->addInlineStyle( '#p-navigation { display: none !important; }' );
		//gesamte Werkzeug gesamt fuer vector-2022 ausblenden
		$out->addInlineStyle( '#vector-page-tools-dropdown { display: none !important; }' );
        }
        return true;
}
$wgHooks['BeforePageDisplay'][] = 'efAddSkinStylesAnon';

Diese Lösung ist eine abgewandelte Form eines Vorschlags aus diesem Beitrag.

Gegenüber dem OptiYummy-Update_1.35_auf_1.39#Ausblenden_von_Links_fuer_nicht_angemeldete_Nutzer werden hier auch gleich Werkzeuge mit ausgeblendet. Eine Modifikation der Skin.php ist nicht mehr nötig. Auch die in Mediawiki 1.44 neue Änderung der automatisch generierte Navigationsleiste wurde deaktiviert. Hier würden sonst die Spezialseiten automatisch verlinkt. Je nach Skin befindet sich die Navigationsleiste dann bei den Werkzeugen oder im Hauptmenü.

Fusszeile nur mit Impressum

• Die Fußzeile besteht weiterhin aus Unterseiten und wurde dadurch mit der Datenbank schon korrekt importiert.
• Details und Dokumentation zu Änderungen der Fußzeile im OptiYummy-Update_1.35_auf_1.39#Ausblenden_von_Links_fuer_nicht_angemeldete_Nutzer unten.
• Die Anzahl der Seitenaufrufe wird anschließend weiterhin angezeigt.
• Eine Anpassung sollte hier in der entsprechenden Extension vorgenommen werden.
• Dazu kann in mediawiki_xx/app/extensions/HitCounters/includes/Hooks.php Zeile 198 auskommentiert werden:

//$footerItems['viewcount'] = $viewcountMsg;	//viewcount nicht in footer schreiben

• Achtung: Im Gegensatz zu den anderen Anpassungen wird sich die HitCounter-Erweiterung nach einem Update vermutlich wieder zurücksetzen und muss neu angepasst werden.

Resultat

• Das Mediawiki wird im aktuellen Design korrekt dargestellt. Desktop und Mobilansicht funktionieren.
• Insbesondere in der Desktopansicht können Nutzer Schriftgröße, Seitenbreite und Darkmode selbst über die Brille oben rechts nach eigenen Vorzügen konfigurieren.
• Der Monobook-Skin funktioniert weiterhin und kann einfach zentral aktiviert oder auf beliebeigen Seiten durch Ergänzen von &useskin=monobook am Ende der URL geladen werden.