Documentation Air WP Sync

Pour installer notre plugin Air WP Sync dans WordPress, suivez les étapes ci-dessous :

• Téléchargez le fichier du plugin sur votre ordinateur.
• Connectez-vous à votre tableau de bord WordPress.
• Dans le menu de gauche, cliquez sur Extensions puis sur Ajouter une extension.
• Cliquez sur le bouton Téléverser une extension en haut de la page.
• Cliquez sur le bouton Choisir un fichier et sélectionnez le fichier du plugin que vous avez téléchargé à l'étape 1.
• Cliquez sur le bouton Installer maintenant.
• Attendez que le plugin soit installé, puis cliquez sur le bouton Activer l’extension.

Après avoir installé et activé le plugin dans WordPress, il apparaîtra dans le menu d'administration et donnera accès aux paramètres de connexion et de configuration.

Avant de créer une connexion, vous êtes invité à saisir votre clé de licence pour valider l'installation du plugin. Pour activer cette clé de licence, allez dans Air WP Sync > Réglages.

La clé de licence est disponible dans votre email confirmation d'achat, ainsi que sur wpconnect.co > Mon compte > Mes produits téléchargeables > Clés de licence, Voir 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 et copiez-collez-le dans le champ Clé de licence Air WP Sync.

Une fois la clé de licence copiée dans les réglages de Air WP Sync, assurez-vous de cliquer sur le bouton Activer. Si votre clé de licence est valide, une coche verte apparaîtra et il vous suffira de sauvegarder les réglages en cliquant sur le bouton Mettre à jour les réglages.

Vous pouvez alors commencer à créer vos connexions.

Pour créer une nouvelle connexion à votre compte Airtable, allez à Air WP Sync > Toutes les connexions, cliquez sur le bouton Ajouter une nouvelle connexion et entrez un nom pour votre connexion.

⚠️ Air WP Sync utilise maintenant des jetons d'accès personnels
Les jetons d'accès personnels dans Airtable sont maintenant en version bêta. Il s'agit d'une nouvelle façon plus sécurisée d'accorder un accès API à vos données Airtable. Créez plusieurs jetons, accordez-leur l'accès à des bases spécifiques et gérez-les individuellement.

Un jeton d'accès vous sera demandé pour connecter votre compte. Nous vous recommandons de récupérer ce jeton en utilisant ce lien. Une fois que vous êtes sur la page d'aperçu de votre compte Airtable, cliquez sur le bouton Accéder à l’espace développeurs. Allez à la section Jeton d'accès personnel et cliquez sur le bouton Créer un jeton. Choisissez un nom pour votre token et sélectionnez ensuite Ajouter une portée pour déterminer le périmètre de votre token. Afin d'utiliser notre plugin, votre token doit être capable de : 

