Plugin WPML Advanced Custom Fields (ACF) Multilingual - 2.2.4

WPML Advanced Custom Fields Multilingual (ACFML) ist ein Bindeglied-Plugin von OnTheGoSystems, das WPML mit dem Plugin Advanced Custom Fields verbindet und die benutzerdefinierten Felder von WordPress für die Übersetzung öffnet. Es funktioniert ausschließlich im Zusammenspiel mit WPML und ACF und richtet sich an Entwickler und Agenturen, die mehrsprachige Websites auf Basis von ACF-Feldern erstellen.

Wie Advanced Custom Fields Multilingual funktioniert

Advanced Custom Fields Multilingual ist eine Vermittlungsschicht zwischen WPML und dem Plugin Advanced Custom Fields – sie sagt WPML, wie mit den in ACF-Feldern gespeicherten Daten umzugehen ist. Ohne ACFML kommt WPML mit benutzerdefinierten Feldern nicht zurecht: Entweder erscheinen sie nicht zur Übersetzung, oder sie duplizieren sich zwischen den Sprachversionen. Das Bindeglied-Plugin benötigt gleichzeitig WPML Core, WPML String Translation sowie ACF oder ACF Pro.

Warum ACFML kein eigenständiges Plugin ist

ACFML übernimmt die Rolle eines Glue Plugin. Es übersetzt selbst keinerlei Inhalte – WPML verwaltet die Sprachversionen von Beiträgen und Seiten, ACF erstellt die benutzerdefinierten Felder, und ACFML liefert das fehlende Wissen darüber, wie beide Plugins bei den Felddaten zusammenarbeiten müssen.

Ohne diesen Vermittler weiß WPML nicht, ob ein bestimmtes Feld übersetzt, kopiert oder ignoriert werden soll, und auch nicht, wie verschachtelte Felder zu behandeln sind. Das typische Symptom fehlender ACFML? Duplizierte Beschreibungen in der übersetzten Version sowie Felder, die überhaupt nicht im Translation Dashboard erscheinen.

Was installiert sein muss, damit ACFML funktioniert

Das Bindeglied-Plugin benötigt den gesamten Plugin-Stack im Zusammenspiel. Fehlt auch nur eine Komponente, werden die ACF-Felder nicht übersetzbar.

• ACF oder ACF Pro – das Basis-Plugin, das die benutzerdefinierten Felder bereitstellt.
• WPML Core – die Umgebung, die die Sprachversionen der Website verwaltet.
• WPML String Translation – die Komponente für die Übersetzung von Textstrings.
• ACFML – das Bindeglied-Plugin selbst, das WPML mit ACF verbindet.

Wo die Übersetzung konfiguriert wird — das Panel Multilingual Setup

Die Übersetzungssteuerung befindet sich direkt im Bearbeitungsbildschirm der Feldgruppe (ACF → Field Groups). Oben auf der Seite erscheint das Panel Multilingual Setup, in dem der Entwickler den Übersetzungsmodus wählt, ohne zu separaten WPML-Einstellungen wechseln zu müssen.

Eine häufige Konfigurationsfalle ist der Versuch, die Felder über WPML → Settings zu verwalten – der richtige Ort ist jedoch der Bildschirm der ACF-Feldgruppe. Seit ACFML 2.0 führt das Add-on mit einem einstufigen Konfigurationsassistenten durch die Auswahl der Optionen.

Funktionen und Möglichkeiten von Advanced Custom Fields Multilingual

Advanced Custom Fields Multilingual übersetzt jeden in ACF und ACF Pro verfügbaren Feldtyp – Feldwerte, Beschriftungen, Auswahloptionen (Radio, Select, Checkbox), Options Pages sowie ACF-Blöcke. Die Steuerung erfolgt über den Bearbeitungsbildschirm der Feldgruppe, und die Werte lassen sich manuell übersetzen oder über die automatische WPML-Übersetzung mit den Engines DeepL, Google und Microsoft.

Übersetzung aller ACF- und ACF-Pro-Feldtypen

ACF bietet mehr als 30 Feldtypen. ACFML deckt sie alle ab – von einfachen Feldern bis zu den komplexen Datenstrukturen, die für ACF Pro typisch sind.

• Text- und Grundfelder – Text, Textbereiche und Zahlenfelder, standardmäßig als Werte übersetzt, die an den Editor übergeben werden.
• Repeater und Flexible Content – wiederholbare und flexible Layouts, bei denen die Unterfelder innerhalb jeder Zeile oder jedes Layouts übersetzt werden.
• Group und Clone – Felder, die andere Felder gruppieren oder klonen, werden zusammen mit ihrem Inhalt verarbeitet.
• Relationale Felder – Link, Post Object, Page Link, Relationship, Taxonomy und User, standardmäßig zwischen den Sprachen kopiert.

