Guide de l'utilisateur

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 :

1. Téléchargez l'archive zip du plugin sur votre ordinateur
2. Connectez-vous à votre tableau de bord WordPress
3. Dans le tableau de bord de WordPress, allez dans Extensions > Ajouter une extension
4. Cliquez sur le bouton Téléverser une extension en haut de la page
5. Cliquez sur le bouton Choisir un fichier et sélectionnez le fichier du plugin que vous avez téléchargé à l'étape 1
6. Cliquez sur le bouton Installer maintenant
7. 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 de 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, puis copiez-le et collez-le dans le champ TimeTonic WP Sync - Clé de licence.

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

Vous pouvez ensuite 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é depuis 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 également votre User ID dans le champ correspondant.

Après avoir saisi votre jeton, sélectionnez l'Espace de travail (Book) à importer, ainsi que les Tables ou la Vue que vous souhaitez synchroniser. Prochainement, vous pourrez également ajouter des filtres par formule aux vues pour ajuster les données importées, comme dans TimeTonic.

attention

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 plusieurs façons : 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 actualités ou des informations, les articles sont affichés par ordre chronologique. Vous pouvez les créer et les gérer dans la section Articles du tableau de bord WordPress.

Page

Une page est un contenu statique qui fait généralement partie du menu de navigation du site. Les pages servent à afficher du contenu pérenne, comme les pages « À propos » ou « Contact ». Vous pouvez les gérer dans la section Pages du tableau de bord WordPress.

Type de publication personnalisé (CPT)

Un type de publication personnalisé (CPT) est un type de contenu spécialisé créé par des plugins ou des thèmes WordPress. Les CPT vous permettent d'ajouter du contenu structuré comme des événements, des produits, des portfolios, etc.

Ils sont généralement utilisés pour étendre les capacités de WordPress et ajouter du contenu structuré à votre site. Ils sont similaires aux articles et aux pages en ce qu'ils peuvent être publiés sur votre site et consultés par les utilisateurs, mais ils possèdent des libellés et des caractéristiques qui leur sont propres.

Il existe plusieurs types de CPT :

• les CPT créés par les plugins ou thèmes installés sur votre site WordPress
• les CPT que vous avez créés via des plugins comme Custom Post Type UI ou ToolSet
• les CPT créés manuellement par des développements sur mesure

Avec le plugin TimeTonic WP Sync, vous pouvez créer vos propres types de publications personnalisés (CPT) à la volée pour les données importées.

astuce

Le CPT produit WooCommerce apparaît dans la liste mais n'est disponible que pour les configurations de mappage de base. Pour une compatibilité totale, consultez notre page Air WP Sync for WooCommerce.

Création de type de publication personnalisé

Pour le type de publication personnalisé que vous créerez depuis le plugin TimeTonic WP Sync, vous aurez 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é créé spécifiquement via le 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é depuis TimeTonic 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 travail en cours et n'est pas visible par le public
• Le contenu PLANIFIÉ est programmé pour être publié à une date et une heure précises dans le futur
• Le contenu EN ATTENTE attend une révision ou une approbation avant de pouvoir être publié
• Le contenu PRIVÉ n'est visible que par les utilisateurs connectés disposant des autorisations appropriées

astuce

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 la section Stratégie ci-dessous).

Auteur de la publication

Pendant le processus d'importation, vous devez choisir un auteur qui sera assigné à chaque publication importée. 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 mapper vos champs TimeTonic aux attributs utilisateur suivants :

• Nom d'utilisateur
• Prénom
• Nom de famille
• Email
• Site web
• Biographie
• Rôle (administrateur, éditeur, contributeur, etc.)
• Langue
• Champs personnalisés

C'est particulièrement utile pour la gestion d'équipes ou les sites d'adhésion.

Terme de taxonomie

Vous pouvez importer des taxonomies (catégories, tags) pour organiser votre contenu. En mappant les champs TimeTonic aux taxonomies WordPress, vous pouvez créer des filtres et des groupes pour vos publications ou CPT.

Champs compatibles pour les taxonomies :

• Nom
• Slug
• Type de taxonomie
• Description
• Catégorie parente (uniquement pour les taxonomies hiérarchiques)
• Champs personnalisés (ex. type de projet, localisation)

astuce

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 aux champs WordPress.

Pour ce faire, cliquez sur le bouton Ajouter un champ. Deux listes déroulantes apparaîtront : l'une contenant les champs de votre base de données TimeTonic et l'autre les champs WordPress avec lesquels vous pouvez les associer.