• data.records:read (afficher les données des entrées)
• schema.bases:read (afficher la structure d'une base, comme les noms de tables ou les types de champs)

Enfin, dans la partie Accès, ajoutez les espaces de travail et les bases pour lesquels vous souhaitez accorder l'accès à votre token. Et cliquez sur le bouton Créer un jeton.

Une fois qu'il a été généré, vous pouvez le copier et le coller dans le champ du jeton d'accès.

Une fois que votre jeton d'accès personnel a été saisi dans le champ, choisissez la base de données à partir de laquelle vous souhaitez importer du contenu, ainsi que la table et/ou les vues. Vous avez également la possibilité d'ajouter des filtres de formule à vos vues, qui fonctionnent de la même manière que dans Airtable.

⚠️ ATTENTION pour les utilisateurs d'Air WP Sync Free : La clé API Airtable est maintenant obsolète, vous ne pouvez plus l'utiliser. Veuillez la remplacer par un jeton d'accès personnel. Pour générer et configurer ces jetons, suivez l'URL suivante.

• Article : un article est un contenu qui peut être publié sur un blog ou un site web. Ils sont généralement utilisés pour partager des nouvelles ou des informations et sont habituellement organisés chronologiquement sur un blog ou un site. Ils sont créés et gérés dans la section Articles du tableau de bord de WordPress .

• Page : une page est un contenu statique qui fait généralement partie du menu de navigation d'un site web. Elles sont utilisées pour afficher des informations. Elles sont créées et gérées dans la section Pages du tableau de bord de WordPress.

Dans le cas où vous utilisez un thème et/ou un développement spécifique, plusieurs autres types de publications peuvent être disponibles. Il s'agit de types de publication personnalisés qui ont déjà été définis par vos thèmes ou plugins installés ou par les développeurs de votre site WordPress.

Notre plugin Air WP Sync offre la possibilité de créer vos propres Types de publication personnalisés (CPT) à la volée, spécifiquement pour votre contenu importé.

⚠️ Bien que WooCommerce Product CPT apparaisse sur la liste, il n'est disponible que pour la configuration de base du mappage. L'intégration complète de WooCommerce for Airtable sera bientôt disponible.

Pour le type de publication personnalisé (CPT) que vous allez créer à partir du plugin Air WP Sync, vous trouverez la possibilité de mapper les champs WordPress suivants : Titre, Contenu, Slug, Champ personnalisé.

Il vous permet également de créer vos propres champs personnalisés.

⚠️ ATTENTION, si vous décidez de modifier la configuration et de ne plus utiliser le type de publication personnalisé (CPT) créé spécifiquement grâce au plugin Air WP Sync, ce CPT créé à la volée n'existera plus dans WordPress et le contenu importé ne sera plus disponible non plus.

Comme dans WordPress, le contenu importé d'Airtable peut avoir différents statuts : Publié, Brouillon, Planifié, En attente, Privé.

Chacun de ces statuts vérifie les conditions suivantes :

• Le contenu PUBLIÉ est visible publiquement sur votre site web.
• Le contenu BROUILLON est enregistré comme un travail en cours et n'est pas visible par le public.
• Le contenu PLANIFIÉ est destiné à être publié à une date et une heure précises dans le futur.
• Le contenu EN ATTENTE est en attente de révision ou d'approbation avant d'être publié.
• Le contenu PRIVÉ n'est visible que par les utilisateurs connectés disposant des autorisations appropriées.

En fonction du statut choisi, le contenu synchronisé recevra le statut défini dans les paramètres.

Si vous décidez de modifier le statut dans la configuration ultérieurement, notez que le changement de statut du contenu déjà importé dépendra de la stratégie d'importation que vous avez définie (voir les différentes stratégies d'importation de contenu).

Vous pouvez désormais relier les champs de votre base de données à ceux de WordPress.

Pour ce faire, cliquez sur le bouton Ajouter un champ. Deux listes déroulantes sont alors disponibles, l'une contient les champs de votre base de données Airtable, la seconde les champs WordPress avec lesquels vous pouvez les mettre en correspondance.

Article

Pour les articles, vous trouverez la possibilité de mapper les champs WordPress suivants : Titre, Image mise en avant, Contenu, Extrait, Slug, Etiquette, Catégorie ou Champ personnalisé.

Page

Pour les pages, vous trouverez la possibilité de mapper les champs WordPress suivants : Titre, Image mise en avant, Contenu, Slug, ou Champ personnalisé.

Type de publication personnalisé (CPT) existant

Pour les Custom Post Types existants, c'est-à-dire créés par des plugins ou le thème WordPress présents sur votre site, vous trouverez la possibilité de mapper les champs WordPress suivants et tous les champs liés à votre CPT : Titre, Contenu, Slug, Taxonomies ou Champ personnalisé.

Les taxonomies sont utilisées pour regrouper des contenus similaires dans plusieurs CPT. Elles peuvent être utilisées pour créer des filtres ou des recherches pour votre contenu.

Exemple de champs disponibles pour un CPT propriété : Titre, Contenu, Slug, Type de propriété (taxonomie), Ville (taxonomie), Champ personnalisé, etc.

Champs personnalisés

Vous pouvez également envisager d'ajouter des champs spécifiques à votre contenu importé dans WordPress en faisant correspondre votre champ Airtable à un champ personnalisé que vous pouvez nommer et que vous retrouverez dans le contenu importé une fois la synchronisation terminée.

⚠️ ATTENTION, si vous modifiez la configuration et supprimez un champ personnalisé créé par le plugin Air WP Sync, vous ne le retrouverez pas dans le contenu importé.

Besoin d'en savoir plus pour comprendre le fonctionnement de notre plugin Air WP Sync ? Nous vous invitons à regarder notre tutoriel vidéo ou notre tutoriel pas à pas (version gratuite) !