Documentation Notion WP Sync
⚠️ NOTE IMPORTANTE
Notion WP Sync propose une synchronisation à sens unique - de Notion to WordPress UNIQUEMENT !
Les changements effectués dans WordPress ne seront pas synchronisés avec Notion, donc assurez-vous de gérer vos données depuis Notion pour que tout soit mis à jour correctement.
Installation et réglages
Pour installer notre plugin Notion 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 et 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 Notion WP Sync > Réglages.
Cette clé de licence est 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.
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-la dans le champ Clé de licence de Notion WP Sync .
Une fois la clé de licence copiée dans le plugin Notion 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 réglages.
Vous pouvez alors commencer à créer vos connexions.

Créer une connexion
Pour créer une nouvelle connexion à votre compte Notion, allez dans Notion WP Sync > Toutes mes connexions, cliquez sur le bouton Ajouter une nouvelle connexion et entrez un nom pour votre connexion.
Un jeton d'intégration interne vous sera demandé pour connecter votre compte. Nous vous recommandons de récupérer ce jeton en utilisant ce lien ou de visionner cette vidéo.
Pour une meilleure compréhension, veuillez suivre les étapes suivantes :
- Dans votre compte Notion, allez sur la page des intégrations : Compte Notion > Connexions > Développer ou gérer des intégrations.
- Cliquez sur le bouton Nouvelle intégration et saisissez un nom pour votre intégration. Sélectionnez ensuite l'espace de travail dans lequel vous souhaitez utiliser l'intégration dans le champ Espace de travail associé. Sélectionnez "Interne" pour le Type. Cliquez ensuite sur le bouton Enregistrer .
- Une fois l'intégration créée avec succès, cliquez sur le bouton Configurer les paramètres d'intégration: un secret d'intégration interne est déjà créé.
- Sélectionnez les capacités Contenu "Lire le contenu" et les capacités Utilisateur "Lire les informations de l'utilisateur, y compris les adresses email ", puis cliquez sur le bouton Enregistrer.
- Vous pouvez maintenant cliquer sur Afficher puis sur Copier le secret d'intégration interne. Vous pouvez le coller dans le champ Internal integration token (jeton d'intégration interne ) de votre Notion WP Sync de Notion WP Sync.
⚠️ Une fois que votre jeton d'intégration interne a été saisi dans le champ, vous devez partager vos pages ou bases de données Notion avec vos intégrations pour les voir dans les différents champs de sélection de votre plugin.
Pour ce faire, veuillez sélectionner le bouton plus d'options en haut à droite de votre page ou base de données Notion, survolez l'option Ajouter une connexion et sélectionnez la connexion que vous venez de créer. Vous pouvez également consulter la page de Documentation Notion pour comprendre comment créer un jeton d'intégration interne.
Réglages d'importation
Contenu Notion
Vous pouvez importer vos pages et bases de données de Notion vers WordPress.
- Pages Notion : il s'agit essentiellement de documents numériques pouvant contenir un large éventail d'informations, allant du texte et des images aux fichiers intégrés, aux bases de données, etc.
- Bases de données Notion : l'une des fonctionnalités les plus puissantes de la plateforme Notion, les bases de données de Notion sont essentiellement des tableaux avec des colonnes personnalisables, où les utilisateurs peuvent saisir et manipuler des données de diverses manières.
Destination
Vous pouvez importer votre contenu de plusieurs manières : Article/Page (Post type) ou Code court (shortcode).
Type de publication
Vous pouvez importer votre contenu de différentes manières : Article, Page ou Type de publication personnalisé (CPT).
Voici comment fonctionnent ces trois éléments :
- 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 présenter des informations. 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 .
- Type de publication personnalisé (CPT) : un type de publication personnalisé est un type de contenu qui peut être créé par des plugins ou des thèmes WordPress. Les CPT vous permettent d'ajouter des types de contenu spécifiques à votre site, tels que des événements, des produits, des portfolios, etc. Ils sont généralement utilisés pour étendre les capacités de WordPress et pour ajouter un contenu structuré à votre site. Ils sont similaires aux articles et aux pages en ce sens qu'ils peuvent être publiés sur votre site et consultés par les utilisateurs, mais ils ont leurs propres libellés et caractéristiques qui les distinguent. Il existe plusieurs types de CPT : les CPT créés par des plugins ou des thèmes que vous avez installés sur votre site WordPress, ceux que vous avez créés via un plugin tel que Custom Post Type UI ou ToolSet ou ceux qui ont été créés manuellement par un développement personnalisé.
Créer un type de publication personnalisé (CPT)
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 Notion WP Sync offre la possibilité de créer vos Type de publication personnalisé (CPT) à la volée spécifiquement pour votre contenu importé.
Pour le type de publication personnalisé (CPT) que vous allez créer à partir de la base de données de lavia le plugin Notion WP Sync vous trouverez la possibilité de mapper les champs WordPress suivants : "Title", "Content", "Slug", "Custom Field".
Il vous permet également de créer vos propres champs personnalisés.

