Plugin WPML String Translation - 3.5.4

WPML String Translation ist ein Add-on für WPML, das Texte außerhalb der Inhalte von Beiträgen und Seiten übersetzt: Menüeinträge, Widgets, Tagline sowie Meldungen von Themes, Plugins und WooCommerce. Die Komponente erkennt nicht übersetzte Strings im Frontend selbstständig und übersetzt sie im selben Translation Dashboard wie den Rest der Website. Sie benötigt den WPML-Multilingual-CMS-Kern und funktioniert nicht eigenständig.

Hauptfunktionen von WPML String Translation

WPML String Translation übersetzt Texte außerhalb der Inhalte von Beiträgen und Seiten: Menüeinträge, Widget-Titel, die Tagline der Website, Fehlermeldungen sowie Texte aus Themes, Plugins und dem Administrationsbereich. Die Komponente erfasst nicht übersetzte Strings automatisch, sobald das Frontend in einer anderen Sprache dargestellt wird, und stellt sie im Translation Dashboard bereit. Die Übersetzung erfolgt manuell, durch Übersetzer oder automatisch mit der KI-Engine.

Der Funktionsumfang der Komponente erstreckt sich sowohl auf die für Besucher sichtbare Ebene als auch auf Texte, die in Einstellungen und Code verborgen sind:

• Übersetzung von Strings – Menü, Titel und Inhalte von Widgets, Tagline, Fehlermeldungen sowie Formularanweisungen, die von der Übersetzung von Beiträgen und Taxonomien nicht erfasst werden.
• Automatische Erkennung nicht übersetzter Strings – mit drei Betriebsmodi: nur für den angemeldeten Administrator (die serverschonendste Variante), für alle Frontend-Besucher oder deaktiviert.
• Integration mit dem Translation Dashboard – Strings werden über denselben Bildschirm übersetzt wie der restliche Inhalt, mit einer Vorschau der Wortanzahl und der Kredite vor dem Versand.
• Admin Texts Translation – Erfassung von Texten aus den Theme-Optionsfeldern und Plugin-Einstellungen, die WPML nicht selbstständig erkennt.
• Erkennung von Strings in JavaScript-Dateien – erfasst Texte, die in JS-Dateien gespeichert sind, unter anderem die WooCommerce-Blöcke Cart und Checkout.
• Scannen von Themes und Plugins – lädt alle Strings der jeweiligen Komponente, wodurch sich vom Theme mitgelieferte Übersetzungen überschreiben oder fehlende Strings aktualisieren lassen.
• Import und Export von .po-Dateien – Hochladen von Übersetzungen sowie Export von Strings samt Übersetzungen, nützlich bei Migrationen und bei der Zusammenarbeit mit externen Übersetzern.
• Wartungsfunktionen für Strings – Löschen von Texten nach Domain, Ändern der Ausgangssprache sowie Nachverfolgen der Herkunft von Strings im Code.

Automatische Stringerkennung und der Filter „Frontend (viewed)”

Die automatische Stringerkennung erfasst nicht übersetzte Texte in dem Moment, in dem die Seite in einer Fremdsprache dargestellt wird. Der Administrator sieht sich das Frontend in der zweiten Sprache an, und die Komponente trägt die dabei entdeckten Strings in die zur Übersetzung bereite Liste ein.

Seit WPML 4.7 (Februar 2025) vereinfacht der Filter „Frontend (viewed)” im Bereich „Other texts (Strings)” diesen Ablauf. Der Filter zeigt ausschließlich Texte an, die beim Durchsuchen der Website erkannt wurden, und ersetzt die manuelle Suche nach einzelnen Strings. Es gibt jedoch einen Haken. Der Erfassungsmodus für alle Frontend-Besucher belastet den Server stärker als der auf den Administrator beschränkte Modus – der Hersteller empfiehlt, ihn nach Abschluss der Übersetzung zu deaktivieren.

Übersetzung im Translation Dashboard und im dedizierten String-Translation-Bildschirm

Das Translation Dashboard sammelt Strings im Bereich „Other texts (Strings)” neben dem übrigen Inhalt der Website und bietet drei Übersetzungsmethoden: manuell, über Übersetzer oder Übersetzungsdienste sowie automatisch mit der KI-Engine von WPML über ein Kreditsystem. Vor dem Versand zeigt der Bildschirm die Wortanzahl und die Kosten in Krediten an.

