ACF Multilingual Review: Advanced Custom Fields mit WPML kombinieren

Die Führung einer globalen Website erfordert mehr als nur die Übersetzung des Hauptinhalts. In einem modernen Content Management System (CMS) werden kritische Informationen – Preise, technische Spezifikationen, Teasertexte, Call-to-Action (CTA)-Texte und Metadaten – in Advanced Custom Fields (ACF) gespeichert. Wenn die Website mehrsprachig sein muss, stellt sich die Frage: Wie übersetzt man diese strukturierten ACF-Daten effizient, konsistent und fehlerfrei?

Die Antwort liegt in der nahtlosen Integration von ACF und WPML (WordPress Multilingual Plugin). Obwohl beide Plugins als Goldstandards in ihren jeweiligen Bereichen gelten, benötigen sie eine robuste Brücke, um die komplexen Datenstrukturen von ACF (insbesondere Repeater- und Flexible Content-Felder) korrekt zwischen den verschiedenen Sprachen zu synchronisieren und zu verwalten.

Dieses umfassende Review analysiert die Funktionen, die Einrichtung und die strategischen Vorteile dieser entscheidenden Kombination. Wir zeigen Ihnen, warum die effektive Nutzung von ACF und WPML der Schlüssel ist, um skalierbare, mehrsprachige und datengetriebene Websites zu erstellen.

1. Das Dilemma der mehrsprachigen Metadaten

Wenn eine WordPress-Seite mit ACF erstellt wird, werden die Inhalte in der Regel in der primären Sprache definiert. Bei der Übersetzung müssen diese Metadaten sauber in die Zielsprache übertragen werden.

Die Herausforderungen ohne saubere Integration:

  • Datenbank-Chaos: Manuelle Übersetzung von ACF-Daten kann zu Inkonsistenzen in der Datenbank führen.

  • Repeater-Desynchronisation: Wenn ein ACF Repeater-Feld (z. B. eine Liste von Teammitgliedern) in der englischen Version 5 Zeilen und in der deutschen Version 6 Zeilen hat, kann das System fehlerhaft arbeiten. Die Anzahl der Zeilen muss synchronisiert werden, aber der Inhalt jeder Zeile muss übersetzbar sein.

  • Entwicklungsaufwand: Das manuelle Codieren einer Übersetzungslogik für jedes ACF-Feld ist zeitaufwendig und nicht wartbar.

Die WPML-Integration für ACF wurde entwickelt, um diese Probleme zu lösen und die Struktur zu bewahren.

2. Die Rolle von WPML und ACF im Multilingualen Setup

  • ACF: Definiert die Struktur (z. B. “Das Produkt hat ein Feld für Preis, ein Feld für Beschreibung und ein Repeater für Spezifikationen”).

  • WPML: Definiert die Sprachlogik und das Übersetzungsmanagement (z. B. “Die englische Version dieser Seite ist die primäre, und die deutsche Version muss dieselbe Struktur haben”).

Die offizielle WPML-Integration für ACF fungiert als Kommunikationsbrücke, die WPML darüber informiert, welche ACF-Daten übersetzt werden müssen und welche einfach in die zweite Sprache kopiert werden können (z. B. Bilder oder Layout-Struktur).

3. Die nahtlose Integration: WPML Translation Management

Die Kombination der beiden Plugins funktioniert durch das WPML Translation Management Module und das dazugehörige ACF Multilingual Add-on (Teil der WPML-Suite, nicht von ACF).

3.1 Automatische Erkennung und Übersetzbarkeit von ACF-Feldern

Nach der Aktivierung erkennen die WPML-Einstellungen automatisch alle vorhandenen ACF-Feldgruppen. Der Entwickler kann dann für jedes Feld präzise definieren, wie es behandelt werden soll:

  1. Übersetzen (Translate): Der Inhalt muss manuell oder automatisch übersetzt werden (z. B. Textfelder, WYSIWYG).

  2. Kopieren (Copy): Der Wert des Feldes wird in die Zielsprache übernommen, ohne dass eine Übersetzung notwendig ist (z. B. die ID eines Bildes, die Farbe).

  3. Kopieren einmalig (Copy Once): Der Wert wird beim ersten Speichern kopiert, kann aber später in der Zielsprache geändert werden (selten genutzt).

3.2 Der Translation Editor: Die UX für Übersetzer

Wenn der Redakteur eine Seite zur Übersetzung an den WPML Translation Editor sendet, werden dank der ACF-Integration nicht nur der Haupttitel und der Hauptinhalt, sondern auch alle übersetzbaren ACF-Felder (Text, URL, Repeater-Unterfelder) im Editor angezeigt.

  • Vorteil: Der Übersetzer sieht die ACF-Daten in einer klaren, strukturierten Liste und muss nicht das Backend durchsuchen.

3.3 Korrekte Synchronisation von Repeater- und Flexible Content-Daten

Dies ist der kritischste Aspekt der Integration:

  • Struktur-Synchronisation: Bei Repeater-Feldern und Flexible Content-Feldern stellt WPML sicher, dass die Anzahl und die Reihenfolge der Zeilen/Layouts zwischen der Originalsprache und der Übersetzung synchronisiert werden.

  • Inhaltliche Übersetzung: Nur die tatsächlich übersetzbaren Unterfelder (z. B. der Titel im Repeater) erscheinen im Translation Editor, während die Struktur (die Zeilen) beibehalten wird.

