Aller au contenu principal

2.5.2. Activer la synchronisation des données ACF : configuration WordPress/WooCommerce pour Fozzels

L'intégration Fozzels - WooCommerce prend désormais officiellement en charge Advanced Custom Fields (ACF) !

Cette fonctionnalité vous permet de synchroniser des caractéristiques produit uniques et étendues (telles que des spécifications techniques, des descriptions multilingues ou des paramètres spéciaux) que vous ajoutez via ACF, afin de créer des flux produits plus détaillés et plus compétitifs pour les places de marché.

Une intégration réussie nécessite des étapes de configuration essentielles dans WordPress comme dans Fozzels.

Partie 1 : préparer les données dans WordPress (ACF et API REST)​

Avant d'activer ACF dans Fozzels, assurez-vous que WordPress et ACF sont configurés pour transmettre correctement ces données spéciales via l'API REST.

Étape 1 : vérifier et configurer les permaliens​

Pour que l'API REST fonctionne correctement, la structure des permaliens doit être différente de la structure par défaut (simple).

  1. Connectez-vous à l'administration de WordPress et accédez à Settings / Permalinks.

  2. Choisissez une structure qui n'utilise pas de paramètres (la structure "Post name" est recommandée).

  3. Vérifiez que v3 est sélectionné dans le champ Request Version.

  4. Enregistrez les modifications.

Étape 2 : accéder au groupe de champs ACF​

  1. Dans le menu WordPress, allez dans ACF / Field Groups.

  2. Cliquez sur le nom du groupe de champs (Field Group) qui contient les champs que vous devez synchroniser pour vos produits WooCommerce (par ex. "Fozzels Description").

Étape 3 : configurer le groupe de champs pour l'accès à l'API (étape cruciale)​

Dans la fenêtre de modification du Field Group, vérifiez les règles d'emplacement et activez l'accès à l'API.

3.1. Vérification des règles d'emplacement​

  1. Dans l'onglet Location Rules, vérifiez que la règle est définie sur : Post Type is equal to Product.

3.2. Activation de l'API REST et du groupe​

  1. Accédez à l'onglet Group Settings.

  2. Vérifiez que les deux boutons sont activés (positionnés sur ON) :

  • Active

    • Show in REST API
  1. Enregistrez les modifications en cliquant sur Update ou Publish.

Étape 4 : vérifier la version de l'API REST d'ACF​

Si vous utilisez un plugin supplémentaire pour intégrer ACF à l'API REST (comme ACF to REST API), vous devez vous assurer que la version sélectionnée est compatible avec Fozzels.

  1. Allez dans Settings / Permalinks / ACF to REST API.

  2. Vérifiez que v3 est sélectionné dans le champ Request Version.

    Exigence de Fozzels : l'intégration nécessite la prise en charge de l'API REST v3.

  3. Enregistrez les paramètres.

Partie 2 : activer ACF dans Fozzels​

Une fois la préparation dans WordPress terminée, activez la fonctionnalité dans les paramètres de votre intégration Fozzels.

  1. Connectez-vous à votre compte Fozzels et accédez à la modification de votre intégration WooCommerce.

  2. Dans la section Configuration, repérez le bouton "Enable ACF (Advanced Custom Fields)".

  3. Activez-le (positionnez-le sur ON).

Important ! Prenez note des prérequis confirmés par Fozzels :

  • Le plugin ACF est installé et activé dans WordPress.

  • L'API REST est activée dans les paramètres du Field Group ACF (Show in REST API: Yes).

  • ACF version 6.x ou supérieure avec prise en charge de l'API REST v3.

  1. Cliquez sur Save en bas de la page.

Partie 3 : utiliser les champs ACF dans le Flow et mettre à jour le catalogue​

Fozzels traite les attributs ACF comme des attributs produit ordinaires, et vous travaillez avec eux selon le flux standard.

  1. Après avoir activé le bouton "Enable ACF" et cliqué sur "Save", vous devez lancer le processus d'importation des données :
  • Si vous mettez à jour une intégration existante : relancez le pool de produits et d'attributs. Cela actualisera les données du catalogue Fozzels et importera les nouveaux champs ACF.

    • S'il s'agit de votre première intégration : lancez simplement le pool de produits en suivant les règles générales de configuration de l'intégration.
  1. Une fois le pool terminé avec succès, accédez à la section 3 Attributes, vérifiez les nouveaux attributs et leur configuration**.** Si vous avez des questions ou besoin d'aide pour configurer l'intégration ACF, notre équipe de support se fera un plaisir de vous aider ! Veuillez nous contacter à l'adresse support@fozzels.com.