Guide de l'utilisateur

Avec notre plugin 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 plugin Air WP Sync for WooCommerce suivez les étapes suivantes :

1. Téléchargez l'archive zip du plugin sur votre ordinateur
2. Connectez-vous à votre tableau de bord WordPress
3. Dans le tableau de bord de WordPress, allez dans Extensions > Ajouter une extension
4. Cliquez sur le bouton Téléverser une extension en haut de la page
5. Cliquez sur le bouton Choisir un fichier et sélectionnez le fichier du plugin que vous avez téléchargé à l'étape 1
6. Cliquez sur le bouton Installer maintenant
7. Attendez que le plugin soit installé, puis cliquez sur le bouton Activer l'extension

attention

Veuillez noter que le plugin WooCommerce doit être installé et activé pour permettre l'utilisation du plugin Air WP Sync for WooCommerce.

Configurer votre plugin

Avant d'utiliser votre plugin 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, préparez votre clé de licence du plugin et votre jeton Airtable :

• Clé de licence — disponible dans votre email de confirmation d'achat, ainsi que sur wpconnect.co > Mon compte > Mes produits téléchargeables > Clés de licence > Voir les licences
• Jeton Airtable — créez-en un dans votre compte Airtable :
  1. Cliquez sur Espace constructeur 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 jeton
  4. Donnez à votre jeton un nom et configurez les Champs d'application et Accès comme indiqué par l'assistant

attention

Pour que le plugin fonctionne correctement, vous devez définir :

• Champs d'application : data.records:read, data.records:write, schema.bases:read, schema.bases:write
• Accès : toutes les bases actuelles et futures dans tous les espaces de travail actuels et futurs

astuce

Si vous avez besoin d'aide pour créer le jeton, regardez cette vidéo.

Pour démarrer l'assistant, cliquez sur le menu Air WP Sync for WooCommerce dans le tableau de bord de WordPress et suivez ces étapes :

1. Cliquez sur Set up your plugin
2. Activez ou non l'option Air WP Sync (voir Activation d'Air WP Sync)
3. Collez votre clé de licence et cliquez sur Next step →
4. Collez votre jeton Airtable dans le champ Access token
5. Cliquez sur Next step → — votre plugin est configuré !
6. Cliquez optionnellement sur Connect to Airtable base → pour configurer votre première connexion

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

Connectez le plugin au modèle de base Airtable pour faciliter la synchronisation des produits. Le modèle sera copié dans votre espace de travail.

attention

Ne renommez pas ou ne modifiez pas le modèle avant la copie et votre première connexion réussie. Vérifiez la version du modèle.

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

1. Dans WordPress, cliquez sur Copy our Airtable template base — le modèle s'ouvre dans un nouvel onglet Airtable
2. Dans Airtable, cliquez sur Copier la base (en haut à droite de la page)
3. Sélectionnez votre espace de travail et cliquez sur Ajouter une base
4. Retournez à l'interface Air WP Sync for WooCommerce — le modèle est maintenant connecté

Woo Connections

Créer une première Woo connexion

Cliquez sur Create a new Woo connection et suivez l'assistant :

Étape 1 — Type de produits :

• Donnez un Nom à votre connexion
• Sélectionnez le Type of product (Simple, Variable, Groupé, Externe, ou Téléchargeable)
• Cliquez sur Next step →

Étape 2 — Réglages d'importation :

• Choisissez un Status par défaut (Publié, Planifié, Brouillon, En attente, Privé)
• Sélectionnez une Catalog visibility par défaut (Boutique uniquement, Résultats de recherche uniquement, Boutique et recherche, Caché)
• Ajoutez optionnellement des filtres via + Add Filter ou + Add Filter Group
• Activez ou désactivez Activate inventory management
• Cliquez sur Next step →

attention

Pour les produits variables, seuls les statuts « publish » et « private » sont pris en charge, correspondant respectivement à l'activation ou non de l'option « Enabled » dans l'onglet Variations.

astuce

• Le statut Planifié bénéficiera d'une meilleure prise en charge dans une future version
• La fréquence de synchronisation la plus élevée est actuellement de 30 minutes
• La synchronisation instantanée via webhook sera implémentée dans une future version

Étape 3 — Vérifier le mappage : Cliquez sur Verify the mapping pour vérifier l'exactitude, puis cliquez sur Next step →.

astuce

Vous ne pouvez pas modifier le mappage des champs lors de la première connexion.

Étape 4 — Détails finaux :

• Choisissez la récurrence de synchronisation Manuel ou Récurrent
• Cliquez sur Save and Synchronize! ou Save as draft

Ajouter une nouvelle Woo connexion

Utilisez Air WP Sync for WooCommerce > Woo Connections > Add New ou cliquez sur Create a new Woo Connection depuis l'écran des connexions.