Dies garantiert die strukturelle Integrität der gesamten Seite über alle Sprachen hinweg.

4. Konfiguration der Übersetzungsstrategie

Die richtige Konfiguration der ACF-Felder in den WPML-Einstellungen ist entscheidend.

“Übersetzen” vs. “Kopieren” vs. “Einmalig”

  • Wann “Kopieren”? Für alle Felder, die keine sprachlichen Inhalte enthalten: Farben, Bilder-IDs (wenn dasselbe Bild verwendet wird), Layout-Auswahl.

  • Wann “Übersetzen”? Für alle Felder, die Text enthalten: CTA-Texte, kurze Beschreibungen, Titel in Repeater-Feldern.

Die Handhabung von Medien- und Beziehungsfeldern (Media/Relationship)

  • Medien: WPML verfügt über das Media Translation Module. Wenn ein ACF-Bildfeld auf “Kopieren” gesetzt ist, kopiert WPML die Bild-ID. Anschließend kann das Media Translation Module das Bild in die sprachspezifische Version umwandeln (falls Sie unterschiedliche Bilder pro Sprache verwenden).

  • Beziehungen (Relationship): Diese Felder müssen meist auf “Kopieren” gesetzt werden. Wenn die Zielbeiträge ebenfalls übersetzt wurden, stellt WPML sicher, dass die Beziehung auf die korrekte übersetzte Version des Zielbeitrags verweist.

5. Strategische Vorteile für Entwickler und Content Manager

Konsistente Datenstruktur über alle Sprachen hinweg

Die WPML-Integration gewährleistet, dass jede übersetzte Seite dieselbe zugrunde liegende ACF-Struktur hat wie das Original. Dies ist entscheidend für die Stabilität des Theme-Codes.

Eliminierung manueller Fehler und Redundanz

Die Notwendigkeit, ACF-Daten manuell zu kopieren und einzufügen, entfällt. Die Automatisierung im Translation Editor reduziert Tippfehler und Formatierungsprobleme.

Beschleunigter Content-Workflow für Übersetzungen

Die nahtlose Integration in den WPML-Workflow (Senden zur Übersetzung $\rightarrow$ Bearbeitung im Editor $\rightarrow$ Rücknahme) macht die Pflege der strukturierten Inhalte extrem schnell und effizient.

6. WPML und das ACF Options Page (Globale Einstellungen)

Das Options Page (ACF Pro Feature) kann ebenfalls mehrsprachig verwaltet werden:

  • Globale Übersetzung: WPML ermöglicht es, eine Option Page als “nicht übersetzbar” (z. B. für API-Schlüssel) oder als “übersetzbar” (z. B. für den Footer-Slogan) zu markieren.

  • Separate Seiten: Sie können die Option Page sogar so konfigurieren, dass sie für jede Sprache eine eigene Instanz erstellt, was maximale Flexibilität bei der Verwaltung globaler Texte bietet.

7. Performance und Kompatibilität

  • Kompatibilität: Die offizielle Integration wird von WPML aktiv gepflegt. Da beide Plugins zu den meistverkauften im WordPress-Ökosystem gehören, ist die Kompatibilität sehr hoch.

  • Performance: Die Integration selbst ist schlank. Die Performance-Auswirkungen sind minimal, da die Übersetzung in der WPML-Datenbank verwaltet wird und nicht bei jedem Seitenaufruf neu berechnet werden muss.

8. ACF Pro vs. ACF Free in der WPML-Integration

Obwohl die grundlegenden ACF-Felder mit WPML funktionieren, wird die volle Leistung und Komplexität erst mit ACF Pro erreicht:

  • Komplexität: Nur ACF Pro erlaubt die Nutzung von Repeater und Flexible Content. Diese hochkomplexen Strukturen erfordern die robuste Synchronisationslogik, die die WPML-Integration bietet.

  • Verzicht auf Pro: Ohne ACF Pro und seine Features (Repeater, Flexible Content) ist die WPML-Integration weitaus weniger notwendig, da die einfachen Textfelder auch nativ gut übersetzbar sind.

9. Fazit: ACF und WPML – Die Basis für globales, strukturiertes CMS

Die effektive Kombination von Advanced Custom Fields Pro und WPML ist der absolute Goldstandard für die Entwicklung von mehrsprachigen, datengetriebenen WordPress-Websites.

Sie löst die Probleme der Datenkonsistenz, der Struktur-Synchronisation und des effizienten Übersetzungs-Workflows mit beispielloser Eleganz.

Die Integration ist der Schlüssel zu:

  • Stabiler, wartbarer Code, der sich nicht um Übersetzungslogik kümmern muss.

  • Einem effizienten Übersetzungs-Workflow dank des Translation Editors.

  • Struktureller Integrität der komplexen ACF-Felder in allen Sprachen.

Wenn Sie das Potenzial von ACF voll ausschöpfen und gleichzeitig eine globale Zielgruppe bedienen möchten, ist die Nutzung dieser robusten Integration unverzichtbar.

Related Articles