Documentation Notion WP Sync
⚠️ NOTE IMPORTANTE
Notion WP Sync est un SYNC À SENS UNIQUE - De l'idée à WordPress SEULEMENT !
Les modifications apportées à WordPress PAS Il faut donc veiller à gérer vos données à partir de Notion pour que tout soit mis à jour correctement.
Installation et réglages
To install our Notion WP Sync plugin in WordPress, follow the steps below:
- 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 and the Ajouter un nouveau.
- Cliquez sur le bouton Télécharger le plugin 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 bouton.
- Attendez que le plugin soit installé, puis cliquez sur le bouton Activer bouton.
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 Notion WP Sync > Paramètres.
Cette clé de licence est disponible à la fois dans l'e-mail de confirmation de votre achat, ainsi que sur wpconnect.co > Mon compte > Mes produits téléchargeables > Clés de licence, Visualiser les licences.
You will then be redirected to the purchase page of your product. Click on the key icon to see the license number appears and copy-paste it into your Notion WP Sync License Key domaine.
Once the license key is copied into the Notion WP Sync settings, be sure to click the Activer button. If your license key is valid, a green checkmark will appear and you juste need to save the settings by clicking the Update settings bouton.
Vous pouvez alors commencer à créer vos connexions.
Créer une connexion
To create a new connection to your Notion account, go to Notion WP Sync > All connections, click the Add New Connection button and enter a name for your connection.
You will be asked for an Internal integration token to connect your account. We recommand that you retrieve this token using ce lien ou consulter cette vidéo.
Pour une meilleure compréhension, veuillez suivre les étapes suivantes :
- In your Notion account, go to the integrations page: Notion account > Connections > Develop or manage integrations.
- Cliquez sur le bouton New integration button and enter a name for your integration. Then select the workspace where you want to use the integration in the Associated workspace field. Select “Internal” for the Type. And click on Save bouton.
- Once the integration successfully created, click on Configure integration settings button: an Internal Integration Secret is already created.
- Please select the Content capabilities “Read content” and the User capabilities “Read user information including email adresses“, and click on Save bouton.
- Now, you can click on Show then Copie the Internal Integration secret. You can paste it into the Internal integration token field of your Notion WP Sync plugin.
⚠️ Once your Internal integration token has been entered in the field, you have to share your Notion pages or databases with your integrations to see their in the differents select fields of your plugin.
To do this, please select the more option button at the right top of your Notion page ou database, hover the Add connection option and select the connection you’ve just created. You can also consult the Page de documentation de la Notion to understand how to create an Internal integration token.
Réglages d'importation
Contenu Notion
Vous pouvez importer vos pages et bases de données de Notion vers WordPress.
- Notion Pages : they are essentially digital documents that can contain a wide range of information, from text and images to embedded files, databases, and more.
- Notion Databases: one of the most powerful features of the Notion platform, Notion Databases are essentially tables with customizable columns, where users can input and manipulate data in a variety of ways
Destination
Vous pouvez importer votre contenu de plusieurs façons : Type de publication ou Code court.
Type de publication
Vous pouvez importer votre contenu de plusieurs façons : Article, Page ou Custom Post Type.
Voici comment fonctionnent ces trois éléments :
- Article: an article is a content that can be published on a blog or website. They are generally used to display information. They are created and managed in the Posts section of the WordPress dashboard.
- Page: a page is static content that is usually part of a website’s navigation menu. They are used to display information. They are created and managed in the Pages section of the WordPress dashboard.
- Type de publication personnalisé (CPT): a custom post type is a custom content type that can be created by WordPress plugins or themes. CPTs allow you to add specialized content types to your site such as events, products, portfolios, etc. They are generally used to extend the capabilities of WordPress and to add structured content to your site. They are similar to posts and pages in that they can be published on your site and viewed by users but they have their own unique labels and characteristics that distinguish them. There are several types of CPTs: CPTs created by plugins or themes that you have installed on your WordPress site, those that you have created via plugin such as Custom Post Type UI or ToolSet or those that have been created manually by custom development.
Création d'un type de publication personnalisé
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.
📌 Our Notion WP Sync plugin offers the ability to create your Custom Post Types on-the-fly specifically for your imported content.
For the Custom Post Type that you will create from the Notion WP Sync plugin, you will find the possibility of mapping the following WordPress fields: “Titre“, “Contenu“, “Slug“, “Custom Field“.
It also allows you to create your own custom fields.
⚠️ ATTENTION, if you decide to change the configuration and no longer use the Custom Post Type created specifically through the Notion WP Sync plugin, this CPT created on-the-fly will no longer exist in WordPress and the content imported will also no longer be available.
Code court
You can import your Notion content in shortcode.
Creating your shortcode content will create a Custom Post Type: “Notion Content“. This Notion Content CPT can be used by developers.
It can also be displayed thanks to our dedicated Notion Content block in Gutenberg editor.
Le shortcode généré peut être utilisé dans le bloc de shortcodes de Gutenberg ou dans différentes pages de constructeurs comme Divi, Elementor, WP Bakery, etc.
Statut de la publication
Like in WordPress, imported content from Notion can have different status: “Published”, “Draft”, “Scheduled”, “Pending”, “Private”.
Chacun de ces états vérifie les conditions suivantes :
- “PUBLIÉ“ content is publicy visible on your website.
- “PROJET“ content is saved as a work in progress and is not visible to the public.
- “PROGRAMMÉ” content is set to be published at a specific date and time in the future.
- “EN ATTENTE” content is waiting for review or approval before it can be published.
- “PRIVÉ” content is only visible to logged-in users with the appropriate permissions.
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).
📌 If you wish to use a property in your Notion database to define the status of posts, you’ll need to use the values defined in WordPress for this property. The article Comment configurer l'état de la synchronisation dans Notion WP Sync ? explains this in detail.
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.
You can now use Notion’s author attribute to assign authors to posts, pages or custom post types (CPTs) in your mapping. This works for existing users in both Notion and WordPress. Simply map the “Author (email)"dans le champ Notion field à la colonne "Auteur"dans le champ Importer en tant que dans WordPress.
⚠️Users doit déjà exister dans WordPress avec même adresse électronique as their Notion account.
This feature does not create new WordPress users during content synchronization.
Si aucun utilisateur correspondant n'est trouvé, le poste sera attribué à l'utilisateur défini dans le champ Auteur de l'article par défaut sous le champ Importer en tant que section.
Color for the Default text in Notion
In Notion, ten colors are available for text, including the default one, called “Default text”: defined as white in dark mode and black in light mode.
You can define a custom color for text using the “Default text” format in Notion when importing content into WordPress.
Dans le cadre de la Importer en tant que section, a color selector becomes available when you map the “Page content” Notion field — whether you’re importing it as a “Article“, “User”, or “Termes de taxonomies”.
To set a color: click the Select color button and choose a color from the palette, enter a hexadecimal code, or pick one of the 8 predefined colors below the palette. In WordPress, the imported content will use this selected color.
To remove a selected color: click the Clear bouton.
⚠️The color you define here will only apply to texts formatted as “Default text” in Notion, and will not apply to texts formatted with another color, such as “purple text” or “red text”. These will retain the same color (purple or red) in WordPress.
Réglages de mappage
Vous pouvez désormais lier les champs de vos pages et de vos bases de données aux champs de WordPress.
To do so, click the Ajouter un champ button. Two drop-down lists are then available, one contains the fields of your Notion page or database, the second the WordPress fields with which you can map them.
Article
For posts, you will find the possibility to map the following WordPress fields: “Title”, “Featured Image”, “Content”, “Excerpt”, “Slug”, “Tag”, “Category” or “Custom Field”.
Page
For pages, you will find the possibility to map the following WordPress fields: “Title”, “Featured Image”, “Content”, “Excerpt”, “Slug”, “Tag”, “Category” or “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
You can also consider adding specific fields to your content imported from WordPress by mapping your Notion field to a custom field that you can name and which you will find in the imported content once the synchronization is complete.
⚠️ CAUTION, if you modify the configuration and remove a Custom Field that was created from the Notion WP Sync plugin, you will not find it in any of the imported content.
Réglages de synchronisation
You can choose the synchronization parameters of the Notion WP Sync plugin.
By clicking on Synchroniser maintenant button, you can synchronize your content for the first time, even if you have not selected the Manual Only trigger.
Stratégie
There are several import strategies for your Notion content in WordPress. We have defined 3 of them which are: Add / Add and Update/ Add, Update and Delete.
Chacune de ces stratégies fonctionne comme indiqué :
- ADD n'ajoutera que du nouveau contenu à votre site web et n'affectera pas le contenu existant.
- ADD/UPDATE ajoutera du nouveau contenu et mettra à jour tout contenu existant s'il a été édité dans Notion
- AJOUTER/METTRE À JOUR/SUPPRIMER ajoutera du nouveau contenu, mettra à jour tout contenu existant s'il a été édité dans Notion et supprimera tout contenu qui a été supprimé dans Notion.
Déclencheur
Triggers allow you to control when data is imported from Notion to WordPress. There are three possible trigger options: “Manual“, “Récurrent” and “Instant“.
- MANUEL: it allows you to manually import the data by clicking on the Sync now button. This is useful if you need to import data occasionally or want more control over when to import.
- RECURRING: it allows you to schedule the import of data at regular intervals. You can choose how often the import should occur, such as every “30 minutes”, “Once hourly”, “Once daily”, “Twice daily”, or “Once weekly”. This is useful if you want to regularly update your WordPress site with the latest content entered into your Notion workspace.
- INSTANT: it allows you to import data as soon as it is added or updated in Notion (depending on the selected import strategy). This is useful if you want your WordPress site to be in real-time sync with Notion, but it can also be resource-intensive if you have a large amount of frequently updated data.
Publier
Once all the parameters have been configured, do not forget to publish your connection by clicking on Publish ou Update button in the case of a configuration modification. And that’s it!
If you have chosen a manual synchronization, do not hesitate to click on the Sync now button to synchronize your first contents and see them appear in WordPress.
Champs et blocs de contenu pris en charge
Supported properties (databases):
- Case à cocher
- Date
- Courriel
- Fichiers et médias
- Multi Select
- Nombre
- Les personnes
- Numéro de téléphone
- Texte enrichi ("Text" dans Notion)
- Sélectionner
- Statut
- Titre
- URL
- Formule
Supported content blocks (pages):
- Paragraphe
- Rubrique (1,2,3)
- Liste à puces/liste de commande
- Citation
- Tableau (colonne d'en-tête non prise en charge)
- Toggle (See restrictions)
- Séparateur
- Callout (Boxed content – See restrictions)
- Image
- Video (Spotify & Loom links too)
- 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
- Board view
Chart view - 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
- Chapelure
- Blocs synchronisés, Embeds
- Mentionner/mentionner une page
- Liens des pages enfants/liens internes
- Date ou rappel
- Equation - Dans ce bloc
- Bloc AI
- Cases à cocher
Les liens internes ne seront pas convertis en liens de page WP.
Only Table view is supported.
Restrictions
Notion est une application offrant un large éventail de fonctionnalités.
Nous nous efforçons de conserver le plus grand nombre possible de ces caractéristiques au cours de notre processus d'importation. Gutenberg, choices on our end, ou limitations de l'API Notionmais certaines de ces fonctionnalités restent limitées avec notre plugin.
Pages
Voici ce que nous avons décidé de restreindre dans notre extension :
Toggles are now compatible with Gutenberg!
Therefore, we have added support for toggles; however, since nesting is infinite on Notion, we have decided to limit it to the second level. You will therefore not be able to have more than 2 levels of toggles (that’s mooooore than enough).
Voir l'exemple ci-dessous :
1. Travaux
2. Fonctionne trop
3. Ne travaille pas
De même, les callouts sont pris en charge. However, vous ne pourrez pas imbriquer un callout dans un autre callout (well, one level is enough, right?).
Voir l'exemple ci-dessous :
1. ⚠️ Travaux
2. ⚠️ Ne fonctionne 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 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 poignée de fonctions PHP pour garantir la performance de leurs serveurs.
Notion API : erreur 403
In your Notion integration settings, ensure that you have checked the token User Capabilities “Read user information including email addresses“.
Délai d'attente du serveur
If you have a large amount of content to import, the synchronization process will take some time for all the data to synchronize, especially if this is the first sync. You may have what is called a “Server Timeout”. It will depend of the number of rows you wish to import, the size and the number of images but also of the server settings. This is all the more likely to happen if you have opted for a basic hosting offer.
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 d'article personnalisé avec Notion WP Sync
- Créer des utilisateurs WordPress à partir de Notion avec Notion WP Sync
- Comment utiliser les paramètres de synchronisation dans Notion WP Sync ?
- Comment configurer l'état de la synchronisation dans Notion WP Sync ?
- How to use Notion “Relation” field with Notion WP Sync?
- How to create WordPress taxonomies from Notion with Notion WP Sync?
- Finding Custom Field Slugs for Mapping with Notion WP Sync
ACF, JETENGINE & META BOX