Der dedizierte String-Translation-Bildschirm (WPML → String Translation) bietet mehr Kontrolle: Filtern nach Status, Text, Domain und Priorität, manuelle Übersetzung über die Symbole Plus und Stift sowie Massenaktionen für ausgewählte Strings.

Admin Texts und Texte aus JavaScript-Dateien

Admin Texts Translation erfasst Texte, die WPML nicht automatisch erkennt – aus den Theme-Optionsfeldern, den Plugin-Einstellungen sowie ausgewählten Einstellungen des WordPress-Kerns. Das betrifft unter anderem die Fußzeile, Urheberrechtshinweise und im Backend konfigurierte Meldungen.

Die Option „Detect strings in JavaScript files” erweitert die Erkennung auf Texte, die in JS-Dateien gespeichert und für WPML standardmäßig unsichtbar sind. Das ist wichtig für die WooCommerce-Blöcke Cart und Checkout, deren Beschriftungen nicht den üblichen Weg durchlaufen. Nach der Übersetzung dieser Texte sollte die Option besser wieder deaktiviert werden – sie geht zulasten der Serverleistung.

Import und Export von .po-Dateien sowie API für Entwickler

Der Bereich Utilities ermöglicht das Hochladen von .po-Dateien mit Übersetzungen sowie deren Export zusammen mit den Strings, was Migrationen und die Zusammenarbeit mit externen Übersetzern erleichtert. Die Komponente liest außerdem XLIFF-Dateien, die in Desktop-CAT-Tools verwendet werden.

Für Entwickler steht eine API zur Verfügung, mit der sich eigene, dynamische Texte registrieren lassen. Die Actions wpml_register_single_string und wpml_translate_single_string (empfohlen seit Version 3.2 der Komponente anstelle der älteren Funktionen icl_register_string und icl_t) erfassen vom Benutzer eingegebene Texte, etwa in den Feldern eines eigenen Widgets, zur Übersetzung.

Anwendungsbeispiele für WPML String Translation

WPML String Translation bewährt sich dort, wo nach der Übersetzung von Beiträgen und Seiten ein Teil der Website noch in der Ausgangssprache verbleibt. Am häufigsten schließt es den WooCommerce-Checkout ab, einschließlich der Warenkorb-Buttons sowie der in JavaScript gespeicherten Cart- und Checkout-Blöcke, übersetzt Tagline, Fußzeile, Widget-Titel und Menüeinträge sowie Texte aus den Optionsfeldern von Premium-Themes.

Vervollständigung des WooCommerce-Shops und der Checkout-Blöcke

In einem Shop, der in zwei Sprachen verkauft, sind Produkte und Seiten häufig übersetzt, während die Warenkorb-Buttons, die Beschriftungen des Checkout-Blocks und die E-Mail-Texte in der Ausgangssprache verbleiben. Ein Teil davon steckt in den JavaScript-Dateien der Cart- und Checkout-Blöcke.

Der typische Ablauf zur Vervollständigung eines solchen Shops sieht folgendermaßen aus:

1. Aktivieren der Option „Detect strings in JavaScript files” in den WPML-Einstellungen.
2. Aufrufen der Warenkorb- und Checkout-Seite in der zweiten Sprache, um die Erfassung der Strings zu erzwingen.
3. Scan von WooCommerce im Bereich „Theme and plugins localization”.
4. Übersetzen der erkannten Strings und Deaktivieren der JavaScript-Option nach Abschluss der Arbeit.

Tagline, Fußzeile, Menü und Widgets einer Unternehmenswebsite

Tagline, der Urheberrechtshinweis in der Fußzeile, Widget-Titel und Menüeinträge sind kein Bestandteil von Beiträgen oder Seiten, weshalb die Übersetzung von Inhalten sie nicht erfasst. Der Administrator sieht sich das Frontend in der Fremdsprache an, und die automatische Erkennung fängt diese Texte ab.

Danach genügt es, den Bereich „Other texts (Strings)” nach „Frontend (viewed)” zu filtern, alle Einträge auszuwählen und sie zur automatischen oder manuellen Übersetzung zu senden.

Texte aus Theme-Optionsfeldern und eigenen Plugins