Feldbeschriftungen und Auswahloptionen

Feldbeschriftungen (Field Labels) identifizieren die Felder im Editor und landen häufig auch im Frontend – etwa in Formularen. ACFML übersetzt sie über WPML → Translation Dashboard im Bereich ACF Field Group, und seit Version 2.0 geschieht dies über einen No-Code-Ansatz ohne Eingriff in den Code.

Separat übersetzt werden die Auswahloptionen der Felder (Field Choices) – die Werte von Radio-, Select- und Checkbox-Feldern. Dadurch erscheinen lokalisierte Beschriftungen der Optionen in Formularen und Auswahlfeldern in jeder Sprache der Website.

Options Pages und ACF-Blöcke

Die globalen ACF-Einstellungsseiten (Options Pages) speichern Kontaktdaten, Logo oder Footer-Texte – sie werden über den Translation Dashboard im Bereich ACF Options übersetzt. Seit ACFML 2.2.0 lassen sich Options Pages direkt aus dem Translation Dashboard zur Übersetzung senden.

In Gutenberg erstellte ACF-Blöcke werden mit denselben Methoden übersetzt wie die übrigen Felder – im Modus gemeinsamer oder sprachspezifisch unterschiedlicher Felder.

Im Code definierte Felder (Local Fields)

Auch Felder, die über PHP oder JSON registriert werden und nicht über die grafische Oberfläche, sind übersetzbar. Die Übersetzungspräferenz wird programmatisch über den Parameter wpml_cf_preferences in der Felddefinition festgelegt.

Seit ACFML 2.2.0 ist die Synchronisierung lokaler Inhalte einfacher – ein einmaliger Aufruf von ACF → Tools → „Sync once now” genügt, und die lokalen Felder erhalten den Status vollwertiger ACF-Felder.

Übersetzungsmodi für Felder in ACFML

Advanced Custom Fields Multilingual bietet drei Übersetzungsmodi für Feldgruppen: „Same fields across languages” (gleiche Felder, übersetzte Werte), „Different fields across languages” (sprachspezifisch unterschiedliche Inhalte) sowie den Expert Mode, mit dem sich die Präferenz für jedes Feld einzeln festlegen lässt. Zur Auswahl stehen vier Präferenzen: Translate, Copy, Copy Once und Do Nothing.

Same fields across languages

Das ist die typische Einstellung für die meisten auf ACF basierenden Websites. Der Modus behält die Feldstruktur zwischen den Sprachen bei und übersetzt deren Werte – der Inhalt wird einmal in der Standardsprache eingegeben und anschließend zur Übersetzung gesendet.

Ein Beispiel? Eine Team-Seite. Dieselben Personen, dieselben Felder, nur übersetzte Textwerte. Layout- und relationale Felder werden in diesem Modus standardmäßig kopiert, während ihr Inhalt übersetzt wird.

Different fields across languages

Dieser Modus zeigt in jeder Sprache andere Werte oder eine andere Feldanordnung. Er eignet sich dort, wo die einzelnen Sprachversionen lokalisierte, unterschiedliche Inhalte präsentieren sollen – etwa wenn ein Unternehmen verschiedene Veranstaltungen für unterschiedliche Sprachzielgruppen organisiert.

Die Übersetzung erfolgt über den nativen WordPress-Editor, in dem die Sprachversion über das „Plus”-Symbol hinzugefügt wird.

Expert Mode — Kontrolle pro Feld

Der Expert Mode gibt manuelle Kontrolle über die Übersetzungspräferenz jedes einzelnen Feldes. Er erlaubt es, verschiedene Ansätze innerhalb einer Gruppe zu kombinieren: Titel und Beschreibung auf Translate, Preis, Datum und Adresse dagegen auf Copy.

Vier Präferenzen bestimmen das Verhalten des Feldes. Translate sendet das Feld zur Übersetzung, Copy kopiert den Wert bei jeder Änderung, Copy Once kopiert ihn einmalig und erlaubt danach eine unabhängige Bearbeitung, und Do Nothing überspringt das Feld.

Anwendungsbeispiele für Advanced Custom Fields Multilingual

Advanced Custom Fields Multilingual bewährt sich überall dort, wo wichtige Inhalte in ACF-Feldern stecken – auf Team-Seiten, in mit dem Repeater aufgebauten Landingpage-Bereichen, auf Produktkarten mit gemischten Daten oder in globalen Options Pages. Der Expert Mode trennt sprachübergreifend gemeinsame Daten wie Preis, SKU oder Datum von zu übersetzenden Inhalten wie Titel und Beschreibung.

