Menu Documentation

WP connect > Air WP Sync pour WooCommerce Documentation

Documentation Air WP Sync pour WooCommerce

Avec notre Air WP Sync for WooCommerce vous pouvez connecter une base de données Airtable à votre site WooCommerce, pour gérer facilement votre boutique en dehors du panneau d'administration de WordPress.

Installation

Pour installer le Air WP Sync for WooCommerce suivez les étapes suivantes :

Téléchargez l'archive zip du plugin sur votre ordinateur.
Connectez-vous à votre tableau de bord WordPress.
Dans le tableau de bord de WordPress, allez à Plugins > Ajouter un nouveau plugin.
Cliquez sur Plugin de téléchargement en haut de la page.
Cliquez sur Choisir un fichier et sélectionnez le fichier du plugin que vous avez téléchargé à l'étape 1.
Cliquez sur Installer maintenant bouton.
Attendez que le plugin soit installé, puis cliquez sur le bouton Activer le plugin bouton.

⚠️ Veuillez noter que le plugin WooCommerce doit être installé et activé pour permettre l'utilisation de la fonction Air WP Sync for WooCommerce plugin.

Configurer votre extension

Avant d'utiliser votre Air WP Sync for WooCommerce il doit être configuré avec votre licence et le jeton Airtable permettant l'accès à votre base de données Airtable.

Avant de démarrer l'assistant, qui vous aidera à configurer rapidement le plugin, préparez votre clé de licence du plugin et votre jeton Airtable :

La clé de licence est disponible à la fois dans l'e-mail de confirmation d'achat et sur le site Internet de la Commission européenne. wpconnect.co > Mon compte > Mes produits téléchargeables > Clés de licence, Visualiser les licences. Vous serez alors redirigé vers la page d'achat de votre produit. Cliquez sur l'icône de la clé pour voir apparaître le numéro de licence que vous pourrez copier ultérieurement.
Connectez-vous à votre compte Airtable pour définir votre jeton :
1. Cliquez sur l'icône Builder Hub dans le menu déroulant de votre compte.
2. Cliquez sur Jetons d'accès personnels dans le menu de gauche.
3. Cliquez sur + Créer un nouveau jeton bouton.
4. Donnez à votre jeton une Nom et suivez les instructions données par notre assistant pour le Scopes et Accès à le configurer.
  ⚠️ Pour que le plugin fonctionne correctement, vous devez définir :
  – Portée : data.records:read, data.records:write, schema.bases:read et schema.bases:write
  – Accès : Toutes les bases actuelles et futures dans tous les espaces de travail actuels et futurs
5. Cliquez sur Créer un jeton bouton.
6. Laissez la fenêtre contextuelle affichant votre jeton ouverte ; nous reviendrons dans un instant pour le copier. Dans la Votre jeton a été créé cliquez sur Copie puis cliquez sur Terminé pour le fermer.
  📌 Si vous avez besoin d'aide pour créer le jeton, voir cette vidéo pour apprendre à créer un jeton dans Airtable.

Pour démarrer l'assistant : cliquez sur le bouton Air WP Sync for WooCommerce dans le tableau de bord de WordPress, et l'assistant apparaît.

Procédez comme suit :

Cliquez sur Configurer votre extension bouton.
Si vous souhaitez activer Air WP Sync changer l'option Air WP Sync est désactivé et cliquez sur l'icône Prochaine étape→ bouton. Voir aussi Activation de Air WP Sync pour plus d'informations.
Allez sur votre compte WP connect, copiez votre licence et collez-la dans Clé de licence puis cliquez sur le bouton Prochaine étape→ bouton.
Allez sur votre compte Airtable, et dans Votre jeton a été créé cliquez sur Copie puis cliquez sur Terminé pour le fermer.
⚠️ Ne vous déconnectez pas de votre compte Airtable pour le moment.
Retournez à l'assistant et collez le jeton dans le champ Jeton d'accès domaine.
Cliquez sur Prochaine étape→ : votre plugin est configuré !
Si vous souhaitez continuer à configurer la connexion à votre base Airtable, cliquez sur le bouton Connexion à la base Airtable→ pour définir les paramètres.

