Eine gewachsene WordPress-Website enthält PO-, MO-, POT- und JSON-Dateien in Plugins, Themes, im globalen Sprachordner und in einem alten Deployment-Verzeichnis. Niemand weiß mehr sicher, welche Kataloge geladen werden und welche eigenen Übersetzungen beim nächsten Update verloren gehen.
Hier erfahren Sie, wie Sie Sprachdateien inventarisieren, Quelle und erzeugte Ausgabe unterscheiden und daraus einen updatefesten Pflegeprozess ableiten.
- Was das Thema bedeutet
- Ein realistisches WordPress-Beispiel
- Warum es wichtig ist und wann es eingesetzt wird
- Der einfache Weg für Einsteiger
- Der technische Weg
- Risiken, häufige Fehler, Backup und Rollback
- Wie AIOWS unterstützt: AIOWS Language Compiler
- Passende AIOWS-Artikel
- Fazit und empfohlener Weg
- Offizielle Quellen
Was das Thema bedeutet
Zur Verwaltung von WordPress-Sprachdateien gehören Inventarisierung, Prüfung, Kompilierung, Ablage und Pflege über den gesamten Lebenszyklus. POT-Dateien beschreiben übersetzbare Ausgangstexte, PO-Dateien enthalten bearbeitbare Übersetzungen, MO-Dateien liefern kompilierte gettext-Kataloge für PHP. Für JavaScript können zusätzlich erzeugte JSON-Kataloge erforderlich sein.
Ein Scan findet mögliche Sprachdateien, sagt aber nicht automatisch, welche davon aktuell, bearbeitbar oder entbehrlich sind. Entscheidend sind Textdomain, Locale, Komponente, Version, Ladepfad und die Zuordnung zwischen gepflegter Quelle und erzeugter Ausgabe.
Ein realistisches WordPress-Beispiel
Nach mehreren Migrationen existieren drei deutsche Kataloge derselben Plugin-Domain. Einer gehört zum Plugin, einer stammt aus einem WordPress-Sprachpaket und einer enthält eigene Übersetzungen im globalen Sprachordner. Das Team erfasst Pfad, Hash und Änderungszeit, prüft die Ladereihenfolge und ordnet jede erzeugte MO-Datei ihrer PO-Quelle zu. Erst danach wird entschieden, welche Kopien archiviert oder entfernt werden können.
Warum es wichtig ist und wann es eingesetzt wird
Mehrere Kataloge derselben Domain und Locale können sich abhängig von Ladezeit und Anfrage überlagern. Eine scheinbar ungenutzte Datei kann für eine Benutzer-Locale, einen JavaScript-Text oder eine Multisite-Unterseite weiterhin erforderlich sein. Ungeprüftes Aufräumen führt dann zu englischen Fallbacks oder gemischten Übersetzungen.
Ein Inventar ist nach Installationen, Updates, Migrationen und größeren Übersetzungsarbeiten sinnvoll, ebenso vor einer Bereinigung oder bei der Diagnose fehlender Texte. Ziel ist keine möglichst kurze Dateiliste, sondern eine nachvollziehbare und reproduzierbare Bereitstellung.
Der einfache Weg für Einsteiger
- Sichern Sie alle eigenen PO-Dateien und die daraus erzeugten MO- beziehungsweise JSON-Dateien.
- Erfassen Sie pro Datei Typ, Locale, Textdomain, Komponente, Version und vollständigen Pfad.
- Kennzeichnen Sie Anbieterdateien, WordPress-Sprachpakete, eigene Quellen, erzeugte Ausgaben und zunächst ungeklärte Kandidaten.
- Ordnen Sie jeder eigenen Ausgabe die gepflegte Quelle und den verwendeten Build-Schritt zu.
- Testen Sie anschließend typische Texte im Frontend, in
wp-adminund in JavaScript-Komponenten.
Der technische Weg
Erweitern Sie das Inventar um Dateigröße, Hash, Änderungszeit, Rechte und zuständiges Team. Vergleichen Sie PO-Dateien mit dem maßgeblichen POT-Katalog oder Quellcode, um neue, veraltete, kontextabhängige und plurale Nachrichten zu erkennen.
Prüfen Sie für jede Textdomain die WordPress-Ladereihenfolge und mögliche Überschreibungen durch Sprachpakete, Plugin-Updates oder Deployments. Eigene Übersetzungen gehören in einen Ort, dessen Bestand der Release-Prozess ausdrücklich schützt. Generierte Dateien sollten jederzeit aus einer versionierten Quelle reproduzierbar sein.
Vor dem Entfernen eines Kandidaten testen Sie alle betroffenen Locales, Benutzer-Sprachen und JavaScript-Ansichten. Dateien ohne eindeutige Zuordnung bleiben erhalten, bis ihr Zweck geklärt ist.
Risiken, häufige Fehler, Backup und Rollback
Ein häufiger Fehler ist, die neueste Datei allein anhand ihres Zeitstempels zum maßgeblichen Katalog zu erklären. Ebenso riskant sind eigene Übersetzungen in updateverwalteten Plugin-Verzeichnissen und MO-Dateien ohne erhaltene PO-Quelle.
Wenn nach einer Änderung Texte fehlen, Fallback-Sprachen wechseln oder andere Übersetzungen betroffen sind, stellen Sie die gesicherten Dateien an ihren bisherigen Pfaden wieder her. Löschen Sie unbekannte Kataloge nicht endgültig, sondern verschieben Sie sie zunächst in ein kontrolliertes Archiv außerhalb des Ladepfads.
Wie AIOWS unterstützt:
AIOWS Language Compiler
AIOWS Language Compiler kann unterstützte WordPress-Sprachquellen scannen, prüfen und aus freigegebenen PO-Dateien die zugehörigen MO-Dateien erzeugen. Damit lassen sich Quelle, Locale, Textdomain und Laufzeitausgabe in einem nachvollziehbaren Arbeitsablauf zusammenführen.
Der Scan dient als Ausgangspunkt für das Inventar. Prüfen Sie jeden Fund anhand von Komponente, Pfad und Zuständigkeit, bevor Sie ihn kompilieren oder verschieben. Nach einem Build bestätigen Dateiname und Existenz nur die Erzeugung; ein konkreter Text im Frontend oder in der Administration belegt erst die tatsächliche Nutzung.
Das Modul entscheidet nicht automatisch, welcher Übersetzungsinhalt fachlich richtig ist, und schützt Dateien nicht vor fremden Update-Prozessen. Es korrigiert auch keine fehlerhafte Internationalisierung im Plugin-Code. Bewahren Sie deshalb eigene Quellen und die vorherigen Ausgaben auf und definieren Sie für dauerhafte Änderungen einen updatefesten Ablage- und Release-Prozess.
Passende AIOWS-Artikel
- WordPress-PO-Dateien in MO-Dateien kompilieren
- WordPress-Plugin-Übersetzungen werden nicht angezeigt
- Cache für mehrsprachige WordPress-Websites konfigurieren
Fazit und empfohlener Weg
Erstellen Sie eine klare Zuordnung von Dateien, Quellen und Verantwortlichkeiten, bevor Sie das Sprachverzeichnis bereinigen. Maßgebliche POT- und PO-Quellen bleiben erhalten; MO- und JSON-Ausgaben werden mit unterstützten Werkzeugen neu erzeugt und anhand einer mehrsprachigen Textmatrix geprüft. Das Ziel ist ein updatefester Übersetzungslebenszyklus mit bekannten Verantwortlichen, nicht nur eine kürzere Dateiliste.
