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 und lokalen in PHP registrierten Feldern werden alle 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.
- Zeilen von Repeater und Flexible Content bleiben über alle Sprachen hinweg synchron.
- Bild-, Datei- und Galerie-Felder können pro Sprache durch lokalisierte Assets ausgetauscht werden.
- Link-, Beziehungs- und Post Object-Felder bleiben zwischen den Sprachen korrekt verknüpft.
- Date Picker, Color Picker, 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 genau 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 für alle Fälle. Die Seite Unser Team auf Ihrer Website zeigt in jeder Sprache dieselben Teammitglieder: Übersetzen Sie deren Namen und Biografien, aber behalten Sie die Struktur bei. Die Seite Veranstaltungen zeigt unterschiedliche Events für verschiedene Zielgruppen: Zeigen Sie pro Sprache komplett andere Events an. Die Seite Produktspezifikationen zeigt eine Mischung: Übersetzen Sie die Beschreibung, aber behalten Sie Artikelnummer (SKU) und Preis bei.
ACFML handhabt alle drei auf Basis der jeweiligen Feldgruppe: Gleiche Felder über Sprachen hinweg, Unterschiedliche Felder über Sprachen hinweg und 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 Übersetzungseinstellung:
- Ü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 Basis 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 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
Bei Repeater- und Flexible Content-Feldern scheitern mehrsprachige ACF-Setups in anderen Tools oft: Zeilen geraten aus der Synchronisation, 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 Event-Liste in jeder Sprache), ermöglicht die Einstellung Einmal kopieren dies.
Lokale Felder (in PHP registriert) erhalten dasselbe Übersetzungsverhalten
Viele Live-Websites registrieren ACF-Felder in PHP statt in der ACF-Admin-Benutzeroberfläche (wegen Portabilität, Versionskontrolle oder im Theme gebündelter Konfigurationen). ACFML 2.2.0 (Feb 2026) bietet vollständige Unterstützung für lokale Felder. Sie legen die Übersetzungseinstellung jedes Feldes mit dem Schlüssel wpml_cf_preferences in der Definition der Feldgruppe fest, synchronisieren diese über ACF > Tools mit WPML, und die Admin-Bildschirme spiegeln wider, was die Feldgruppe deklariert. Die lokalen JSON-Dateien von ACF nehmen die Einstellungen mit, wenn Sie zwischen Websites exportieren und importieren. Die Schritt-für-Schritt-Anleitung finden Sie auf der How-to-Seite unter Einstellungen für in PHP oder JSON registrierte Felder festlegen.
Entwickler-Hooks für Ausnahmefälle
Für Websites mit benutzerdefinierter Logik für die Feldübersetzung (bestimmte Felder ausschließen, die Standardeinstellung 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) zur Verfügung. Die vollständige Referenz mit Codebeispielen 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, 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 wird mit Multilingual CMS und WPML Agency ausgeliefert. Kein separater Kauf, keine Gebühr pro Website. Kaufen Sie WPML einmalig, und jede ACF-Website, die Ihr Konto abdeckt, wird mehrsprachig. Wenn Sie bereits WPML haben, aktivieren Sie ACFML über Ihre WPML-Download-Seite.