Documentation TimeTonic WP Sync
⚠️ NOTE IMPORTANTE
TimeTonic WP Sync is a ONE-WAY SYNC – from TimeTonic to WordPress ONLY!
Changes made in WordPress will NOT be synced to TimeTonic, so make sure to manage your data from TimeTonic to ensure everything is updated properly.
Installation et réglages
To install our TimeTonic WP Sync plugin in WordPress, follow the steps below:
- 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 à Plugins > Ajouter un nouveau plugin.
- Cliquez sur Plugin de téléchargement en haut de la page.
- Cliquez sur Choisir un fichier et sélectionnez le fichier du plugin que vous avez téléchargé à l'étape 1.
- Cliquez sur Installer maintenant bouton.
- Attendez que le plugin soit installé, puis cliquez sur le bouton Activer le plugin bouton.
After installing and activating the plugin in WordPress, it will appear in the admin menu and will allow access to the connection and configuration settings.
Before creating a connection, you are prompted to enter your license key to validate the plugin installation. To activate this license key, go to TimeTonic WP Sync > Settings.
The license key is available in your purchase confirmation email, as well as on wpconnect.co > My Account > License Keys, View Licenses.
You will then be redirected to your product purchase page. Click on the key icon to see the license number appear and copy and paste it into your TimeTonic WP Sync Clé de licence domaine.
Once the license key is copied into the TimeTonic WP Sync settings, make sure to click the Activer button. If your license key is valid, a green check mark will appear and you will simply need to save the settings by clicking the Update Settings bouton.
You can then start creating your connections.
Créer une connexion
To create a new connection to your TimeTonic account, go to TimeTonic WP Sync > All Connections, click on the Ajouter un nouveau Connection button, and enter a Titre for your connection.
An API key will be required to connect your account. We recommend retrieving this key from this link. Go to your TimeTonic Account > Paramètres page, click on the Add New API key bouton.
Once the token is generated, copy and paste it into the designated field API Key, then also add your User ID in the corresponding field.
After entering your token, select the Book (Workspace) to import, as well as the Tables ou Voir you want to synchronize. In the near future, you’ll also be able to add formula filters to views to adjust imported data, as in TimeTonic.
⚠️ Reminder: to use a table, you must own it or have admin rights.
Réglages d'importation
You can import your content into multiple formats: Post, Users, or Taxonomies.
Here’s an overview of each type.
Type de publication
You can import your content in several ways: post, page, or custom post type.
Here’s how these three elements work.
Article
A post is content that can be published on a blog or website. Typically used for sharing news or information, posts are displayed chronologically. You can create and manage them in the Posts section of the WordPress dashboard.
Page
A page is static content that is usually part of the site navigation menu. Pages are used to display long-term content, such as “About” ou “Contact” pages. You can manage them in the Pages section of the WordPress dashboard.
Type de publication personnalisé (CPT)
A Custom Post Type (CPT) is a specialized content type created by WordPress plugins or themes. CPTs allow you to add structured content like events, products, portfolios, etc.
They are generally used to extend the capabilities of WordPress and 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 unique tags and characteristics that set them apart.
There are several types of CPTs:
– CPTs created by plugins or themes installed on your WordPress site.
– CPTs that you have created via plugins like Interface utilisateur des types d'articles personnalisés ou Jeu d'outils.
– CPTs created manually by custom developments.
With the TimeTonic WP Sync plugin, you can create your own Custom Post Types (CPTs) on the fly for imported data.
📌 While the WooCommerce Product CPT appears in the list, it is only available for basic mapping configurations. For full compatibility, check out our Air WP Sync for WooCommerce.
Création d'un type de publication personnalisé
For the Custom Post Type that you will create from the TimeTonic WP Sync plugin, you will find the possibility to map the following WordPress fields: Title, Content, Slug, Custom Field.
It also allows you to create your own custom fields.
⚠️ CAUTION: if you decide to change the configuration and no longer use the Custom Post Type created specifically via the TimeTonic WP Sync plugin, this CPT created on the fly will no longer exist in WordPress and the imported content will also no longer be available.
Statut de la publication
Like in WordPress, imported content from TimeTonic can have different status: Publié, Projet, Prévu, Pending, Private.
Chacun de ces états vérifie les conditions suivantes :
PRIVÉ le contenu n'est visible que par les utilisateurs connectés disposant des autorisations appropriées
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é
📌 If you change the status later in the configuration, the status of already imported content will depend on the import strategy you defined (see Import Strategies section).
Auteur de la publication
During the import process, you must choose an author who will be assigned to each imported post. The author must be an existing WordPress user with access to the admin panel, regardless of their role.
⭐️ You can also import users from TimeTonic and assign them as authors
Importation d’utilisateurs
TimeTonic WP Sync also allows you to import users directly into WordPress. You can map your TimeTonic fields to user attributes such as:
• Username
• First Name
• Last Name
• Email
• Website
• Biography
• Role (admin, editor, contributor, etc.)
• Language
• Custom Fields
This is particularly useful for team management or membership sites.
Termes de taxonomies
You can import taxonomies (categories, tags) to organize your content. By mapping TimeTonic fields to WordPress taxonomies, you can create filters and groups for your posts or CPTs.
Compatible fields for taxonomies:
• Name
• Slug
• Taxonomy Type
• Description
• Parent Category (only for hierarchical taxonomies)
• Custom Fields (e.g., project type, location)
📌 However, for custom taxonomies, only those based on text fields are currently supported. Other field types will be added in future versions of the plugin.
Réglages de mappage
You can now link the fields of your TimeTonic database with the WordPress fields.
To do this, click on the Ajouter un champ button. Two drop-down lists will appear: one containing the fields of your TimeTonic database and the other the WordPress fields with which you can associate them.
Article
For posts, you can map the following WordPress fields:
Title, Featured Image, Content, Excerpt, Slug, Tags, Categories, or Custom Field.
Page
For pages, you can map the following WordPress fields:
Title, Featured Image, Content, Slug, or Custom Field.
Type de publication personnalisé existant
For existing Custom Post Types (CPTs), meaning those created by installed plugins or WordPress themes, you can map:
Title, Content, Slug, Taxonomies, or Custom Fields.
Taxonomies allow grouping similar content across multiple CPTs. They can be used to create filters or search functions.
Example for a “Real Estate” CPT:
• Title
• Content
• Slug
• Property Type (taxonomy)
• City (taxonomy)
• Custom Fields
Champs personnalisés
You can also add specific fields to your content imported from TimeTonic by associating a TimeTonic field with a custom field that you can name. You will find this field in the imported content once the synchronization is complete.
⚠️ If you modify the configuration and delete a custom field created via TimeTonic WP Sync, you will no longer find it in any of the imported content.
Réglages de synchronisation
You can choose the synchronization settings of the TimeTonic WP Sync plugin.
By clicking on Synchronize, you can perform your first synchronization, even if you have not selected the Manual only trigger.
Stratégie
There are three import strategies for importing TimeTonic content into WordPress:
• ADD: only adds new content without modifying existing ones.
• ADD/UPDATE: adds new content and updates existing ones if they have been modified in TimeTonic.
• AJOUTER/METTRE À JOUR/SUPPRIMER: adds new content, updates existing ones, and deletes any removed from TimeTonic.
Déclencheur
Triggers allow you to control when data is imported from TimeTonic to WordPress. There are three options available:
- 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: It allows you to schedule the import of data at regular intervals. You can choose how often the import should occur, such as every 5 minutes, hourly, daily, or weekly. This is useful if you want to regularly update your WordPress site with the latest data entered into TimeTonic.
Pour de meilleures performances, vous pouvez mettre en place un job cron en utilisant WP-Cron : voir notre tutoriel ici. - INSTANT: It allows you to import data as soon as it is added or updated in TimeTonic (depending on the selected import strategy). This is useful if you want your WordPress site to be in real-time sync with TimeTonic, but it can also be resource-intensive if you have a large amount of frequently updated data. To do so, you’ll have to create an automation.
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, voilà !
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.
Prise en charge des constructeurs de pages Elementor, Divi, Beaver Builder et autres
If you use Elementor, Divi, Beaver Builder or any Page Builder to create and manage your site, you can use directly the content imported by TimeTonic WP Sync. You will find all the synchronized posts including the existing Custom Post Type and your Custom Post Type created with TimeTonic WP Sync.
Refer to your page builder documentation to enable, use your Custom Post Types and add them to posts loops or single templates.
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
TimeTonic supported fields:
WordPress supported fields:
- Single line of text
- Multiline Text
- Smart Text
- Nombre
- Selection
- Case à cocher
- Date
- Phone Number
- Courriel
- Attachments
- URL
- Formule
- Link to another table
- Selection (List from another table)
- Automatic Number
- Titre
- Contenu
- Excerpt
- Slug
- Publication Date
- Featured Image
- Custom Field
- Term Taxonomies
- Statut
- Auteur
Not Supported Fields & Views:
Here is what is not yet supported by our plugin:
TimeTonic Fields:
- Color Selection
- Text Color Selection
- Linked Table Column
- Conditional Text (Text from Another Table)
- Conditional Selection (List from Another Table)
- Comments
- Change History
- Automatic Numbers
- External Form
- Permalink
- QR Code
- Encrypted Field
- Last Modified
- Automatic Document
- Mask
- Contact Information
- Record URL
TimeTonic Views:
- Kanban
- Calendar
- Planner
- Gantt
- Cart
- TCD
Dépannage
Make sure you have created your databases and TimeTonic columns names before adding a new connection. If you don’t see it, wait 15 minutes. For performance reasons, your TimeTonic elements are cached for 15 minutes.
Si nécessaire, vous pouvez accéder aux journaux 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 poignée 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.
