{"id":2256,"date":"2026-06-28T13:34:19","date_gmt":"2026-06-28T10:34:19","guid":{"rendered":"https:\/\/allinonewpsettings.com\/blog\/?p=2256"},"modified":"2026-10-18T05:20:23","modified_gmt":"2026-10-18T02:20:23","slug":"wordpress-plugin-uebersetzungen-werden-nicht-angezeigt","status":"publish","type":"post","link":"https:\/\/allinonewpsettings.com\/blog\/de\/wordpress-plugin-uebersetzungen-werden-nicht-angezeigt\/","title":{"rendered":"WordPress-Plugin-\u00dcbersetzungen werden nicht angezeigt"},"content":{"rendered":"

Sie haben ein Plugin \u00fcbersetzt, die Datei liegt auf dem Server, und Ihr Bildschirm zeigt trotzdem Englisch. Kaputt ist dabei nichts. WordPress sucht pro Plugin genau eine Datei, ausgew\u00e4hlt nach Ihrer Sprache, nach dem Dateinamen und nach dem Ordner. Stimmt eines davon um ein Zeichen nicht, meldet WordPress nichts und zeigt Ihnen Englisch.<\/p>\n

Auf deutschen Websites kommt eine Falle dazu, die es im Englischen nicht gibt: Deutsch und Deutsch (Sie) sind f\u00fcr WordPress zwei verschiedene Sprachen. Bearbeiten Sie Ihre \u00dcbersetzung deshalb noch nicht. Finden Sie zuerst heraus, welche Datei WordPress f\u00fcr Sie tats\u00e4chlich liest. Jede Pr\u00fcfung unten lief auf einer Testseite, mit einem kleinen Plugin, das jeden Text mit seiner Herkunftsdatei markiert.<\/p>\n

Inhaltsverzeichnis<\/strong><\/p>\n
    \n
  1. Welche Sprache fragt WordPress an?<\/a><\/li>\n
  2. Ihre Website siezt, das Plugin nicht<\/a><\/li>\n
  3. Der Dateiname muss genau stimmen<\/a><\/li>\n
  4. Eine Datei in wp-content\/languages gewinnt<\/a><\/li>\n
  5. Die .l10n.php daneben<\/a><\/li>\n
  6. Texte aus JavaScript brauchen eine eigene Datei<\/a><\/li>\n
  7. Zu fr\u00fch geladene \u00dcbersetzungen<\/a><\/li>\n
  8. \u00dcberpr\u00fcfung<\/a><\/li>\n
  9. AIOWS Language Compiler<\/a><\/li>\n
  10. H\u00e4ufige Fragen<\/a><\/li>\n
  11. Quellen<\/a><\/li>\n<\/ol>\n<\/div>\n

    Welche Sprache fragt WordPress an?<\/h2>\n

    WordPress kennt zwei Spracheinstellungen, und Ihre Verwaltungsseiten folgen der, an die Sie vielleicht nicht denken:<\/p>\n

    \n\n\n\n\n\n\n
    Einstellung<\/th>\nWo Sie sie finden<\/th>\nWas sie steuert<\/th>\n<\/tr>\n<\/thead>\n
    Website-Sprache<\/td>\nEinstellungen<\/strong> \u203a Allgemein<\/strong> \u203a Website-Sprache<\/strong><\/td>\nIhre \u00f6ffentlichen Seiten<\/td>\n<\/tr>\n
    Ihre Profilsprache<\/td>\nBenutzer<\/strong> \u203a Profil<\/strong> \u203a Sprache<\/strong><\/td>\njede Verwaltungsseite, die Sie sehen<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

    Stellen Sie die Website auf Deutsch und Ihr eigenes Profil auf Englisch, sehen Sie, was die Testseite zeigte: die Plugin-Seite im Backend auf Englisch, obwohl eine richtige deutsche Datei vorhanden war.<\/p>\n

    Steht in Ihrem Profil der Standardwert der Website, folgt es der Website-Sprache. Steht dort eine Sprache, gilt diese auf Ihren Verwaltungsseiten, und zwar nur f\u00fcr Sie. Eine Kollegin kann dieselbe Seite in einer anderen Sprache sehen.<\/p>\n

    Ihre Website siezt, das Plugin nicht<\/h2>\n

    Im Sprachmen\u00fc von WordPress stehen Deutsch<\/strong> und Deutsch (Sie)<\/strong> nebeneinander. Dahinter stehen zwei Gebietsschemata, de_DE<\/code> und de_DE_formal<\/code>, und f\u00fcr jedes braucht ein Plugin eine eigene Datei.<\/p>\n

    Auf der Testseite lief das so ab: – Mit Deutsch (Sie)<\/strong> im Profil und nur einer de_DE<\/code>-Datei blieb die Seite komplett englisch. WordPress weicht bei Plugins nicht auf de_DE<\/code> aus. – Mit einer zus\u00e4tzlichen de_DE_formal<\/code>-Datei war sie deutsch.<\/p>\n

    \"Die
    Deutsch (Sie) eingestellt, nur Du-Datei vorhanden: Englisch.<\/figcaption><\/figure>\n

    Die f\u00f6rmliche \u00dcbersetzung ist auf translate.wordpress.org ein eigenes Projekt. Ein Sprachpaket gibt es erst, wenn dort 90 % der stabilen Texte \u00fcbersetzt sind, und zwar f\u00fcr jedes Gebietsschema einzeln. Ein Plugin kann deshalb auf Deutsch fertig sein und auf Deutsch (Sie) noch gar nicht.<\/p>\n

    Liefert Ihr Plugin nur de_DE<\/code> und Ihre Website l\u00e4uft auf Deutsch (Sie), kopieren Sie dessen de_DE<\/code>-Dateien unter dem Namen de_DE_formal<\/code>. Ihre Leser werden dann geduzt, aber auf Deutsch.<\/p>\n

    Der Dateiname muss genau stimmen<\/h2>\n

    Die \u00dcbersetzungsdatei eines Plugins hei\u00dft textdomain-gebietsschema.mo<\/code>. Die Textdomain ist die Kennung des Plugins, meist sein Ordnername. Das Gebietsschema ist der volle Code, ohne Abk\u00fcrzung:<\/p>\n

    \n\n\n\n\n\n\n\n\n
    Ihre Spracheinstellung<\/th>\nDatei, die WordPress sucht<\/th>\n<\/tr>\n<\/thead>\n
    Deutsch<\/td>\nmein-plugin-de_DE.mo<\/code><\/td>\n<\/tr>\n
    Deutsch (Sie)<\/td>\nmein-plugin-de_DE_formal.mo<\/code><\/td>\n<\/tr>\n
    Deutsch (Schweiz)<\/td>\nmein-plugin-de_CH.mo<\/code><\/td>\n<\/tr>\n
    Deutsch (\u00d6sterreich)<\/td>\nmein-plugin-de_AT.mo<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

    Eine Datei mein-plugin-de.mo<\/code> passt zu keiner dieser Einstellungen. Auf der Testseite blieb eine verk\u00fcrzt benannte Datei ebenso wirkungslos, im Versuch mit T\u00fcrkisch: -tr.mo<\/code> wurde ignoriert, -tr_TR.mo<\/code> gelesen.<\/p>\n

    Eine Datei in wp-content\/languages gewinnt<\/h2>\n

    Die \u00dcbersetzung eines Plugins kann aus zwei Ordnern kommen: – aus wp-content\/languages\/plugins\/<\/code>, wohin WordPress die Sprachpakete von translate.wordpress.org l\u00e4dt; – aus dem eigenen languages<\/code>-Ordner des Plugins, der nur z\u00e4hlt, wenn das Plugin ihn mit load_plugin_textdomain()<\/code> anmeldet.<\/p>\n

    WordPress pr\u00fcft wp-content\/languages\/plugins\/<\/code> zuerst.<\/strong> Legen Sie denselben Text in beide Ordner, jeweils mit seiner Herkunft markiert, zeigt Ihre Seite die Fassung aus dem Sprachpaket. \u00c4ndern Sie die Datei im Plugin-Ordner, so oft Sie wollen: Es \u00e4ndert sich nichts.<\/p>\n

    \"Die
    Das Sprachpaket gewinnt, und die JSON-Datei im Plugin-Ordner wird nicht mehr gelesen.<\/figcaption><\/figure>\n

    Umgekehrt gilt es auch. Ruft Ihr Plugin load_plugin_textdomain()<\/code> nie auf, wird es nur aus wp-content\/languages\/plugins\/<\/code> \u00fcbersetzt. Ihre Datei im Plugin-Ordner bleibt wirkungslos, bis Sie sie dorthin verschieben.<\/p>\n

    Wie Sie eine korrigierte Datei kompilieren und wohin sie geh\u00f6rt, steht in WordPress-PO-Dateien in MO-Dateien kompilieren<\/a>.<\/p>\n

    Die .l10n.php daneben<\/h2>\n

    Seit WordPress 6.5 l\u00e4dt WordPress eine .l10n.php<\/code> mit demselben Namen wie Ihre .mo<\/code> an deren Stelle. Auf der Testseite gewann eine .l10n.php<\/code> neben der .mo<\/code> des Sprachpakets. Eine .l10n.php<\/code> ganz ohne .mo<\/code> daneben gewann ebenso.<\/p>\n

    Haben Sie eine .mo<\/code> bearbeitet, neu kompiliert, und nichts \u00e4ndert sich, suchen Sie eine .l10n.php<\/code> gleichen Namens. Erzeugen Sie sie mit wp i18n make-php<\/code> aus Ihrer PO-Datei neu, oder l\u00f6schen Sie sie, damit die .mo<\/code> gelesen wird.<\/p>\n

    Ein Unterschied \u00fcberrascht viele. msgfmt<\/code> l\u00e4sst als \u201efuzzy\u201c markierte Eintr\u00e4ge aus der .mo<\/code> weg, sie bleiben englisch. wp i18n make-php<\/code> aus WP-CLI 2.12.0 \u00fcbernahm den unsicheren Eintrag, und die Testseite zeigte seine ungepr\u00fcfte \u00dcbersetzung. Entfernen Sie die Markierung bei Eintr\u00e4gen, die Sie behalten wollen, bevor Sie die PHP-Datei erzeugen, und lassen Sie die \u00fcbrigen leer.<\/p>\n

    Texte aus JavaScript brauchen eine eigene Datei<\/h2>\n

    Text, den ein Skript in Ihre Seite schreibt, ber\u00fchrt die .mo<\/code> nie. Sie brauchen eine JSON-Datei, benannt nach Textdomain, Gebietsschema und dem MD5-Hash des Skriptpfads im Plugin, etwa mein-plugin-de_DE-0a1b2c\u2026.json<\/code>. wp i18n make-json<\/code> erzeugt sie aus Ihrer PO-Datei, und Ihr Plugin muss wp_set_script_translations()<\/code> aufrufen.<\/p>\n

    Zwei Ergebnisse der Testseite sollten Sie kennen: – Ohne JSON-Datei<\/strong> ist Ihr PHP-Text deutsch und Ihr Skript-Text englisch, auf derselben Seite. – Mit einem Sprachpaket<\/strong> wird Ihre JSON-Datei im Plugin-Ordner ignoriert, und der Skript-Text f\u00e4llt auf Englisch zur\u00fcck. Legen Sie die JSON-Datei neben die Datei, die gewinnt.<\/p>\n

    Ist Ihre Seite halb deutsch, halb englisch, fangen Sie hier an.<\/p>\n

    Zu fr\u00fch geladene \u00dcbersetzungen<\/h2>\n

    Seit WordPress 6.7 schreibt ein Plugin, das vor der Aktion init<\/code> eine \u00dcbersetzung anfordert, einen Hinweis in Ihr Debug-Protokoll. Er kommt auf Englisch, auch auf einer deutschen Website:<\/p>\n

    Translation loading for the mein-plugin domain was triggered too early.\nThis is usually an indicator for some code in the plugin or theme running\ntoo early. Translations should be loaded at the init action or later.<\/code><\/pre>\n
    Schalten Sie WP_DEBUG_LOG<\/code> ein und durchsuchen Sie Ihre wp-content\/debug.log<\/code> nach der Textdomain des Plugins. Auf der Testseite blieb ein Text, der schon beim Laden der Plugin-Datei \u00fcbersetzt wurde, englisch, w\u00e4hrend der Rest Ihrer Seite deutsch war. Ihr Protokoll enth\u00e4lt dann den Hinweis.<\/p>\n
    Mit einer Datei beheben Sie das nicht. Schicken Sie den Hinweis an den Autor des Plugins: Der betroffene Code geh\u00f6rt an init<\/code> oder sp\u00e4ter.<\/p>\n
    \u00dcberpr\u00fcfung<\/h2>\n
    Sie haben die Ursache gefunden, wenn Sie die Datei nennen k\u00f6nnen, die den Text liefert, und Ihr Bildschirm sich \u00e4ndert, sobald sie fehlt.<\/p>\n
    \n\n\n\n\n\n\n\n\n\n
    Pr\u00fcfung<\/th>\nErwartet<\/th>\n<\/tr>\n<\/thead>\n
    Seite mit der Profilsprache \u00f6ffnen, die nicht funktioniert, also genau Deutsch oder Deutsch (Sie)<\/td>\nDiese Sprache. Sonst siehe den ersten Abschnitt<\/a>.<\/td>\n<\/tr>\n
    Die Datei, die Sie f\u00fcr die liefernde halten, umbenennen, etwa in .mo.off<\/code>, und neu laden<\/td>\nMuss sich \u00e4ndern.<\/strong> Der Text f\u00e4llt auf Englisch zur\u00fcck oder auf die Fassung einer anderen Datei.<\/td>\n<\/tr>\n
    Den Namen zur\u00fccksetzen und neu laden<\/td>\nDie \u00dcbersetzung ist wieder da.<\/td>\n<\/tr>\n
    Einen PHP-Text und einen Skript-Text auf derselben Seite pr\u00fcfen<\/td>\nBeide \u00fcbersetzt. Sonst siehe JavaScript<\/a>.<\/td>\n<\/tr>\n
    debug.log<\/code> nach der Textdomain durchsuchen<\/td>\nDarf<\/strong> keine Zeile \u201etriggered too early\u201c enthalten.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
    Das Umbenennen entscheidet es f\u00fcr Sie. Auf der Testseite schaltete das Umbenennen der .mo<\/code> aus dem Sprachpaket den Text auf die Fassung aus dem Plugin-Ordner um. Die Datei, die Sie bearbeitet h\u00e4tten, war nie die auf Ihrem Bildschirm.<\/p>\n
    \u00c4ndert sich beim Umbenennen nichts, hat WordPress Ihre Datei nicht gelesen. Suchen Sie dann eine .l10n.php<\/code>, eine zweite Kopie in einem anderen Ordner oder einen Seiten-Cache, der Ihnen eine \u00e4ltere Fassung ausliefert.<\/p>\n
    Benennen Sie die einzige .mo<\/code> um, wird Ihr PHP-Text englisch, Ihr Skript-Text bleibt deutsch. Jede Art von Text hat ihre eigene Datei, also pr\u00fcfen Sie jede.<\/p>\n
    \n
    Wie AIOWS unterst\u00fctzt:<\/p>\n
    AIOWS Language Compiler<\/h2>\n
    Der Language Compiler, im deutschen Men\u00fc \u201eSprach-Compiler\u201c, verwaltet Ihre AIOWS-\u00dcbersetzungen. AIOWS l\u00e4dt sie anders als das Plugin in diesem Artikel, und die Fallen oben wirken sich f\u00fcr Sie deshalb anders aus.<\/p>\n
    Er nimmt bewusst den eigenen Ordner zuerst.<\/strong> F\u00fcr die Sprachen, die AIOWS mitliefert, Deutsch und T\u00fcrkisch, l\u00e4dt AIOWS die Datei aus seinem eigenen languages<\/code>-Ordner und setzt sie an die Stelle eines Sprachpakets f\u00fcr seine Textdomain in wp-content\/languages\/plugins\/<\/code>. Ein \u00e4lteres Paket dort kann neu ausgelieferte Texte nicht verdecken. Auf der Testseite \u00e4nderte ein untergeschobenes Paket mit anderer Beschriftung, .mo<\/code> und .l10n.php<\/code>, nichts an Ihren AIOWS-Seiten.<\/p>\n
    Er l\u00e4sst Sie auf Deutsch (Sie) nicht im Englischen stehen.<\/strong> F\u00fcr ein deutsches Gebietsschema ohne eigene Datei, etwa de_DE_formal<\/code>, gibt Ihnen AIOWS seine de_DE<\/code>-\u00dcbersetzung. Genau die Falle aus dem zweiten Abschnitt tritt bei AIOWS also nicht auf.<\/p>\n
    \"Der
    Deutsch (Sie) ohne eigene Datei: AIOWS nimmt seine de_DE-\u00dcbersetzung.<\/figcaption><\/figure>\n
    Er zeigt Ihnen, was fehlt.<\/strong> Der Reiter \u201eScannen\u201c vergleicht den Code von AIOWS mit jeder Ihrer PO-Dateien und meldet \u00fcbersetzte, leere, doppelte und fehlende Eintr\u00e4ge je Gebietsschema. Lesen Sie die Spalten \u201eLeer\u201c und \u201eFehlende Quellenabdeckung\u201c: Sie nennen, was fehlt, und die Abdeckung rundet einen fehlenden Text nie auf 100 % auf.<\/p>\n
    Er kompiliert sicher ohne msgfmt.<\/strong> \u201eKompilieren\u201c macht aus Ihren AIOWS-PO-Dateien MO-Dateien, mit GNU msgfmt<\/code>, wenn Ihr Server es erlaubt, sonst mit dem eigenen Compiler. Beide lassen unsichere und un\u00fcbersetzte Eintr\u00e4ge weg, ein unfertiger Text zeigt Ihnen also Englisch, nie eine leere Stelle.<\/p>\n
    Seine Grenzen, offen gesagt. Er arbeitet nur mit dem eigenen languages<\/code>-Ordner von AIOWS. Die \u00dcbersetzungen Ihrer anderen Plugins und Ihres Themes kompilieren Sie mit msgfmt<\/code>, Poedit oder WP-CLI. Er schreibt nur .mo<\/code>-Dateien, keine .l10n.php<\/code> und kein JSON f\u00fcr Skripte. Und er untersucht nicht, wie andere Plugins laden: Profilsprache, zu fr\u00fche Aufrufe oder eine zweite Kopie einer Datei pr\u00fcfen Sie mit der \u00dcberpr\u00fcfung oben.<\/p>\n
    AIOWS Language Compiler ansehen<\/a>AIOWS-Pl\u00e4ne vergleichen<\/a><\/p>\n<\/section>\n
    H\u00e4ufige Fragen<\/h2>\n
    Ich habe die \u00dcbersetzung hochgeladen und den Cache geleert. Warum ist es noch englisch?<\/strong> Pr\u00fcfen Sie zuerst Ihre Profilsprache, dann Du oder Sie, dann den Dateinamen, dann ob eine Datei in wp-content\/languages\/plugins\/<\/code> Ihre verdr\u00e4ngt.<\/p>\n
    F\u00e4llt WordPress von de_DE_formal<\/code> auf de_DE<\/code> zur\u00fcck?<\/strong> Bei Plugins nicht. AIOWS tut es f\u00fcr sich selbst; Ihre anderen Plugins brauchen eine eigene de_DE_formal<\/code>-Datei.<\/p>\n
    Warum ist das Plugin im Frontend \u00fcbersetzt, im Backend aber nicht?<\/strong> Ihre Profilsprache bestimmt Ihr Backend, die Website-Sprache Ihre \u00f6ffentlichen Seiten.<\/p>\n
    Bleibt meine eigene \u00dcbersetzung bei einem Update erhalten?<\/strong> Eine Datei im Plugin-Ordner verschwindet, wenn ein Update diesen Ordner ersetzt. Bewahren Sie Ihre PO-Datei woanders auf und kompilieren Sie nach Updates neu.<\/p>\n
    Wo sehe ich, welche Texte noch fehlen?<\/strong> In Ihrer PO-Datei oder in der Liste un\u00fcbersetzter Eintr\u00e4ge Ihres Editors. F\u00fcr AIOWS z\u00e4hlt der Reiter \u201eScannen\u201c sie je Sprache. Mehr zum Lesen von Sprachdateien steht in WordPress-Sprachdateien scannen und verwalten<\/a>.<\/p>\n
    Quellen<\/h2>\n