Première connexion à la base de données Airtable

Si vous avez cliqué sur le bouton Connexion à la base Airtable→ à la fin de l'assistant de configuration, ou si vous cliquez sur le bouton Air WP Sync for WooCommerce dans le tableau de bord de WordPress, vous accéderez à l'assistant qui vous permettra de connecter votre plugin à la base de données Airtable.

Nous allons maintenant connecter le plugin à notre fichier Modèle de base de table aérienneLe système de synchronisation des produits est créé pour faciliter les connexions entre les produits (synchronisations).

Ce modèle sera copié dans l'espace de travail auquel vous avez donné accès précédemment.

⚠️ Ne renommez pas ou ne modifiez pas le modèle avant la copie et votre première connexion réussie.

⚠️ Vérifier la version du modèle.

La copie et la connexion se font en quatre étapes :

Dans WordPress, cliquez sur Copiez notre modèle de base Airtable : notre modèle de base Airtable s'affiche dans un nouvel onglet Airtable.
Dans cet onglet Airtable, cliquez sur Copier la base (situé à droite du nom du modèle en haut de la page).
Sélectionnez l'espace de travail souhaité et cliquez sur Ajouter une base bouton.
Retourner à Air WP Sync for WooCommerce interface : vous voyez maintenant que Air WP Sync pour WooCommerce Template est connecté au plugin.

Nous pouvons maintenant définir un premier Connexion Woo pour importer des produits dans le plugin WooCommerce.

Connexions Woo

Créer une première connexion Woo

Une connexion Woo vous permet d'importer rapidement des produits dans votre magasin.

Vérifiez qu'il n'y a pas de message d'erreur et que tout est prêt, avant de créer votre première connexion Woo.

Cliquez sur Créer une nouvelle connexion Woo et suivez les étapes de l'assistant :

Type de produits :
1. Donner un Nom à votre première connexion Woo.
2. Sélectionnez l'option Type de produit. Il s'agit des 4 types de produits proposés par WooCommerce, auxquels nous avons ajouté l'option Téléchargeable qui est en fait une configuration particulière du type Produit simple type.
3. Cliquez ensuite sur Prochaine étape→ bouton.

Importer des paramètres :
1. Choisir une valeur par défaut Statut pour les futurs produits importés. Il s'agit de l'état de publication de la fiche produit. Les valeurs de l'état sont : Publié, Prévu, Brouillon, En attente et Privé, respectivement dans Airtable : publié, futur, brouillon, en attente et privé.
  ⚠️ Si un statut est déjà défini dans votre base de données Airtable, il aura la priorité sur le statut par défaut.
  
  📌 Notes :
  - lors de la première connexion, vous ne pouvez pas sélectionner l'option Prévu statut.
  – Prévu sera mieux pris en charge dans une prochaine version du plugin.
  
  ⚠️ Pour Produits variablesle plugin ne supporte que les deux statuts "publish" et "private", qui correspondent respectivement dans WooCommerce à l'activation ou la non-activation de l'option "Enabled" dans l'onglet Variations tab. Si vous importez des produits variables avec le statut "publier", l'option "activé" sera cochée dans WooCommerce.

Sélectionner une valeur par défaut Visibilité du catalogue. C'est la visibilité du produit dans la boutique. Il peut être présent uniquement sur la page présentant les produits (Shop only) ou sur la page des résultats de recherche (Search results only), présent partout (shop et search results, categories pages), ou caché partout (Hidden). Dans Airtable, les valeurs correspondantes sont dans l'ordre : catalogue, recherche, visible et caché.
⚠️ Si une visibilité de catalogue est déjà définie dans votre base de données Airtable, elle aura la priorité sur la visibilité de catalogue par défaut.
Si vous le souhaitez, vous pouvez ajouter des filtres en cliquant sur + Ajouter un filtre ou + Ajouter un groupe de filtres . Pour plus d'informations, voir le paragraphe Ajouter des filtres aux connexions Woo ci-dessous.
Désactiver ou laisser activée l'option Activer la gestion des stockset cliquez sur Prochaine étape→ Le bouton Pour plus d'informations, voir le paragraphe Gestion des stocks ci-dessous.

