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.
- Zeilen von Repeater und Flexible Content bleiben über alle Sprachen hinweg synchron.
- Bild-, Datei- und Galerie-Felder können pro Sprache durch lokalisierte Assets ersetzt werden.
- Link-, Beziehungs- und Post-Object-Felder bleiben zwischen den Sprachen korrekt verknüpft.
- Date Picker, Color Picker, Karten und die anderen interaktiven Felder verhalten sich pro Sprache korrekt.
Benutzerdefinierte Beitragstypen, Taxonomien und Options-Seiten, die Sie über ACF registrieren, lassen sich ebenfalls übersetzen – einschließlich ihrer Bezeichnungen. Die Website, die Sie mit ACF erstellen, ist genau die Website, die mit ACFML mehrsprachig wird, nicht nur ein Teil 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, aber behalten Sie die Struktur intakt. Die Events-Seite zeigt unterschiedliche Veranstaltungen für unterschiedliche Zielgruppen: Zeigen Sie pro Sprache komplett andere Events an. Die Seite Produktspezifikationen zeigt eine Mischung: Übersetzen Sie die Beschreibung, aber behalten Sie SKU und Preis bei.


ACFML handhabt alle drei Fälle auf Basis der jeweiligen Feldgruppe: Gleiche Felder in allen Sprachen, Unterschiedliche Felder in verschiedenen Sprachen und den Expertenmodus für gemischte Setups. Wählen Sie den Modus, der zum Zweck jeder 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 übernommen.
- 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 vollständig ignoriert (z. B. ein internes Feld nur für den Admin-Bereich).
Sinnvolle Standardeinstellungen pro Feldtyp sind sofort einsatzbereit: Text- und Wysiwyg-Felder stehen standardmäßig auf Übersetzen, 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.
Zeilen von Repeater und Flexible Content bleiben über alle Sprachen hinweg synchron
Repeater- und Flexible Content-Felder sind die Stellen, an denen mehrsprachige ACF-Setups in anderen Tools oft scheitern: Zeilen geraten aus dem Takt, 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 sich jedes übersetzbare Unterfeld an seinem Platz befindet. Wenn Sie abweichende Strukturen pro Sprache benötigen (z. B. eine andere Event-Liste in jeder Sprache), ermöglicht die Präferenz Einmal kopieren genau das.
Lokale Felder (über PHP registriert) erhalten dasselbe Übersetzungsverhalten
Viele Live-Websites registrieren ACF-Felder in PHP statt in der ACF-Admin-Benutzeroberfläche (aus Gründen der Portabilität, Versionskontrolle oder für in Themes gebündelte Konfigurationen). ACFML 2.2.0 (Feb. 2026) bringt vollständige Unterstützung für lokale Felder. Sie legen die Übersetzungspräferenz jedes Feldes mit dem Schlüssel wpml_cf_preferences in der Feldgruppen-Definition fest, synchronisieren sie über ACFWerkzeuge in 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 schrittweise Anleitung finden Sie auf der How-to-Seite unter Festlegen von Präferenzen für in PHP oder JSON registrierte Felder.
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) bietet 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). Die vollständige Referenz mit Code-Beispielen finden Sie unter Referenz für 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, zieht ACFML nach; wenn ACFML ACF-seitige Unterstützung für ein neues Übersetzungsverhalten benötigt, wird die Integration gemeinsam entwickelt, anstatt sie per Reverse-Engineering nachzubauen.