Unternehmensseiten und Abschnitte mit ACF Pro

Unternehmensseiten speichern Daten von Teammitgliedern – Name, Position, Biografie und Foto – oft in ACF-Pro-Feldern. Wenn ein Unternehmen eine zweite Sprache einführt, bewahrt der Modus „Same fields across languages” die Struktur, während die Textwerte, einmal in der Standardsprache eingegeben, zur Übersetzung gehen.

Fotos können sprachübergreifend gemeinsam genutzt oder über die Komponente WPML Media Translation pro Sprache ausgetauscht werden.

Unterschiedliche Inhalte pro Sprachmarkt

Manche Projekte erfordern, dass jede Sprachversion andere Inhalte zeigt, statt nur eine Übersetzung derselben Inhalte. Eine Veranstaltungsseite für englisch- und spanischsprachige Zielgruppen kann in jeder Sprache völlig unterschiedliche Beiträge und Feldwerte anzeigen.

Der Modus „Different fields across languages” setzt dieses Szenario über den nativen WordPress-Editor um, in dem jede Sprachversion einen unabhängigen Datensatz darstellt.

Produktkarten und globale Website-Einstellungen

Auf Produktkarten ist ein Teil der Daten sprachübergreifend gemeinsam – Preis, Datum, Adresse, Parameter – während ein anderer Teil übersetzt werden muss, wie Titel und Beschreibung. Der Expert Mode legt die Präferenz pro Feld fest und vermeidet doppelte Arbeit an technischen Daten.

Globale Website-Einstellungen – Kontaktdaten, Logo, Footer-Texte – werden in den Options Pages verwaltet und aus dem Bereich ACF Options im Translation Dashboard zur Übersetzung gesendet.

Für wen ist Advanced Custom Fields Multilingual geeignet

Advanced Custom Fields Multilingual richtet sich an Entwickler und Agenturen, die mehrsprachige Websites auf Basis von ACF und WPML erstellen, bei denen ein erheblicher Teil der Inhalte in benutzerdefinierten Feldern steckt. Auf Websites ohne WPML oder ACF sowie auf einsprachigen Websites hat das Produkt keinen Nutzen – in diesen Fällen gibt es für das Bindeglied-Plugin nichts zu verarbeiten.

Für welche Projekte sich ACFML am besten eignet

Für wen sich Advanced Custom Fields Multilingual am besten eignet:

• Entwickler und Agenturen, die mehrsprachige Websites auf ACF und WPML erstellen, bei denen wichtige Inhalte in benutzerdefinierten Feldern stecken.
• Unternehmensseiten und Landingpages mit ACF Pro, deren Abschnitte mit Repeater und Flexible Content aufgebaut sind und die in ausländische Märkte expandieren.
• Shops und Kataloge mit Daten in ACF-Feldern, bei denen ein Teil der Informationen sprachübergreifend gemeinsam ist und ein Teil übersetzt werden muss.
• Websites mit Options Pages in ACF Pro, deren globale Einstellungen sich pro Sprache unterscheiden müssen.
• Entwickler, die in PHP oder JSON definierte Local Fields verwenden.

Für wen ACFML nicht die richtige Wahl ist

Für wen Advanced Custom Fields Multilingual nicht die richtige Wahl ist:

• Websites, die mit Polylang, TranslatePress oder Weglot übersetzt werden – diese Tools nutzen kein WPML und haben eigene ACF-Integrationen.
• Websites ohne ACF-Felder – zum Übersetzen reiner Beiträge und Seiten genügt WPML Core.
• Einsprachige Websites – das Produkt hat ohne mindestens zwei Sprachen keinen Nutzen.

Integrationen von Advanced Custom Fields Multilingual

Advanced Custom Fields Multilingual lässt sich mit ACF und ACF Pro integrieren, mit der automatischen WPML-Übersetzung (DeepL, Google, Microsoft), mit WPML Media Translation zum sprachspezifischen Austausch von Bildern sowie mit ACF-Blöcken in Gutenberg. ACF-Felder auf WooCommerce-Produkten verarbeitet es gemeinsam mit der Komponente WooCommerce Multilingual, und in Setups mit Page Buildern funktioniert es über Dynamic Content.

ACF, ACF Pro und die automatische WPML-Übersetzung

Die Integration mit ACF und ACF Pro ist der Kern – sie ist der einzige Grund für die Existenz des Bindeglied-Plugins. ACFML unterstützt beide Editionen des Basis-Plugins ausdrücklich und funktioniert somit sowohl mit dem kostenlosen ACF als auch mit ACF Pro.