⚠️ ATTENTION, si vous décidez de changer de configuration et de ne plus utiliser le type de publication personnalisé (CPT) créé spécifiquement par le biais du plugin Notion WP Sync, ce CPT créé à la volée n'existera plus dans WordPress et le contenu importé ne sera plus disponible.
Code court
Vous pouvez importer le contenu de votre Notion dans un code court (shortcode).

En créant le contenu de votre code court, vous créez un type de publication personnalisé (CPT) : "Notion Content". Ce CPT Notion Content peut être utilisé par les développeurs.
Il peut également être affiché grâce à notre bloc dédié Notion Content dans l'éditeur Gutenberg.

Le code court généré peut être utilisé dans le bloc de code court de Gutenberg ou dans différentes pages de constructeurs comme Divi, Elementor, WP Bakery, etc.
Statut de la publication
Comme dans WordPress, le contenu importé de Notion peut avoir différents statuts : Publié, Brouillon, Planifié, En attente, Privé.
Chacun de ces statuts vérifie les conditions suivantes :
- PUBLIÉ : le contenu est visible publiquement sur votre site web.
- BROUILLON : le contenu est sauvegardé en tant que 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 d'examen 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).
📌 Si vous souhaitez utiliser une propriété de votre base de données Notion pour définir le statut des articles, vous devrez utiliser les valeurs définies dans WordPress pour cette propriété. L'article Comment configurer le statut de la publication dans Notion WP Sync ? explique cela en détail.
Auteur de la publication
Dans le processus d'importation de votre contenu, vous devez choisir un auteur qui sera assigné à chaque contenu importé. Le choix de cet auteur doit se faire uniquement parmi les utilisateurs enregistrés du site, c'est-à-dire les utilisateurs qui ont accès à la partie administrative du site, quel que soit leur rôle.
Vous pouvez désormais utiliser l'attribut auteur de Notion pour attribuer des auteurs aux articles, pages ou types de publication personnalisés (CPT) dans votre mappage. Cela fonctionne pour les utilisateurs existants à la fois dans Notion et dans WordPress. Il suffit de faire correspondre le champ Auteur (email) dans la colonne Champs de Notion au champ Auteur dans la colonne Importer en tant que de WordPress.
⚠️Les utilisateurs doivent déjà exister dans WordPress avec la même adresse email que leur compte Notion.
Cette fonction ne crée pas de nouveaux utilisateurs WordPress lors de la synchronisation du contenu.
Si aucun utilisateur correspondant n'est trouvé, l'article sera attribué à l'utilisateur défini dans le champ Auteur par défaut de l'article dans la section Importer en tant que.