Vérifier le mappage : vérifiez si le mappage est correct en cliquant sur Vérifier le mappage bouton. Une fois la vérification effectuée, cliquez sur Prochaine étape→ bouton.
📌 Vous ne pouvez pas modifier le mappage des champs de la première connexion de produit.

Détails finaux :
1. Définir le Récurrence de la synchronisation en choisissant :
  - Manuel. Vous devrez accéder à la connexion Woo chaque fois que vous souhaiterez synchroniser des produits.
  - Récurrent. Choisissez ensuite votre fréquence de synchronisation. Les produits sont automatiquement synchronisés à la fréquence sélectionnée.
2. Cliquez sur Enregistrer et synchroniser ! pour publier la connexion et synchroniser les produits ou Enregistrer comme brouillon pour enregistrer la connexion Woo en tant que brouillon.

📌 La fréquence de synchronisation la plus élevée est actuellement 30 minutes.

📌 La synchronisation instantanée via un webhook sera implémentée dans une prochaine version.

Si vous cliquez sur le bouton Enregistrer et synchroniser ! la synchronisation démarre et l'assistant affiche une barre de progression et estime le temps nécessaire à la synchronisation de vos produits.

⚠️ Si le délai est trop long, ou si un problème survient et que la synchronisation semble ne pas progresser, vous pouvez interrompre la synchronisation en cliquant sur Arrêter l'importation.

Lorsque la synchronisation est terminée, un message s'affiche avec la durée de la synchronisation et vos produits ont été importés avec succès dans WooCommerce.

Ajouter une nouvelle connexion Woo

Pour ajouter une nouvelle connexion de produit, utilisez le même assistant que la première fois.

Cet assistant est disponible en cliquant sur le bouton Air WP Sync pour WooCommerce > Woo Connections > Add New ou Air WP Sync pour WooCommerce > Connexions Woo puis cliquez sur Créer une nouvelle connexion Woo bouton.

Rappel : pour ajouter une nouvelle connexion Woo, vous devez déjà avoir copié notre modèle dans votre espace de travail Airtable comme décrit ci-dessus.

Modifier une connexion Woo

Pour modifier une connexion Woo, procédez comme suit :

Cliquez sur Air WP Sync pour WooCommerce > Woo Connections menu.
Dans la liste des Mes connexions Woosurvolez la connexion Woo que vous souhaitez modifier, puis cliquez sur Editer.
Le dernier écran de l'assistant s'affiche, et pour modifier les paramètres, vous pouvez utiliser les boutons ←Back pour accéder à l'écran souhaité.
Modifiez tous les paramètres souhaités et cliquez sur Prochaine étape→ jusqu'à ce que vous atteigniez le dernier écran de l'assistant.
Et cliquez sur Sauvegarde des modifications et synchronisation ! ou Sauvegarder les modifications bouton.

Si vous cliquez sur Sauvegarder les modifications la connexion Woo est sauvegardée (et publiée) et le message "Connexion publiée" s'affiche.

Si vous cliquez sur Sauvegarde des modifications et synchronisation !la connexion Woo est sauvegardée et publiée) et la synchronisation démarre.

Vous pouvez également dépublier la connexion Woo en cliquant sur Passer au brouillonou supprimer la connexion Woo en cliquant sur Déplacer vers la poubelle.

Ajouter des filtres aux connexions Woo

À l'étape 2 du processus de création d'une connexion, vous pouvez ajouter un ou plusieurs filtres.

Pour définir un filtre :

Cliquez sur +Ajouter un filtre bouton.
Sélectionnez un champ sur la base Airtable, puis sélectionnez un opérateur (une liste différente est proposée en fonction du type de champ sélectionné) et tapez une valeur.

