Plugin WPML Media Translation - 3.1.2

WPML Media Translation ist ein Add-on für WPML, das in jeder Sprachversion eines Beitrags oder Produkts ein anderes Bild, Video oder PDF anzeigt. Der WPML-Kern übersetzt nur die Metadaten der Medien – Alt-Text, Bildunterschriften, Beschreibungen –, während dieses Add-on die gesamte Datei austauscht. Es setzt WPML ab dem Paket Multilingual CMS voraus.

Was WPML Media Translation leistet und wie es sich vom WPML-Kern unterscheidet

WPML Media Translation zeigt in jeder Sprachversion desselben Beitrags, derselben Seite oder desselben Produkts eine andere Bild-, Video- oder PDF-Datei an. Diese Erweiterung geht weiter als der WPML-Kern, der ausschließlich die Metadaten der Medien übersetzt – Alt-Text, Bildunterschriften, Beschreibungen und Titel –, aber jeder Sprache dieselbe Bilddatei belässt.

Der WPML-Kern übersetzt Metadaten, das Add-on tauscht die Datei aus

Die Grenze zwischen diesen beiden Ebenen ist mitunter verwirrend, daher lohnt sich eine klare Trennung. Der WPML-Kern allein übersetzt die einem Bild zugeordneten Texte – Alt-Text, Bildunterschrift, Beschreibung und Titel – zusammen mit dem restlichen Beitragsinhalt, ganz ohne Add-on.

WPML Media Translation wird erst dann nützlich, wenn statt derselben Datei in jeder Sprache ein völlig anderes Bild, Videoclip oder PDF-Dokument gezeigt werden soll. Das Add-on dient ausschließlich dem Austausch der Datei pro Sprache – für die reine Übersetzung von Bildbeschreibungen genügt der WPML-Kern.

Wenn der Alt-Text nicht ausreicht

Ein übersetzter Alt-Text löst das Problem der Barrierefreiheit und der SEO. Er ändert jedoch nichts an dem, was auf dem Bild selbst zu sehen ist. Enthält die Grafik eingebrannten Text – eine Beschriftung auf einem Banner, ein Etikett auf einem Produktfoto, eine Beschreibung auf einer Infografik –, sieht der Besucher in einer anderen Sprache trotzdem den fremdsprachigen Text.

Hier hilft nur noch der Austausch der gesamten Datei, nicht nur der Metadaten. Genau diese Lücke schließt WPML Media Translation: Jede Sprachversion erhält eine eigene, auf die Zielgruppe abgestimmte Bilddatei.

Funktionen von WPML Media Translation

WPML Media Translation fügt einen eigenen Bildschirm WPML → Media Translation hinzu, auf dem für das gewählte Medium unter der Spalte der jeweiligen Sprache eine andere Datei hochgeladen wird. Das Add-on kennzeichnet Bilder als Copied oder Referenced, übersetzt benutzerdefinierte Medienfelder und bindet Medien in den Standard-Übersetzungsworkflow von WPML ein – Translation Dashboard und Advanced Translation Editor.

• Anzeige unterschiedlicher Medien pro Sprache – ein eigenes Bild, Video oder PDF für jede Sprachversion desselben Beitrags oder Produkts, automatisch passend zur Sprache, in der die Seite aufgerufen wird.
• Dedizierter Bildschirm Media Translation – ein Panel, auf dem unter der Spalte der gewählten Sprache eine andere Datei hochgeladen und deren Metadaten über das Plus-Symbol angepasst werden.
• Anzeigen Copied / Referenced – seit Version 3.0.0 zeigt der Bildschirm, welche Medien eine eigene Datei haben (Copied) und welche sich eine Datei zwischen den Sprachen teilen (Referenced).
• Übersetzung von Media Custom Fields – seit Version 3.0.0 unterstützt das Add-on benutzerdefinierte Felder, die Medien zugeordnet sind.
• Arbeiten im Standard-Übersetzungsworkflow – Medien werden wie der übrige Inhalt über das Translation Dashboard zur Übersetzung weitergeleitet, und die Medientexte werden im Advanced Translation Editor mit Bildminiatur bearbeitet.
• Einrichtungsassistent – nach der Aktivierung führt das Add-on durch ein Ein-Klick-Setup, und alles Weitere geschieht automatisch.

Dedizierter Bildschirm Media Translation und Anzeigen Copied / Referenced

