🔑 Activation
Gère l’activation de la licence nécessaire pour la connexion au Pricelist Server.
L’entrée des données de licence active toutes les fonctions du plugin.

Champs principaux :
• License ID → code d’identification unique de la licence.
• License Expiration → date d’expiration de la licence.

Après avoir saisi les données, appuyez sur Save pour compléter l’activation. La fenêtre Sync pour la synchronisation sera activée.

🔄 Synchronisation
Permet de synchroniser le contenu du catalogue du serveur Pricelist vers le site WordPress.
Pendant la synchronisation, les articles, les listes de prix, les descriptions et les images sont mis à jour.

Fonctions disponibles :
• Lancement de la synchronisation manuelle.
• Affichage de l’état d’avancement.

💡 Conseil : effectuer la synchronisation périodiquement ou après chaque mise à jour du catalogue.

🧰 Développer
Permet de définir la langue par défaut et de réaliser des tests sans affecter l’environnement de production.

Champs principaux :
• Default Language → langue de référence pour le développement en fonction des langues de catalogue disponibles.

⚙️ Configuration
Gère les paramètres généraux du plugin et du catalogue publié.

Options disponibles :
• Page des conditions de vente → lien vers la page d’information du site.
• Unité de mesure → unité de base pour les produits (ex. cm, mm, pièce).
• Symbole de la devise → option ON/OFF qui détermine si le symbole de la devise défini dans la liste de prix du Pricelist Server est affiché ou non.
• ON → le symbole de la devise est affiché à côté des prix sur le site.
• OFF → les prix sont affichés sans symbole de devise.
• Langue de secours → langue de réserve si une traduction n’est pas disponible.
• Régénération des ID uniques → fonction pour recréer les identifiants des blocs.

💡 Conseil : maintenir l’option Symbole de la devise active uniquement si les listes de prix en ligne sont destinées à une seule devise de référence.

📱 App
Définit les paramètres d’intégration avec l’application Pricelist dédiée ou avec la section mobile du site.
Permet d’indiquer la page de destination et les paramètres de connexion de base.

• Page de destination → page affichée à l’ouverture du chatbot.

📝 Note
Activez la fonctionnalité de devis rapide sur le site web.
Les utilisateurs peuvent sélectionner des articles, des configurations ou des finitions directement à partir du tarif et obtenir un total estimé en temps réel.

Fonctions principales :
• Activation du calcul dynamique des prix.
• Gestion des options de personnalisation (ex. couleur, finition, quantité).
• Affichage du récapitulatif du devis.
Les devis générés sont enregistrés automatiquement dans la section Pricelist Note de Pricelist Server.

🧠 CONSEILS OPÉRATIONNELS
• Vérifier l’activation correcte de la licence avant de lancer la synchronisation.
• Configurer l’environnement de développement séparément de celui de production.
• Mettre à jour périodiquement les données via la section Sync.
• Utiliser Vault uniquement avec des identifiants sécurisés et protégés.
• Contrôler périodiquement les utilisateurs configurés dans WP-User pour maintenir la cohérence entre WordPress et Pricelist Server.

Le bloc Price-list Description permet de montrer à l’intérieur des pages du site WordPress les descriptions des articles présents dans la liste de prix connectée à Pricelist Server. C’est l’un des blocs fondamentaux pour construire la structure de la liste de prix en ligne et permet de rappeler automatiquement les informations des produits, telles que descriptions, en-têtes et données techniques, via le code article ou la recherche textuelle.

🔹 ID
La section ID contient tous les paramètres de configuration principaux du bloc.
• ID : C’est le code unique attribué automatiquement au bloc. Il sert à l’identifier au sein de la page et ne peut pas être modifié manuellement.
• Tag : Détermine le type d’élément HTML qui contiendra le texte (par exemple, paragraphe, en-tête 1, en-tête 2, span, etc.). Il permet de définir la hiérarchie et le style sémantique du contenu.
• Style de police : Permet de sélectionner le style du texte parmi les options disponibles (Normal ou Gras).
• Code de liste de prix : C’est le champ qui relie le bloc à un article de la liste de prix. Le code ne peut pas être saisi manuellement, mais doit être sélectionné via une recherche (icône loupe 🔍). Il est possible de rechercher soit par texte (par exemple, partie de la description) soit par code neutre.
• Mode : Ce champ se remplit automatiquement après la sélection du code et indique le type de donnée récupérée. Il peut prendre les valeurs :
• Description de l’article → si la recherche a identifié un article.
• Description de l’en-tête → si la recherche a identifié une en-tête.
• Type de champ : Permet de sélectionner le type de champ à afficher, comme « Champ de description standard », « Champ technique », ou d’autres, selon les informations disponibles pour le produit.