Vous pouvez ajouter d'autres filtres en cliquant sur le bouton +Ajouter un filtre et vous pouvez définir l'opérateur logique (ET/OU) à utiliser pour associer ces filtres (ou conditions) en le sélectionnant .

Si vous souhaitez définir des filtres plus complexes, utilisez les groupes de filtres, qui peuvent également être combinés avec les opérateurs logiques AND et OR.

Pour définir un filtre de groupe :

Cliquez sur +Ajouter un groupe de filtres bouton.
Cliquez sur +Ajouter un filtre ou +Ajouter un groupe de filtres bouton.
Définissez chaque filtre ou groupe de filtres en sélectionnant des champs, des opérateurs et en saisissant des valeurs.
Sélectionnez l'opérateur logique ET ou OU pour associer les filtres ou les groupes de filtres.

📌 Pour supprimer un filtre ou un groupe de filtres, cliquez sur l'icône de la corbeille qui lui est associée.

Connexions régulières

Si vous avez activé la fonction Air WP Sync dans l'option paramètres du pluginvous pouvez alors utiliser Connexions régulières pour importer du contenu Airtable tel que des pages, des messages, des CPT, des utilisateurs et des termes de taxonomie. Voir la page Documentation Air WP Sync pour en savoir plus sur ses caractéristiques.

Gestion des stocks

À l'étape 2 du processus de création de la connexion, vous pouvez voir que le bouton Activer la gestion des stocks est cochée par défaut.

Lorsque l'option est activée : chaque commande modifiera le stock du produit, en ajoutant une ligne à la base de données Transactions boursières dans Airtable, et la valeur de la table Stock / Quantité dans le champ Produits sera alors mis à jour.

Lorsque l'option n'est pas activée : le Transactions boursières n'enregistre pas les variations de stock liées aux commandes, et le stock de chaque produit n'est pas géré dans Airtable, mais seulement dans WooCommerce.

Mappage

Description du mappage

Les champs sont regroupés en différents ensembles ayant un thème commun :

Principal - Champs décrivant les produits, c'est-à-dire Nom, Description, Statut, Catégories, Tags, Image du produit, etc.
Général - Champs concernant le prix et les taxes, c'est-à-dire Prix normal, Prix de vente, Statut fiscal, Classe d'impôt, etc.
Inventaire - Champs concernant le stock, c'est-à-dire SKU, Quantité en stock, Seuil de stock bas, etc.
Produits liés - Les champs Ventes incitatives et Ventes croisées.
Expédition - Champs relatifs à la taille/au poids du produit, c'est-à-dire Poids, Longueur, Largeur, Hauteur, etc.
Champs ajoutés - Les champs que vous ajoutez.

📌 Les champs de mappage diffèrent en fonction de la Type de produit sélectionné et si le Activer la gestion des stocks est activée.

Modifier un mappage

Une fois que la première synchronisation a eu lieu, et seulement à ce moment-là, vous pouvez personnaliser le mappage en ajoutant ou en supprimant des champs.

Ajouter un champ

Pour ajouter un champ à la cartographie, vous devez ouvrir la connexion Woo et utiliser la commande ←Back pour accéder à la cartographie des champs :

Cliquez ensuite sur Ajouter un champ une ligne est ajoutée dans le Champs ajoutés section.
Choisir le Champ WordPress de la liste déroulante, et pour le champ de la base Airtable, il y a deux cas possibles :
1. Il est automatiquement sélectionné par l'assistant, car il fait partie des champs préconfigurés.
2. Ou vous devez le sélectionner vous-même dans la liste déroulante.

Supprimer un champ

Pour supprimer un champ, ouvrez la connexion Woo et utilisez la commande ←Back pour accéder à la cartographie des champs puis cliquez sur le lien Poubelle à la fin de la ligne de droite : la ligne est supprimée sans message de confirmation.

⚠️ Les champs obligatoires sont les suivants Nom du produit, Prix normal, SKUetc. ne peuvent pas être supprimés.