Article

Pour les articles, vous pouvez mapper les champs WordPress suivants : Titre, Image mise en avant, Contenu, Extrait, Slug, Tags, Catégories ou Champ personnalisé.

Page

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

Type de publication personnalisé existant

Pour les types de publications personnalisés (CPT) existants, c'est-à-dire ceux créés par les plugins installés ou les thèmes WordPress, vous pouvez mapper : Titre, Contenu, Slug, Taxonomies ou Champs personnalisés.

Les taxonomies permettent de regrouper des contenus similaires à travers plusieurs CPT. Elles peuvent servir à créer des filtres ou des fonctions de recherche.

Exemple pour un CPT « Immobilier » :

• Titre
• Contenu
• Slug
• Type de bien (taxonomie)
• Ville (taxonomie)
• Champs personnalisés

Champs personnalisés

Vous pouvez également ajouter des champs spécifiques à votre contenu importé depuis 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.

attention

Si vous modifiez la configuration et supprimez un champ personnalisé créé via TimeTonic WP Sync, vous ne le retrouverez dans aucun des contenus importés.

Réglages de synchronisation

Vous pouvez choisir les réglages de synchronisation du plugin TimeTonic WP Sync.

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 TimeTonic dans WordPress :

• AJOUTER : ajoute uniquement de nouveaux contenus sans modifier les contenus existants.
• AJOUTER/METTRE À JOUR : ajoute de nouveaux contenus et met à jour les contenus existants s'ils ont été modifiés dans TimeTonic.
• AJOUTER/METTRE À JOUR/SUPPRIMER : ajoute de nouveaux contenus, met à jour les contenus existants et supprime tout contenu retiré de TimeTonic.

Déclencheur

Les déclencheurs vous permettent de contrôler quand 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.
• RÉCURRENT : il 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 avec WP-Cron : voir notre tutoriel ici.
• INSTANTANÉ : il 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 également ê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.

Publication

Une fois tous les paramètres configurés, n'oubliez pas de publier votre connexion en cliquant sur 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 maintenant 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 constructeur de pages pour créer et gérer votre site, vous pouvez utiliser directement le contenu importé par TimeTonic WP Sync. Vous retrouverez toutes les publications synchronisées, y compris les CPT existants et votre CPT créé avec TimeTonic WP Sync.

Consultez la documentation de votre constructeur de pages pour activer et utiliser vos CPT et les ajouter à des boucles de publications ou des modèles de page.

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 élément dynamique comme des boutons ou des tags, ce qui vous offre un haut niveau de personnalisation !

Champs pris en charge

Champs TimeTonic pris en charge :

• Une seule ligne de texte
• Texte multiligne
• Texte intelligent
• Nombre
• Sélection
• Case à cocher
• Date
• Numéro de téléphone
• Email
• Pièces jointes
• URL
• Formule
• Lien vers un autre tableau
• Sélection (liste d'un autre tableau)
• Numéro automatique

Champs WordPress pris en charge :

• Titre
• Contenu
• Extrait
• Slug
• Date de publication
• Image mise en avant
• Champ personnalisé
• Taxonomies de termes
• Statut
• 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 d'un autre tableau)
• Sélection conditionnelle (liste 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
• Panier
• TCD

Dépannage

Assurez-vous d'avoir créé vos bases de données et les noms de colonnes TimeTonic avant d'ajouter une nouvelle connexion. Si vous ne les voyez pas, attendez 15 minutes. Pour des raisons de performance, vos éléments TimeTonic sont mis en cache pendant 15 minutes.

Si besoin, vous pouvez accéder aux journaux depuis 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 quelques fonctions PHP pour garantir la performance de leurs serveurs.

Délai d'expiration du serveur

Si vous avez une grande quantité de contenu à importer, le processus de synchronisation prendra un certain temps, surtout s'il s'agit de la première synchronisation. Vous pouvez rencontrer ce qu'on appelle un « Server Timeout ». Cela dépendra du nombre de lignes à importer, de la taille et du nombre d'images, mais aussi des réglages du serveur. C'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 si nécessaire le temps d'exécution, la taille de mémoire autorisée et la taille des fichiers au maximum.

Authentification basique

Si vous avez configuré une authentification basique (Basic Auth) 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 page pour se déclencher et donc synchroniser. Si vous utilisez un système de cache (WP Rocket ou WP Super Cache par exemple), il est alors nécessaire d'utiliser un cron serveur.