Premium-Themes speichern Texte – Abschnittsüberschriften, Meldungen, Button-Beschriftungen – häufig in ihren eigenen Einstellungsfeldern, die WPML nicht automatisch erkennt. Admin Texts Translation ermöglicht es, solche Texte zu registrieren und zur Übersetzung weiterzugeben.

Bei einem eigenen Widget oder Plugin mit vom Benutzer eingegebenen Texten registriert der Entwickler diese über die Action wpml_register_single_string und ruft den Wert über wpml_translate_single_string ab, damit sie in die String-Translation-Tabelle gelangen.

Integrationen von WPML String Translation mit Plugins und Tools

WPML String Translation arbeitet mit WooCommerce über das Add-on WCML zusammen, mit ACF und ACF PRO über ACFML, mit Page Buildern wie Elementor, mit gängigen Formular-Plugins (Gravity Forms, Contact Form 7, WPForms) sowie mit SEO-Plugins über WPML SEO. Texte aus diesen Komponenten, die als Strings vorliegen, laufen über String Translation, und die fertigen Übersetzungen lassen sich als .po- und XLIFF-Dateien importieren und exportieren.

WooCommerce, WCML und die Übersetzung des Shops

String Translation verarbeitet die Strings des Shops, darunter die Beschriftungen von Warenkorb und Checkout sowie Texte aus den JavaScript-Blöcken Cart und Checkout. Vollständig mehrsprachige und mehrwährungsfähige Shops – mit Übersetzung von Produkten, Währungen und E-Mails – deckt das separate Add-on WooCommerce Multilingual & Multicurrency (WCML) ab, das zusammen mit WPML arbeitet.

Hinweis zum Funktionsumfang: String Translation allein übersetzt weder Produktdaten noch die Währungskonfiguration – diese Ebenen deckt WCML ab, während String Translation für die verstreuten Texte der Shop-Oberfläche zuständig ist.

ACF, Formulare und Page Builder

In den Plänen Multilingual CMS und Agency unterstützt WPML ACF und ACF PRO über das Add-on ACFML, das in einem Teil der Abläufe ein aktiviertes String Translation für Feldbeschriftungen und -werte benötigt, etwa bei Radio- und Select-Auswahlfeldern. Formular-Plugins – Gravity Forms, Contact Form 7, Ninja Forms und WPForms – nutzen dedizierte WPML-Add-ons, und ihre als Strings vorliegenden Texte laufen über String Translation.

Page Builder, darunter Elementor, werden in den Plänen CMS und Agency unterstützt. Statischer Text, der direkt in die Widgets des Builders eingefügt wird, landet jedoch im WPML-Übersetzungseditor und nicht in der String-Tabelle – String Translation erfasst die Interface-Texte aus den Komponentendateien, nicht den in der Builder-Datenbank gespeicherten Inhalt.

Dateien .po, XLIFF und externe Übersetzungsdienste

Übersetzungen von Strings lassen sich zwischen Umgebungen über den Import und Export von .po-Dateien übertragen, bei der Arbeit mit CAT-Tools über XLIFF-Dateien. Die automatische KI-Übersetzung von WPML arbeitet auf Ebene der Strings im Translation Dashboard nach einem Kreditmodell, wodurch sie sich mit manueller Übersetzung und der Arbeit von Übersetzern kombinieren lässt.

Für wen ist WPML String Translation geeignet

WPML String Translation richtet sich an Betreiber mehrsprachiger WordPress-Websites, die WPML nutzen und die gesamte Oberfläche übersetzen möchten, nicht nur den Inhalt von Beiträgen und Seiten. Am nützlichsten ist es für WooCommerce-Shops, die in mehreren Sprachen verkaufen, sowie für Agenturen und Entwickler, die auf die API zur Registrierung eigener, dynamischer Texte und auf Wartungsfunktionen für große Websites zurückgreifen.

WooCommerce-Shops und mehrsprachige Unternehmenswebsites

WooCommerce-Shops, die in mehreren Sprachen verkaufen, erhalten Zugriff auf die Meldungen von Warenkorb, Checkout und E-Mails, die ohne String Translation in der Ausgangssprache bleiben – vor allem die in JavaScript gespeicherten Strings der Cart- und Checkout-Blöcke. Unternehmenswebsites nutzen die Komponente für Tagline, Fußzeile, Widget-Titel und Menüeinträge.

