{"id":20864,"date":"2026-10-18T14:41:00","date_gmt":"2026-10-18T12:41:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=20864"},"modified":"2026-10-09T22:29:15","modified_gmt":"2026-10-09T20:29:15","slug":"plugin-internationalisierung","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/wordpress-plugins-tricks-de\/tutorials-de-wordpress-plugins-tricks-de\/plugin-internationalisierung\/","title":{"rendered":"Plugins \u00fcbersetzen: Text Domain, Sprachpakete und JavaScript"},"content":{"rendered":"

Ein Plugin, das nur Englisch kann, zeigt auf einer deutschen oder polnischen Website englische Schaltfl\u00e4chen, obwohl WordPress selbst l\u00e4ngst die Sprache der Besucher spricht. Dieser Blog erscheint auf Englisch, Deutsch und Polnisch; jede Zeichenkette eines hier eingesetzten Plugins muss also dreifach vorliegen, auch die Texte, die JavaScript erst nachtr\u00e4glich in die Seite schreibt. WordPress l\u00f6st das auf drei Ebenen: gettext-Aufrufe in PHP, eigene JSON-Dateien f\u00fcr Skripte und Sprachpakete, die translate.wordpress.org baut und ausliefert. Viele \u00e4ltere Anleitungen rufen load_plugin_textdomain()<\/code> noch fr\u00fch in plugins_loaded<\/code> auf, obwohl der Aufruf seit WordPress 6.7 nur noch den Pfad registriert; die mit 6.7 eingef\u00fchrte Meldung stammt von \u00dcbersetzungsaufrufen vor after_setup_theme<\/code>.<\/p>\n

Dieser Beitrag baut ein kleines Plugin \u201eLW Reading Time\u201c mit einer PHP-Datei und einem Skript, das @wordpress\/i18n<\/code> importiert. Er zeigt die \u00dcbersetzungsfunktionen, die Pluralregeln f\u00fcr Deutsch und Polnisch, was WordPress 7.1.2 (aktuelle Version am 29.09.2026) selbst l\u00e4dt, wie eine Zeichenkette \u00fcber GlotPress in ein Sprachpaket gelangt und wie sich \u00dcbersetzungsdateien lokal mit WP-CLI erzeugen lassen. Plugin Check<\/a> und die Felder der readme.txt<\/code><\/a> sind Thema eigener Beitr\u00e4ge dieser Reihe; hier tauchen sie nur dort auf, wo \u00dcbersetzungen sie ber\u00fchren.<\/p>\n

Die Text Domain: eine Kennung, identisch mit dem Slug<\/h2>\n

Jeder gettext-Aufruf tr\u00e4gt als letztes Argument die Text Domain, die eine Zeichenkette der richtigen \u00dcbersetzungsdatei zuordnet. F\u00fcr Plugins im Verzeichnis gilt eine feste Regel: Die Text Domain entspricht dem Slug, ein Plugin mit dem Slug akismet<\/code> nutzt also die Text Domain akismet<\/code>, und mehr als eine Text Domain pro Plugin ist nicht vorgesehen. Laut Meta-Handbuch l\u00e4sst sich ein Plugin sonst nicht sauber in translate.wordpress.org importieren und bekommt keine Sprachpakete. Erlaubt sind Kleinbuchstaben und Bindestriche, keine Unterstriche, keine Leerzeichen.<\/p>\n

Au\u00dferdem muss die Text Domain als literale Zeichenkette dastehen. wp i18n make-pot<\/code> und der Importer auf WordPress.org lesen den Quelltext, ohne ihn auszuf\u00fchren; eine Konstante oder Variable anstelle von 'lw-reading-time'<\/code> bleibt f\u00fcr sie unsichtbar, und das Plugin-Handbuch r\u00e4t ausdr\u00fccklich davon ab. Auch Zeichenketten, die der Core bereits \u00fcbersetzt, etwa \u201eSettings\u201c, bekommen die eigene Text Domain. Sonst verlieren sie ihre \u00dcbersetzung, sobald der Core den Wortlaut \u00e4ndert.<\/p>\n

Der Header Text Domain<\/code> ist laut Handbuch seit WordPress 4.6 optional, Domain Path<\/code> darf bei Plugins im Verzeichnis fehlen. Es lohnt sich trotzdem, beide zu setzen: make-pot<\/code> liest die Text Domain standardm\u00e4\u00dfig aus dem Header, und seit WordPress 6.8 laden Plugins au\u00dferhalb des Verzeichnisses ihre \u00dcbersetzungen genau \u00fcber dieses Paar automatisch. Plugin Check 2.1.0 (erschienen am 16.08.2026) meldet ein ung\u00fcltiges Format der Text Domain als Fehler, einen vom Slug abweichenden Header als Warnung und ebenso einen Domain Path<\/code> ohne f\u00fchrenden Schr\u00e4gstrich oder mit Verweis auf einen fehlenden Ordner. Das Beispiel-Plugin bringt deshalb einen vorhandenen Ordner languages\/<\/code> mit der POT-Datei mit.<\/p>\n

Die gettext-Funktionen in PHP<\/h2>\n

Die Hauptdatei des Beispiel-Plugins zeigt die Lesezeit \u00fcber einzelnen Beitr\u00e4gen an und erg\u00e4nzt eine Schaltfl\u00e4che, die das Skript sp\u00e4ter umbeschriftet. Jede sichtbare Zeichenkette l\u00e4uft durch eine \u00dcbersetzungsfunktion:<\/p>\n\n\n

PHP<\/span>