ACFML – Mehrsprachige benutzerdefinierte Felder für ACF und ACF Pro in WordPress
Machen Sie jedes benutzerdefinierte Feld auf Ihrer Website mehrsprachig. ACFML fügt Advanced Custom Fields und ACF Pro mehrsprachige Unterstützung hinzu. Es deckt jeden Feldtyp, jede Feldgruppe, jede Optionsseite sowie die Feldbezeichnungen selbst ab. ACF Pro-Setups mit Repeater, Flexible Content, Clone, bedingter Logik (Conditional Logic) und lokalen, über PHP registrierten Feldern werden vollständig unterstützt. In Multilingual CMS und Agency enthalten.
Jeder ACF-Feldtyp ist mehrsprachig
Wenn Sie Websites mit ACF erstellen, deckt ACFML jeden Feldtyp im Katalog von ACF und ACF Pro ab:
- Text- und Wysiwyg-Felder werden pro Sprache übersetzt.
- Repeater- und Flexible-Content-Zeilen bleiben über alle Sprachen hinweg synchron.
- Bild-, Datei- und Galerie-Felder können gegen lokalisierte Assets pro Sprache ausgetauscht werden.
- Link-, Beziehungs- und Beitragsobjekt-Felder bleiben zwischen den Sprachen korrekt verknüpft.
- Datumsauswahl, Farbauswahl, Karte und die anderen interaktiven Felder verhalten sich pro Sprache korrekt.
Benutzerdefinierte Beitragstypen, Taxonomien und Optionsseiten, die Sie über ACF registrieren, werden ebenfalls übersetzt – einschließlich ihrer Bezeichnungen. Die Website, die Sie mit ACF erstellen, ist exakt die Website, die mit ACFML mehrsprachig wird, nicht nur eine Teilmenge davon.
Wählen Sie, was pro Sprache gleich und was unterschiedlich ist
ACF-Feldgruppen haben kein einheitliches Übersetzungsverhalten. Die Seite Unser Team auf Ihrer Website zeigt in jeder Sprache dieselben Teammitglieder: Übersetzen Sie deren Namen und Biografien, behalten Sie die Struktur intakt. Die Seite Veranstaltungen zeigt unterschiedliche Events für unterschiedliche Zielgruppen: Zeigen Sie pro Sprache komplett andere Veranstaltungen an. Die Seite Produktspezifikationen zeigt eine Mischung: Übersetzen Sie die Beschreibung, behalten Sie Artikelnummer (SKU) und Preis bei.
ACFML handhabt alle drei auf Basis der jeweiligen Feldgruppe: Gleiche Felder in allen Sprachen, Unterschiedliche Felder in verschiedenen Sprachen und Expertenmodus für gemischte Setups. Wählen Sie den Modus, der zum Zweck der jeweiligen Feldgruppe passt; ACFML richtet das Übersetzungsverhalten automatisch ein.
Übersetzungssteuerung pro Feld
Innerhalb einer Feldgruppe erhält jedes Feld seine eigene Übersetzungspräferenz:
- Übersetzen. Der Wert des Feldes wird pro Sprache übersetzt.
- Kopieren. Der Wert des Feldes bleibt über alle Sprachen hinweg synchron; bearbeiten Sie ihn einmal und er wird auf alle Sprachen übertragen.
- Einmal kopieren. Der Wert des Feldes dient als Ausgangsbasis für neue Übersetzungen, danach kann jede Sprachversion unabhängig bearbeitet werden.
- Nicht übersetzen. Das Feld wird komplett ignoriert (z. B. ein internes Feld nur für den Admin-Bereich).
Sinnvolle Standardeinstellungen pro Feldtyp werden direkt mitgeliefert: Text- und Wysiwyg-Felder sind standardmäßig auf Übersetzen eingestellt, strukturierte Felder wie Bild, Link und Zahl standardmäßig auf Kopieren. Die vollständige Referenz der Voreinstellungen finden Sie unter So übersetzen Sie benutzerdefinierte ACF-Felder.
Repeater- und Flexible-Content-Zeilen bleiben über alle Sprachen hinweg synchron
Repeater- und Flexible-Content-Felder sind die Stellen, an denen mehrsprachige ACF-Setups mit anderen Tools oft scheitern: Zeilen werden asynchron, Layouts weichen voneinander ab und Übersetzer sehen Inhalte, die sie nicht erkennen. ACFML hält die Zeilenstruktur standardmäßig über alle Sprachen hinweg synchron. Übersetzer sehen dieselben Zeilen in derselben Reihenfolge, wobei jedes übersetzbare Unterfeld an seinem Platz ist. Wenn Sie abweichende Strukturen pro Sprache benötigen (z. B. eine andere Veranstaltungsliste in jeder Sprache), ermöglicht die Präferenz Einmal kopieren genau das.
Lokale Felder (PHP-registriert) erhalten dasselbe Übersetzungsverhalten
Viele Live-Websites registrieren ACF-Felder in PHP statt in der ACF-Benutzeroberfläche (aus Gründen der Portabilität, Versionskontrolle oder für im Theme gebündelte Konfigurationen). ACFML 2.2.0 (Feb. 2026) bringt vollständige Unterstützung für lokale Felder (Local Fields). Sie legen die Übersetzungspräferenz jedes Feldes mit dem Schlüssel wpml_cf_preferences in der Definition der Feldgruppe fest, synchronisieren sie unter ACF > Werkzeuge mit WPML, und die Admin-Bildschirme spiegeln wider, was die Feldgruppe deklariert. Die lokalen JSON-Dateien von ACF nehmen die Präferenzen mit, wenn Sie zwischen Websites exportieren und importieren. Die Schritt-für-Schritt-Anleitung finden Sie auf der How-to-Seite unter Präferenzen für in PHP oder JSON registrierte Felder festlegen.
Entwickler-Hooks für Sonderfälle
Für Websites mit benutzerdefinierter Logik zur Feldübersetzung (bestimmte Felder ausschließen, die Standardpräferenz für einen Feldtyp global überschreiben, Anmerkungen vor Übersetzern verbergen) stellt ACFML zwei Filter (acfml_should_translate_acf_entity, acfml_field_group_mode_field_translation_preference) und vier Konstanten (ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS, ACFML_HIDE_FIELD_ANNOTATIONS, ACFML_REPEATER_SYNC_DEFAULT, ACFML_SCAN_LOCAL_FIELDS) bereit. Die vollständige Referenz mit Codebeispielen finden Sie unter Referenz zu ACFML-Hooks und -Konstanten.
Gemeinsam mit dem ACF-Team entwickelt und gepflegt
WPML und das ACF-Team arbeiten eng an der kontinuierlichen Kompatibilität zusammen – bestätigt auf der gemeinsamen ACF-Kompatibilitätsseite. Wenn ACF oder ACF Pro eine neue Version veröffentlicht, hält ACFML Schritt; wenn ACFML ACF-seitige Unterstützung für ein neues Übersetzungsverhalten benötigt, wird die Integration gemeinsam entwickelt, anstatt sie per Reverse Engineering nachzubauen.
ACFML ist in WPML enthalten
ACFML ist in Multilingual CMS und WPML Agency enthalten. Kein separater Kauf, keine Gebühr pro Website. Kaufen Sie WPML einmalig und jede ACF-Website, die Ihr Konto abdeckt, wird mehrsprachig. Wenn Sie WPML bereits haben, aktivieren Sie ACFML über Ihre WPML-Downloadseite.