Für wen sich WPML String Translation am besten eignet:

• Betreiber mehrsprachiger WPML-Websites, die die gesamte Oberfläche übersetzen möchten, nicht nur Beiträge und Seiten;
• WooCommerce-Shops, die in mehreren Sprachen verkaufen und bei denen ein Teil der Warenkorb- und Checkout-Texte in Strings steckt;
• Websites, die auf Themes oder Plugins basieren, die nicht vollständig in WPML integriert sind und bei denen Texte manuell registriert werden müssen;
• Nutzer, die KI-Übersetzung mit manueller Übersetzung in einem einzigen Translation Dashboard kombinieren.

Agenturen und Entwickler, die die API nutzen

Agenturen und Entwickler, die Websites für Kunden erstellen, greifen auf die API von String Translation zurück, um eigene, dynamische Texte zu registrieren, sowie auf Wartungsfunktionen für die Pflege komplexer Projekte. Die Action wpml_register_single_string erfasst Texte, die in Widget-Feldern oder Einstellungen eingegeben werden, zur Übersetzung.

Zur Pflege großer Websites dienen Funktionen wie die Nachverfolgung der Herkunft von Strings, der Import und Export von .po-Dateien sowie das Bereinigen der String-Tabelle nach Domain. Das erleichtert die Arbeit bei Migrationen und beim Austausch von Plugins.

Für wen WPML String Translation keine passende Wahl ist

Für wen sich WPML String Translation nicht am besten eignet:

• Nutzer ohne bezahltes WPML-Konto im Plan CMS oder Agency – die Komponente funktioniert weder im Plan Multilingual Blog noch als eigenständiges Produkt;
• einsprachige Websites oder solche, die kein WPML verwenden – für die reine Bearbeitung von .po-Dateien genügen leichtere, eigenständige Tools;
• wer ausschließlich eine kostenlose Lösung sucht – String Translation ist Teil der kostenpflichtigen Suite, es gibt keine eigenständige Free-Version;
• Websites, die einen Review- und Freigabeprozess für die Übersetzung von Strings benötigen – laut Dokumentation lassen sich Strings nicht wie Beitragsinhalte begutachten.

Technische Anforderungen und Kompatibilität

WPML String Translation benötigt den WPML-Multilingual-CMS-Kern und ist in den Plänen Multilingual CMS sowie Multilingual Agency enthalten, nicht jedoch im günstigsten Plan Multilingual Blog. Die Komponente läuft auf WordPress 6.0 oder neuer und PHP im Bereich 7.4–8.5, mit einem empfohlenen Speicherlimit von 256 MB. Sie benötigt eine aktivierte REST API, die mbstring-Erweiterung sowie die von dem Framework TWIG verwendete Funktion eval().

Erforderlicher WPML-Kern und Verfügbarkeit in den Plänen

Der WPML-Multilingual-CMS-Kern ist die Umgebung, in der String Translation überhaupt erst läuft – die Komponente erweitert ihn um die Übersetzung von Texten außerhalb von Beiträgen und Taxonomien. Ohne das aktive übergeordnete Plugin startet das Add-on nicht.

Hinweis zum Plan: String Translation ist nicht Bestandteil des Plans Multilingual Blog. Zugriff auf die Komponente und auf das Translation Dashboard bieten erst die Pläne Multilingual CMS und Multilingual Agency, und die Datei selbst wird aus dem Downloads-Bereich des WPML-Kontos heruntergeladen.

Serveranforderungen und Speicherlimit

Das WordPress-Speicherlimit ist für diese Komponente ein kritischer Parameter. Unterhalb von 128 MB treten Probleme beim Hinzufügen und Übersetzen von Strings auf, weshalb 256 MB empfohlen werden.

Die Serverumgebung muss die Erweiterungen mbstring, SimpleXML sowie libxml in der Version 2.7.8 oder neuer, eine aktivierte WordPress-REST-API und eine funktionierende eval()-Funktion bereitstellen, die vom TWIG-Template-Framework verwendet wird. Das Datenbankkonto benötigt Rechte zum Erstellen von Tabellen, und der empfohlene Zeichensatz utf8mb4 begünstigt die korrekte Verarbeitung diakritischer Zeichen.

Häufig gestellte Fragen