Zum Inhalt springen Zur Seitenleiste springen
Startseite » WPML-Dokumentation » Verwandte Projekte » Advanced Custom Fields (ACF) Mehrsprachig – Alle Felder mit WPML übersetzen » Übersetzungseinstellungen für ACF-Felder in PHP- und JSON-Dateien festlegen

Übersetzungseinstellungen für ACF-Felder in PHP- und JSON-Dateien festlegen

Kathy
Aktualisiert
März 3, 2026

Erfahren Sie, wie Sie Übersetzungseinstellungen für in PHP registrierte ACF-Felder festlegen und diese automatisch in von ACF generierte JSON-Dateien aufnehmen.

Übersetzungseinstellungen für mit PHP registrierte ACF-Felder

Um Übersetzungseinstellungen für mit PHP registrierte ACF-Felder festzulegen, müssen Sie die acf_add_local_field_group-Funktion verwenden und wpml_cf_preferences zu jeder Felddefinition hinzufügen.

Es gibt vier numerische Werte, die Sie für wpml_cf_preferences verwenden können:

  • 0 — Nicht übersetzen. WPML ignoriert das Feld vollständig.
  • 1 — Kopieren. Der Feldwert wird in alle Sprachen kopiert und bleibt synchron.
  • 2 — Übersetzen. Der Feldwert steht zur Übersetzung zur Verfügung.
  • 3 — Einmal kopieren. Der Feldwert wird einmal in alle Sprachen kopiert, danach kann er in jeder Sprache unabhängig bearbeitet werden.

Sie sind sich nicht sicher, welche Übersetzungsoption Sie verwenden sollen? Sehen Sie sich die empfohlene Option für jedes ACF-Feld an.

Unten sehen Sie ein Beispiel für das Hinzufügen des Schlüssels wpml_cf_preferences zu einer programmgesteuert registrierten Feldgruppe.

acf_add_local_field_group( [
  'key' => 'group_1',
  'title' => 'Meine Gruppe',
  'fields' => [
  [
  'key' => 'field_1',
  'label' => 'Untertitel',
  'name' => 'sub_title',
  'type' => 'text',
  'prefix' => '',
  'instructions' => '',
  'required' => 0,
  'conditional_logic' => 0,
  'wrapper' => [
  'width' => '',
  'class' => '',
  'id' => '',
  ],
  'default_value' => '',
  'placeholder' => '',
  'prepend' => '',
  'append' => '',
  'maxlength' => '',
  'readonly' => 0,
  'disabled' => 0,
  'wpml_cf_preferences' => 2, // Dieses Feld ("Untertitel") wird übersetzt.
  ],
  ],
  'location' => [
  [
  [
  'param' => 'post_type',
  'operator' => '==',
  'value' => 'post',
  ],
  ],
  ],
  'menu_order' => 0,
  'position' => 'normal',
  'style' => 'default',
  'label_placement' => 'top',
  'instruction_placement' => 'label',
  'hide_on_screen' => '',
] );

Ihre Felder mit WPML synchronisieren

Nachdem Sie Ihre Felder per PHP definiert haben, müssen Sie WPML darüber informieren.

  1. Gehen Sie zur Seite ACF → Tools.
  2. Scrollen Sie nach unten zu ACF lokale JSON- und PHP-registrierte Felder übersetzen.
Lokale ACF-Felder mit WPML synchronisieren
  1. Wählen Sie im Abschnitt Übersetzungseinstellungen für lokale Felder synchronisieren aus, wann die Synchronisierung erfolgen soll. In den meisten Fällen möchten Sie die Option Jetzt einmal synchronisieren verwenden und dann auf die Schaltfläche Anwenden klicken.

WPML synchronisiert die Felder und setzt anschließend wieder auf die Option ohne Synchronisierung zurück. So wird Ihre Datenbank nur einmal und zu dem von Ihnen gewählten Zeitpunkt durch die Synchronisierung belastet.

Übersetzungseinstellungen für ACF-Felder in JSON-Dateien festlegen

Wenn Sie die Funktion Local JSON von ACF verwenden, fügt ACF Multilingual (ACFML) automatisch Übersetzungseinstellungen für jedes Feld in Ihrer JSON-Datei hinzu. Das bedeutet, dass beim Export und Import von JSON-Dateien zwischen Websites die Übersetzungseinstellungen automatisch auf der Ziel-Website angewendet werden.

Sie müssen ACFML lediglich auf der Quell- und der Zielseite aktivieren. Danach wird ACF bei jeder Generierung einer JSON-Datei auch Ihre Übersetzungseinstellungen aufnehmen.

Wenn Ihre JSON-Dateien ursprünglich ohne aktives ACFML generiert wurden, aktivieren Sie ACFML, importieren Sie die JSON-Dateien in die ACF-Benutzeroberfläche, legen Sie die Übersetzungseinstellungen fest und speichern Sie die Feldgruppen erneut. Dadurch werden die JSON-Dateien mit den enthaltenen Einstellungen neu generiert.