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 "Plugins" puis sur "Ajouter un nouveau"
• Cliquez sur le bouton "Upload Plugin" en haut de la page.
• Cliquez sur le bouton "Choose File" 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".

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, rendez-vous sur Air WP Sync > Paramètres.

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 et copiez-collez-le dans le champ Clé de licence Air WP Sync.

Une fois la clé de licence copiée dans les paramètres d'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 paramètres en cliquant sur le bouton "Mettre à jour les paramètres".

Vous pouvez alors commencer à créer vos connexions.

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

⚠️ Air WP Sync utilise désormais 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 à l'aide de la fonction ce lien. Une fois que vous êtes sur la page d'aperçu de votre compte Airtable, cliquez sur le bouton " Go to developer hub ". Passez à la page Jeton d'accès personnel et cliquez sur le bouton " créer un nouveau token ". Choisissez un nom pour votre token et sélectionnez ensuite Scopes pour déterminer le périmètre de votre token. Afin d'utiliser notre plugin, votre token doit être capable de : 

• données.enregistrements:lire (Voir les données dans les dossiers)
• schema.bases:read (Voir 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 " Enregistrer les modifications ".

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 une Jeton d'accès personnel. Pour générer et configurer ces jetons, procédez comme suit URL.

• 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 web. 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 d'articles peuvent être disponibles. Il s'agit de types d'articles 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 Custom Post Types à la volée, spécifiquement pour votre contenu importé.

⚠️ Bien que WooCommerce Product CPT apparaisse dans la liste, il n'est disponible que pour les produits suivants configuration de base de la cartographie. Intégration complète de WooCommerce pour Airtable sera bientôt disponible.

Pour le Custom Post Type 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.

⚠️ ATTENTIONSi vous décidez de modifier la configuration et de ne plus utiliser le Custom Post Type créé spécifiquement par le 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, Programmé, En attente, Privé.

Chacun de ces états vérifie les conditions suivantes :

• PUBLIÉ le contenu est visible publiquement sur votre site web
• PROJET le contenu est sauvegardé en tant que travail en cours et n'est pas visible par le public
• PROGRAMMÉ le contenu doit être publié à une date et une heure précises dans le futur
• EN ATTENTE le contenu est en attente de révision ou d'approbation avant d'être publié
• PRIVÉ le contenu 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, Featured Image, Content, Excerpt, Slug, Tag, Category ou Custom Field.

Page

Pour les pages, vous trouverez la possibilité de mapper les champs WordPress suivants : Title, Featured Image, Content, Slug, ou Custom Field.

Type de publication personnalisé existant

Pour les Custom Post Types existants, c'est-à-dire créés par des plugins ou des thèmes 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 de 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é de 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.

⚠️ ATTENTIONSi 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 comment fonctionne notre plugin Air WP Sync ? Nous vous invitons à regarder notre tutoriel vidéo ou notre Tutoriel étape par étape (version gratuite) !

Les déclencheurs vous permettent de contrôler quand les données sont importées d'Airtable vers WordPress. Il existe trois options de déclenchement possibles : manuel, récurrent et instantané.

• MANUEL: Il vous permet d'importer manuellement les données en cliquant sur le bouton "Synchroniser maintenant". Cette option est utile si vous devez importer des données occasionnellement ou si vous souhaitez mieux contrôler le moment de l'importation.
  
• RECURRENT: Il vous permet de programmer l'importation de données à intervalles réguliers. Vous pouvez choisir la fréquence de l'importation, par exemple toutes les 5 minutes, toutes les heures, tous les jours ou toutes les semaines. Ceci est utile si vous souhaitez mettre à jour régulièrement votre site WordPress avec les dernières données saisies dans Airtable.
  Pour de meilleures performances, vous pouvez mettre en place un job cron en utilisant WP-Cron : voir notre tutoriel ici.
  
• INSTANT: Il vous permet d'importer des données dès qu'elles sont ajoutées ou mises à jour dans Airtable (en fonction de la stratégie d'importation sélectionnée). C'est utile si vous voulez que votre site WordPress soit synchronisé en temps réel avec Airtable, mais cela peut aussi être gourmand en ressources si vous avez une grande quantité de données fréquemment mises à jour. Pour ce faire, vous devrez créer une automatisation. Suivez ce lien pour voir notre tutoriel complet sur la façon de créer un automatisme. créer une automatisation dans Airtable.