Passer au contenu Passer à la barre latérale
Accueil » Documentation WPML » Projets connexes » Advanced Custom Fields (ACF) Multilingual – Traduisez tous les champs avec WPML » Définir les préférences de traduction pour les champs ACF dans les fichiers PHP et JSON

Définir les préférences de traduction pour les champs ACF dans les fichiers PHP et JSON

Kathy
Mis à jour
mars 3, 2026

Découvrez comment définir les préférences de traduction pour les champs ACF enregistrés en PHP et les inclure automatiquement dans les fichiers JSON générés par ACF.

Définir les préférences de traduction pour les champs ACF enregistrés avec PHP

Pour définir les préférences de traduction pour les champs ACF enregistrés avec PHP, vous devez utiliser la fonction acf_add_local_field_group et ajouter wpml_cf_preferences à la définition de chaque champ.

Il y a quatre valeurs numériques que vous pouvez utiliser pour wpml_cf_preferences :

  • 0 — Ne pas traduire. WPML ignore entièrement le champ.
  • 1 — Copier. La valeur du champ est copiée dans toutes les langues et reste synchronisée.
  • 2 — Traduire. La valeur du champ est rendue disponible pour la traduction.
  • 3 — Copier une fois. La valeur du champ est copiée une fois dans toutes les langues, après quoi elle peut être modifiée indépendamment dans chaque langue.

Vous ne savez pas quelle option de traduction utiliser ? Consultez l’option recommandée pour chaque champ ACF.

Ci-dessous, vous pouvez voir un exemple d’ajout de la clé wpml_cf_preferences à un groupe de champs enregistré de manière programmatique.

acf_add_local_field_group( [
  'key' => 'group_1',
  'title' => 'My Group',
  'fields' => [
  [
  'key' => 'field_1',
  'label' => 'Sub Title',
  '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, // Ce champ ("Sub Title") sera traduit.
  ],
  ],
  'location' => [
  [
  [
  'param' => 'post_type',
  'operator' => '==',
  'value' => 'post',
  ],
  ],
  ],
  'menu_order' => 0,
  'position' => 'normal',
  'style' => 'default',
  'label_placement' => 'top',
  'instruction_placement' => 'label',
  'hide_on_screen' => '',
] );

Synchroniser vos champs avec WPML

Après avoir défini vos champs à l’aide de PHP, vous devez les déclarer à WPML.

  1. Accédez à la page ACF → Outils.
  2. Faites défiler jusqu’à Traduire les champs ACF Local JSON et enregistrés en PHP.
Synchroniser les champs ACF locaux avec WPML
  1. Dans la section Synchroniser les préférences de traduction pour les champs locaux, sélectionnez le moment où la synchronisation doit avoir lieu. Dans la plupart des cas, vous souhaiterez utiliser l’option Synchroniser une fois maintenant, puis cliquer sur le bouton Appliquer.

WPML synchronisera les champs, puis reviendra à l’option de non-synchronisation. Ainsi, la synchronisation ne sollicite votre base de données qu’une seule fois, au moment que vous choisissez.

Définir les préférences de traduction pour les champs ACF dans les fichiers JSON

Si vous utilisez la fonctionnalité Local JSON d’ACF, ACF Multilingual (ACFML) ajoute automatiquement des préférences de traduction pour chaque champ de votre fichier JSON. Cela signifie que lorsque vous exportez et importez des fichiers JSON entre des sites, les préférences de traduction s’appliquent automatiquement sur le site de destination.

Il vous suffit d’activer ACFML sur le site d’origine et sur le site de destination. Une fois cette opération effectuée, chaque fois qu’ACF génère un fichier JSON, il inclura également vos préférences de traduction.

Si vos fichiers JSON ont été générés à l’origine sans ACFML actif, activez ACFML, importez les fichiers JSON dans l’interface utilisateur d’ACF, définissez les préférences de traduction et enregistrez à nouveau les groupes de champs. Cela régénère les fichiers JSON avec les préférences incluses.