Documentation TimeTonic WP Sync
⚠️ NOTE IMPORTANTE
TimeTonic WP Sync propose une synchronisation à sens unique - de TimeTonic vers WordPress UNIQUEMENT !
Les changements effectués dans WordPress ne seront PAS synchronisés avec TimeTonic, assurez-vous donc de gérer vos données depuis TimeTonic pour vous assurer que tout est mis à jour correctement.
Installation et réglages
Pour installer notre plugin TimeTonic WP Sync dans WordPress, suivez les étapes ci-dessous :
- Téléchargez l'archive zip du plugin sur votre ordinateur.
- Connectez-vous à votre tableau de bord WordPress.
- Dans le tableau de bord de WordPress, allez dans Extensions > 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 permettra d'accéder aux réglages 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 TimeTonic WP Sync > Réglages.
La clé de licence est disponible dans votre email confirmation d'achat, ainsi que sur wpconnect.co > Mon compte > 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 et collez-le dans votre champ TimeTonic WP Sync - Clé de licence.
Une fois la clé de licence copiée dans TimeTonic WP Sync assurez-vous de cliquer sur le bouton Activer. Si votre clé de licence est valide, une coche verte apparaîtra et vous n'aurez plus qu'à sauvegarder les réglages 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 TimeTonic, allez dans TimeTonic WP Sync > Toutes les connexions, cliquez sur le bouton Ajouter une nouvelle connexion, et entrez un Titre pour votre connexion.
Une clé API sera nécessaire pour connecter votre compte. Nous vous recommandons de récupérer cette clé à partir de ce lien. Allez sur votre compte TimeTonic > Paramètres , cliquez sur le bouton Ajouter une nouvelle clé d’API.
Une fois le jeton généré, copiez-le et collez-le dans le champ désigné API Key, puis ajoutez votre User ID dans le champ correspondant.
Après avoir saisi votre jeton, sélectionnez l’Espace de travail à importer, ainsi que la Table ou laVue que vous souhaitez synchroniser. Dans un avenir proche, vous pourrez également ajouter des filtres de formule aux vues pour ajuster les données importées, comme dans TimeTonic.
⚠️ Rappel : pour utiliser un tableau, vous devez en être le propriétaire ou avoir des droits d'administrateur.
Réglages d'importation
Vous pouvez importer votre contenu dans plusieurs formats : Publications, Utilisateurs ou Taxonomies.
Voici un aperçu de chaque type.
Type de publication
Vous pouvez importer votre contenu de différentes manières : article, page ou type de publication personnalisé.
Voici comment fonctionnent ces trois éléments.
Article
Un article est un contenu qui peut être publié sur un blog ou un site web. Généralement utilisés pour partager des nouvelles ou des informations, les articles sont affichés chronologiquement. Vous pouvez les créer et les gérer 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 du site. Les pages sont utilisées pour afficher du contenu à long terme, comme les pages "À propos" ou "Contact". Vous pouvez les gérer dans la section Pages du tableau de bord de WordPress .
Type de publication personnalisé (CPT)
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é.
Avec le plugin TimeTonic WP Sync vous pouvez créer vos propres Custom Post Types (CPT) à la volée pour les données importées.
📌 Bien que le CPT produit WooCommerce apparaisse dans la liste, il n'est disponible que pour les configurations de mappagge de base. Pour une compatibilité totale, consultez notre page Air WP Sync for WooCommerce.
Créer un type de publication personnalisé (CPT)
Pour le type de publication personnalisé (CPT) que vous allez créer à partir de TimeTonic 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 TimeTonic WP Sync, ce CPT créé à la volée n'existera plus dans WordPress et le contenu importé ne sera plus disponible non plus.
Statut de la publication
Comme dans WordPress, le contenu importé de TimeTonic peut avoir différents statuts : Publié, Brouillon, Planifié, En attente, Privé.
Chacun de ces statuts vérifie les conditions suivantes :
Le contenu PRIVÉ n'est visible que par les utilisateurs connectés disposant des autorisations appropriées.
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é.
📌 Si vous modifiez le statut ultérieurement dans la configuration, le statut du contenu déjà importé dépendra de la stratégie d'importation que vous avez définie (voir Stratégies d'importation ).
Auteur de la publication
Pendant le processus d'importation, vous devez choisir un auteur qui sera assigné à chaque article importé. L'auteur doit être un utilisateur WordPress existant ayant accès au panneau d'administration, quel que soit son rôle.
⭐️ Vous pouvez également importer des utilisateurs de TimeTonic et les désigner comme auteurs.
Importation d'utilisateurs
TimeTonic WP Sync vous permet également d'importer des utilisateurs directement dans WordPress. Vous pouvez faire correspondre vos champs TimeTonic aux attributs de l'utilisateur tels que :
- Nom d'utilisateur
- Prénom
- Nom de famille
- Email
- Site web
- Biographie
- Rôle (administrateur, éditeur, contributeur, etc.)
- Langue
- Champs personnalisés
Cette fonctionnalité est particulièrement utile pour la gestion des équipes ou des membres sur un site WordPress.
Terme de taxonomie
Vous pouvez importer des taxonomies (catégories, tags) pour organiser votre contenu. En faisant correspondre les champs TimeTonic aux taxonomies WordPress , vous pouvez créer des filtres et des groupes pour vos articles ou vos CPT.
Champs compatibles avec les taxonomies :
- Nom
- Slug
- Type de taxonomie
- Description
- Catégorie parente (uniquement pour les taxonomies hiérarchiques)
- Champs personnalisés (par exemple, type de projet, localisation)
📌 Cependant, pour les taxonomies personnalisées, seules celles basées sur des champs de texte sont actuellement prises en charge. D'autres types de champs seront ajoutés dans les prochaines versions du plugin.
Réglages de mappage
Vous pouvez maintenant lier les champs de votre base de données TimeTonic avec les champs de WordPress
Pour ce faire, cliquez sur le bouton Ajouter un champ. Deux listes déroulantes apparaissent : l'une contenant les champs de votre base de données TimeTonic et l'autre les champs WordPress auxquels vous pouvez les associer.
Article
Pour les articles, vous pouvez mettre en correspondance les champs WordPress suivants :
Titre, Image mise en avant, Contenu, Extrait, Slug, Balises, Catégories ou Champ personnalisé.
Page
Pour les pages, vous pouvez affecter 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 (CPT) existants, c'est-à-dire ceux créés par des plugins ou des thèmes WordPress installés, vous pouvez établir une correspondance :
Titre, Contenu, Slug, Taxonomies ou Champs personnalisés.
Les taxonomies permettent de regrouper des contenus similaires dans plusieurs CPT. Elles peuvent être utilisées pour créer des filtres ou des fonctions de recherche.
Exemple pour un CPT"Immobilier" :
- Titre
- Contenu
- Slug
- Type de propriété (taxonomie)
- Ville (taxonomie)
- Champs personnalisés
Champs personnalisés
Vous pouvez également ajouter des champs spécifiques à votre contenu importé de TimeTonic en associant un champ TimeTonic à un champ personnalisé que vous pouvez nommer. Vous retrouverez ce champ dans le contenu importé une fois la synchronisation terminée.
⚠️ Si vous modifiez la configuration et supprimez un champ personnalisé créé via TimeTonic WP Sync vous ne le retrouverez plus dans le contenu importé.
Réglages de synchronisation
Vous pouvez choisir les paramètres de synchronisation de TimeTonic WP Sync TimeTonic.
En cliquant sur Synchroniser, vous pouvez effectuer votre première synchronisation, même si vous n'avez pas sélectionné le déclencheur Manuel uniquement.
Stratégie
Il existe trois stratégies d'importation pour importer le contenu de TimeTonic dans WordPress
- AJOUTER : ajoute uniquement de nouveaux contenus sans modifier les contenus existants.
- AJOUTER/METTRE A JOUR : ajoute de nouveaux contenus et met à jour les contenus existants s'ils ont été modifiés dans TimeTonic.
- AJOUTER/METTRE A JOUR/SUPPRIMER : ajoute de nouveaux contenus, met à jour les contenus existants et supprime ceux qui ont été retirés de TimeTonic.
Déclencheur
Les déclencheurs vous permettent de contrôler le moment où les données sont importées de TimeTonic vers WordPress. Trois options sont disponibles :
- 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: 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 TimeTonic.
Pour de meilleures performances, vous pouvez mettre en place une tâche cron en utilisant WP-Cron : voir notre tutoriel ici. - INSTANTANÉ : vous permet d'importer des données dès qu'elles sont ajoutées ou mises à jour dans TimeTonic (en fonction de la stratégie d'importation sélectionnée). Ceci est utile si vous voulez que votre site WordPress soit synchronisé en temps réel avec TimeTonic, mais cela peut aussi être coûteux en ressources si vous avez une grande quantité de données fréquemment mises à jour. Pour ce faire, vous devez créer une automatisation.
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 voilà !
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.
Prise en charge des constructeurs de pages Elementor, Divi, Beaver Builder et autres
Si vous utilisez Elementor, Divi, Beaver Builder ou tout autre Page Builder pour créer et gérer votre site, vous pouvez utiliser directement le contenu importé par TimeTonic WP Sync. Vous trouverez toutes les publications synchronisées, y compris le type de publication personnalisé (CPT) existant et votre type de publication personnalisé (CPT) créé avec TimeTonic WP Sync.
Reportez-vous à la documentation de votre constructeur de pages pour activer, utiliser vos CPT et les ajouter aux boucles de requêtes ou aux modèles individuels.
De la même manière, vous pouvez utiliser les champs personnalisés pour afficher vos données dans des pages, des boîtes, des widgets ou tout autre élément dynamique tel que des boutons ou des balises qui vous offrent un haut niveau de personnalisation !
Champs pris en charge
Champs pris en charge par TimeTonic :
- Une seule ligne de texte
- Texte multiligne
- Texte intelligent
- Nombre
- La sélection
- Case à cocher
- Date
- Numéro de téléphone
- Pièces jointes
- URL
- Formule
- Lien vers un autre tableau
- Sélection (liste d'un autre tableau)
- Numéro automatique
Champs pris en charge par WordPress :
- Titre
- Contenu
- Extrait
- Limace
- Date de publication
- Image mise en avant
- Champ personnalisé
- Taxonomies de termes
- Status
- Auteur
Champs et vues non pris en charge
Voici ce qui n'est pas encore pris en charge par notre plugin :
Champs TimeTonic :
- Sélection des couleurs
- Sélection de la couleur du texte
- Colonne du tableau lié
- Texte conditionnel (texte provenant d'un autre tableau)
- Sélection conditionnelle (liste à partir d'un autre tableau)
- Commentaires
- Historique des changements
- Numéros automatiques
- Formulaire externe
- Permalink
- Code QR
- Champ crypté
- Dernière modification
- Document automatique
- Masque
- Informations sur le contact
- URL de l'enregistrement
Vues TimeTonic :
- Kanban
- Calendrier
- Planificateur
- Gantt
- Chariot
- TCD
Dépannage
Assurez-vous d'avoir créé vos bases de données et les noms des colonnes TimeTonic avant d'ajouter une nouvelle connexion. Si vous ne le voyez pas, attendez 15 minutes. Pour des raisons de performance, vos éléments TimeTonic sont mis en cache pendant 15 minutes.
Si nécessaire, vous pouvez accéder aux journaux à partir d'un serveur FTP dans ce dossier :
/wp-content/uploads/tmtwpsync-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.
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.