Couleur du texte par défaut dans Notion
Dans Notion, dix couleurs sont disponibles pour le texte, dont celle par défaut, appelée "Texte par défaut" : définie comme étant blanche en mode sombre et noire en mode clair.
Vous pouvez définir une couleur personnalisée pour le texte en utilisant le format Texte par défaut dans Notion lors de l'importation de contenu dans WordPress.
Dans la section Importer en tant que, un sélecteur de couleur devient disponible lorsque vous mappez le champ de notion "Contenu de la page" - que vous l'importiez en tant que "Article", "Utilisateur" ou "Terme de taxonomie".
Pour définir une couleur : cliquez sur le bouton Sélectionner une couleur et choisissez une couleur dans la palette, entrez un code hexadécimal ou choisissez l'une des 8 couleurs prédéfinies sous la palette. Dans WordPress, le contenu importé utilisera la couleur sélectionnée.
Pour supprimer une couleur sélectionnée : cliquez sur le bouton Effacer.
⚠️ La couleur que vous définissez ici ne s'appliquera qu' aux textes formatés comme "Texte par défaut" dans Notion, et ne s'appliquera pas aux textes formatés avec une autre couleur, comme "texte violet" ou "texte rouge". Ceux-ci conserveront la même couleur (violet ou rouge) dans WordPress.
Réglages de mappage
Vous pouvez désormais lier les champs de vos pages et de vos bases de données avec les champs 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 page ou base de données Notion, l'autre 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 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 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 Notion à 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 que vous supprimez un champ personnalisé qui a été créé à partir du plugin Notion WP Sync vous ne le retrouverez pas dans les contenus importés.
Réglages de synchronisation
Vous pouvez choisir les paramètres de synchronisation du plugin Notion WP Sync.
En cliquant sur le bouton Sync Now, vous pouvez synchroniser votre contenu pour la première fois, même si vous n'avez pas sélectionné le déclencheur Manuel uniquement.
Stratégie
Il existe plusieurs stratégies d'importation pour votre contenu Notion dans WordPress. Nous en avons défini 3 qui sont : Ajouter / Ajouter et mettre à jour / Ajouter, mettre à jour et supprimer.
Chacune de ces stratégies fonctionne comme indiqué :
- Le mode Ajouter n'ajoutera que du nouveau contenu à votre site web et n'affectera pas le contenu existant.
- Le mode Ajouter/Mettre à jour permet d'ajouter de nouveaux contenus et de mettre à jour les contenus existants s'ils ont été édités dans Notion.
- Le mode Ajouter/Mettre à jour/Supprimer permet d'ajouter un nouveau contenu, de mettre à jour un contenu existant s'il a été modifié dans Notion et de supprimer un contenu qui a été supprimé dans Notion.
Déclencheur
Les déclencheurs vous permettent de contrôler le moment où les données sont importées de Notion to 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.
- RÉCURRENT : 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 "30 minutes", "une fois par heure", "une fois par jour", "deux fois par jour" ou "une fois par semaine". Ceci est utile si vous souhaitez mettre à jour régulièrement votre site WordPress avec les derniers contenus saisis dans votre espace de travail Notion.
- INSTANTANÉ : il vous permet d'importer des données dès qu'elles sont ajoutées ou mises à jour dans Notion (en fonction de la stratégie d'importation sélectionnée). Cette fonction est utile si vous souhaitez que votre site WordPress soit synchronisé en temps réel avec Notion, mais elle peut également s'avérer gourmande en ressources si vous disposez d'une grande quantité de données fréquemment mises à jour.
Publication
Une fois tous les paramètres configurés, n'oubliez pas de publier votre connexion en cliquant sur le bouton Publier ou Mettre à jour en cas de modification de la configuration. Et c'est tout !
Si vous avez choisi une synchronisation manuelle, n'hésitez pas à cliquer sur le bouton Synchroniser pour synchroniser vos premiers contenus et les voir apparaître dans WordPress.
Champs et blocs de contenu pris en charge
Propriétés prises en charge (bases de données) :
- Case à cocher
- Date
- Fichiers et médias
- Sélection multiple
- Nombre
- Personnes
- Numéro de téléphone
- Texte enrichi ("Text" dans Notion)
- Sélectionner
- Status
- Titre
- URL
- Formule
Blocs de contenu (pages) pris en charge :
- Paragraphe
- Rubrique (1,2,3)
- Liste à puces/liste de commande
- Citation
- Tableau (colonne d'en-tête non prise en charge)
- Toggle (voir restrictions)
- Séparateur
- Callout (Contenu encadré - Voir les restrictions)
- Image
- Vidéo (liens Spotify & Loom également)
- Dossiers
- Colonnes
Champs, blocs de contenu et vues non pris en charge
Voici ce qui n'est pas encore pris en charge par notre plugin :
- Listes de tâches
- Prévisualisation des liens web
- Audios
- Insertion de fichiers
- Vue du tableau
Vue du graphique - Vue de la galerie
- Vue de la liste
- Vue du calendrier
- Vue de la ligne de temps
- Base de données synchronisée
- Signets
- Table des matières
- Formule mathématique
- Bouton
- Fil d’Ariane
- Blocs synchronisés, contenus embarqués
- Mentionner/mentionner une page
- Liens des pages enfants/liens internes
- Date ou rappel
- Équation - Dans ce bloc
- Bloc AI
- Cases à cocher
Les liens internes ne seront pas convertis en liens de pages WordPress.
Seul l'affichage sous forme de tableau est pris en charge.
Restrictions
Notion est une application offrant un large éventail de fonctionnalités.
Nous nous efforçons de maintenir autant de ces fonctionnalités que possible au cours de notre processus d'importation ; cependant, en raison de problèmes de compatibilité avec Gutenberg, de choix de notre part ou de limitations de l'API Notion, certaines de ces fonctionnalités restent encore restreintes avec notre plugin.
Pour les pages
Voici ce que nous avons décidé de restreindre dans notre plugin :
Les Toggles sont désormais compatibles avec Gutenberg !
C'est pourquoi nous avons ajouté le support des toggles ; cependant, comme l'imbrication est infinie sur Notion, nous avons décidé de la limiter au deuxième niveau. Vous ne pourrez donc pas avoir plus de 2 niveaux de toggles (c'est plus que suffisant).
Voir l'exemple ci-dessous :
1. Travaux
2. Fonctionne trop
3. Ne fonctionne pas
De la même manière, les listes d'appels sont prises en charge. Cependant, vous ne pourrez pas imbriquer un callout dans un autre callout (un niveau suffit, n'est-ce pas ?).
Voir l'exemple ci-dessous :
1. ⚠️ Travaille
2. ⚠️ Ne travaille pas
Tableau de compatibilité
Dépannage
Assurez-vous d'avoir créé vos bases de données et les noms des champs de Notion avant d'ajouter une nouvelle connexion. Si vous ne le voyez pas, attendez 1 minute. Pour des raisons de performance, vos éléments de Notion sont mis en cache pendant une minute.
Si nécessaire, vous pouvez accéder aux journaux à partir d'un serveur FTP dans ce dossier :
/wp-content/uploads/notionwpsync-logs
Problèmes de synchronisation
Certains problèmes peuvent apparaître lors de la synchronisation. Certains hébergeurs désactivent une série de fonctions PHP pour garantir la performance de leurs serveurs.
Notion API : erreur 403
Dans les paramètres d'intégration de Notion, assurez-vous que vous avez coché le jeton Capacités de l'utilisateur Lire les informations de l'utilisateur, y compris les adresses email.
Délai d'attente du serveur
Si vous avez une grande quantité de contenu à importer, le processus de synchronisation prendra un certain temps pour synchroniser toutes les données, surtout s'il s'agit de la première synchronisation. Il se peut que vous ayez ce que l'on appelle un "délai d'attente du serveur". Cela dépendra du nombre de lignes que vous souhaitez importer, de la taille et du nombre d'images, mais aussi des paramètres du serveur. Ceci est d'autant plus probable si vous avez opté pour une offre d'hébergement basique.
Vérifiez auprès de votre hébergeur et augmentez le temps d'exécution, la taille de la mémoire autorisée et la taille du fichier au maximum si nécessaire.
Authentification de base
Dans le cas où vous avez configuré une authentification de base pour protéger l'accès au site ou à certaines informations du site, l'appel à WP Cron est alors impossible, rendant la synchronisation récurrente et instantanée impossible.
Problèmes de cache avec WP-Cron
WP-Cron a besoin du chargement de la page pour se déclencher et donc se synchroniser. Dans le cas où vous utilisez un système de cache (WP Rocket ou WP Super Cache par exemple), il est donc nécessaire d'utiliser un cron serveur.
Articles avancés
GÉNÉRALITÉS
- Créer un type de publication personnalisé (CPT) avec Notion WP Sync
- Créer des utilisateurs WordPress depuis Notion avec Notion WP Sync
- Comment utiliser les réglages de synchronisation dans Notion WP Sync ?
- Comment configurer le statut de la publication dans Notion WP Sync ?
- Comment utiliser le champ "Relation" de Notion avec Notion WP Sync ?
- Comment créer des taxonomies WordPress à partir de Notion avec Notion WP Sync ?
- Trouver les slugs des champs personnalisés pour le mappage avec Notion WP Sync
ACF, JETENGINE & META BOX