🔹 Lien
La section Lien permet de rendre le bloc cliquable, en le liant à une ressource interne ou externe.
• Type : Définit le type de lien à appliquer. Les options disponibles sont :
• Page → lie le bloc à une page du site.
• Article → lie le bloc à un article WordPress.
• Lien personnalisé → permet d’insérer une URL personnalisée.
• Lié : En fonction du type sélectionné, permet de choisir la page, l’article ou l’adresse web à associer. Cela est utile, par exemple, pour lier un code article à la fiche produit correspondante ou à une catégorie du catalogue.

🔹 Phantom
La section Phantom permet de activer le mode réservé du bloc.
• Mode Phantom : Lorsqu’il est activé, le contenu du bloc est caché aux utilisateurs non enregistrés et reste visible uniquement pour ceux qui se sont connectés. Il est particulièrement utile pour gérer des contenus destinés exclusivement aux revendeurs, partenaires ou personnel interne (par exemple, prix réservés ou informations techniques).

🔹 Pricelist AI
La section Pricelist AI intègre le bloc avec le système d’intelligence artificielle de la liste de prix, permettant de générer des descriptions dynamiques ou des textes personnalisés basés sur les données de l’article.
• Contenu : Champ principal où l’on insère le prompt, c’est-à-dire le texte qui guide la génération automatique du contenu. Il est possible d’utiliser des balises dynamiques pour rappeler les données du produit sélectionné.
Exemple de prompt :
• Le code <COD> est un <st;A;des> du modèle <topic> avec largeur <diml>
• Charger le prompt enregistré / Enregistrer le prompt : Permettent respectivement de charger un prompt enregistré précédemment ou d’enregistrer un nouveau pour le réutiliser dans d’autres blocs.
• Aperçu : Affiche un aperçu du résultat final en remplaçant les balises par les valeurs réelles du produit connecté.
• Balises : Liste des champs disponibles pour le code article sélectionné (ex. COD, DIML, DIMP, DES, etc.), utilisables à l’intérieur du prompt.
• Sujet : Champ dédié au sujet de référence du prompt (par exemple modèle, collection ou catégorie). Permet de générer des textes plus cohérents et contextualisés par rapport au produit affiché.

Le bloc Price-list Table permet de visualiser les données de la liste de prix sous forme de tableau. Chaque tableau peut être entièrement personnalisé : nombre de lignes et de colonnes, contenu des cellules, données chargées depuis la liste de prix, images, liens, textes libres, descriptions et bien plus encore. C’est le bloc idéal pour créer des listes de prix structurées, des tableaux techniques, des grilles de produits ou des fiches configurables.

🔹 Structure du tableau
Le tableau est généré en fonction des paramètres saisis dans la section Paramètres du tableau :
• Rows number : nombre de lignes à générer
• Columns number : nombre de colonnes à générer
• Cell style : permet d’appliquer un style graphique aux cellules (bords, fonds, alignements)
Lors de l’enregistrement, le plugin génère automatiquement une liste de cellules avec un nom progressif :
Format des cellules :
cellule-
Exemples :
• Ligne 0 → cellule-00, cellule-01, cellule-02
• Ligne 1 → cellule-10, cellule-11, cellule-12
• …
• Ligne 5 → cellule-50, cellule-51, cellule-52
Chaque cellule peut être configurée de manière indépendante.

🔹 Sélection de la cellule
Après avoir généré le tableau :
1. Ouvrez le menu déroulant Cell.
2. Sélectionnez la cellule à configurer (ex. cellule-01).
3. En fonction du type de contenu choisi, la barre latérale affiche des paramètres différents.