Lorsque vous avez ajouté ou supprimé un champ dans le mappage, vous devez enregistrer les modifications en cliquant sur Prochaine étape→ puis cliquez sur Sauvegarder les modifications bouton. Vous pouvez également cliquer sur Sauvegarde des modifications et synchronisation ! pour enregistrer les modifications et synchroniser vos données dès maintenant.

Gérez vos connexions Woo

Pour gérer vos connexions Woo, cliquez sur Air WP Sync pour WooCommerce > Connexions Woo Dans le menu, faites défiler vers le bas pour accéder à la liste Mes connexions Woo.

Dans cette liste, vous pouvez voir pour chaque connexion Woo : le Titre (nom) de la connexion, le type de produit, la date de la dernière synchronisation, le déclencheur sélectionné et les actions que vous pouvez effectuer.

Les connexions Woo peuvent avoir différents statuts, tels que Publié ou Projetou peuvent être placés dans le Poubelle.

Dans le cadre de la Mes connexions Woo vous pouvez effectuer les actions suivantes :

Synchroniser les produits d'une connexion Woo en cliquant sur le bouton correspondant. Synchroniser maintenant bouton.
Téléchargez les derniers journaux de synchronisation d'une connexion Woo en cliquant sur le bouton correspondant. Télécharger les journaux bouton.
Utilisez des filtres prédéfinis pour trier les connexions, par exemple Tous, Publié, Projet, Les déchets.
Recherchez une connexion de produit en tapant des mots-clés dans le champ de recherche et cliquez sur Recherche Woo Connections bouton. Si une ou plusieurs connexions Woo correspondent aux mots-clés, elles seront affichées dans la liste.
Cliquez sur les flèches à droite de l'icône Titre pour trier les connexions Woo par ordre alphabétique de A à Z ou de Z à A.
Modifier une connexion Woo en cliquant sur Editer qui apparaît lorsque vous survolez le nom de la connexion. Dans ce cas, vous revenez dans l'assistant et vous pouvez modifier la connexion du produit en utilisant ← Retour pour modifier les paramètres de la connexion du produit. N'oubliez pas de sauvegarder les modifications à la fin de l'assistant.
Déplacez une connexion Woo vers la corbeille en cliquant sur Poubelle qui apparaît lorsque vous survolez le nom de la connexion.
Sélectionnez toutes les connexions Woo en cliquant sur la case à cocher à gauche de Titre dans l'en-tête de la table pour appliquer l'une des Actions en bloc.
Sélectionnez une ou plusieurs connexions en cliquant sur les cases à cocher correspondantes en face de leur Titre et effectuer une Action en bloc.
Si le filtre actif est Tous, Publié ou ProjetVous pouvez sélectionner plusieurs connexions Woo et effectuer les opérations suivantes Actions en bloc tels que Editer ou Déplacer vers la poubelleen sélectionnant l'action souhaitée dans le menu déroulant et en cliquant sur le bouton Appliquer bouton. Si vous choisissez Editer vous ne pouvez modifier que l'état des connexions Woo sélectionnées.
Si vous avez déjà sélectionné l'option Poubelle les actions en bloc disponibles sont les suivantes : Restaurer et Supprimer définitivement.

Base de données Airtable

Accès à la base de données Airtable

Pour accéder rapidement à la base de données Airtable :

Aller à Votre base Airtable synchronisée section dans l'écran Connexions Woo, en cliquant sur Airtable WP Sync pour WooCommerce > Woo Connections menu.
Cliquez sur Vérifier sur Airtable lien.
Connectez-vous à Airtable si nécessaire.
La base de données utilisée dans Air WP Sync for WooCommerce s'affiche automatiquement.

Déconnecter la base de données Airtable

Si vous souhaitez changer la base de données connectée au plugin Air WP Sync pour WooCommerce :

