Comment utiliser ACF avec Air WP Sync Pro ?

La version Pro d'Air WP Sync permet la compatibilité avec ACF. Les principaux champs ACF sont pris en charge.
Voici une documentation sur la façon de configurer certains des champs les plus intéressants.

Champ Répéteur d’ACF

Voir l'article ici sur l'utilisation du champ Répéteur d’ACF.

Champ Utilisateur ACF

Le champ Utilisateur d’ACF vous permet de sélectionner un ou plusieurs utilisateurs.

Il y a deux façons de remplir un champ utilisateur ACF :

Durant l’importation d’une publication

Il est possible d'importer des utilisateurs Airtable dans les champs Utilisateur ACF contenus dans les types d'articles.

⚠️ Notez que le champ Utilisateur d’ACF n'est compatible qu'avec une adresse email .

Le champ fonctionne en utilisant un email sur Airtable : soit le champ "email", soit l'email d'un champ utilisateur ("Créé par", "Utilisateur", etc.).

Lors de l'importation d'un utilisateur

Il est désormais possible d'importer des utilisateurs Airtable dans les comptes WordPress.

⚠️ Notez qu'il est nécessaire de mettre en correspondance l'adresse Email et le nom d'utilisateur pour que l'importation soit effectuée.

Sélecteur de couleurs d’ACF

Le champ Sélecteur de couleur d’ACF fonctionne en utilisant un champ de texte sur Airtable, quel que soit le format de couleur sélectionné. Il suffit de respecter le format spécifié.

ACF vérifie le format à l'étape du rendu, et si aucun format reconnu n'est trouvé, il utilise par défaut la couleur noire.

Champs Objet de la publication / Relation d’ACF

Champ Objet de la publication

Le champ Objet de la publication d’ACF vous permet de sélectionner un ou plusieurs articles, pages ou types de publication personnalisés (CPT).

Si vous souhaitez utiliser un champ Objet de la publication lors de votre mappage, vous devez d'abord saisir dans votre champ Airtable le chemin de la publication (ou de la page ou du CPT) en fonction du type de publication :

Si la publication est un simple article ou une page, saisissez le nom de l'article ou de la page, c'est-à-dire le slug de la publication.
Si la publication est une page enfant, saisissez le nom de la page parent et le nom de la page enfant comme chemin, c'est-à-dire slug de la page parent/slug de la page enfant.
Si la publication est un type de publication personnalisé (CPT), saisissez le préfixe du CPT et le nom de la publication en tant que chemin, c'est-à-dire slug-prefix-cpt/slug-publication.

Vous pouvez utiliser différents types de champs Airtable : texte d'une seule ligne, texte long, sélection unique, sélection multiple.

⚠️ Si vous avez une structure de permalien personnalisée (par exemple : "/%category%/%postname%/"), le chemin de la publication dans Airtable doit y correspondre. Voir l'exemple ci-dessous.

💡 Si vous souhaitez utiliser des publications multiples, comme le permet le champ Objet de la publication d’ACF, vous devez utiliser un champ de sélection multiple dans Airtable.

Par exemple, dans WordPress, vous avez la structure suivante :

Publications correspondant à des formations, avec un champ ACF Objet de la publication affichant l'organisateur, et un champ ACF Objet de la publication affichant le lieu.
Publications correspondant à des organisateurs, dans la catégorie "organisateur de formation".
CPT correspondant aux lieux de formation.

Si vous souhaitez synchroniser Airtable et WordPress, et remplir les champs de Objet de la publication d’ACF avec des valeurs qui correspondent aux publications, vous devez remplir les champs en formant un chemin à l'aide de slugs de publications, de slugs de taxonomies, de slugs de CPT ou de page parent.