🔹 Types de contenu disponibles
Pour chaque cellule, il est possible de sélectionner le type de contenu via le champ Type de cellule :
• Description de l’article
• Données de l’article
• Description de l’en-tête
• Prix
• Texte libre
• Image
Lorsqu’un type est sélectionné, la barre latérale affiche les paramètres correspondants à la catégorie.

🔸 CONFIGURATION DES CELLULES
Toutes les configurations possibles en fonction du contenu choisi sont décrites ci-dessous.

🟦 1. Description de l’article
Affiche une description de l’article lié.

Champs disponibles :
• Code de l’article : se sélectionne en cliquant sur la loupe et en recherchant :
• code neutre
• texte descriptif de l’article
• Mode : se remplit automatiquement
• Type de champ : sélectionne quel champ descriptif afficher (ex. description standard, description technique, langue, etc.).
• ROW SPAN / COL SPAN : Permettent de fusionner la cellule avec celles adjacentes :
• 0 = aucune fusion
• 1+ = fusion des cellules verticalement ou horizontalement

🟩 2. Données de l‘article
Afficher les informations d’identification du produit.

Exemples de champs sélectionnables :
• code article
• dimensions
• hauteur, largeur, profondeur
• informations supplémentaires
Fonctionne comme Description de l’article, avec recherche via loupe.

🟧 3. Description de l’en-tête
Affiche les descriptions appartenant aux en-têtes de la liste de prix.

Champs
• Code de l’en-tête : Recherche via la loupe, en sélectionnant un en-tête de la liste de prix.
• Type de champ : Champ descriptif de l’en-tête
• Lien :
• Type : sélection du type de contenu (Page, Post, Lien personnalisé)
• Lié : sélection de la page/post/URL
Utile pour rendre cliquables les catégories ou sections.

🟥 4. Prix
Affiche un prix provenant de la liste de prix.

Champs disponibles
• Code article : sélectionnable uniquement via recherche
• Colonne de prix : colonne de la liste de prix à utiliser

🟨 5. Texte libre
Insère du texte manuellement dans une cellule, ne sera pas traduit.

🟪 6. Image
Insère une image dans la cellule.

Sélection de l’image :
• L’image est sélectionnée depuis la Bibliothèque de Médias de WordPress.

Dimensions de l’image :
• Dimension automatique de l’image = ON –> Utilise les dimensions originales de l’image.
• Dimension automatique de l’image = OFF –> Permet de définir manuellement :
• largeur
• hauteur
• unité de mesure (px, %, vh, vw, etc.)

Préfixe / Suffixe :
Permettent de sélectionner une image basée sur le nom de fichier avec le suffixe ou préfixe indiqués.
Préfixe/suffixe permettent de trouver des variantes comme :
• AB01.jpg
• dessin_AB01.png
• AB01_schema.jpeg

Exemple :
Code article = AB01
Préfixe = dessin_
Suffixe = (vide)
Le plugin cherchera automatiquement dans la Bibliothèque de Médias un fichier contenant :
dessin_AB01.*

Remplacement récursif :
Utilisé pour le bloc récursif (expliqué dans le module suivant).
Si le remplacement récursif est actif, l’image reste celle sélectionnée, sans être remplacée automatiquement en fonction du code article sélectionné.

🔹 SAUVEGARDE
Le bouton Save cell se trouve à l’intérieur de l’écran de configuration de chaque cellule individuelle.
Il sert à sauvegarder :
• les paramètres de la cellule actuellement sélectionnée
• la configuration générale du tableau
• l’état actuel de la page WordPress

👉 Il est essentiel de cliquer sur “Save cell” avant de quitter la cellule sélectionnée, sinon les modifications apportées ne seront pas appliquées.

🔹 APERÇU
Cliquez sur Show Table pour voir l’aperçu du tableau avec les données générées.

Le bloc Price-list Recursive permet de générer automatiquement une série de tableaux répétés, à partir d’un modèle créé avec le bloc Price-list table et en l’appliquant à plusieurs codes article sélectionnés. Le résultat est une séquence de tableaux identiques dans la structure, mais avec des contenus différents selon le code associé.

Note importante : le bloc Recursive fonctionne uniquement sur les codes article, pas sur les en-têtes.