Aller à la page Votre base Airtable synchronisée section dans l'écran Connexions Woo, en cliquant sur Airtable WP Sync pour WooCommerce > Woo Connections menu.
Cliquez sur l'icône Déconnecter la base lien.
Dans la fenêtre pop-up, cliquez sur Oui, je veux déconnecter ma base pour rompre le lien avec votre base de données.
⚠️ Toutes les connexions à cette base de données sont supprimées, comme l'indique le message contextuel. Les produits importés sont conservés.
Ou cliquez sur Non, gardez-le pour annuler la déconnexion.

Réglages de l’extension

Vous pouvez accéder aux paramètres du plugin par l'intermédiaire de l'option Air WP Sync pour WooCommerce > Paramètres menu.

Dans cette section, vous pouvez activer le Air WP Sync gérer votre licence et votre jeton Airtable, et vider le cache.

Activation de Air WP Sync

Par défaut, le Air WP Sync est désactivée. Mais si vous souhaitez continuer à utiliser les fonctionnalités de Air WP Sync Pro/Pro+ pour synchroniser les pages, les posts, les CPT, les utilisateurs et les termes de taxonomie, activez cette option puis cliquez sur Sauvegarder→ bouton. Air WP Sync Pro+ est alors activée. Voir le documentation du plugin.

Si vous utilisez déjà Air WP Sync ProVous bénéficierez des avantages suivants Air WP Sync Pro+ sans frais supplémentaires.

Quelle que soit la version de Air WP Sync que vous utilisez, vos connexions actuelles ont été préservées, vous pouvez y accéder par Air WP Sync pour WooCommerce > Connexions régulières.

Licence

Dans le cadre de la Licence vous pouvez voir la section Clé de licence que vous avez saisi lors de l'assistant de configuration.

Vous pouvez modifier cette Clé de licence en saisissant une nouvelle licence et en cliquant sur Sauvegarder→ bouton.

Airtable

Dans le cadre de la Airtable vous pouvez voir une partie de votre jeton Airtable ajouté pendant l'assistant de configuration.

Si vous modifiez ce jeton dans votre compte Airtable, vous devez coller le nouveau jeton dans ce champ et cliquer sur Sauvegarder→ bouton. Vos connexions seront automatiquement mises à jour.

Cache

Cette fonction peut être utilisée lorsque vous avez modifié la structure de votre table Airtable et que vous ne voyez pas ces changements dans le tableau Air WP Sync for WooCommerce.

Dans ce cas, cliquez sur Effacer le cache→ pour forcer le plugin à recharger les données Airtable.

Assistance et documentation

Obtenir de l'aide

Pour obtenir de l'aide, cliquez sur le lien suivant Air WP Sync pour WooCommerce > Support menu. Vous êtes redirigé vers un nouvel onglet avec notre centre de support WP connect où vous pouvez poster un ticket décrivant votre problème ou votre demande, après vous être connecté.

Lire la documentation

Vous pouvez accéder à cette documentation en cliquant sur le bouton Air WP Sync pour WooCommerce > Documentation menu. Un nouvel onglet contenant la documentation du plugin sera ouvert dans votre navigateur.

Limites

Ces plugins tiers ne sont pas pris en charge :

WooCommerce Bookings
Expédition WooCommerce
Abonnements WooCommerce
Compléments de produits WooCommerce
Taxe WooCommerce
WooCommerce Box Office
Adhésion à WooCommerce
Recommandations sur les produits
Produits composites
Produits de l'offre groupée
Options de produits personnalisées supplémentaires pour WooCommerce

Dépannage

Vous avez modifié la structure du template Airtable, mais rien n'a changé dans l'interface du plugin : ce comportement est normal car pour des raisons de performance, la structure de votre base Airtable est mise en cache pendant 15 minutes. Voir ci-dessus comment purger le cache.

Si nécessaire, vous pouvez accéder aux journaux via une connexion FTP dans ce dossier :

/wp-content/uploads/airwpsync-logs

Et vous pouvez accéder aux journaux de la dernière synchronisation à partir de l'onglet Connexions Woo écran : cliquer sur Air WP Sync pour WooCommerce > Woo Connections puis cliquez sur le menu Télécharger les journaux pour la connexion qui vous intéresse.