Der Bildschirm WPML → Media Translation ist die zentrale Arbeitsfläche des Add-ons für Medien. Für jedes Medium gibt es eine Spalte pro Sprache, und ein Klick auf das Plus-Symbol ermöglicht das Hochladen einer anderen Datei sowie das Festlegen ihrer Beschreibung für die jeweilige Sprachversion.

Version 3.0.0 vom August 2025 hat diesen Bildschirm im Hinblick auf die Übersichtlichkeit überarbeitet und die Anzeigen Copied und Referenced ergänzt. Dadurch ist sofort erkennbar, welche Bilder tatsächlich eine eigene Datei haben und welche sich lediglich die Basisdatei zwischen den Sprachen teilen.

Medien im Übersetzungsworkflow von WPML

Medien in WPML Media Translation stehen nicht losgelöst vom übrigen Inhalt. Sie gelangen über denselben Kanal wie Beiträge und Seiten zur Übersetzung – über das Translation Dashboard –, und die den Medien zugeordneten Texte werden im Advanced Translation Editor bearbeitet.

Der Editor zeigt eine Bildminiatur neben den Textfeldern an, sodass die Übersetzung von Bildunterschriften und Beschreibungen im richtigen Kontext erfolgt. Medieninhalte können außerdem an die mit WPML verbundenen Übersetzungsdienste weitergeleitet werden.

Übersetzung von Bildern, Videos und PDFs

Der Dateiaustausch pro Sprache beschränkt sich nicht auf Bilder. Das Add-on unterstützt auch Videodateien und PDF-Dokumente, sodass jede Sprachversion eines Beitrags oder Produkts einen eigenen, an den Markt angepassten Anhang haben kann.

Einsatzbereiche von WPML Media Translation

WPML Media Translation bewährt sich überall dort, wo eine Grafik eingebrannten Text enthält oder sich zwischen den Märkten unterscheidet – in WooCommerce-Shops mit Produktfotos in unterschiedlichen Sprachversionen, auf Seiten mit Infografiken und Bannern in mehreren Sprachen sowie dort, wo einem Produkt eine PDF-Datei in der Sprache des jeweiligen Marktes beiliegt. In all diesen Szenarien reicht ein übersetzter Alt-Text allein nicht aus.

WooCommerce-Shop mit Produktgrafiken, die Text enthalten

Ein Shop, der in mehreren Sprachen verkauft, hat oft Produktfotos mit eingebrannten Etiketten oder Beschreibungen in der Originalsprache. Ein übersetzter Alt-Text behebt das nicht – der Text steckt im Bild selbst.

Das Add-on ermöglicht es, auf dem Bildschirm WPML → Media Translation für jede Sprache eine eigene Bilddatei hochzuladen. Das Ergebnis: Der Kunde sieht auf jedem Markt die Grafik in seiner eigenen Sprache.

Infografiken und Banner in mehreren Sprachversionen

Firmenseiten, die Infografiken und Banner mit Slogans veröffentlichen, stoßen auf dieselbe Hürde – der Text ist Teil der Grafik. Die Redaktion erstellt für jede Sprache eine eigene Grafikversion und tauscht sie pro Sprachversion aus, statt eine gemeinsame Grafik mit fremdsprachigem Text zu verwenden.

Datenblätter und PDFs, die sich je Markt unterscheiden

Produkte mit einer beigefügten PDF-Datei – einer Spezifikation, einer Anleitung oder einem Datenblatt – benötigen ein Dokument in der Sprache des jeweiligen Marktes. WPML Media Translation ermöglicht es, dass jede Sprachversion eines Produkts eine eigene PDF-Datei hat, statt eines einzigen gemeinsamen Anhangs.

Derselbe Mechanismus greift auch bei Lifestyle- und Kochinhalten mit visueller Lokalisierung. Die Dokumentation nennt als Beispiel ein Rezept: Die englische Version zeigt ein Foto des Gerichts, die spanische ein anderes, das die lokale Zielgruppe besser anspricht.

Integrationen von WPML Media Translation mit WooCommerce und Page-Buildern

WPML Media Translation arbeitet über die Komponente WCML mit WooCommerce zusammen, mit den Page-Buildern Elementor, Divi und Beaver Builder sowie mit Gutenberg und ACF. Der Mechanismus für unterschiedliche Dateien pro Sprache funktioniert bei Medien aus der Mediathek, die eine Attachment-ID besitzen – Bilder, die direkt in den Inhalt eingefügt werden, etwa über das Image-Modul in Divi, bleiben außerhalb seiner Reichweite.

WooCommerce und unterschiedliche Produktbilder sowie -PDFs pro Sprache