1. Gestion des associations
Ouverture du panneau
Cliquez sur Manage Associations pour ouvrir la fenêtre de gestion des codes.
Ajouter une association
1. Cliquez sur Add Association
2. Recherchez un code article par texte ou code
3. Cliquez sur Associer à côté du code souhaité
4. Répétez pour tous les codes nécessaires
5. Confirmez avec Save & Close
Ordre des associations
• Chaque code est inséré avec une position automatique (0,1,2,…)
• Vous pouvez la modifier via Move Up / Move Down
• L’ordre établi détermine l’ordre dans lequel les tableaux sont générés dans le frontend

2. Sélection du Modèle
Après avoir enregistré les associations, choisissez dans le menu Modèle quelle table (précédemment créée avec Price-list table) doit être utilisée pour chaque code.
Le modèle est obligatoire, car :
• il définit la structure des cellules
• il indique quels champs doivent être remplacés
• il permet au récursif de savoir quels éléments générer (textes, images, prix, etc.).

3. Préfixe/Suffixe image (attention !)
Dans le bloc Recursive, vous pouvez configurer :
• Préfixe d’image
• Suffixe d’image
Ces valeurs sont appliquées à TOUTES les images à l’intérieur du modèle.

⚠️ Attention
Si certaines cellules du modèle ont déjà un préfixe/suffixe spécifique, ajouter un préfixe/suffixe également dans le récursif pourrait :
• dupliquer les préfixes/suffixes,
• faire en sorte que l’image ne soit pas trouvée.
Règle pratique
• Si toutes les images doivent avoir un certain préfixe ou suffixe → configurez-le dans le Recursive.
• Si seules certaines images doivent l’avoir → configurez-le directement dans le tableau (modèle) et laissez vides Préfixe et Suffixe dans le Recursive.

4. Comment se fait la génération des tableaux
Pour chaque code associé :
1. Le système clone le modèle
2. Remplace automatiquement les champs des cellules (ex. code, dim, image, description, etc.)
3. Applique des préfixes/suffixes aux images (si configurés dans le Recursive)
4. Affiche sur la page une séquence de tableaux, un pour chaque code

Exemple :
Vous avez sélectionné les codes AB01, AB02, AB03
→ Trois tableaux identiques dans la structure seront générés mais avec :
• code différent
• descriptions différentes
• images avec le nom AB01 / AB02 / AB03
• contenus textuels adaptés automatiquement

5. Champs AI
Le Recursive ne contient pas de champ “content” : le texte AI se trouve dans le modèle, où il sera écrit de manière dynamique (par exemple, avec des balises AI comme <COD>, <DES&gt; <diml&gt; etc.).
Seul le sujet général peut être appliqué.
Le Recursive se limite à transmettre les valeurs correctes pour chaque code.

6. Sortie finale (rendu)
À la publication, le bloc affichera :
• un tableau pour chaque code
• selon l’ordre décidé
• avec les données et images correctement remplacées

Le bloc Price-list Single Price permet de montrer un prix unique extrait de la liste de prix, pour un article spécifique et pour une colonne de prix choisie. Il est utilisé par exemple lorsque vous souhaitez afficher le prix d’un produit dans une page de détail ou dans une fiche produit.

⚙️ PARAMÈTRES DU BLOC

🔎 Code de la liste de prix
Champ de recherche qui vous permet de sélectionner uniquement par recherche le code article.
👉 Vous ne pouvez pas le saisir manuellement.
Vous pouvez rechercher par :
• texte de la description
• code neutre
Une fois un résultat sélectionné, le bloc se connecte automatiquement à l’article.

🧱 Colonne
Sélectionnez de quelle colonne de prix extraire la valeur.

📌 À quoi ça sert ?
De nombreuses entreprises utilisent plusieurs colonnes pour gérer différents prix :
• matériaux différents
• variantes
• tranches de prix

Exemple :
• Colonne 001 → prix en mélaminé
• Colonne 002 → prix en marbre
👉 Avec ce champ, choisissez exactement quel prix afficher.

💱 Devise

Le symbole de la devise :
• est décidé par le serveur de liste de prix (ex. €, $, CHF…)
• peut être activé ou désactivé dans les paramètres du plugin WordPress (options ON/OFF)

👉 le bloc ne gère pas directement la devise, mais uniquement l’affichage.