Modifier une Woo connexion

1. Allez dans Air WP Sync for WooCommerce > Woo Connections
2. Survolez une connexion et cliquez sur Edit
3. Utilisez les liens ← Back pour atteindre l'écran souhaité, modifiez les paramètres et cliquez jusqu'à la fin
4. Cliquez sur Save modifications and Sync! ou Save modifications

Ajouter des filtres aux Woo connexions

À l'étape 2, cliquez sur + Add Filter pour définir un filtre : sélectionnez un champ Airtable, un opérateur et une valeur. Combinez plusieurs filtres avec la logique ET/OU. Utilisez + Add Filter Group pour des structures de filtres complexes.

Regular Connections

Si vous avez activé l'option Air WP Sync dans les réglages, vous pouvez utiliser les Regular Connections pour importer des pages, articles, CPT, utilisateurs et termes de taxonomie. Consultez la documentation Air WP Sync.

Gestion des stocks

Lorsque l'option Activate inventory management est activée : chaque commande modifie le stock du produit dans Airtable, en ajoutant une ligne au tableau Stock transactions, et la valeur du champ Stock / Quantity dans le tableau Products est alors mise à jour.

Lorsque l'option n'est pas activée : le stock n'est géré que dans WooCommerce, pas dans Airtable.

Mappage

Les champs sont regroupés en différents ensembles :

• Main — Nom, Description, Statut, Catégories, Tags, Image du produit, etc.
• General — Prix normal, Prix de vente, Statut fiscal, Classe d'impôt, etc.
• Inventory — SKU, Quantité en stock, Seuil de stock bas, etc.
• Linked Products — Ventes incitatives, Ventes croisées
• Shipping — Poids, Longueur, Largeur, Hauteur, etc.
• Added fields — les champs que vous ajoutez manuellement

astuce

Les champs de mappage diffèrent selon le Type de produit sélectionné et selon que l'option Activate inventory management est activée ou non.

Modifier le mappage

Après la première synchronisation, vous pouvez ajouter ou supprimer des champs en ouvrant la Woo connexion et en naviguant jusqu'à l'étape de mappage.

attention

Les champs obligatoires tels que Product Name, Regular Price, SKU ne peuvent pas être supprimés.

Gérez vos Woo connexions

Allez dans Air WP Sync for WooCommerce > Woo Connections pour voir toutes les connexions avec leur type, date de dernière synchronisation, déclencheur et actions disponibles. Vous pouvez synchroniser, télécharger les logs, filtrer, rechercher, trier, modifier ou supprimer des connexions.

Base de données Airtable

Accès — Allez dans Woo Connections, faites défiler jusqu'à Your synchronized Airtable base et cliquez sur Check on Airtable.

Déconnexion — Cliquez sur Disconnect the base et confirmez. Toutes les connexions à cette base sont supprimées, mais les produits importés sont conservés.

Réglages du plugin

Allez dans Air WP Sync for WooCommerce > Settings pour gérer la licence, le jeton Airtable, l'activation d'Air WP Sync et le cache.

Activation de Air WP Sync

Par défaut, Air WP Sync est désactivé. Activez-le pour utiliser les fonctionnalités Air WP Sync Pro/Pro+ (pages, articles, CPT, utilisateurs, termes de taxonomie). Si vous utilisez déjà Air WP Sync Pro, vous bénéficierez de Pro+ sans frais supplémentaires.

Licence

Consultez ou mettez à jour votre clé de licence dans la section Licence.

Airtable

Si vous modifiez votre jeton Airtable, collez le nouveau jeton ici et cliquez sur Save →. Vos connexions seront automatiquement mises à jour.

Cache

Cliquez sur Clear Cache → si vous avez modifié la structure de votre table Airtable et que vous ne voyez pas les changements dans le plugin.

Limites

Ces plugins tiers ne sont pas pris en charge : WooCommerce Bookings, WooCommerce Shipping, WooCommerce Subscriptions, WooCommerce Product Add-Ons, WooCommerce Tax, WooCommerce Box Office, WooCommerce Memberships, Product Recommendations, Composite Products, Bundle Products, Extra Custom Product Options for WooCommerce.

Dépannage

Si vous avez modifié la structure du modèle Airtable mais que rien n'a changé : ce comportement est normal car, pour des raisons de performance, la structure de votre base Airtable est mise en cache pendant 15 minutes. Utilisez Clear Cache → dans les Réglages pour forcer le rechargement.

Les logs sont accessibles via FTP dans le dossier : /wp-content/uploads/airwpsync-logs

Vous pouvez également télécharger les logs de la dernière synchronisation directement depuis l'écran Woo Connections en cliquant sur Download logs.