In einem mehrsprachigen Shop arbeiten die Produktmedien mit der Komponente WooCommerce Multilingual & Multicurrency (WCML) zusammen. Das Add-on erlaubt es, für jede Sprachversion eines Produkts unterschiedliche Fotos und PDF-Dateien einzusetzen – nützlich bei unterschiedlichen Verpackungen, Varianten oder Spezifikationen auf den einzelnen Märkten.

Elementor, Divi, Beaver Builder und Gutenberg

Wie Medien behandelt werden, hängt davon ab, woher der Builder die Bildtexte bezieht. Bezieht er sie aus der Mediathek – wie Elementor, Divi Gallery und Beaver Builder –, dupliziert WPML die Medientexte bei der Übersetzung. Stecken die Texte im Inhalt, wie in Gutenberg-Blöcken oder im Divi-Image-Modul, übersetzt WPML sie direkt.

Hinweis zur Kompatibilität: Der Mechanismus für unterschiedliche Dateien pro Sprache funktioniert ausschließlich bei Medien mit Attachment-ID. Bilder, die direkt in den Inhalt eingefügt werden, etwa über das Image-Modul in Divi, werden nicht durch eine eigene Datei für die jeweilige Sprache ersetzt.

ACF und benutzerdefinierte Felder

Das Add-on arbeitet mit Advanced Custom Fields zusammen, einschließlich Bildfeldern und -galerien. Unterschiedliche Dateien pro Sprache in ACF-Feldern werden durch die Verbindung von ACF mit WPML sowie durch die eigene Komponente Advanced Custom Fields Multilingual unterstützt, für die der Hersteller eine eigene Anleitung bereitstellt.

Für wen ist WPML Media Translation geeignet

WPML Media Translation richtet sich an WPML-Nutzer, die in den einzelnen Sprachen unterschiedliche Mediendateien benötigen – WooCommerce-Shops, die auf mehreren Märkten verkaufen, und Seiten mit Grafiken, die Text enthalten. Verwenden alle Sprachen dieselben Bilder und müssen nur Alt-Text und Bildunterschriften übersetzt werden, ist das Add-on überflüssig und der WPML-Kern allein genügt.

Wann das Add-on benötigt wird

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

• WooCommerce-Shops, die auf mehreren Märkten verkaufen, wenn sich Produktfotos, Banner oder PDF-Datenblätter zwischen den Ländern unterscheiden;
• Seiten mit Grafiken, die Text enthalten – Infografiken, Titelbilder, Banner mit Slogans, Screenshots der Benutzeroberfläche;
• internationale Websites mit kulturellen oder regionalen Unterschieden, bei denen dieselbe Botschaft eine andere visuelle Gestaltung erfordert;
• Nutzer, die WPML bereits einsetzen und für die dies eine natürliche Erweiterung des vorhandenen Setups ist, ohne auf ein Plugin außerhalb des Ökosystems zurückgreifen zu müssen.

Für wen WPML Media Translation nicht benötigt wird

Für wen das Add-on nicht die richtige Wahl ist:

• Seiten, die in allen Sprachen dieselben Bilder verwenden – für die Übersetzung von Alt-Text und Bildunterschriften genügt der WPML-Kern;
• Seiten ohne WPML – das Add-on funktioniert nicht eigenständig und kommt daher bei Polylang, TranslatePress oder Weglot nicht zum Einsatz;
• Nutzer des Pakets Multilingual Blog – in diesem Plan ist das Add-on nicht verfügbar;
• sehr große Medienbibliotheken ohne echten Bedarf an unterschiedlichen Dateien, bei denen das Hochladen eigener Dateien pro Sprache die Dateizahl auf dem Server nur unnötig vergrößern würde.

Technische Anforderungen und Kompatibilität

WPML Media Translation übernimmt die Anforderungen des WPML-Kerns: WordPress 6.0 oder neuer, PHP 7.4 bis 8.5, MySQL 5.6+ oder MariaDB 10.1+, mindestens 128 MB Arbeitsspeicher (empfohlen 256 MB) sowie eine aktive WordPress REST API. Das Add-on ist ausschließlich in den Paketen Multilingual CMS und höher verfügbar – im günstigsten Paket Multilingual Blog fehlt es.

Das Add-on veröffentlicht keine eigene Liste von Anforderungen, da es stets zusammen mit dem WPML-Kern läuft und dessen Umgebung nutzt. Die folgende Tabelle fasst die für die Einrichtung relevanten Parameter des Kerns zusammen.

Häufig gestellte Fragen