Die Feldwerte lassen sich manuell übersetzen oder über die automatische WPML-Übersetzung auf Basis der Engines DeepL, Google und Microsoft. Den Feldern zugeordnete Bilder verarbeitet WPML Media Translation, wodurch sich Grafiken selbst im Modus „Same fields” pro Sprache austauschen lassen.

WooCommerce, ACF-Blöcke und Page Builder

ACF-Felder, die auf WooCommerce-Produkten verwendet werden, werden übersetzbar, wobei der vollständige Weg zu einem mehrsprachigen Shop die Komponente WooCommerce Multilingual auf Seiten von WPML erfordert. ACF-Blöcke in Gutenberg und Full Site Editing werden mit denselben Modi übersetzt wie die übrigen Felder.

In Setups mit Page Buildern funktionieren ACF-Felder, die über Dynamic Content angezeigt werden, mit ACFML. Dokumentiert ist eine Anleitung für Avada und Fusion Builder, und die Community beschreibt außerdem Konfigurationen mit Divi und Elementor.

Einschränkungen von Advanced Custom Fields Multilingual

Advanced Custom Fields Multilingual funktioniert nicht ohne WPML Core, WPML String Translation und ACF – von selbst übersetzt es nichts. Zu den bekannten Einschränkungen gehören die Entsynchronisierung von Repeater-Übersetzungen beim Ändern der Zeilenreihenfolge, die fehlende Übersetzung externer Links im Modus „Same fields” sowie Probleme mit der Conditional Logic bei Taxonomy- und Post-Object-Feldern in sekundären Sprachen.

Repeater und Flexible Content bei Änderung der Reihenfolge

Das Ändern der Zeilenreihenfolge im Repeater oder das Löschen einer Zeile in der Standardsprache kann bestehende Übersetzungen entsynchronisieren. Dieser Punkt steht auf der Liste bekannter WPML-Probleme.

Workaround: Nach der Änderung der Reihenfolge genügt eine kleine Änderung im Inhalt, etwa ein Leerzeichen, damit WPML eine neue Übersetzungsaufgabe in der korrekten Reihenfolge erstellt.

Regeln für die Feldbenennung und weitere Einschränkungen

Damit Felder zur Übersetzung erscheinen, darf sich der Feldname nicht mehrfach wiederholen und nicht mit einem Unterstrich beginnen, wie bei _custom_field. Ein Verstoß gegen diese Regel führt dazu, dass das Feld nicht im Translation Dashboard erscheint.

Externe Links sind im Modus „Same fields across languages” nicht übersetzbar, und die Conditional Logic für Taxonomy- und Post-Object-Felder funktioniert in anderen Sprachen als der Standardsprache nicht korrekt.

Technische Anforderungen und Kompatibilität

Advanced Custom Fields Multilingual erfordert gleichzeitig ACF oder ACF Pro, WPML Core sowie WPML String Translation und übernimmt als Bindeglied-Plugin die Serveranforderungen von WPML und ACF. Die Umgebung benötigt mindestens 128 MB WordPress-Arbeitsspeicher (empfohlen 256 MB), die aktivierte PHP-Funktion eval(), die Erweiterung libxml sowie die Permalink-Struktur /%postname%/.

Erforderlicher Plugin-Stack

ACFML hat keine eigene, öffentliche Anforderungstabelle – als Glue Plugin übernimmt es diese von WPML und ACF. Alle vier Plugins müssen gemeinsam vorhanden sein: ACF oder ACF Pro, WPML Core, WPML String Translation sowie ACFML selbst.

ACF und ACF Pro sind bis PHP 8.3 kompatibel, und WPML erklärt Kompatibilität mit den aktuell unterstützten WordPress- und PHP-Versionen. Der Hersteller nennt kein einzelnes festes numerisches Minimum, sondern verweist auf eine dynamische Anforderungsseite und das Site-Health-Tool.

Serveranforderungen und PHP-Speicher

Die häufigste Problemquelle im WPML-und-ACF-Stack? Ein zu niedriges Speicherlimit. Hinweis: Das Minimum sind 128 MB WordPress-Arbeitsspeicher, empfohlen werden 256 MB – bei niedrigeren Werten erscheinen ACF-Felder mitunter nicht zur Übersetzung.

WPML benötigt die aktivierte PHP-Funktion eval(), da es das TWIG-Framework nutzt, sowie die Erweiterung libxml. Die empfohlene Permalink-Struktur ist /%postname%/, da WPML die Sprachinformation an die URL anhängt.

Häufig gestellte Fragen