https://wiki.dolibarr.org/api.php?action=feedcontributions&feedformat=atom&user=AbahfirDolibarr ERP CRM Wiki - User contributions [en]2026-10-23T06:01:09ZUser contributionsMediaWiki 1.39.17https://wiki.dolibarr.org/index.php?title=Label_Designer_FR&diff=67553Label Designer FR2026-09-30T12:20:00Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module :</strong> 1.0.0<br><strong>Compatibilité déclarée :</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire :</strong> 2026-09-30</p><br />
<p><strong>Vidéo de démonstration :</strong></p><br />
<youtube width="560" height="315">Hcec6UGBJtI</youtube><br />
<p><strong>Site de démonstration :</strong> [https://01consulting.eu/demo/htdocs/ Ouvrir le site]</p><br />
<p><strong>Site officiel de l’éditeur :</strong> [https://01consulting.eu 01consulting.eu]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement : il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.1 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires :<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné : produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche :<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code, de 32 à 2048 pixels ; valeur par défaut : 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur :</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités :<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong> : active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong> : remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde :</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
<h2>17. Assistance</h2><br />
<p>Pour obtenir de l’aide, transmettre la version du module et de Dolibarr, les étapes pour reproduire le problème et le message d’erreur après avoir retiré toute donnée sensible. Contacter le support à [mailto:contact@01consulting.eu contact@01consulting.eu]. Site de l’éditeur : [https://01consulting.eu 01consulting.eu].</p><br />
</div></div><br />
[[en:Label_Designer]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67552Label Designer2026-09-30T12:19:29Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Label Designer User Guide</h1><br />
<p style="line-height:1.6;"><strong>Module version:</strong> 1.0.0<br><strong>Declared compatibility:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Last documentation review:</strong> 2026-09-30</p><br />
<p><strong>Demo video:</strong></p><br />
<youtube width="560" height="315">Hcec6UGBJtI</youtube><br />
<p><strong>Demo site:</strong> [https://01consulting.eu/demo/htdocs/ Open the demo site]</p><br />
<p><strong>Publisher website:</strong> [https://01consulting.eu 01consulting.eu]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">This guide describes, step by step, how to install, configure, and use Label Designer 1.0.0 for Dolibarr.</p><br />
<h2 id="sec-1">1. Module overview</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer lets you visually create label templates and generate PDF files using data stored in Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The module supports four object types:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">products and services;</li><li style="margin:0 0 4px 0;">product batches;</li><li style="margin:0 0 4px 0;">warehouses;</li><li style="margin:0 0 4px 0;">third parties (customers and suppliers).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">One template is created for each object type and reused automatically. You do not need a separate label for every product, batch, warehouse, or third party. When a PDF is generated, template variables are replaced with the current object's data.</p><br />
<h2 id="sec-2">2. Requirements</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Before installation, check that:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 or later is installed;</li><li style="margin:0 0 4px 0;">PHP 7.1 or later is available;</li><li style="margin:0 0 4px 0;">Dolibarr's <strong>Barcodes</strong> module is available;</li><li style="margin:0 0 4px 0;">the web server can write to the Dolibarr documents directory.</li></ul><br />
<h2 id="sec-3">3. Installation and activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copy the <code>labeldesigner</code> directory to <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Sign in to Dolibarr with an administrator account.</li><li style="margin:0 0 4px 0;">Go to <strong>Home &gt; Setup &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Find <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Enable the module.</li><li style="margin:0 0 4px 0;">Make sure the <strong>Barcodes</strong> module is also enabled.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">When activated, Label Designer prepares its storage directory in Dolibarr documents and enables barcode use for products and third parties.</p><br />
<h2 id="sec-4">4. Configure user permissions</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the relevant user or group record.</li><li style="margin:0 0 4px 0;">Open the <strong>Permissions</strong> tab.</li><li style="margin:0 0 4px 0;">Grant the required Label Designer permissions:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">read labels;</li><li style="margin:0 0 4px 0;">create and modify templates and PDFs.</li></ul></li><li style="margin:0 0 4px 0;">Make sure the user can also view the relevant object: product, batch, warehouse, or third party.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Without permission to view the object, some data or variables may not be available.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">After an update that adds or changes module permissions, disable and re-enable Label Designer so Dolibarr registers the new permissions. You can then grant <strong>Read labels</strong> and <strong>Create labels</strong> separately to users and groups.</p><br />
<h2 id="sec-5">5. Open a label</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open a product, batch, warehouse, or third-party record.</li><li style="margin:0 0 4px 0;">Click the <strong>Label</strong> tab provided by Label Designer.</li><li style="margin:0 0 4px 0;">The page displays:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">label settings;</li><li style="margin:0 0 4px 0;">the <strong>Card Designer</strong> button;</li><li style="margin:0 0 4px 0;">the <strong>Reset settings</strong> button;</li><li style="margin:0 0 4px 0;">the generated PDF files area;</li><li style="margin:0 0 4px 0;">the <strong>Generate</strong> button.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If another module also adds a tab named <strong>Label</strong>, identify the Label Designer tab by its URL or content.</p><br />
<h2 id="sec-6">6. Set label parameters</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Settings are stored separately for each object type.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Setting</th><th style="padding:10px;border:1px solid #dee2e6;">Purpose</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document width</td><td style="padding:10px;border:1px solid #dee2e6;">Final label width, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document height</td><td style="padding:10px;border:1px solid #dee2e6;">Final label height, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode width</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode width in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode height</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode height in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Bar width</td><td style="padding:10px;border:1px solid #dee2e6;">Visual bar thickness, from 0.2 to 1.0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Pixel size</td><td style="padding:10px;border:1px solid #dee2e6;">QR code image resolution, from 32 to 2048 pixels; default: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Show barcode value</td><td style="padding:10px;border:1px solid #dee2e6;">Shows or hides the text below the barcode</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels horizontally</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed horizontally in the final PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels vertically</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed vertically in the final PDF</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To change a value:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Click the pencil icon.</li><li style="margin:0 0 4px 0;">Enter the new value.</li><li style="margin:0 0 4px 0;">Confirm the change.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Barcode and QR code dimensions are synchronized with the Card Designer template. Changing them in the settings updates the template; changing their size in Card Designer also updates the related settings.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Reset settings</strong> button restores the defaults for the displayed object type.</p><br />
<h2 id="sec-7">7. Create a template in Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The supplied templates are empty so that users can create their own labels.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">On the <strong>Label</strong> tab, set the document width and height first.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Use the toolbar to add the elements you need:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Shapes</strong> to add graphical shapes;</li><li style="margin:0 0 4px 0;"><strong>Text</strong> to add free text;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> to add dynamic Dolibarr data;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> to use an uploaded image;</li><li style="margin:0 0 4px 0;"><strong>Stickers</strong> to add a decorative element;</li><li style="margin:0 0 4px 0;"><strong>Color</strong> to change an element's color;</li><li style="margin:0 0 4px 0;"><strong>Align</strong> to position elements;</li><li style="margin:0 0 4px 0;"><strong>Delete</strong> to remove the selected element.</li></ul></li><li style="margin:0 0 4px 0;">Move and resize each element directly on the canvas.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirm the save.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Saving creates only the JSON template; it does not generate a PDF. After confirmation, Card Designer returns to the object record.</p><br />
<h2 id="sec-8">8. Add dynamic variables</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">In Card Designer, click <strong>Product variables</strong>, <strong>Batch variables</strong>, <strong>Warehouse variables</strong>, or <strong>Third-party variables</strong>, depending on the open object. Then click a variable to add it to the template.</p><br />
<h3 id="sec-8-1">8.1. Product variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">price excluding tax;</li><li style="margin:0 0 4px 0;">price including tax;</li><li style="margin:0 0 4px 0;">VAT rate;</li><li style="margin:0 0 4px 0;">category;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">product extra fields.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Prices and the VAT rate are formatted with two decimal places.</p><br />
<h3 id="sec-8-2">8.2. Batch variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">batch reference;</li><li style="margin:0 0 4px 0;">linked product reference;</li><li style="margin:0 0 4px 0;">product label;</li><li style="margin:0 0 4px 0;">product description;</li><li style="margin:0 0 4px 0;">use-by date (DLC);</li><li style="margin:0 0 4px 0;">best-before date (DMD/DLUO);</li><li style="margin:0 0 4px 0;">barcode generated from the batch reference;</li><li style="margin:0 0 4px 0;">QR code generated from the batch reference;</li><li style="margin:0 0 4px 0;">batch extra fields.</li></ul><br />
<h3 id="sec-8-3">8.3. Warehouse variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">location and address;</li><li style="margin:0 0 4px 0;">postal code and city;</li><li style="margin:0 0 4px 0;">linked project, project reference and title;</li><li style="margin:0 0 4px 0;">categories or tags;</li><li style="margin:0 0 4px 0;">barcode generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">QR code generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">warehouse extra fields.</li></ul><br />
<h3 id="sec-8-4">8.4. Third-party variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">third-party name;</li><li style="margin:0 0 4px 0;">customer code;</li><li style="margin:0 0 4px 0;">supplier code;</li><li style="margin:0 0 4px 0;">address, postal code, and city;</li><li style="margin:0 0 4px 0;">email address and phone number;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">third-party extra fields.</li></ul><br />
<h3 id="sec-8-5">8.5. Extra fields</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Extra fields configured in Dolibarr are automatically added to the variables for that object. Their technical names are associated with readable labels in Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If an extra field is empty for the current object, its placeholder may still appear in Card Designer, but no value is printed in the PDF.</p><br />
<h2 id="sec-9">9. Use barcodes and QR codes</h2><br />
<h3>Products and third parties</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code are available only when:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Barcodes module is enabled;</li><li style="margin:0 0 4px 0;">barcode use is enabled for the relevant object type in Dolibarr setup;</li><li style="margin:0 0 4px 0;">the object has a barcode value.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If a product or third party has no barcode, Card Designer may show the variable name as a placeholder, but no fictitious code is printed in the PDF.</p><br />
<h3>Batches and warehouses</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code use the batch or warehouse reference. If the reference is empty, the corresponding area in the PDF is blank.</p><br />
<h3>QR code pixel size</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pixel size controls the resolution of the generated QR code image. A higher value improves sharpness when enlarged but increases the data size. The default value of 250 is suitable for most labels.</p><br />
<h2 id="sec-10">10. Upload and use photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">In Card Designer, click <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">An upload QR code appears.</li><li style="margin:0 0 4px 0;">Scan it with a phone or open the upload page directly.</li><li style="margin:0 0 4px 0;">Select PNG, JPG, or JPEG images to upload.</li><li style="margin:0 0 4px 0;">Confirm the upload.</li><li style="margin:0 0 4px 0;">Return to Card Designer and reopen the <strong>Photos</strong> library if needed.</li><li style="margin:0 0 4px 0;">Click the photo to insert it into the label.</li><li style="margin:0 0 4px 0;">Move and resize the image, then save the template.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The upload page only sends files. Photo layout is done afterward in Card Designer.</p><br />
<h2 id="sec-11">11. Generate the PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the record to print.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Check the settings and object data.</li><li style="margin:0 0 4px 0;">Click <strong>Generate</strong>.</li><li style="margin:0 0 4px 0;">The module loads the template for that object type.</li><li style="margin:0 0 4px 0;">Variables are replaced with the current object's data.</li><li style="margin:0 0 4px 0;">The PDF is generated with Fabric.js and jsPDF.</li><li style="margin:0 0 4px 0;">The file appears in the <strong>Attached files</strong> area.</li><li style="margin:0 0 4px 0;">Click the PDF name or preview icon to view it.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The same template can generate labels for multiple objects in succession. The horizontal and vertical label counts apply only to the final PDF, repeating the label without changing the Card Designer template.</p><br />
<h2 id="sec-12">12. Modify an existing template</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open any object of the relevant type.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Edit the template.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong> and confirm.</li><li style="margin:0 0 4px 0;">Generate the PDF again.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The change applies to future labels of the same type. Previously generated PDFs are not updated automatically.</p><br />
<h2 id="sec-13">13. Configure Bluetooth printing</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Home &gt; Setup &gt; Modules/Applications &gt; Label Designer</strong> page has two options:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner on Bluetooth printer</strong>: enables the features intended for Bluetooth printing;</li><li style="margin:0 0 4px 0;"><strong>Replace accented characters on Bluetooth printers</strong>: replaces characters that some printers cannot print correctly.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Bluetooth printing is disabled by default. The second option is useful only when the first is enabled and the printer has trouble with accented characters.</p><br />
<h2 id="sec-14">14. Design tips</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Set the document dimensions before starting the layout.</li><li style="margin:0 0 4px 0;">Leave a margin around the label to avoid print cutoffs.</li><li style="margin:0 0 4px 0;">Do not stretch a barcode or QR code excessively.</li><li style="margin:0 0 4px 0;">Print a test and check that scanners can read the codes.</li><li style="margin:0 0 4px 0;">Use clear images without unnecessarily high resolution.</li><li style="margin:0 0 4px 0;">Leave enough room for variables whose length changes between objects.</li><li style="margin:0 0 4px 0;">Save the template before leaving Card Designer.</li></ul><br />
<h2 id="sec-15">15. Troubleshooting</h2><br />
<h3>The Save button returns an HTTP 500 error</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the web server can write to the Dolibarr documents directory, especially the folder reserved for Label Designer templates. Disabling and re-enabling the module may recreate the required folder. Also check the PHP or web server log for the exact message.</p><br />
<h3>The PDF is blank</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that a template containing elements has been saved for this object type. Templates installed by default are intentionally empty.</p><br />
<h3>A variable appears in Card Designer but is missing from the PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the field is populated on the object used to generate the PDF. An empty variable is not replaced with a fictitious value.</p><br />
<h3>Extra fields are not visible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that extra fields are enabled for the correct object type and that the user has the required permissions. Reload Card Designer after adding a new field.</p><br />
<h3>The barcode or QR code is unavailable</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">For a product or third party, check that the Barcodes module is enabled, barcode use is enabled for that object type, and the record has a value. For a batch or warehouse, check that its reference is not empty.</p><br />
<h3>A size change does not seem to apply</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Save the value, reload Card Designer if it was already open, then generate a new PDF. Make sure you are viewing the latest file.</p><br />
<h3>The page shows an old version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Hard-refresh the browser page. If needed, clear the Dolibarr and browser caches.</p><br />
<h2 id="sec-16">16. Storage and backups</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Card Designer templates are stored as JSON files in the module's directory under Dolibarr documents. Generated PDFs are stored with the documents associated with each object.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To back up the module configuration, include the following in your backup plan:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Dolibarr database;</li><li style="margin:0 0 4px 0;">the Dolibarr documents directory;</li><li style="margin:0 0 4px 0;">the Label Designer module directory.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Do not manually edit JSON files while a user is working in Card Designer.</p><br />
<h2>17. Support</h2><br />
<p>When requesting help, provide the module and Dolibarr versions, the steps to reproduce the issue, and the error message with sensitive data removed. Contact support at [mailto:contact@01consulting.eu contact@01consulting.eu]. Publisher website: [https://01consulting.eu 01consulting.eu].</p><br />
</div></div><br />
[[fr:Label_Designer_FR]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Odoo_Payroll_FR&diff=67486Odoo Payroll FR2026-09-29T16:26:08Z<p>Abahfir: module odoo payroll fr</p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Odoo Payroll — Paie pour Dolibarr</h1><br />
<p><strong>Résumé :</strong> gestion des règles et structures salariales, contrats de paie et bulletins pour les utilisateurs internes de Dolibarr.<br><strong>Version du module :</strong> 1.0.0<br><strong>Version minimale de Dolibarr déclarée :</strong> 18.0<br><strong>Version minimale de PHP déclarée :</strong> 7.4<br><strong>Versions effectivement vérifiées :</strong> aucune version de Dolibarr ou PHP n’a été testée pendant cette vérification documentaire.<br><strong>Dernière vérification :</strong> 2026-09-29</p><br />
<p><strong>Site officiel de l’éditeur :</strong> [https://01consulting.eu 01 Consulting]</p><br />
<p><strong>Vidéo de démonstration :</strong></p><br />
<youtube width="560" height="315">aeqG94iA8yQ</youtube><br />
<br />
<h2>1. Présentation</h2><br />
<p>Odoo Payroll est un module de paie natif pour Dolibarr, développé par 01 Consulting. Malgré son nom, il s’installe dans Dolibarr et ne nécessite pas d’instance Odoo. Il permet de configurer les catégories et règles de salaire, de les réunir dans des structures, de rattacher ces structures à des contrats d’employés et de calculer des bulletins de paie.</p><br />
<p>Le moteur fournit un cadre de calcul configurable ; il ne fournit pas une garantie de conformité à une législation, à une convention collective ou à un barème fiscal ou social. Les règles CNAS, IRG et autres obligations applicables doivent être conçues et approuvées par un spécialiste de la paie avant utilisation en production.</p><br />
<br />
<h2>2. Fonctionnalités</h2><br />
<ul><br />
<li>Catégories de règles salariales, éventuellement hiérarchisées.</li><br />
<li>Structures salariales composées de règles et pouvant hériter d’une structure parente.</li><br />
<li>Règles conditionnelles à montant fixe, en pourcentage ou exprimées par une formule arithmétique contrôlée.</li><br />
<li>Contrats associés aux utilisateurs Dolibarr, avec salaire, heures hebdomadaires, période, type et département.</li><br />
<li>Calcul des lignes de bulletin, du brut et du net, avec validation et états de suivi.</li><br />
<li>Création individuelle de bulletins et génération en série à partir d’un lot.</li><br />
<li>Retour d’un bulletin validé au brouillon, annulation des bulletins validés et actions de masse, selon les permissions et réglages.</li><br />
<li>Génération d’un PDF de bulletin et association avec le paiement de salaire natif de Dolibarr.</li><br />
<li>Onglet Paie dans la fiche utilisateur, profils d’import et filtrage des données par entité active.</li><br />
</ul><br />
<br />
<h2>3. Prérequis et compatibilité</h2><br />
<ul><br />
<li><strong>Dolibarr :</strong> le descripteur déclare Dolibarr 18.0 comme version minimale. La version réellement vérifiée dans le cadre de ce wiki est « aucune ».</li><br />
<li><strong>PHP :</strong> le descripteur déclare PHP 7.4 comme version minimale ; aucune exécution n’a été testée pendant la rédaction.</li><br />
<li><strong>Modules Dolibarr requis :</strong> Utilisateurs (<code>modUser</code>) et Salaires (<code>modSalaries</code>).</li><br />
<li><strong>Base de données :</strong> l’initialisation crée des triggers avec une syntaxe MySQL/MariaDB. La compatibilité des triggers avec d’autres moteurs SQL n’est pas établie. Le compte de base de données doit pouvoir créer et supprimer des triggers.</li><br />
<li><strong>Documents :</strong> le processus de génération doit pouvoir créer des fichiers dans le répertoire de sortie du module sous les documents Dolibarr.</li><br />
</ul><br />
<br />
<h2>4. Installation, mise à jour et désactivation</h2><br />
<h3>4.1. Installation et activation</h3><br />
<ol><br />
<li>Vérifier que les modules Dolibarr <strong>Utilisateurs</strong> et <strong>Salaires</strong> sont disponibles.</li><br />
<li>Installer le dossier du module dans <code>htdocs/custom/payroll</code> ou dans le répertoire personnalisé configuré pour les modules externes.</li><br />
<li>Dans Dolibarr, ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>, rechercher <strong>Payroll</strong> ou <strong>Paie</strong>, puis activer le module.</li><br />
<li>À l’activation, le module charge ses tables SQL, complète certaines colonnes de contrat manquantes, ajoute le champ supplémentaire de liaison bulletin-salaire et tente de créer trois triggers sur les tables de salaires.</li><br />
<li>Vérifier que le menu <strong>RH &gt; Paie</strong> apparaît et que la page de configuration s’ouvre. Avant un traitement réel, réaliser un calcul complet avec des données de test et vérifier les PDF ainsi que les triggers de paiement.</li><br />
</ol><br />
<p>L’activation met également en place les menus, les droits et les profils d’import. Si la création des triggers échoue, les changements d’état automatiques liés au paiement ne fonctionneront pas correctement ; consulter l’erreur de base de données et les journaux Dolibarr.</p><br />
<br />
<h3>4.2. Mise à jour</h3><br />
<ol><br />
<li>Sauvegarder la base Dolibarr et les documents avant de remplacer les fichiers du module.</li><br />
<li>Installer les fichiers de la nouvelle version. Réactiver le module si l’initialisation des tables, des colonnes supplémentaires ou des triggers doit être rejouée.</li><br />
<li>Contrôler les catégories, règles, contrats et bulletins existants ainsi que les triggers sur les tables de salaires.</li><br />
<li>Générer un bulletin de test, ouvrir son PDF et vérifier le chemin d’enregistrement et les permissions utilisateur.</li><br />
</ol><br />
<p>Le script d’activation vérifie et ajoute certaines colonnes de contrat et rend obligatoire la catégorie des règles après avoir essayé d’affecter une catégorie aux règles orphelines. Les migrations détaillées dépendent de la version précédente et du schéma déjà installé ; une sauvegarde est nécessaire avant l’opération.</p><br />
<br />
<h3>4.3. Désactivation et suppression</h3><br />
<p>La désactivation masque le champ supplémentaire de liaison sur les salaires et supprime les trois triggers créés par le module. Le traitement de désactivation ne supprime pas les tables de paie. Le comportement d’une suppression manuelle des tables ou du dossier du module n’est pas établi ; ne pas supprimer ces données sans sauvegarde et procédure de migration définie.</p><br />
<br />
<h2>5. Configuration</h2><br />
<p>Ouvrir la page <strong>Configuration</strong> du module depuis Dolibarr. L’accès est réservé aux administrateurs ou aux utilisateurs disposant du droit <code>payroll-&gt;setup</code>. Les valeurs indiquées ci-dessous sont les valeurs initiales déclarées par le module ou les replis utilisés par l’écran ; une valeur déjà enregistrée dans une entité peut être différente.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Réglage</th><th style="padding:8px;border:1px solid #dee2e6;">Initialisation ou repli</th><th style="padding:8px;border:1px solid #dee2e6;">Effet</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Numérotation des bulletins</td><td style="padding:8px;border:1px solid #dee2e6;">Modèle standard ; masque déclaré <code>PSL{00000}</code>. L’écran utilise <code>PAY{00000}</code> comme valeur de repli si aucun masque n’est enregistré.</td><td style="padding:8px;border:1px solid #dee2e6;">Définit la référence générée pour les bulletins. Contrôler la valeur dans l’écran après installation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Numérotation des contrats</td><td style="padding:8px;border:1px solid #dee2e6;">Modèle standard, masque <code>CTR{00000}</code>.</td><td style="padding:8px;border:1px solid #dee2e6;">Définit la référence des contrats.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Désactivé (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Autorise le retour au brouillon et l’annulation d’un bulletin validé.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_CONFIRM_PAYSLIPS_WITHOUT_RECOMPUTING</code></td><td style="padding:8px;border:1px solid #dee2e6;">Activé (<code>1</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Empêche le recalcul automatique lors de la validation. Quand l’option est désactivée, la validation recalcule le bulletin.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code></td><td style="padding:8px;border:1px solid #dee2e6;">Désactivé (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Autorise, si activé, la modification manuelle de certains champs des lignes d’un brouillon.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Compte bancaire par défaut</td><td style="padding:8px;border:1px solid #dee2e6;">Aucun.</td><td style="padding:8px;border:1px solid #dee2e6;">Valeur proposée dans le parcours de paiement ; le réglage est affiché si le module Banque est activé.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Mode de paiement par défaut</td><td style="padding:8px;border:1px solid #dee2e6;">Aucun.</td><td style="padding:8px;border:1px solid #dee2e6;">Mode proposé dans le parcours de paiement des salaires.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Types de contrat et départements</td><td style="padding:8px;border:1px solid #dee2e6;">Dictionnaires gérés dans la configuration.</td><td style="padding:8px;border:1px solid #dee2e6;">Ajoutez des codes et libellés actifs ; une entrée utilisée par un contrat ne peut pas être supprimée.</td></tr><br />
</table><br />
<p>Les masques de référence doivent contenir au moins quatre zéros entre accolades, par exemple <code>PAY{00000}</code>. Les modèles de numérotation disponibles peuvent être sélectionnés dans l’écran. Les constantes de configuration sont enregistrées pour l’entité Dolibarr courante.</p><br />
<br />
<h2>6. Préparer la configuration de paie</h2><br />
<h3>6.1. Catégories</h3><br />
<ol><br />
<li>Dans <strong>RH &gt; Paie &gt; Catégories de règles salariales</strong>, créer une catégorie avec un code et un libellé.</li><br />
<li>Choisir éventuellement une catégorie parente pour organiser la hiérarchie.</li><br />
<li>Activer ou désactiver la catégorie selon son usage.</li><br />
</ol><br />
<p>Les codes sont utilisés dans les formules comme des variables de total préfixées par <code>CAT_</code>, par exemple <code>CAT_BASIC</code>. Un code utilisable dans une formule doit suivre les caractères acceptés par l’écran et les profils d’import.</p><br />
<br />
<h3>6.2. Structures salariales</h3><br />
<ol><br />
<li>Dans <strong>Structures</strong>, créer une structure avec une référence et un libellé.</li><br />
<li>Associer les règles à la structure et définir leur ordre de séquence.</li><br />
<li>Si nécessaire, choisir une structure parente. Le moteur récupère les règles liées à la structure et à sa chaîne de structures parentes.</li><br />
<li>Enregistrer la structure, puis l’affecter à un contrat.</li><br />
</ol><br />
<p>Une structure référencée par un contrat ou par une structure enfant est protégée contre la suppression par les contrôles du module.</p><br />
<br />
<h3>6.3. Règles de salaire et calcul</h3><br />
<p>Une règle possède un code, un libellé, une catégorie, un numéro de séquence, une condition et un type de calcul. Seules les règles actives liées à la structure sont chargées. Le calcul s’effectue par séquence croissante ; les règles déjà calculées sont accessibles sous leur code dans les règles suivantes.</p><br />
<ul><br />
<li><strong>Condition toujours vraie :</strong> applique la règle sans condition supplémentaire.</li><br />
<li><strong>Plage :</strong> compare le salaire aux bornes minimale et maximale configurées ; les bornes sont inclusives.</li><br />
<li><strong>Expression :</strong> évalue une condition comme <code>WAGE &gt;= 90000</code>.</li><br />
<li><strong>Montant fixe :</strong> montant configuré multiplié par l’expression de quantité ; la quantité par défaut dans les données du modèle est <code>1</code>.</li><br />
<li><strong>Pourcentage :</strong> applique un taux à une expression de base ; un pourcentage négatif peut représenter une retenue.</li><br />
<li><strong>Formule :</strong> évalue une expression arithmétique configurée.</li><br />
<li><strong>Afficher sur le bulletin :</strong> détermine si la ligne correspondante apparaît sur le PDF.</li><br />
</ul><br />
<p>Le moteur accepte les nombres, variables, parenthèses et opérateurs <code>+ - * /</code>. Les opérateurs de comparaison <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>==</code> et <code>!=</code> sont acceptés dans une condition. Il n’exécute ni PHP ni Python ni des fonctions arbitraires. Une variable inconnue, un opérateur invalide ou une division par zéro interrompt le calcul avec une erreur.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Variable</th><th style="padding:8px;border:1px solid #dee2e6;">Valeur utilisée</th><th style="padding:8px;border:1px solid #dee2e6;">Exemple</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Salaire du contrat associé au bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORK_HOURS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Heures hebdomadaires du contrat.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE / WORK_HOURS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Nombre de jours travaillés indiqué sur le bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE * WORKED_DAYS / MONTH_DAYS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>MONTH_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Nombre de jours du lundi au vendredi dans la période du bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS / MONTH_DAYS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Codes de règles antérieures</td><td style="padding:8px;border:1px solid #dee2e6;">Montant calculé par une règle précédente dans l’ordre de séquence.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>BASIC + PRIME</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_CODE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Total calculé pour une catégorie ; un total vide commence à zéro.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_BASIC + CAT_ALW + CAT_DED</code></td></tr><br />
</table><br />
<p><code>MONTH_DAYS</code> ne retire pas les jours fériés : seuls les samedis et dimanches sont exclus. Les exemples de formules sont des exemples de syntaxe et ne constituent pas des recommandations de barème.</p><br />
<p>Le brut et le net sont alimentés à partir des règles portant les codes <code>GROSS</code> et <code>NET</code>. Si ces règles ne fournissent pas les totaux, le moteur utilise les catégories portant ces codes comme solution de repli.</p><br />
<br />
<h3>6.4. Contrats</h3><br />
<ol><br />
<li>Dans <strong>Contrats</strong>, créer un contrat pour un utilisateur interne Dolibarr.</li><br />
<li>Renseigner la structure, le salaire, le nombre d’heures hebdomadaires, la date de début et, si applicable, la date de fin.</li><br />
<li>Choisir éventuellement un type de contrat et un département dans les dictionnaires configurés.</li><br />
<li>Enregistrer et activer le contrat lorsqu’il doit être proposé pour la génération d’un lot.</li><br />
</ol><br />
<p>Un contrat doit avoir un employé et une date de début. Les formulaires et classes du module empêchent de supprimer certains objets encore référencés, notamment un contrat associé à des bulletins.</p><br />
<br />
<h2>7. Gérer les bulletins de paie</h2><br />
<h3>7.1. Créer et calculer un bulletin individuel</h3><br />
<ol><br />
<li>Ouvrir <strong>RH &gt; Paie &gt; Bulletins salariés</strong>, puis créer un bulletin.</li><br />
<li>Sélectionner l’employé, son contrat, la période et le nombre de jours travaillés. La création d’un bulletin nécessite le droit <code>payroll-&gt;write</code>.</li><br />
<li>Enregistrer le bulletin ; il commence au statut <strong>Brouillon</strong>.</li><br />
<li>Cliquer sur <strong>Calculer</strong>. Le calcul exige un contrat et une structure salariale disponible. Si la structure n’est pas encore enregistrée sur le bulletin, celle du contrat lui est affectée.</li><br />
<li>Contrôler les lignes, le brut et le net. Tant que le bulletin est brouillon, corriger la configuration ou les données, puis recalculer.</li><br />
<li>Valider avec un utilisateur disposant du droit <code>payroll-&gt;validate</code>. Vérifier le résultat avant validation, car le réglage initial empêche le recalcul pendant cette étape.</li><br />
</ol><br />
<p>En cas de période inversée, de contrat ou structure manquant, de variable inconnue ou d’expression invalide, le calcul affiche une erreur et ne doit pas être considéré comme terminé.</p><br />
<br />
<h3>7.2. Générer des bulletins par lot</h3><br />
<ol><br />
<li>Ouvrir <strong>RH &gt; Paie &gt; Lots de bulletins</strong> et créer un lot avec un libellé et une période valide.</li><br />
<li>Sur la fiche du lot, lancer <strong>Générer</strong>. Le module sélectionne les contrats actifs ayant une structure, dont les dates couvrent tout ou partie de la période du lot, et pour lesquels le lot ne contient pas encore de bulletin.</li><br />
<li>Le module crée un brouillon par contrat éligible avec <strong>22 jours travaillés</strong>, puis tente de calculer les bulletins brouillons du lot. Vérifier et corriger les jours travaillés lorsque la situation réelle diffère.</li><br />
<li>Examiner les erreurs de calcul et corriger les contrats, structures ou règles concernés avant de valider.</li><br />
<li>Valider les bulletins du lot. L’action est refusée si aucun brouillon n’est présent ou si un brouillon n’a aucune ligne calculée. Lorsque la validation réussit, le lot passe à l’état fermé.</li><br />
</ol><br />
<p>Une génération répétée dans le même lot n’ajoute pas un second bulletin pour un contrat déjà présent dans ce lot. Cette vérification porte sur le contrat et le lot ; elle ne constitue pas une protection générale contre deux lots couvrant la même période.</p><br />
<br />
<h3>7.3. États, retour au brouillon et annulation</h3><br />
<ul><br />
<li><strong>Brouillon (0) :</strong> calculable et supprimable individuellement ; les lignes peuvent être modifiées si <code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code> est activé.</li><br />
<li><strong>Validé (1) :</strong> état obtenu après validation. L’action de validation peut recalculer ou non selon le réglage mentionné ci-dessus.</li><br />
<li><strong>Payé (2) :</strong> état associé au paiement Dolibarr lorsque le bulletin est relié au salaire correspondant.</li><br />
<li><strong>Annulé (9) :</strong> état de bulletin annulé.</li><br />
</ul><br />
<p>Avec <code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code> activé, un utilisateur ayant le droit de validation peut ramener un bulletin validé au brouillon, l’annuler, et utiliser l’action de masse <strong>Retourner au brouillon</strong> dans la liste des bulletins. L’action de masse ne traite que les bulletins validés sélectionnés. Le code de l’action individuelle ne vérifie que le droit et le réglage avant de changer l’état ; contrôler le bulletin et son éventuel salaire lié avant de l’utiliser.</p><br />
<p>Un bulletin payé ne doit pas être traité comme un bulletin validé ordinaire : la synchronisation du salaire peut modifier son état et le lot ne peut pas être rouvert ou supprimé s’il contient des bulletins payés. La suppression individuelle d’un bulletin est réservée aux brouillons et supprime aussi ses lignes de calcul.</p><br />
<br />
<h3>7.4. Rouvrir ou supprimer un lot</h3><br />
<p>Un lot fermé peut être rouvert par un utilisateur ayant le droit de validation si aucun de ses bulletins n’est payé. La réouverture remet les bulletins validés du lot au brouillon. La suppression d’un lot par un utilisateur ayant le droit de suppression supprime le lot, ses bulletins et leurs lignes ; elle est refusée en présence d’un bulletin payé. Cette suppression est définitive : vérifier la liste affichée dans la confirmation avant de poursuivre.</p><br />
<br />
<h2>8. Fiche employé, paiement et PDF</h2><br />
<h3>8.1. Onglet Paie de l’employé</h3><br />
<p>Le module ajoute un onglet <strong>Paie</strong> à la fiche utilisateur. Un utilisateur ayant le droit de lecture Paie peut consulter l’onglet ; l’employé peut également ouvrir sa propre fiche. L’onglet liste ses contrats et bulletins. Les boutons de création sont conditionnés par le droit d’écriture <code>payroll-&gt;write</code>. La page applique le filtrage de l’entité Dolibarr courante.</p><br />
<br />
<h3>8.2. Lier un bulletin au paiement natif Dolibarr</h3><br />
<p>Lors de l’activation, le module ajoute un champ supplémentaire au salaire Dolibarr pour sélectionner un bulletin payé du même employé. Une contrainte empêche de rattacher le même bulletin à plusieurs salaires. Le trigger SQL synchronise l’état du bulletin lié lorsque la valeur « payé » du salaire change : il passe le bulletin validé à payé lorsque le salaire est marqué payé, et le remet à validé lorsque le salaire est marqué non payé.</p><br />
<p>Le trigger Dolibarr associé à la création d’un paiement de salaire met également le bulletin lié au statut payé. Ces automatismes dépendent de la présence du champ supplémentaire, du lien sélectionné et des triggers installés avec succès.</p><br />
<br />
<h3>8.3. Générer et consulter le PDF</h3><br />
<ol><br />
<li>Ouvrir la fiche du bulletin et lancer la génération du document.</li><br />
<li>Le module produit un PDF A4 qui présente la société, l’employé, le statut, le contrat, la structure, la période, les jours travaillés, les lignes visibles et les totaux brut/net.</li><br />
<li>Les règles marquées « afficher sur le bulletin » sont incluses ; les autres règles sont omises du tableau détaillé.</li><br />
<li>Le PDF est enregistré sous le répertoire de sortie du module pour l’entité courante, ou, à défaut, dans <code>DOL_DATA_ROOT/payroll</code>, dans un dossier portant la référence du bulletin. La fiche permet ensuite de l’afficher ou de le télécharger.</li><br />
</ol><br />
<p>Une nouvelle génération écrit le PDF à la même référence de bulletin. Les documents existants ne sont pas automatiquement supprimés lors des changements d’état.</p><br />
<br />
<h2>9. Menus, permissions et visibilité</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Droit Dolibarr</th><th style="padding:8px;border:1px solid #dee2e6;">Usage</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;read</code></td><td style="padding:8px;border:1px solid #dee2e6;">Consulter le tableau de bord, les bulletins, lots et documents, accéder à l’aide ; permet l’accès en lecture à plusieurs listes.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;setup</code></td><td style="padding:8px;border:1px solid #dee2e6;">Configurer les catégories, règles, structures, contrats et paramètres. Les administrateurs ont également accès à la configuration.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;write</code></td><td style="padding:8px;border:1px solid #dee2e6;">Créer et modifier les bulletins, contrats et lots selon les contrôles de chaque écran ; lancer des calculs.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;validate</code></td><td style="padding:8px;border:1px solid #dee2e6;">Valider les bulletins ; selon le réglage, remettre en brouillon ou annuler les bulletins validés ; valider/réouvrir les lots.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;delete</code></td><td style="padding:8px;border:1px solid #dee2e6;">Supprimer les enregistrements autorisés par leur état et leurs dépendances.</td></tr><br />
</table><br />
<p>Les menus de catégories, règles, structures et contrats sont rattachés au menu <strong>RH &gt; Paie</strong> et conditionnés au droit de configuration. Les accès aux bulletins et lots requièrent la lecture ; la création est réservée aux droits correspondants. Les droits natifs Dolibarr sur les utilisateurs et salaires restent également pertinents.</p><br />
<br />
<h2>10. Données, imports, triggers et journaux</h2><br />
<ul><br />
<li><strong>Données stockées :</strong> catégories, règles, structures, associations entre structures et règles, contrats, bulletins, lignes de calcul et lots dans des tables propres au module ; liaison du bulletin sur l’extrafield de l’objet Salaire.</li><br />
<li><strong>Imports :</strong> des profils d’import sont déclarés pour les catégories, règles, structures et associations structure-règle. Les contrats et bulletins ne figurent pas parmi les profils déclarés dans le descripteur.</li><br />
<li><strong>Triggers SQL :</strong> un trigger synchronise certains changements de statut entre le salaire payé et le bulletin lié. Deux autres triggers empêchent l’affectation d’un même bulletin à des salaires différents.</li><br />
<li><strong>Trigger Dolibarr :</strong> à la création du paiement d’un salaire, le module met le bulletin relié au statut payé.</li><br />
<li><strong>Journal technique observé :</strong> le trigger de paiement écrit dans <code>/tmp/payroll_debug.log</code> des horodatages, identifiants de salaires, résultats SQL et messages d’erreur. La rotation, la durée de conservation et les permissions de ce fichier ne sont pas gérées par le module ; l’administrateur du serveur doit les contrôler.</li><br />
<li><strong>Fichiers :</strong> les PDF générés sont écrits sous le répertoire de documents de sortie du module décrit dans la section PDF. Aucune tâche planifiée ou règle de purge des PDF et données de paie n’est déclarée par le module.</li><br />
<li><strong>Multi-entité :</strong> les opérations et listes sont filtrées sur l’entité Dolibarr active ; les constantes de configuration sont enregistrées avec cette entité.</li><br />
</ul><br />
<br />
<h2>11. Dépannage</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Symptôme</th><th style="padding:8px;border:1px solid #dee2e6;">Vérifications</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le menu ou une page Paie n’est pas accessible.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier que le module est activé, que le rôle possède le droit Paie requis et que les modules Dolibarr Utilisateurs et Salaires sont activés.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le calcul ne démarre pas ou retourne une erreur.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier l’employé, le contrat, la structure, les dates, les règles actives, les séquences et la syntaxe des expressions. Une variable inconnue ou une division par zéro interrompt le calcul.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">La validation ne met pas à jour les montants.</td><td style="padding:8px;border:1px solid #dee2e6;">Le réglage initial désactive le recalcul lors de la validation. Recalculer le brouillon avant validation ou modifier cette option selon la procédure de paie.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le lot ne génère aucun bulletin.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier la période du lot et l’existence de contrats actifs, associés à une structure et chevauchant la période. Vérifier aussi si un bulletin du contrat existe déjà dans ce lot.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">La validation du lot est refusée.</td><td style="padding:8px;border:1px solid #dee2e6;">Chaque brouillon doit avoir au moins une ligne de calcul. Recalculer ou corriger les bulletins signalés avant de relancer la validation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le champ de sélection du bulletin est absent du salaire.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier l’activation du module et l’existence/activation de l’extrafield ajouté à l’objet Salaire. Réactiver le module si nécessaire, avec les droits SQL adéquats.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le statut payé ne suit pas le paiement Dolibarr.</td><td style="padding:8px;border:1px solid #dee2e6;">Vérifier que le bulletin est lié au bon salaire, que les triggers sont installés et consulter les journaux Dolibarr ainsi que <code>/tmp/payroll_debug.log</code>.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Le PDF est absent ou ne peut pas être ouvert.</td><td style="padding:8px;border:1px solid #dee2e6;">Contrôler les droits d’écriture du serveur sur le répertoire de sortie et l’existence du document. Examiner le message d’erreur et les journaux Dolibarr.</td></tr><br />
</table><br />
<br />
<h2>12. Limites et précautions</h2><br />
<ul><br />
<li>Faire valider toutes les formules de paie par un spécialiste connaissant la législation applicable avant de traiter des salaires réels.</li><br />
<li>Le calcul de <code>MONTH_DAYS</code> exclut les samedis et dimanches mais conserve les jours fériés ; il ne lit pas un calendrier de congés.</li><br />
<li>La validation d’un bulletin ne recalcule pas les montants avec la configuration initiale. Vérifier les lignes et recalculer explicitement avant confirmation si les données ont changé.</li><br />
<li>La génération par lot utilise initialement 22 jours travaillés pour chaque bulletin créé. Adapter cette valeur à la situation réelle avant validation.</li><br />
<li>Le retour au brouillon et l’annulation dépendent d’un réglage désactivé par défaut. Une modification d’état d’un bulletin relié à un salaire doit être coordonnée avec le suivi comptable et le paiement Dolibarr.</li><br />
<li>La suppression d’un lot supprime les bulletins et calculs qu’il contient, sauf si la présence d’un bulletin payé bloque la suppression. Cette opération doit être vérifiée avant confirmation.</li><br />
<li>La synchronisation automatique des statuts dépend de triggers MySQL/MariaDB et des permissions de création de triggers ; la compatibilité avec les autres moteurs de base de données reste à confirmer.</li><br />
</ul><br />
<br />
<h2>13. Assistance</h2><br />
<p>Pour signaler un problème, fournir la version du module, les versions de Dolibarr et PHP, l’entité concernée, les étapes de reproduction et le message d’erreur expurgé des noms, salaires et autres données personnelles. Le module est édité par [https://01consulting.eu 01 Consulting]. Aucun courriel de support n’est indiqué dans les fichiers du module consultés.</p><br />
</div></div><br />
[[en:Odoo_Payroll]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Odoo_Payroll&diff=67485Odoo Payroll2026-09-29T16:25:07Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Odoo Payroll — Payroll for Dolibarr</h1><br />
<p><strong>Summary:</strong> management of payroll rules and structures, payroll contracts, and payslips for Dolibarr internal users.<br><strong>Module version:</strong> 1.0.0<br><strong>Declared minimum Dolibarr version:</strong> 18.0<br><strong>Declared minimum PHP version:</strong> 7.4<br><strong>Versions actually verified:</strong> no Dolibarr or PHP version was tested during this documentation review.<br><strong>Last reviewed:</strong> 2026-09-29</p><br />
<p><strong>Publisher’s official website:</strong> [https://01consulting.eu 01 Consulting]</p><br />
<p><strong>Demonstration video:</strong></p><br />
<youtube width="560" height="315">aeqG94iA8yQ</youtube><br />
<br />
<h2>1. Overview</h2><br />
<p>Odoo Payroll is a native payroll module for Dolibarr, developed by 01 Consulting. Despite its name, it is installed in Dolibarr and does not require an Odoo instance. It lets administrators configure salary categories and rules, group them into structures, assign these structures to employee contracts, and calculate payslips.</p><br />
<p>The engine provides a configurable calculation framework; it does not guarantee compliance with any legislation, collective agreement, tax scale, or social contribution schedule. CNAS, IRG, and other applicable statutory rules must be designed and approved by a payroll specialist before production use.</p><br />
<br />
<h2>2. Features</h2><br />
<ul><br />
<li>Salary rule categories, which can be organized hierarchically.</li><br />
<li>Salary structures containing rules and optionally inheriting from a parent structure.</li><br />
<li>Conditional rules with fixed amounts, percentages, or controlled arithmetic formulas.</li><br />
<li>Contracts linked to Dolibarr users, with salary, weekly hours, dates, contract type, and department.</li><br />
<li>Payslip line calculation, gross and net totals, validation, and status tracking.</li><br />
<li>Individual payslip creation and batch generation for multiple employees.</li><br />
<li>Moving a validated payslip back to draft, canceling validated payslips, and mass actions, subject to permissions and settings.</li><br />
<li>PDF payslip generation and integration with Dolibarr’s native salary payment workflow.</li><br />
<li>A Payroll tab on user cards, Dolibarr import profiles, and filtering by the active entity.</li><br />
</ul><br />
<br />
<h2>3. Requirements and compatibility</h2><br />
<ul><br />
<li><strong>Dolibarr:</strong> the module descriptor declares Dolibarr 18.0 as the minimum version. The version actually verified for this wiki is “none”.</li><br />
<li><strong>PHP:</strong> the descriptor declares PHP 7.4 as the minimum; no runtime testing was performed during this review.</li><br />
<li><strong>Required Dolibarr modules:</strong> Users (<code>modUser</code>) and Salaries (<code>modSalaries</code>).</li><br />
<li><strong>Database:</strong> initialization creates triggers using MySQL/MariaDB syntax. Compatibility with other SQL database engines has not been established. The database account must be able to create and drop triggers.</li><br />
<li><strong>Documents:</strong> the generation process must be able to create files in the module’s output directory under Dolibarr documents.</li><br />
</ul><br />
<br />
<h2>4. Installation, update, and deactivation</h2><br />
<h3>4.1. Installation and activation</h3><br />
<ol><br />
<li>Check that Dolibarr’s <strong>Users</strong> and <strong>Salaries</strong> modules are available.</li><br />
<li>Install the module directory in <code>htdocs/custom/payroll</code>, or in the custom directory configured for external modules.</li><br />
<li>In Dolibarr, open <strong>Home &gt; Setup &gt; Modules/Applications</strong>, find <strong>Payroll</strong>, and enable the module.</li><br />
<li>On activation, the module loads its SQL tables, adds certain missing contract columns, adds a salary extra field for linking a payslip, and attempts to create three triggers on salary tables.</li><br />
<li>Check that <strong>HRM &gt; Payroll</strong> appears and the setup page opens. Before processing real payroll, run a complete calculation with test data and verify the PDFs and payment triggers.</li><br />
</ol><br />
<p>Activation also installs menus, permissions, and import profiles. If trigger creation fails, automatic status changes associated with payments will not work correctly; review the database error and Dolibarr logs.</p><br />
<br />
<h3>4.2. Updating</h3><br />
<ol><br />
<li>Back up the Dolibarr database and documents before replacing module files.</li><br />
<li>Install the updated files. Deactivate and reactivate the module if initialization of new tables, columns, or triggers needs to run again.</li><br />
<li>Review existing categories, rules, contracts, and payslips, and check the triggers on salary tables.</li><br />
<li>Generate a test payslip, open its PDF, and verify the output path and user permissions.</li><br />
</ol><br />
<p>The activation script checks for and adds certain missing contract columns, then makes the rule category mandatory after attempting to assign a category to orphaned rules. Migration details depend on the previous version and existing schema; back up the database before proceeding.</p><br />
<br />
<h3>4.3. Deactivation and removal</h3><br />
<p>Deactivation hides the salary-to-payslip linking extra field and removes the three triggers created by the module. The deactivation process does not delete the payroll tables. The effects of manually removing the tables or module directory have not been established; do not delete this data without a backup and a defined migration procedure.</p><br />
<br />
<h2>5. Configuration</h2><br />
<p>Open the module’s <strong>Setup</strong> page in Dolibarr. Access is limited to administrators and users with the <code>payroll-&gt;setup</code> permission. The values below are the module’s declared initial values or the fallbacks used by the page; a value already saved for an entity may differ.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Initial value or fallback</th><th style="padding:8px;border:1px solid #dee2e6;">Effect</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Payslip numbering</td><td style="padding:8px;border:1px solid #dee2e6;">Standard model; declared mask <code>PSL{00000}</code>. The page falls back to <code>PAY{00000}</code> if no mask is saved.</td><td style="padding:8px;border:1px solid #dee2e6;">Sets generated payslip references. Check the value shown in Setup after installation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Contract numbering</td><td style="padding:8px;border:1px solid #dee2e6;">Standard model, mask <code>CTR{00000}</code>.</td><td style="padding:8px;border:1px solid #dee2e6;">Sets contract references.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Disabled (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Allows a validated payslip to be returned to draft or canceled.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_CONFIRM_PAYSLIPS_WITHOUT_RECOMPUTING</code></td><td style="padding:8px;border:1px solid #dee2e6;">Enabled (<code>1</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Prevents automatic recalculation during validation. When disabled, validation recalculates the payslip.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code></td><td style="padding:8px;border:1px solid #dee2e6;">Disabled (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">When enabled, allows selected fields on draft payslip lines to be edited manually.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Default bank account</td><td style="padding:8px;border:1px solid #dee2e6;">None.</td><td style="padding:8px;border:1px solid #dee2e6;">Value proposed in the payment workflow; this setting is shown when the Bank module is enabled.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Default payment method</td><td style="padding:8px;border:1px solid #dee2e6;">None.</td><td style="padding:8px;border:1px solid #dee2e6;">Payment method proposed in the salary payment workflow.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Contract types and departments</td><td style="padding:8px;border:1px solid #dee2e6;">Dictionaries managed in Setup.</td><td style="padding:8px;border:1px solid #dee2e6;">Add active codes and labels; an entry used by a contract cannot be deleted.</td></tr><br />
</table><br />
<p>Numbering masks must contain at least four zeroes inside braces, for example <code>PAY{00000}</code>. Available numbering models can be selected on the Setup page. Configuration constants are saved for the current Dolibarr entity.</p><br />
<br />
<h2>6. Preparing payroll configuration</h2><br />
<h3>6.1. Categories</h3><br />
<ol><br />
<li>In <strong>HRM &gt; Payroll &gt; Salary Rule Categories</strong>, create a category with a code and label.</li><br />
<li>Optionally choose a parent category to organize the hierarchy.</li><br />
<li>Enable or disable the category according to its use.</li><br />
</ol><br />
<p>Codes are used in formulas as category totals prefixed with <code>CAT_</code>, for example <code>CAT_BASIC</code>. A code used in a formula must follow the characters accepted by the page and import profiles.</p><br />
<br />
<h3>6.2. Salary structures</h3><br />
<ol><br />
<li>In <strong>Structures</strong>, create a structure with a reference and label.</li><br />
<li>Link rules to the structure and set their sequence order.</li><br />
<li>Optionally select a parent structure. The engine loads rules linked to the structure and its chain of parent structures.</li><br />
<li>Save the structure and assign it to a contract.</li><br />
</ol><br />
<p>A structure referenced by a contract or child structure is protected from deletion by the module’s dependency checks.</p><br />
<br />
<h3>6.3. Salary rules and calculations</h3><br />
<p>A rule has a code, label, category, sequence number, condition, and computation type. Only active rules linked to the structure are loaded. Rules are calculated in ascending sequence order; rules already calculated are available by their code to later rules.</p><br />
<ul><br />
<li><strong>Always true:</strong> applies the rule without an additional condition.</li><br />
<li><strong>Range:</strong> compares the salary with configured minimum and maximum values; both endpoints are inclusive.</li><br />
<li><strong>Expression:</strong> evaluates a condition such as <code>WAGE &gt;= 90000</code>.</li><br />
<li><strong>Fixed amount:</strong> configured amount multiplied by the quantity expression; the model’s default quantity is <code>1</code>.</li><br />
<li><strong>Percentage:</strong> applies a rate to a base expression; a negative percentage can represent a deduction.</li><br />
<li><strong>Formula:</strong> evaluates a configured arithmetic expression.</li><br />
<li><strong>Show on payslip:</strong> controls whether the corresponding line appears in the PDF.</li><br />
</ul><br />
<p>The engine accepts numbers, variables, parentheses, and the <code>+ - * /</code> operators. Comparison operators <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>==</code>, and <code>!=</code> are accepted in a condition. It does not execute PHP, Python, or arbitrary functions. An unknown variable, invalid operator, or division by zero stops the calculation with an error.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Variable</th><th style="padding:8px;border:1px solid #dee2e6;">Value used</th><th style="padding:8px;border:1px solid #dee2e6;">Example</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Salary from the contract linked to the payslip.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORK_HOURS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Contract’s weekly hours.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE / WORK_HOURS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Worked days entered on the payslip.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE * WORKED_DAYS / MONTH_DAYS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>MONTH_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Weekdays, Monday through Friday, in the payslip period.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS / MONTH_DAYS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Earlier rule codes</td><td style="padding:8px;border:1px solid #dee2e6;">Amount calculated by an earlier rule in sequence order.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>BASIC + PRIME</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_CODE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Calculated total for a category; an empty total starts at zero.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_BASIC + CAT_ALW + CAT_DED</code></td></tr><br />
</table><br />
<p><code>MONTH_DAYS</code> does not exclude public holidays: only Saturdays and Sundays are excluded. Formula examples illustrate syntax and are not recommended payroll scales.</p><br />
<p>Gross and net totals are taken from rules with the codes <code>GROSS</code> and <code>NET</code>. If these rules do not provide the totals, the engine falls back to categories with those codes.</p><br />
<br />
<h3>6.4. Contracts</h3><br />
<ol><br />
<li>In <strong>Contracts</strong>, create a contract for an internal Dolibarr user.</li><br />
<li>Enter the structure, salary, weekly hours, start date, and, if applicable, end date.</li><br />
<li>Optionally select a contract type and department from the configured dictionaries.</li><br />
<li>Save and activate the contract if it should be offered for batch generation.</li><br />
</ol><br />
<p>A contract must have an employee and a start date. The module’s forms and classes prevent deleting certain referenced records, including a contract linked to payslips.</p><br />
<br />
<h2>7. Managing payslips</h2><br />
<h3>7.1. Create and calculate an individual payslip</h3><br />
<ol><br />
<li>Open <strong>HRM &gt; Payroll &gt; Employee Payslips</strong>, then create a payslip.</li><br />
<li>Select the employee and contract, set the period, and enter the number of worked days. Creating a payslip requires <code>payroll-&gt;write</code>.</li><br />
<li>Save the payslip; it starts in <strong>Draft</strong> status.</li><br />
<li>Click <strong>Compute</strong>. Calculation requires a contract and an available salary structure. If no structure is saved on the payslip yet, the contract’s structure is assigned to it.</li><br />
<li>Review the lines, gross, and net amounts. While the payslip is a draft, correct the configuration or data and compute it again.</li><br />
<li>Validate it with a user who has the <code>payroll-&gt;validate</code> permission. Review the result before validation because the initial setting prevents recalculation at this step.</li><br />
</ol><br />
<p>If the period is reversed, a contract or structure is missing, a variable is unknown, or an expression is invalid, calculation displays an error and must not be treated as complete.</p><br />
<br />
<h3>7.2. Generate payslips in a batch</h3><br />
<ol><br />
<li>Open <strong>HRM &gt; Payroll &gt; Payslip Batches</strong> and create a batch with a label and valid period.</li><br />
<li>On the batch card, run <strong>Generate</strong>. The module selects active contracts with a structure whose dates overlap all or part of the batch period, and for which the batch does not already contain a payslip.</li><br />
<li>The module creates one draft per eligible contract with <strong>22 worked days</strong>, then attempts to compute the batch’s draft payslips. Review and correct worked days if the actual situation differs.</li><br />
<li>Review calculation errors and correct the affected contracts, structures, or rules before validation.</li><br />
<li>Validate the batch payslips. The action is refused if there are no drafts or if a draft has no calculated lines. When validation succeeds, the batch is closed.</li><br />
</ol><br />
<p>Running generation again in the same batch does not add a second payslip for a contract already included in that batch. This check is by contract and batch; it does not generally prevent two separate batches from covering the same period.</p><br />
<br />
<h3>7.3. Statuses, returning to draft, and cancellation</h3><br />
<ul><br />
<li><strong>Draft (0):</strong> can be computed and deleted individually; lines can be edited if <code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code> is enabled.</li><br />
<li><strong>Validated (1):</strong> status reached after validation. Whether validation recalculates the payslip depends on the setting described above.</li><br />
<li><strong>Paid (2):</strong> status associated with the Dolibarr salary payment when the payslip is linked to the corresponding salary.</li><br />
<li><strong>Canceled (9):</strong> canceled payslip status.</li><br />
</ul><br />
<p>When <code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code> is enabled, a user with validation permission can return a validated payslip to draft, cancel it, and use the <strong>Set to draft</strong> mass action from the payslip list. The mass action only processes selected validated payslips. The individual action checks the permission and setting before changing the status; review the payslip and any linked salary before using it.</p><br />
<p>A paid payslip must not be treated like an ordinary validated payslip: salary synchronization may change its status, and a batch cannot be reopened or deleted if it contains paid payslips. Individual payslip deletion is limited to drafts and also deletes their calculation lines.</p><br />
<br />
<h3>7.4. Reopen or delete a batch</h3><br />
<p>A closed batch can be reopened by a user with validation permission if none of its payslips are paid. Reopening returns the batch’s validated payslips to draft. Deleting a batch requires delete permission and deletes the batch, its payslips, and their lines; deletion is refused if a paid payslip is present. This deletion is permanent: review the list shown in the confirmation before proceeding.</p><br />
<br />
<h2>8. Employee card, payment, and PDF</h2><br />
<h3>8.1. Employee Payroll tab</h3><br />
<p>The module adds a <strong>Payroll</strong> tab to user cards. A user with Payroll read permission can view the tab; an employee can also open their own card. The tab lists that employee’s contracts and payslips. Creation buttons depend on the <code>payroll-&gt;write</code> permission. The page filters results by the active Dolibarr entity.</p><br />
<br />
<h3>8.2. Link a payslip to Dolibarr’s native salary payment</h3><br />
<p>When activated, the module adds an extra field to a Dolibarr salary for selecting a paid payslip belonging to the same employee. A constraint prevents linking the same payslip to multiple salaries. The SQL trigger synchronizes the payslip status when the salary’s paid value changes: it changes the linked payslip from validated to paid when the salary is marked paid, and back to validated when the salary is marked unpaid.</p><br />
<p>The Dolibarr trigger associated with creating a salary payment also sets the linked payslip status to paid. These automations depend on the extra field, the selected link, and successful trigger installation.</p><br />
<br />
<h3>8.3. Generate and view the PDF</h3><br />
<ol><br />
<li>Open the payslip card and start document generation.</li><br />
<li>The module produces an A4 PDF showing the company, employee, status, contract, structure, period, worked days, visible lines, and gross/net totals.</li><br />
<li>Rules marked “show on payslip” are included; other rules are omitted from the detailed table.</li><br />
<li>The PDF is saved in the module output directory for the active entity, or, if none is configured, in <code>DOL_DATA_ROOT/payroll</code>, inside a directory named after the payslip reference. The card can then display or download it.</li><br />
</ol><br />
<p>Generating the PDF again writes to the same payslip reference. Existing documents are not automatically deleted when the payslip status changes.</p><br />
<br />
<h2>9. Menus, permissions, and visibility</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Dolibarr permission</th><th style="padding:8px;border:1px solid #dee2e6;">Purpose</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;read</code></td><td style="padding:8px;border:1px solid #dee2e6;">View the dashboard, payslips, batches, and documents; access help; grants read access to several lists.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;setup</code></td><td style="padding:8px;border:1px solid #dee2e6;">Configure categories, rules, structures, contracts, and settings. Administrators also have access to setup.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;write</code></td><td style="padding:8px;border:1px solid #dee2e6;">Create and edit payslips, contracts, and batches according to each page’s checks; run calculations.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;validate</code></td><td style="padding:8px;border:1px solid #dee2e6;">Validate payslips; subject to the setting, return or cancel validated payslips; validate or reopen batches.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;delete</code></td><td style="padding:8px;border:1px solid #dee2e6;">Delete records allowed by their status and dependencies.</td></tr><br />
</table><br />
<p>Category, rule, structure, and contract menus are under <strong>HRM &gt; Payroll</strong> and require the setup permission. Access to payslips and batches requires read permission; creation requires the corresponding write permission. Native Dolibarr permissions for Users and Salaries are also relevant.</p><br />
<br />
<h2>10. Data, imports, triggers, and logs</h2><br />
<ul><br />
<li><strong>Stored data:</strong> categories, rules, structures, structure-rule links, contracts, payslips, calculation lines, and batches in module tables; the payslip link is stored in an extra field on the Salary object.</li><br />
<li><strong>Imports:</strong> import profiles are declared for categories, rules, structures, and structure-rule links. Contracts and payslips are not listed among the import profiles in the module descriptor.</li><br />
<li><strong>SQL triggers:</strong> one trigger synchronizes certain status changes between the paid salary and linked payslip. Two other triggers prevent a payslip from being linked to different salaries.</li><br />
<li><strong>Dolibarr trigger:</strong> when a salary payment is created, the module sets the linked payslip to paid.</li><br />
<li><strong>Observed technical log:</strong> the payment trigger writes timestamps, salary identifiers, SQL results, and error messages to <code>/tmp/payroll_debug.log</code>. The module does not manage this file’s rotation, retention, or permissions; the server administrator should review them.</li><br />
<li><strong>Files:</strong> generated PDFs are written under the module document output directory described in the PDF section. The module descriptor declares no scheduled job or purge policy for payslips, payroll data, or PDFs.</li><br />
<li><strong>Multi-entity:</strong> operations and lists are filtered by the active Dolibarr entity; configuration constants are saved for that entity.</li><br />
</ul><br />
<br />
<h2>11. Troubleshooting</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Symptom</th><th style="padding:8px;border:1px solid #dee2e6;">Checks</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The Payroll menu or a page is inaccessible.</td><td style="padding:8px;border:1px solid #dee2e6;">Check that the module is enabled, the user has the required Payroll permission, and the native Users and Salaries modules are enabled.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Calculation does not start or returns an error.</td><td style="padding:8px;border:1px solid #dee2e6;">Check the employee, contract, structure, dates, active rules, sequences, and expression syntax. An unknown variable or division by zero stops calculation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Validation does not update the amounts.</td><td style="padding:8px;border:1px solid #dee2e6;">The initial setting disables recalculation during validation. Recompute the draft first or change this setting according to the payroll procedure.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The batch generates no payslips.</td><td style="padding:8px;border:1px solid #dee2e6;">Check the batch period and whether active contracts have a structure and overlap the period. Also check whether a payslip for the contract already exists in this batch.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Batch validation is refused.</td><td style="padding:8px;border:1px solid #dee2e6;">Each draft must have at least one calculated line. Recompute or correct the indicated payslips before retrying validation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The payslip selection field is missing from a salary.</td><td style="padding:8px;border:1px solid #dee2e6;">Check module activation and whether the extra field was installed/enabled on the Salary object. Reactivate the module if needed, with sufficient SQL permissions.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The paid status does not follow a Dolibarr payment.</td><td style="padding:8px;border:1px solid #dee2e6;">Check that the payslip is linked to the correct salary, that triggers are installed, and review Dolibarr logs and <code>/tmp/payroll_debug.log</code>.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The PDF is missing or cannot be opened.</td><td style="padding:8px;border:1px solid #dee2e6;">Check the web server’s write access to the output directory and whether the document exists. Review the error message and Dolibarr logs.</td></tr><br />
</table><br />
<br />
<h2>12. Limitations and precautions</h2><br />
<ul><br />
<li>Have all payroll formulas reviewed by a specialist familiar with the applicable legislation before processing real salaries.</li><br />
<li><code>MONTH_DAYS</code> excludes Saturdays and Sundays but includes public holidays; it does not use a leave calendar.</li><br />
<li>With the initial configuration, validating a payslip does not recalculate it. Review the lines and recompute explicitly before validation if the data has changed.</li><br />
<li>Batch generation initially uses 22 worked days for each payslip it creates. Adjust this value to the actual situation before validation.</li><br />
<li>Returning a payslip to draft or canceling it depends on a setting that is disabled by default. Coordinate status changes for payslips linked to salaries with Dolibarr’s accounting and payment tracking.</li><br />
<li>Deleting a batch deletes its payslips and calculations unless a paid payslip blocks the operation. Review the batch before confirming deletion.</li><br />
<li>Automatic status synchronization depends on MySQL/MariaDB triggers and database permissions to create triggers; compatibility with other database engines remains unconfirmed.</li><br />
</ul><br />
<br />
<h2>13. Support</h2><br />
<p>When reporting a problem, provide the module version, Dolibarr and PHP versions, affected entity, reproduction steps, and an error message with names, salary amounts, and other personal data removed. The module is published by [https://01consulting.eu 01 Consulting]. No support email address was found in the reviewed module files.</p><br />
</div></div><br />
[[fr:Odoo_Payroll_FR]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Odoo_Payroll&diff=67484Odoo Payroll2026-09-29T16:24:39Z<p>Abahfir: module odoo payroll</p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Odoo Payroll — Payroll for Dolibarr</h1><br />
<p><strong>Summary:</strong> management of payroll rules and structures, payroll contracts, and payslips for Dolibarr internal users.<br><strong>Module version:</strong> 1.0.0<br><strong>Declared minimum Dolibarr version:</strong> 18.0<br><strong>Declared minimum PHP version:</strong> 7.4<br><strong>Versions actually verified:</strong> no Dolibarr or PHP version was tested during this documentation review.<br><strong>Last reviewed:</strong> 2026-09-29</p><br />
<p><strong>Publisher’s official website:</strong> [https://01consulting.eu 01 Consulting]</p><br />
<p><strong>Demonstration video:</strong></p><br />
<youtube width="200" height="120">aeqG94iA8yQ</youtube><br />
<br />
<h2>1. Overview</h2><br />
<p>Odoo Payroll is a native payroll module for Dolibarr, developed by 01 Consulting. Despite its name, it is installed in Dolibarr and does not require an Odoo instance. It lets administrators configure salary categories and rules, group them into structures, assign these structures to employee contracts, and calculate payslips.</p><br />
<p>The engine provides a configurable calculation framework; it does not guarantee compliance with any legislation, collective agreement, tax scale, or social contribution schedule. CNAS, IRG, and other applicable statutory rules must be designed and approved by a payroll specialist before production use.</p><br />
<br />
<h2>2. Features</h2><br />
<ul><br />
<li>Salary rule categories, which can be organized hierarchically.</li><br />
<li>Salary structures containing rules and optionally inheriting from a parent structure.</li><br />
<li>Conditional rules with fixed amounts, percentages, or controlled arithmetic formulas.</li><br />
<li>Contracts linked to Dolibarr users, with salary, weekly hours, dates, contract type, and department.</li><br />
<li>Payslip line calculation, gross and net totals, validation, and status tracking.</li><br />
<li>Individual payslip creation and batch generation for multiple employees.</li><br />
<li>Moving a validated payslip back to draft, canceling validated payslips, and mass actions, subject to permissions and settings.</li><br />
<li>PDF payslip generation and integration with Dolibarr’s native salary payment workflow.</li><br />
<li>A Payroll tab on user cards, Dolibarr import profiles, and filtering by the active entity.</li><br />
</ul><br />
<br />
<h2>3. Requirements and compatibility</h2><br />
<ul><br />
<li><strong>Dolibarr:</strong> the module descriptor declares Dolibarr 18.0 as the minimum version. The version actually verified for this wiki is “none”.</li><br />
<li><strong>PHP:</strong> the descriptor declares PHP 7.4 as the minimum; no runtime testing was performed during this review.</li><br />
<li><strong>Required Dolibarr modules:</strong> Users (<code>modUser</code>) and Salaries (<code>modSalaries</code>).</li><br />
<li><strong>Database:</strong> initialization creates triggers using MySQL/MariaDB syntax. Compatibility with other SQL database engines has not been established. The database account must be able to create and drop triggers.</li><br />
<li><strong>Documents:</strong> the generation process must be able to create files in the module’s output directory under Dolibarr documents.</li><br />
</ul><br />
<br />
<h2>4. Installation, update, and deactivation</h2><br />
<h3>4.1. Installation and activation</h3><br />
<ol><br />
<li>Check that Dolibarr’s <strong>Users</strong> and <strong>Salaries</strong> modules are available.</li><br />
<li>Install the module directory in <code>htdocs/custom/payroll</code>, or in the custom directory configured for external modules.</li><br />
<li>In Dolibarr, open <strong>Home &gt; Setup &gt; Modules/Applications</strong>, find <strong>Payroll</strong>, and enable the module.</li><br />
<li>On activation, the module loads its SQL tables, adds certain missing contract columns, adds a salary extra field for linking a payslip, and attempts to create three triggers on salary tables.</li><br />
<li>Check that <strong>HRM &gt; Payroll</strong> appears and the setup page opens. Before processing real payroll, run a complete calculation with test data and verify the PDFs and payment triggers.</li><br />
</ol><br />
<p>Activation also installs menus, permissions, and import profiles. If trigger creation fails, automatic status changes associated with payments will not work correctly; review the database error and Dolibarr logs.</p><br />
<br />
<h3>4.2. Updating</h3><br />
<ol><br />
<li>Back up the Dolibarr database and documents before replacing module files.</li><br />
<li>Install the updated files. Deactivate and reactivate the module if initialization of new tables, columns, or triggers needs to run again.</li><br />
<li>Review existing categories, rules, contracts, and payslips, and check the triggers on salary tables.</li><br />
<li>Generate a test payslip, open its PDF, and verify the output path and user permissions.</li><br />
</ol><br />
<p>The activation script checks for and adds certain missing contract columns, then makes the rule category mandatory after attempting to assign a category to orphaned rules. Migration details depend on the previous version and existing schema; back up the database before proceeding.</p><br />
<br />
<h3>4.3. Deactivation and removal</h3><br />
<p>Deactivation hides the salary-to-payslip linking extra field and removes the three triggers created by the module. The deactivation process does not delete the payroll tables. The effects of manually removing the tables or module directory have not been established; do not delete this data without a backup and a defined migration procedure.</p><br />
<br />
<h2>5. Configuration</h2><br />
<p>Open the module’s <strong>Setup</strong> page in Dolibarr. Access is limited to administrators and users with the <code>payroll-&gt;setup</code> permission. The values below are the module’s declared initial values or the fallbacks used by the page; a value already saved for an entity may differ.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Initial value or fallback</th><th style="padding:8px;border:1px solid #dee2e6;">Effect</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Payslip numbering</td><td style="padding:8px;border:1px solid #dee2e6;">Standard model; declared mask <code>PSL{00000}</code>. The page falls back to <code>PAY{00000}</code> if no mask is saved.</td><td style="padding:8px;border:1px solid #dee2e6;">Sets generated payslip references. Check the value shown in Setup after installation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Contract numbering</td><td style="padding:8px;border:1px solid #dee2e6;">Standard model, mask <code>CTR{00000}</code>.</td><td style="padding:8px;border:1px solid #dee2e6;">Sets contract references.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Disabled (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Allows a validated payslip to be returned to draft or canceled.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_CONFIRM_PAYSLIPS_WITHOUT_RECOMPUTING</code></td><td style="padding:8px;border:1px solid #dee2e6;">Enabled (<code>1</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">Prevents automatic recalculation during validation. When disabled, validation recalculates the payslip.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code></td><td style="padding:8px;border:1px solid #dee2e6;">Disabled (<code>0</code>).</td><td style="padding:8px;border:1px solid #dee2e6;">When enabled, allows selected fields on draft payslip lines to be edited manually.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Default bank account</td><td style="padding:8px;border:1px solid #dee2e6;">None.</td><td style="padding:8px;border:1px solid #dee2e6;">Value proposed in the payment workflow; this setting is shown when the Bank module is enabled.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Default payment method</td><td style="padding:8px;border:1px solid #dee2e6;">None.</td><td style="padding:8px;border:1px solid #dee2e6;">Payment method proposed in the salary payment workflow.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Contract types and departments</td><td style="padding:8px;border:1px solid #dee2e6;">Dictionaries managed in Setup.</td><td style="padding:8px;border:1px solid #dee2e6;">Add active codes and labels; an entry used by a contract cannot be deleted.</td></tr><br />
</table><br />
<p>Numbering masks must contain at least four zeroes inside braces, for example <code>PAY{00000}</code>. Available numbering models can be selected on the Setup page. Configuration constants are saved for the current Dolibarr entity.</p><br />
<br />
<h2>6. Preparing payroll configuration</h2><br />
<h3>6.1. Categories</h3><br />
<ol><br />
<li>In <strong>HRM &gt; Payroll &gt; Salary Rule Categories</strong>, create a category with a code and label.</li><br />
<li>Optionally choose a parent category to organize the hierarchy.</li><br />
<li>Enable or disable the category according to its use.</li><br />
</ol><br />
<p>Codes are used in formulas as category totals prefixed with <code>CAT_</code>, for example <code>CAT_BASIC</code>. A code used in a formula must follow the characters accepted by the page and import profiles.</p><br />
<br />
<h3>6.2. Salary structures</h3><br />
<ol><br />
<li>In <strong>Structures</strong>, create a structure with a reference and label.</li><br />
<li>Link rules to the structure and set their sequence order.</li><br />
<li>Optionally select a parent structure. The engine loads rules linked to the structure and its chain of parent structures.</li><br />
<li>Save the structure and assign it to a contract.</li><br />
</ol><br />
<p>A structure referenced by a contract or child structure is protected from deletion by the module’s dependency checks.</p><br />
<br />
<h3>6.3. Salary rules and calculations</h3><br />
<p>A rule has a code, label, category, sequence number, condition, and computation type. Only active rules linked to the structure are loaded. Rules are calculated in ascending sequence order; rules already calculated are available by their code to later rules.</p><br />
<ul><br />
<li><strong>Always true:</strong> applies the rule without an additional condition.</li><br />
<li><strong>Range:</strong> compares the salary with configured minimum and maximum values; both endpoints are inclusive.</li><br />
<li><strong>Expression:</strong> evaluates a condition such as <code>WAGE &gt;= 90000</code>.</li><br />
<li><strong>Fixed amount:</strong> configured amount multiplied by the quantity expression; the model’s default quantity is <code>1</code>.</li><br />
<li><strong>Percentage:</strong> applies a rate to a base expression; a negative percentage can represent a deduction.</li><br />
<li><strong>Formula:</strong> evaluates a configured arithmetic expression.</li><br />
<li><strong>Show on payslip:</strong> controls whether the corresponding line appears in the PDF.</li><br />
</ul><br />
<p>The engine accepts numbers, variables, parentheses, and the <code>+ - * /</code> operators. Comparison operators <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>==</code>, and <code>!=</code> are accepted in a condition. It does not execute PHP, Python, or arbitrary functions. An unknown variable, invalid operator, or division by zero stops the calculation with an error.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Variable</th><th style="padding:8px;border:1px solid #dee2e6;">Value used</th><th style="padding:8px;border:1px solid #dee2e6;">Example</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Salary from the contract linked to the payslip.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORK_HOURS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Contract’s weekly hours.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE / WORK_HOURS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Worked days entered on the payslip.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WAGE * WORKED_DAYS / MONTH_DAYS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>MONTH_DAYS</code></td><td style="padding:8px;border:1px solid #dee2e6;">Weekdays, Monday through Friday, in the payslip period.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>WORKED_DAYS / MONTH_DAYS</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Earlier rule codes</td><td style="padding:8px;border:1px solid #dee2e6;">Amount calculated by an earlier rule in sequence order.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>BASIC + PRIME</code></td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_CODE</code></td><td style="padding:8px;border:1px solid #dee2e6;">Calculated total for a category; an empty total starts at zero.</td><td style="padding:8px;border:1px solid #dee2e6;"><code>CAT_BASIC + CAT_ALW + CAT_DED</code></td></tr><br />
</table><br />
<p><code>MONTH_DAYS</code> does not exclude public holidays: only Saturdays and Sundays are excluded. Formula examples illustrate syntax and are not recommended payroll scales.</p><br />
<p>Gross and net totals are taken from rules with the codes <code>GROSS</code> and <code>NET</code>. If these rules do not provide the totals, the engine falls back to categories with those codes.</p><br />
<br />
<h3>6.4. Contracts</h3><br />
<ol><br />
<li>In <strong>Contracts</strong>, create a contract for an internal Dolibarr user.</li><br />
<li>Enter the structure, salary, weekly hours, start date, and, if applicable, end date.</li><br />
<li>Optionally select a contract type and department from the configured dictionaries.</li><br />
<li>Save and activate the contract if it should be offered for batch generation.</li><br />
</ol><br />
<p>A contract must have an employee and a start date. The module’s forms and classes prevent deleting certain referenced records, including a contract linked to payslips.</p><br />
<br />
<h2>7. Managing payslips</h2><br />
<h3>7.1. Create and calculate an individual payslip</h3><br />
<ol><br />
<li>Open <strong>HRM &gt; Payroll &gt; Employee Payslips</strong>, then create a payslip.</li><br />
<li>Select the employee and contract, set the period, and enter the number of worked days. Creating a payslip requires <code>payroll-&gt;write</code>.</li><br />
<li>Save the payslip; it starts in <strong>Draft</strong> status.</li><br />
<li>Click <strong>Compute</strong>. Calculation requires a contract and an available salary structure. If no structure is saved on the payslip yet, the contract’s structure is assigned to it.</li><br />
<li>Review the lines, gross, and net amounts. While the payslip is a draft, correct the configuration or data and compute it again.</li><br />
<li>Validate it with a user who has the <code>payroll-&gt;validate</code> permission. Review the result before validation because the initial setting prevents recalculation at this step.</li><br />
</ol><br />
<p>If the period is reversed, a contract or structure is missing, a variable is unknown, or an expression is invalid, calculation displays an error and must not be treated as complete.</p><br />
<br />
<h3>7.2. Generate payslips in a batch</h3><br />
<ol><br />
<li>Open <strong>HRM &gt; Payroll &gt; Payslip Batches</strong> and create a batch with a label and valid period.</li><br />
<li>On the batch card, run <strong>Generate</strong>. The module selects active contracts with a structure whose dates overlap all or part of the batch period, and for which the batch does not already contain a payslip.</li><br />
<li>The module creates one draft per eligible contract with <strong>22 worked days</strong>, then attempts to compute the batch’s draft payslips. Review and correct worked days if the actual situation differs.</li><br />
<li>Review calculation errors and correct the affected contracts, structures, or rules before validation.</li><br />
<li>Validate the batch payslips. The action is refused if there are no drafts or if a draft has no calculated lines. When validation succeeds, the batch is closed.</li><br />
</ol><br />
<p>Running generation again in the same batch does not add a second payslip for a contract already included in that batch. This check is by contract and batch; it does not generally prevent two separate batches from covering the same period.</p><br />
<br />
<h3>7.3. Statuses, returning to draft, and cancellation</h3><br />
<ul><br />
<li><strong>Draft (0):</strong> can be computed and deleted individually; lines can be edited if <code>PAYROLL_ALLOW_EDIT_PAYSLIP_LINES</code> is enabled.</li><br />
<li><strong>Validated (1):</strong> status reached after validation. Whether validation recalculates the payslip depends on the setting described above.</li><br />
<li><strong>Paid (2):</strong> status associated with the Dolibarr salary payment when the payslip is linked to the corresponding salary.</li><br />
<li><strong>Canceled (9):</strong> canceled payslip status.</li><br />
</ul><br />
<p>When <code>PAYROLL_ALLOW_CANCEL_CONFIRMED_PAYSLIPS</code> is enabled, a user with validation permission can return a validated payslip to draft, cancel it, and use the <strong>Set to draft</strong> mass action from the payslip list. The mass action only processes selected validated payslips. The individual action checks the permission and setting before changing the status; review the payslip and any linked salary before using it.</p><br />
<p>A paid payslip must not be treated like an ordinary validated payslip: salary synchronization may change its status, and a batch cannot be reopened or deleted if it contains paid payslips. Individual payslip deletion is limited to drafts and also deletes their calculation lines.</p><br />
<br />
<h3>7.4. Reopen or delete a batch</h3><br />
<p>A closed batch can be reopened by a user with validation permission if none of its payslips are paid. Reopening returns the batch’s validated payslips to draft. Deleting a batch requires delete permission and deletes the batch, its payslips, and their lines; deletion is refused if a paid payslip is present. This deletion is permanent: review the list shown in the confirmation before proceeding.</p><br />
<br />
<h2>8. Employee card, payment, and PDF</h2><br />
<h3>8.1. Employee Payroll tab</h3><br />
<p>The module adds a <strong>Payroll</strong> tab to user cards. A user with Payroll read permission can view the tab; an employee can also open their own card. The tab lists that employee’s contracts and payslips. Creation buttons depend on the <code>payroll-&gt;write</code> permission. The page filters results by the active Dolibarr entity.</p><br />
<br />
<h3>8.2. Link a payslip to Dolibarr’s native salary payment</h3><br />
<p>When activated, the module adds an extra field to a Dolibarr salary for selecting a paid payslip belonging to the same employee. A constraint prevents linking the same payslip to multiple salaries. The SQL trigger synchronizes the payslip status when the salary’s paid value changes: it changes the linked payslip from validated to paid when the salary is marked paid, and back to validated when the salary is marked unpaid.</p><br />
<p>The Dolibarr trigger associated with creating a salary payment also sets the linked payslip status to paid. These automations depend on the extra field, the selected link, and successful trigger installation.</p><br />
<br />
<h3>8.3. Generate and view the PDF</h3><br />
<ol><br />
<li>Open the payslip card and start document generation.</li><br />
<li>The module produces an A4 PDF showing the company, employee, status, contract, structure, period, worked days, visible lines, and gross/net totals.</li><br />
<li>Rules marked “show on payslip” are included; other rules are omitted from the detailed table.</li><br />
<li>The PDF is saved in the module output directory for the active entity, or, if none is configured, in <code>DOL_DATA_ROOT/payroll</code>, inside a directory named after the payslip reference. The card can then display or download it.</li><br />
</ol><br />
<p>Generating the PDF again writes to the same payslip reference. Existing documents are not automatically deleted when the payslip status changes.</p><br />
<br />
<h2>9. Menus, permissions, and visibility</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Dolibarr permission</th><th style="padding:8px;border:1px solid #dee2e6;">Purpose</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;read</code></td><td style="padding:8px;border:1px solid #dee2e6;">View the dashboard, payslips, batches, and documents; access help; grants read access to several lists.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;setup</code></td><td style="padding:8px;border:1px solid #dee2e6;">Configure categories, rules, structures, contracts, and settings. Administrators also have access to setup.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;write</code></td><td style="padding:8px;border:1px solid #dee2e6;">Create and edit payslips, contracts, and batches according to each page’s checks; run calculations.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;validate</code></td><td style="padding:8px;border:1px solid #dee2e6;">Validate payslips; subject to the setting, return or cancel validated payslips; validate or reopen batches.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;"><code>payroll-&gt;delete</code></td><td style="padding:8px;border:1px solid #dee2e6;">Delete records allowed by their status and dependencies.</td></tr><br />
</table><br />
<p>Category, rule, structure, and contract menus are under <strong>HRM &gt; Payroll</strong> and require the setup permission. Access to payslips and batches requires read permission; creation requires the corresponding write permission. Native Dolibarr permissions for Users and Salaries are also relevant.</p><br />
<br />
<h2>10. Data, imports, triggers, and logs</h2><br />
<ul><br />
<li><strong>Stored data:</strong> categories, rules, structures, structure-rule links, contracts, payslips, calculation lines, and batches in module tables; the payslip link is stored in an extra field on the Salary object.</li><br />
<li><strong>Imports:</strong> import profiles are declared for categories, rules, structures, and structure-rule links. Contracts and payslips are not listed among the import profiles in the module descriptor.</li><br />
<li><strong>SQL triggers:</strong> one trigger synchronizes certain status changes between the paid salary and linked payslip. Two other triggers prevent a payslip from being linked to different salaries.</li><br />
<li><strong>Dolibarr trigger:</strong> when a salary payment is created, the module sets the linked payslip to paid.</li><br />
<li><strong>Observed technical log:</strong> the payment trigger writes timestamps, salary identifiers, SQL results, and error messages to <code>/tmp/payroll_debug.log</code>. The module does not manage this file’s rotation, retention, or permissions; the server administrator should review them.</li><br />
<li><strong>Files:</strong> generated PDFs are written under the module document output directory described in the PDF section. The module descriptor declares no scheduled job or purge policy for payslips, payroll data, or PDFs.</li><br />
<li><strong>Multi-entity:</strong> operations and lists are filtered by the active Dolibarr entity; configuration constants are saved for that entity.</li><br />
</ul><br />
<br />
<h2>11. Troubleshooting</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><br />
<tr><th style="padding:8px;border:1px solid #dee2e6;">Symptom</th><th style="padding:8px;border:1px solid #dee2e6;">Checks</th></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The Payroll menu or a page is inaccessible.</td><td style="padding:8px;border:1px solid #dee2e6;">Check that the module is enabled, the user has the required Payroll permission, and the native Users and Salaries modules are enabled.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Calculation does not start or returns an error.</td><td style="padding:8px;border:1px solid #dee2e6;">Check the employee, contract, structure, dates, active rules, sequences, and expression syntax. An unknown variable or division by zero stops calculation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Validation does not update the amounts.</td><td style="padding:8px;border:1px solid #dee2e6;">The initial setting disables recalculation during validation. Recompute the draft first or change this setting according to the payroll procedure.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The batch generates no payslips.</td><td style="padding:8px;border:1px solid #dee2e6;">Check the batch period and whether active contracts have a structure and overlap the period. Also check whether a payslip for the contract already exists in this batch.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">Batch validation is refused.</td><td style="padding:8px;border:1px solid #dee2e6;">Each draft must have at least one calculated line. Recompute or correct the indicated payslips before retrying validation.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The payslip selection field is missing from a salary.</td><td style="padding:8px;border:1px solid #dee2e6;">Check module activation and whether the extra field was installed/enabled on the Salary object. Reactivate the module if needed, with sufficient SQL permissions.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The paid status does not follow a Dolibarr payment.</td><td style="padding:8px;border:1px solid #dee2e6;">Check that the payslip is linked to the correct salary, that triggers are installed, and review Dolibarr logs and <code>/tmp/payroll_debug.log</code>.</td></tr><br />
<tr><td style="padding:8px;border:1px solid #dee2e6;">The PDF is missing or cannot be opened.</td><td style="padding:8px;border:1px solid #dee2e6;">Check the web server’s write access to the output directory and whether the document exists. Review the error message and Dolibarr logs.</td></tr><br />
</table><br />
<br />
<h2>12. Limitations and precautions</h2><br />
<ul><br />
<li>Have all payroll formulas reviewed by a specialist familiar with the applicable legislation before processing real salaries.</li><br />
<li><code>MONTH_DAYS</code> excludes Saturdays and Sundays but includes public holidays; it does not use a leave calendar.</li><br />
<li>With the initial configuration, validating a payslip does not recalculate it. Review the lines and recompute explicitly before validation if the data has changed.</li><br />
<li>Batch generation initially uses 22 worked days for each payslip it creates. Adjust this value to the actual situation before validation.</li><br />
<li>Returning a payslip to draft or canceling it depends on a setting that is disabled by default. Coordinate status changes for payslips linked to salaries with Dolibarr’s accounting and payment tracking.</li><br />
<li>Deleting a batch deletes its payslips and calculations unless a paid payslip blocks the operation. Review the batch before confirming deletion.</li><br />
<li>Automatic status synchronization depends on MySQL/MariaDB triggers and database permissions to create triggers; compatibility with other database engines remains unconfirmed.</li><br />
</ul><br />
<br />
<h2>13. Support</h2><br />
<p>When reporting a problem, provide the module version, Dolibarr and PHP versions, affected entity, reproduction steps, and an error message with names, salary amounts, and other personal data removed. The module is published by [https://01consulting.eu 01 Consulting]. No support email address was found in the reviewed module files.</p><br />
</div></div><br />
[[fr:Odoo_Payroll_FR]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=TakePOS_Digital_Invoice&diff=67483TakePOS Digital Invoice2026-09-29T14:31:58Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><div style="width:100%;"><br />
<h1>TakePOS Digital Invoice</h1><br />
<p><strong>Summary:</strong> Lets a buyer of a TakePOS sale request an electronic invoice by scanning a QR code on the receipt.<br><strong>Module version:</strong> 1.0.0<br><strong>Declared compatibility:</strong> Dolibarr 23.0 or later, PHP 7.2 or later<br><strong>Last documentation review:</strong> 2026-09-29</p><br />
<p><strong>Demo video:</strong></p><br />
<youtube width="560" height="315">PaenAajCX0E</youtube><br />
<p><strong>Demo site:</strong> [https://01consulting.eu/demo/htdocs/ Open the demo site]</p><br />
<p><strong>Publisher website:</strong> [https://01consulting.eu/ 01Consulting]</p><br />
<p>This guide covers installation, settings, receipt QR codes, the customer workflow, request tracking, EInvoicing integration, permissions, and troubleshooting.</p><br />
<br />
<h2>1. Purpose and scope</h2><br />
<p>TakePOS sales are often recorded against the generic third party assigned to a terminal. This module gives the buyer of a paid sale a way to provide company details, confirm an email address, and request the electronic invoice for that existing sale.</p><br />
<p>The module identifies or creates a customer third party, links the TakePOS invoice to it, prepares the electronic invoice with EInvoicing, sends it to the approved platform configured there, then emails the requester the official readable PDF retrieved from that platform.</p><br />
<p>The public workflow is intended for French companies with an active 14-digit SIRET. It does not create a new commercial invoice; it operates on the already-paid TakePOS invoice. Individuals and foreign companies are not supported.</p><br />
<br />
<h2>2. End-to-end workflow</h2><br />
<ol><li>When a TakePOS invoice is validated, the module creates a random 64-character identifier and stores it in the invoice <code>hash</code> extrafield.</li><li>The receipt prints or displays a QR code that opens the public form for that invoice.</li><li>The buyer submits company details and a SIRET. The module checks the fields, email domain, and available official register data.</li><li>The module sends a confirmation link to the submitted email address. Processing does not start until the link is opened.</li><li>After confirmation, the module reuses the matching third party or creates one, then links the paid invoice to it.</li><li>EInvoicing generates the electronic document using the configured protocol and sends it to the approved platform.</li><li>The module retrieves the platform’s official readable PDF and emails it to the requester.</li></ol><br />
<p>Errors are recorded on the request. An authorized user can retry processing. If the invoice has already been transmitted, the existing platform flow is reused to retrieve the PDF; the invoice is not sent a second time.</p><br />
<br />
<h2>3. Requirements and compatibility</h2><br />
<ul><li><strong>Dolibarr:</strong> the module descriptor declares Dolibarr 23.0 or later; the module was prepared for Dolibarr 23.0.3.</li><li><strong>PHP:</strong> minimum declared version is 7.2.</li><li><strong>Dolibarr modules:</strong> Invoices, TakePOS, and EInvoicing must be enabled.</li><li><strong>EInvoicing:</strong> configure an approved platform, satisfy its prerequisites, and select the CII or Factur-X protocol.</li><li><strong>Email:</strong> outbound email from Dolibarr must be configured.</li><li><strong>Server connectivity:</strong> the server must be able to reach the Company Search API, DNS, and, if enabled, the Verifalia API over HTTPS.</li><li><strong>Customer access:</strong> the public Dolibarr URL must be reachable from the phone scanning the receipt.</li><li><strong>TakePOS terminal:</strong> each relevant point of sale must have a default generic third party, used to determine whether the buyer is still anonymous.</li></ul><br />
<br />
<h2>4. Installation, activation, and updates</h2><br />
<h3>4.1. Install and activate</h3><br />
<ol><li>Copy the <code>takeposdigitalinvoice</code> directory to <code>htdocs/custom</code>.</li><li>In Dolibarr, open <strong>Home &gt; Setup &gt; Modules/Applications</strong>.</li><li>Enable <strong>TakePOS Digital Invoice</strong>. First check that Invoices, TakePOS, and EInvoicing are installed and enabled.</li><li>Open the module configuration and set the <strong>General</strong> and <strong>Email</strong> tabs.</li><li>Grant the required read and process permissions to the relevant users.</li><li>Add the QR tag to the browser receipt template and/or ESC/POS template used by the terminal.</li><li>Make a test sale and verify the QR code, public form, email confirmation, and request tracking.</li></ol><br />
<p>Activation loads the request table, adds the invoice <code>hash</code> extrafield (varchar, 64 characters), declares the tracking menu and invoice tab, registers permissions, and declares the retention scheduled task. An activation migration also handles the former CII tracking columns and, where possible, fills in the format from documents already generated.</p><br />
<h3>4.2. Update</h3><br />
<p>Back up the database and Dolibarr documents before updating. Replace the module files with the new version, then reactivate the module if its menu or tab declaration has changed. Activation runs the migrations declared by the module. Afterward, check the configuration page, request menu, and a TakePOS invoice tab.</p><br />
<h3>4.3. Disable or uninstall</h3><br />
<p>The effects on tables, the extrafield, and documents depend on the operation selected in Dolibarr. Back up data before uninstalling and review the consequences shown by Dolibarr. The public workflow does not operate while the module is disabled.</p><br />
<br />
<h2>5. Permissions, menus, and screens</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Permission or screen</th><th style="padding:8px;border:1px solid #dee2e6;">Purpose</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Read requests</td><td style="padding:8px;border:1px solid #dee2e6;">Opens the request list and tracking tab on a TakePOS invoice. Dolibarr permission to view the invoice is also required.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Process requests</td><td style="padding:8px;border:1px solid #dee2e6;">Allows Retry and Cancel actions in the list and invoice tab.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Administer requests</td><td style="padding:8px;border:1px solid #dee2e6;">Permission declared in the module descriptor. Configuration pages also require Dolibarr administrator status.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Configuration</td><td style="padding:8px;border:1px solid #dee2e6;">Available to Dolibarr administrators from the module settings; includes General, Email, and About tabs.</td></tr></table><br />
<p>The <strong>Billing/Payments &gt; TakePOS Digital Invoice</strong> menu is shown to users with read permission. The invoice tab is shown only on invoices originating from TakePOS and to users with the same permission.</p><br />
<br />
<h2>6. General settings</h2><br />
<p>Open the module settings and select the <strong>General</strong> tab. The defaults below are defined by the configuration page; Dolibarr may retain a value already stored for the entity.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Default</th><th style="padding:8px;border:1px solid #dee2e6;">Effect</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Public link lifetime</td><td style="padding:8px;border:1px solid #dee2e6;">30 days</td><td style="padding:8px;border:1px solid #dee2e6;">Period from invoice validation; minimum one day.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Maximum attempts</td><td style="padding:8px;border:1px solid #dee2e6;">5</td><td style="padding:8px;border:1px solid #dee2e6;">Limits submissions for the same invoice and hashed IP address.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Rate-limit window</td><td style="padding:8px;border:1px solid #dee2e6;">15 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Time window applied to the attempt counter.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Completed request retention</td><td style="padding:8px;border:1px solid #dee2e6;">365 days</td><td style="padding:8px;border:1px solid #dee2e6;">The scheduled cleanup can delete completed requests after this period.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Error request retention</td><td style="padding:8px;border:1px solid #dee2e6;">90 days</td><td style="padding:8px;border:1px solid #dee2e6;">The scheduled cleanup can delete requests in error after this period.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Privacy policy URL</td><td style="padding:8px;border:1px solid #dee2e6;">Empty</td><td style="padding:8px;border:1px solid #dee2e6;">Optional link displayed below the public form when configured.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">QR code message</td><td style="padding:8px;border:1px solid #dee2e6;">“Scan this QR code to request your electronic invoice.”</td><td style="padding:8px;border:1px solid #dee2e6;">Text printed or displayed with the QR code; an empty message falls back to the translated text.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Public form URL</td><td style="padding:8px;border:1px solid #dee2e6;">Computed</td><td style="padding:8px;border:1px solid #dee2e6;">Read-only value; verify it from outside the server.</td></tr></table><br />
<br />
<h2>7. Email and PDF settings</h2><br />
<p>In the <strong>Email</strong> tab, configure the following:</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Initial value</th><th style="padding:8px;border:1px solid #dee2e6;">Description</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Confirmation token lifetime</td><td style="padding:8px;border:1px solid #dee2e6;">24 hours</td><td style="padding:8px;border:1px solid #dee2e6;">The link is single-use and expires at its stored expiry time.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Resend delay</td><td style="padding:8px;border:1px solid #dee2e6;">2 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Minimum delay before requesting another email for the invoice.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Sender name</td><td style="padding:8px;border:1px solid #dee2e6;">Empty</td><td style="padding:8px;border:1px solid #dee2e6;">Optional name used with Dolibarr’s general sender address.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Verifalia verification</td><td style="padding:8px;border:1px solid #dee2e6;">Disabled</td><td style="padding:8px;border:1px solid #dee2e6;">Optional external deliverability check; requires API username and password.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Verifalia timeout</td><td style="padding:8px;border:1px solid #dee2e6;">20 seconds</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 5–30 seconds per call.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">PDF retrieval attempts</td><td style="padding:8px;border:1px solid #dee2e6;">4</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 1–6 checks of the same platform flow.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Delay between attempts</td><td style="padding:8px;border:1px solid #dee2e6;">2 seconds</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 1–5 seconds; no new transmission is made.</td></tr></table><br />
<p>The sender address comes from <code>MAIN_MAIL_EMAIL_FROM</code> in Dolibarr’s general email configuration. The module sender name is used for confirmation and PDF emails. If Verifalia is enabled without credentials, or its service rejects the request, submission is blocked with an appropriate error.</p><br />
<br />
<h2>8. Add the QR code to receipts</h2><br />
<h3>8.1. Browser receipt</h3><br />
<ol><li>Open the TakePOS setup and edit the relevant browser receipt template.</li><li>Insert the <code>__DOL_FAC_NUM__</code> tag once where the QR code should appear.</li><li>Save the template and print a receipt for a newly validated TakePOS invoice.</li></ol><br />
<p>On a browser receipt, the substitution displays a QR image produced by Dolibarr’s TCPDF engine, with the configured message. The module loads the invoice extrafields before performing the substitution.</p><br />
<h3>8.2. ESC/POS printer</h3><br />
<ol><li>In the RAW/Text printer setup, open the receipt template.</li><li>Add <code>{dol_fac_num}</code> once.</li><li>Select this template for the terminal and run a print check.</li></ol><br />
<p>The module documents this tag in the ESC/POS template help and replaces it with the native QR instruction <code>{dol_print_qrcode}</code> followed by the public URL. The ESC/POS replacements also recognize <code>{DOL_FAC_NUM}</code> and <code>{__DOL_FAC_NUM__}</code>. The QR message is sent as ESC/POS text after the code.</p><br />
<p>The module also prepares the substitutions <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code>, and <code>__dol_fac_num__</code>. If a valid hash is unavailable, substitutions are empty; while printing ESC/POS, the module tries to create the hash. If it fails, the tag is removed from the printout and an error is written to the Dolibarr log.</p><br />
<p>Do not add the tag in two locations in the same template. After enabling the module, verify a newly validated invoice: the hash is created by the TakePOS invoice validation trigger. Older receipts are not reprinted automatically.</p><br />
<br />
<h2>9. Public form and requested data</h2><br />
<p>The public page looks up the invoice using its hash. It requires the invoice to originate from TakePOS, the link to be within its lifetime, the invoice to be paid/closed, and the invoice still to be linked to the terminal’s default generic third party.</p><br />
<p>The public summary displays the seller, sale date, total including tax, terminal, and invoice reference masked except for its last four characters. It does not display sale lines, payment information, third-party identity, or the full invoice reference.</p><br />
<p>The form asks for:</p><br />
<ul><li>company name;</li><li>address and optional additional address;</li><li>postal code and town;</li><li>14-digit SIRET;</li><li>email address.</li></ul><br />
<p>The country is set to France in third-party processing; the form does not offer a country selector. The privacy policy link appears only when configured.</p><br />
<br />
<h2>10. Company and email checks</h2><br />
<h3>10.1. SIRET check</h3><br />
<p>The module queries the public Company Search API at <code>https://recherche-entreprises.api.gouv.fr/search?q=</code> using the submitted SIRET. It requires 14 digits, finds the matching establishment, and checks that its administrative status is active. It also compares the company name with the official data after normalizing accents, case, and separators, then compares the postal code and town (case and accents are normalized for the town).</p><br />
<p><strong>Current check limitation:</strong> the submitted street address is stored and may be used to create the third party, but the code does not compare it with the address returned by the API. Consistency checks cover the name, postal code, and town, not the street. A missing, closed, or invalid SIRET, or a mismatch in these checked fields, blocks submission. Network, DNS, TLS, timeout, unreadable-response, and service rate-limit errors produce specific or generic errors and do not create a third party.</p><br />
<h3>10.2. Email address check</h3><br />
<p>The module checks the email format, then uses DNS to check that the domain has an MX record. If Verifalia is enabled, its API is also called: addresses classified as undeliverable or disposable are rejected; deliverable, risky, and unknown results are accepted by this check. A service failure or credentials/credit error blocks submission when the option is enabled.</p><br />
<p>Email confirmation is still required even when Verifalia is disabled or returns an accepted result. The random token sent to the customer is stored hashed in the database, expires according to the configured duration, and can be used once. Resending is subject to the configured minimum delay.</p><br />
<br />
<h2>11. Confirmation and invoice processing</h2><br />
<ol><li>After a valid submission, the request is stored in the tracking table as <strong>Pending confirmation</strong>. A confirmation link is sent to the submitted address.</li><li>The customer opens the link before it expires. The token is consumed and the request changes to <strong>Ready</strong>.</li><li>Processing reloads the invoice and confirms it originates from TakePOS and is paid/closed. An atomic lock prevents the same request from being processed concurrently.</li><li>The module searches for a third party by exact SIRET, then by SIREN (the first nine digits), preferring an exact SIRET match. If none exists, it creates a French customer third party and lets Dolibarr assign the customer code.</li><li>The TakePOS invoice is linked to this third party. Generation or sending through EInvoicing is refused while the invoice is still linked to the terminal’s default third party.</li><li>The module checks that EInvoicing is enabled, its prerequisites are met, and its configured protocol is CII or Factur-X. It marks only this invoice as ready for EInvoicing generation.</li><li>EInvoicing generates a document for the selected protocol. For Factur-X, the Dolibarr source PDF is generated before requesting the hybrid Factur-X document. For CII, the protocol produces an XML file.</li><li>The provider configured in EInvoicing transmits the invoice to the approved platform. The module records the generation, transmission, and format steps.</li><li>The module queries the platform flow for its <strong>ReadableView</strong> resource, which must be a readable PDF. It makes the configured number of attempts if the view is not ready yet.</li><li>The official readable PDF is saved in the invoice document directory and emailed to the customer as an attachment.</li><li>After the email is sent successfully, the request changes to <strong>Completed</strong>.</li></ol><br />
<p>With CII, the XML file is used for transmission and the customer receives the platform’s official readable PDF. With Factur-X, the hybrid document is generated and transmitted, while the customer attachment remains the readable PDF retrieved from the platform. This module does not email the standard Dolibarr PDF to the customer.</p><br />
<br />
<h2>12. Request statuses</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Status</th><th style="padding:8px;border:1px solid #dee2e6;">Meaning</th><th style="padding:8px;border:1px solid #dee2e6;">Next step</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Pending confirmation</td><td style="padding:8px;border:1px solid #dee2e6;">The request is stored, but its email address has not been confirmed.</td><td style="padding:8px;border:1px solid #dee2e6;">The customer must open the link before it expires.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Ready</td><td style="padding:8px;border:1px solid #dee2e6;">Email is confirmed and processing can start.</td><td style="padding:8px;border:1px solid #dee2e6;">Automatic processing or the Retry action.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Processing</td><td style="padding:8px;border:1px solid #dee2e6;">The request is reserved for processing.</td><td style="padding:8px;border:1px solid #dee2e6;">Wait for processing to finish and check detailed status.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Error</td><td style="padding:8px;border:1px solid #dee2e6;">A step failed; its error code and step are retained.</td><td style="padding:8px;border:1px solid #dee2e6;">Fix the cause and retry if email was confirmed.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Completed</td><td style="padding:8px;border:1px solid #dee2e6;">Transmission and PDF email both succeeded.</td><td style="padding:8px;border:1px solid #dee2e6;">The public link reports that the request has already been processed.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Canceled</td><td style="padding:8px;border:1px solid #dee2e6;">The public link can no longer be used.</td><td style="padding:8px;border:1px solid #dee2e6;">No standard retry is offered.</td></tr></table><br />
<p>The table also stores separate indicators for email confirmation, SIRET validation, third-party linking, EInvoicing generation, platform transmission, PDF email, protocol used, error step, and creation, modification, completion, or cancellation dates.</p><br />
<br />
<h2>13. Track and manage requests</h2><br />
<h3>13.1. Request list</h3><br />
<p>Open <strong>Billing/Payments &gt; TakePOS Digital Invoice</strong>. The list shows the invoice, third party when known, SIRET, email address, status, last error code, and creation date. Columns can be sorted and results are paginated. Filters include invoice reference, third party, SIRET, email, and status. Invoice and third-party references open their Dolibarr records.</p><br />
<h3>13.2. Invoice tab</h3><br />
<p>On a TakePOS invoice, open the <strong>TakePOS Digital Invoice</strong> tab. It shows status, creation and modification dates, email confirmation, requester email, SIRET, protocol, generation/transmission/PDF email status, and, on failure, the step and error message. A download button is available when a readable PDF is present.</p><br />
<h3>13.3. Retry</h3><br />
<p>Retry is offered for a request whose email has been confirmed and whose status is Ready or Error. Processing resumes and uses the recorded indicators and platform flow. If transmission already succeeded, retry does not send a second invoice; it attempts to retrieve the PDF and complete delivery to the customer.</p><br />
<h3>13.4. Cancel</h3><br />
<p>Cancel asks for confirmation, invalidates the public link, and marks the request canceled unless it is already completed or canceled. The TakePOS invoice cancellation trigger also cancels a non-completed request. The request remains available for tracking until it is purged.</p><br />
<br />
<h2>14. EInvoicing configuration and sending conditions</h2><br />
<p>TakePOS Digital Invoice does not replace EInvoicing or configure the approved platform. Configure the EInvoicing module separately: select the platform, credentials, and protocol. This version’s workflow accepts only the <code>CII</code> and <code>FACTURX</code> protocol values.</p><br />
<p>An anonymous TakePOS customer cannot receive an electronic invoice while the invoice remains linked to the terminal’s generic third party. The module checks this explicitly, including in the hook that intercepts direct EInvoicing generate or send actions on a TakePOS invoice. Identifying the customer makes only that invoice eligible; it does not change the global TakePOS invoice eligibility setting.</p><br />
<p>If the EInvoicing protocol is changed after transmission, the module blocks using a different format for that request and asks for the format associated with the already-submitted flow to be restored. This avoids an inconsistent or duplicate transmission.</p><br />
<br />
<h2>15. Stored data, files, and privacy</h2><br />
<ul><li><strong>Invoice extrafield:</strong> <code>hash</code>, a random 64-character public identifier. Do not publish it separately or edit it manually.</li><li><strong>Request table:</strong> entity, invoice, optional third party, SIRET, company name, address, postal code, town, email, hashed IP fingerprint, hashed token and expiry, counters, statuses, errors, and timestamps.</li><li><strong>Documents:</strong> the EInvoicing electronic file and the platform’s readable PDF are stored with the invoice documents.</li><li><strong>Public summary:</strong> limited sale-identification details; invoice lines, payments, and third-party identity are not exposed before identification.</li><li><strong>Logs:</strong> the dedicated log is <code>DOL_DATA_ROOT/takeposdigitalinvoice/module.log</code>. Technical error details may also be present in Dolibarr logs. Review and redact logs before sharing them.</li></ul><br />
<p>The retention task is scheduled daily. It deletes completed requests according to completion date and error requests according to modification date. This cleanup method does not delete pending, ready, processing, or canceled requests. The task that purges requests does not delete invoice documents.</p><br />
<br />
<h2>16. Triggers, hooks, and substitutions</h2><br />
<ul><li><strong><code>BILL_VALIDATE</code>:</strong> for a validated TakePOS invoice, the trigger ensures the public hash exists and creates it if missing.</li><li><strong><code>BILL_CANCEL</code>:</strong> for a canceled TakePOS invoice, the trigger cancels its non-completed request.</li><li><strong>Browser receipt:</strong> the hook loads invoice extrafields before TakePOS substitutions are processed.</li><li><strong>ESC/POS templates:</strong> the hook adds the QR tag description to template help and substitutes the tag in the text sent to the printer.</li><li><strong>EInvoicing actions:</strong> a hook blocks direct generation or sending for a TakePOS invoice that remains linked to the default third party.</li><li><strong>Substitutions:</strong> the module provides <code>__DOL_FAC_NUM__</code>, <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code>, and <code>__dol_fac_num__</code> for a TakePOS invoice with a valid hash.</li><li><strong>Scheduled task:</strong> periodically purges completed or error requests after their configured retention periods.</li></ul><br />
<br />
<h2>17. Troubleshooting</h2><br />
<h3>The QR code is missing from the browser receipt</h3><p>Check that the module is enabled, the invoice comes from TakePOS, the template contains <code>__DOL_FAC_NUM__</code>, and the invoice was validated after activation. Check that the tag is not repeated. Browser substitution requires the hash to be loaded in the invoice extrafields.</p><br />
<h3>The QR code is missing from the ESC/POS printout</h3><p>Check the active RAW/Text template, the exact recognized tag, and that the template does not already send an equivalent tag. If the hash could not be stored, check Dolibarr logs and database/write permissions.</p><br />
<h3>The public link is rejected</h3><p>The hash must be valid; the invoice must originate from TakePOS, be closed/paid, and remain linked to the terminal’s generic third party. The link expires based on the validation date and configured duration. A completed request is reported as already processed; a canceled request cannot be used.</p><br />
<h3>SIRET verification fails</h3><p>Check the 14 digits, establishment status, company name, postal code, and town. A mismatch in these values or an unavailable API blocks the request. Current code does not compare the submitted street with the API address.</p><br />
<h3>No confirmation email arrives</h3><p>Check the address, domain and MX record, Dolibarr outbound email setup, and spam folder. If Verifalia is enabled, check the credentials, configured timeout, and service authentication or credit errors.</p><br />
<h3>Confirmation succeeded but processing failed</h3><p>Check the latest error and failed step in the list or invoice tab. Verify the third-party link, EInvoicing activation and setup, CII/Factur-X protocol, and access to Dolibarr documents. Then use Retry if the user has process permission.</p><br />
<h3>Transmission succeeded but the PDF is not ready</h3><p>The platform may create its readable view asynchronously. Retry later; the module checks the existing flow and does not transmit the invoice again.</p><br />
<h3>The download button is unavailable</h3><p>The button is enabled when the saved readable PDF is available, or when the invoice tab can use an accessible EInvoicing PDF as a fallback.</p><br />
<br />
<h2>18. Limitations and operational precautions</h2><br />
<ul><li>The current public workflow is for French companies with an active SIRET; it does not support individuals or foreign companies.</li><li>Establishment consistency checks cover company name, postal code, and town; current code does not compare the street address with official data.</li><li>The module retains one request per invoice. Do not create concurrent requests for the same invoice.</li><li>Do not manually remove or edit the hash, tokens, or processing indicators in the database.</li><li>Do not change the EInvoicing protocol during a request that has already been transmitted without restoring the format of its existing flow.</li><li>Do not edit the invoice’s third party while it is being processed.</li><li>Cleanup removes completed and error request history after the configured retention periods; retain any needed tracking information before then.</li></ul><br />
<br />
<h2>19. Support</h2><br />
<p>For help or to report a problem, contact [mailto:contact@01consulting.eu contact@01consulting.eu]. Include the module and Dolibarr versions, receipt type, workflow step, request status, error code, and approximate time. Redact SIRET, email addresses, tokens, platform credentials, invoice details, and any other confidential information from screenshots and log extracts.</p><br />
<br />
</div></div><br />
[[fr:Facture_numérique_pour_TakePOS]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Facture_num%C3%A9rique_pour_TakePOS&diff=67482Facture numérique pour TakePOS2026-09-29T14:30:53Z<p>Abahfir: module takepos digital invoice fr</p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><div style="width:100%;"><br />
<h1>Facture électronique TakePOS</h1><br />
<p><strong>Résumé<span> </span>:</strong> Permet à l’acheteur d’une vente TakePOS de demander sa facture électronique au moyen d’un QR code sur son reçu.<br><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 23.0 ou supérieur, PHP 7.2 ou supérieur<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-29</p><br />
<p><strong>Vidéo de démonstration<span> </span>:</strong></p><br />
<youtube width="560" height="315">PaenAajCX0E</youtube><br />
<p><strong>Site de démonstration<span> </span>:</strong> [https://01consulting.eu/demo/htdocs/ Ouvrir le site de démonstration]</p><br />
<p><strong>Site de l’éditeur<span> </span>:</strong> [https://01consulting.eu/ 01Consulting]</p><br />
<p>Ce guide couvre l’installation, les réglages, le QR code des reçus, le parcours client, le suivi des demandes, l’intégration EInvoicing, les permissions et le diagnostic.</p><br />
<br />
<h2>1. Rôle du module et périmètre</h2><br />
<p>Les ventes TakePOS sont souvent enregistrées avec le tiers générique associé au terminal. Ce module donne à l’acheteur d’une vente payée un parcours pour fournir les coordonnées de son entreprise, confirmer son adresse e-mail et demander la facture électronique correspondant à cette vente.</p><br />
<p>Le traitement identifie ou crée un tiers client, rattache la facture TakePOS à ce tiers, prépare la facture avec EInvoicing, la transmet au prestataire configuré dans EInvoicing, puis envoie au demandeur le PDF lisible officiel récupéré auprès de ce prestataire.</p><br />
<p>Le parcours public est destiné aux entreprises françaises disposant d’un SIRET actif à 14 chiffres. Il ne sert pas à créer une nouvelle facture commerciale<span> </span>: il agit sur la facture TakePOS déjà payée. Les particuliers et les entreprises étrangères ne sont pas pris en charge.</p><br />
<br />
<h2>2. Fonctionnement d’ensemble</h2><br />
<ol><li>À la validation d’une facture TakePOS, le module crée un identifiant aléatoire de 64 caractères et le conserve dans l’extrafield de facture <code>hash</code>.</li><li>Le reçu imprime ou affiche un QR code qui ouvre le formulaire public de cette facture.</li><li>L’acheteur fournit les coordonnées de l’entreprise et son SIRET ; le module contrôle les champs, le domaine e-mail et les données disponibles dans le registre officiel.</li><li>Le module envoie un lien de confirmation à l’adresse fournie. La demande n’est pas traitée avant l’ouverture de ce lien.</li><li>Après confirmation, le module réutilise le tiers correspondant ou crée un tiers, puis rattache la facture payée au tiers identifié.</li><li>EInvoicing génère le document électronique selon le protocole configuré et le transmet à la plateforme agréée.</li><li>Le module récupère la vue PDF lisible officielle de la plateforme et l’envoie par e-mail au demandeur.</li></ol><br />
<p>Une erreur à une étape est enregistrée sur la demande. Un utilisateur autorisé peut relancer le traitement ; si la facture a déjà été transmise, le même flux est repris pour récupérer le PDF et la facture n’est pas envoyée une seconde fois.</p><br />
<br />
<h2>3. Prérequis et compatibilité</h2><br />
<ul><li><strong>Dolibarr<span> </span>:</strong> le descripteur déclare Dolibarr 23.0 ou supérieur ; le module a été préparé pour Dolibarr 23.0.3.</li><li><strong>PHP<span> </span>:</strong> version 7.2 minimum déclarée par le module.</li><li><strong>Modules Dolibarr<span> </span>:</strong> Factures, TakePOS et EInvoicing doivent être activés.</li><li><strong>EInvoicing<span> </span>:</strong> le module doit être configuré avec une plateforme agréée, ses prérequis satisfaits et un protocole CII ou Factur-X.</li><li><strong>E-mails<span> </span>:</strong> l’envoi des e-mails depuis Dolibarr doit être correctement configuré.</li><li><strong>Serveur<span> </span>:</strong> il doit pouvoir joindre l’API Recherche d’entreprises, le service DNS et, si cette option est activée, l’API Verifalia en HTTPS.</li><li><strong>Accès client<span> </span>:</strong> l’adresse publique de Dolibarr doit être joignable depuis le téléphone qui scanne le reçu.</li><li><strong>Terminal TakePOS<span> </span>:</strong> chaque point de vente concerné doit disposer d’un tiers générique par défaut, utilisé pour déterminer si l’acheteur est encore anonyme.</li></ul><br />
<br />
<h2>4. Installation, activation et mise à jour</h2><br />
<h3>4.1. Installer et activer</h3><br />
<ol><li>Copier le dossier <code>takeposdigitalinvoice</code> dans <code>htdocs/custom</code>.</li><li>Dans Dolibarr, ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li>Activer <strong>Facture électronique TakePOS</strong>. Vérifier auparavant que Factures, TakePOS et EInvoicing sont disponibles et activés.</li><li>Ouvrir la configuration du module et renseigner les onglets <strong>Général</strong> et <strong>E-mails</strong>.</li><li>Attribuer les permissions de lecture et de traitement aux utilisateurs concernés.</li><li>Ajouter le tag du QR code au modèle de reçu navigateur et/ou au modèle ESC/POS utilisé par le terminal.</li><li>Réaliser une vente de test et vérifier le QR code, le formulaire public, la confirmation par e-mail et le suivi de la demande.</li></ol><br />
<p>L’activation charge la table des demandes, ajoute l’extrafield de facture <code>hash</code> (varchar de 64 caractères), déclare le menu de suivi, l’onglet de facture, les permissions et la tâche planifiée de rétention. Une migration intégrée traite aussi les anciennes colonnes de suivi CII et renseigne le format à partir des documents déjà générés lorsque cela est possible.</p><br />
<h3>4.2. Mettre à jour</h3><br />
<p>Sauvegarder la base de données et le répertoire de documents Dolibarr avant la mise à jour. Remplacer les fichiers du module par la nouvelle version, puis réactiver le module si sa déclaration de menu ou d’onglet a changé. L’activation exécute les migrations prévues par le descripteur. Contrôler la page de configuration, le menu de demandes et l’onglet d’une facture TakePOS après la mise à jour.</p><br />
<h3>4.3. Désactiver ou désinstaller</h3><br />
<p>La procédure et les effets de suppression des tables, de l’extrafield et des documents dépendent de l’opération choisie dans Dolibarr. Sauvegarder les données avant toute désinstallation et vérifier les conséquences affichées par Dolibarr. La désactivation empêche le fonctionnement du parcours tant que le module reste inactif.</p><br />
<br />
<h2>5. Permissions, menus et écrans</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Droit ou écran</th><th style="padding:8px;border:1px solid #dee2e6;">Fonction</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Consulter les demandes</td><td style="padding:8px;border:1px solid #dee2e6;">Ouvre le menu de liste et l’onglet de suivi sur une facture TakePOS. Le droit Dolibarr de consulter la facture reste requis.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Traiter les demandes</td><td style="padding:8px;border:1px solid #dee2e6;">Autorise les actions Réessayer et Annuler dans la liste et l’onglet de facture.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Administrer les demandes</td><td style="padding:8px;border:1px solid #dee2e6;">Droit déclaré dans le descripteur du module. Les pages de configuration vérifient également le statut d’administrateur Dolibarr.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Configuration</td><td style="padding:8px;border:1px solid #dee2e6;">Accessible aux administrateurs Dolibarr depuis la fiche de configuration du module ; comprend les onglets Général, E-mails et À propos.</td></tr></table><br />
<p>Le menu <strong>Facturation/Paiement &gt; Facture électronique TakePOS</strong> est affiché aux utilisateurs ayant le droit de lecture. L’onglet de facture n’apparaît que pour les factures dont la source est TakePOS et si l’utilisateur possède ce même droit.</p><br />
<br />
<h2>6. Configuration générale</h2><br />
<p>Ouvrir la fiche du module, puis l’onglet <strong>Général</strong>. Les valeurs par défaut suivantes sont définies dans le code de la page de configuration ; Dolibarr peut conserver une valeur déjà enregistrée pour l’entité.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Réglage</th><th style="padding:8px;border:1px solid #dee2e6;">Défaut</th><th style="padding:8px;border:1px solid #dee2e6;">Effet</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Durée du lien public</td><td style="padding:8px;border:1px solid #dee2e6;">30 jours</td><td style="padding:8px;border:1px solid #dee2e6;">Durée à partir de la validation de la facture ; au minimum un jour.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Nombre maximal de tentatives</td><td style="padding:8px;border:1px solid #dee2e6;">5</td><td style="padding:8px;border:1px solid #dee2e6;">Limite les soumissions pour une même facture et une même adresse IP hachée.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Fenêtre de limitation</td><td style="padding:8px;border:1px solid #dee2e6;">15 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Fenêtre de temps appliquée au compteur de tentatives.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Conservation des demandes terminées</td><td style="padding:8px;border:1px solid #dee2e6;">365 jours</td><td style="padding:8px;border:1px solid #dee2e6;">Après ce délai, la tâche de rétention peut supprimer les demandes terminées.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Conservation des erreurs</td><td style="padding:8px;border:1px solid #dee2e6;">90 jours</td><td style="padding:8px;border:1px solid #dee2e6;">Après ce délai, la tâche peut supprimer les demandes en erreur.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">URL de politique de confidentialité</td><td style="padding:8px;border:1px solid #dee2e6;">Vide</td><td style="padding:8px;border:1px solid #dee2e6;">Lien facultatif affiché sous le formulaire public lorsqu’il est renseigné.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Message du QR code</td><td style="padding:8px;border:1px solid #dee2e6;">« Scannez ce QR code pour demander votre facture électronique. »</td><td style="padding:8px;border:1px solid #dee2e6;">Texte imprimé ou affiché avec le QR code ; un message vide revient au texte traduit.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">URL du formulaire public</td><td style="padding:8px;border:1px solid #dee2e6;">Calculée</td><td style="padding:8px;border:1px solid #dee2e6;">Valeur en lecture seule à vérifier depuis l’extérieur du serveur.</td></tr></table><br />
<br />
<h2>7. Configuration des e-mails et du PDF</h2><br />
<p>Dans l’onglet <strong>E-mails</strong>, régler les éléments suivants<span> </span>:</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Réglage</th><th style="padding:8px;border:1px solid #dee2e6;">Valeur initiale</th><th style="padding:8px;border:1px solid #dee2e6;">Description</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Durée du jeton de confirmation</td><td style="padding:8px;border:1px solid #dee2e6;">24 heures</td><td style="padding:8px;border:1px solid #dee2e6;">Le lien est à usage unique et expire à la date enregistrée.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Délai de renvoi</td><td style="padding:8px;border:1px solid #dee2e6;">2 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Délai minimal avant une nouvelle demande d’e-mail pour cette facture.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Nom de l’expéditeur</td><td style="padding:8px;border:1px solid #dee2e6;">Vide</td><td style="padding:8px;border:1px solid #dee2e6;">Nom facultatif ajouté à l’adresse d’expédition générale de Dolibarr.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Vérification Verifalia</td><td style="padding:8px;border:1px solid #dee2e6;">Désactivée</td><td style="padding:8px;border:1px solid #dee2e6;">Contrôle externe facultatif de la délivrabilité ; requiert identifiant et mot de passe API.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Délai maximal Verifalia</td><td style="padding:8px;border:1px solid #dee2e6;">20 secondes</td><td style="padding:8px;border:1px solid #dee2e6;">Valeur admise<span> </span>: 5 à 30 secondes par appel.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Tentatives de récupération du PDF</td><td style="padding:8px;border:1px solid #dee2e6;">4</td><td style="padding:8px;border:1px solid #dee2e6;">Valeur admise<span> </span>: 1 à 6 consultations du même flux.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Attente entre les tentatives</td><td style="padding:8px;border:1px solid #dee2e6;">2 secondes</td><td style="padding:8px;border:1px solid #dee2e6;">Valeur admise<span> </span>: 1 à 5 secondes ; aucune nouvelle transmission n’est effectuée.</td></tr></table><br />
<p>L’adresse d’expédition est <code>MAIN_MAIL_EMAIL_FROM</code>, définie dans la configuration générale des e-mails de Dolibarr. Le nom d’expéditeur du module est utilisé pour l’e-mail de confirmation et celui contenant le PDF. Si Verifalia est activé sans identifiants, ou si son service refuse la requête, la demande est bloquée avec un message adapté.</p><br />
<br />
<h2>8. Ajouter le QR code aux reçus</h2><br />
<h3>8.1. Reçu navigateur</h3><br />
<ol><li>Ouvrir la configuration du module TakePOS, puis le modèle du reçu navigateur concerné.</li><li>Insérer une fois le tag <code>__DOL_FAC_NUM__</code> à l’emplacement souhaité.</li><li>Enregistrer le modèle et imprimer le reçu d’une nouvelle facture TakePOS validée.</li></ol><br />
<p>Dans le reçu navigateur, la substitution affiche une image QR produite par le moteur TCPDF de Dolibarr, avec le message configuré. Le module charge les extrafields de la facture avant la substitution.</p><br />
<h3>8.2. Imprimante ESC/POS</h3><br />
<ol><li>Dans la configuration de l’imprimante RAW/Texte, ouvrir le modèle de reçu.</li><li>Ajouter une seule fois <code>{dol_fac_num}</code>.</li><li>Sélectionner ce modèle pour le terminal, puis effectuer une impression de contrôle.</li></ol><br />
<p>Le module documente le tag dans l’aide de configuration des modèles ESC/POS et le remplace par l’instruction QR native <code>{dol_print_qrcode}</code>, suivie de l’URL publique. Les variantes <code>{DOL_FAC_NUM}</code> et <code>{__DOL_FAC_NUM__}</code> sont aussi reconnues par le remplacement ESC/POS. Le message QR est envoyé comme texte ESC/POS après le code.</p><br />
<p>Les substitutions <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code> et <code>__dol_fac_num__</code> sont également préparées par le module. Si aucun hash valide n’est disponible, les substitutions sont vides ; au moment de l’impression ESC/POS, le module tente de créer le hash. S’il échoue, il retire le tag de l’impression et écrit une erreur dans le journal Dolibarr.</p><br />
<p>Ne pas ajouter le tag dans deux emplacements du même modèle. Après l’activation du module, vérifier une facture nouvellement validée<span> </span>: le hash est créé lors du déclencheur de validation de facture TakePOS. Les anciens reçus ne sont pas réimprimés automatiquement.</p><br />
<br />
<h2>9. Formulaire public et données demandées</h2><br />
<p>Le formulaire reçoit le hash de la facture dans son URL. Il n’est accepté que si le hash correspond à une facture dont la source est TakePOS, si le lien n’a pas expiré, si la facture est payée/clôturée et si elle est toujours rattachée au tiers générique du terminal.</p><br />
<p>Le résumé public affiche le nom du vendeur, la date de vente, le total TTC, le terminal et une référence de facture masquée sauf ses quatre derniers caractères. Il ne montre pas les lignes de vente, les informations de paiement, l’identité du tiers ni la référence complète.</p><br />
<p>Le formulaire demande<span> </span>:</p><br />
<ul><li>raison sociale ;</li><li>adresse et complément d’adresse facultatif ;</li><li>code postal et ville ;</li><li>SIRET à 14 chiffres ;</li><li>adresse e-mail.</li></ul><br />
<p>Le pays est fixé à la France dans le traitement du tiers ; il n’est pas proposé comme choix dans le formulaire. L’URL de politique de confidentialité est affichée uniquement si elle est configurée.</p><br />
<br />
<h2>10. Contrôles d’entreprise et de l’adresse e-mail</h2><br />
<h3>10.1. Contrôle du SIRET</h3><br />
<p>Le module interroge l’API publique Recherche d’entreprises à l’adresse <code>https://recherche-entreprises.api.gouv.fr/search?q=</code>, avec le SIRET fourni. Il exige 14 chiffres, trouve l’établissement correspondant et vérifie que son état administratif est actif. Il compare aussi la raison sociale à la donnée officielle après normalisation des accents, casse et séparateurs, puis compare le code postal et la ville (casse et accents normalisés pour la ville).</p><br />
<p><strong>Limite du contrôle actuel<span> </span>:</strong> l’adresse de voie saisie est enregistrée et peut servir à créer le tiers, mais le code ne la compare pas aux champs d’adresse retournés par l’API. La validation de cohérence couvre le nom, le code postal et la ville, pas la rue. Un SIRET absent, fermé, invalide ou une divergence sur ces champs bloque la soumission. Les erreurs réseau, DNS, TLS, délai dépassé, réponse illisible et limitation du service donnent des messages distincts ou génériques et ne créent pas de tiers.</p><br />
<h3>10.2. Contrôle de l’adresse e-mail</h3><br />
<p>Le module vérifie le format de l’adresse, puis vérifie par DNS que le domaine possède un enregistrement MX. Si Verifalia est activé, son API est également appelée<span> </span>: les adresses classées non délivrables ou jetables sont refusées ; les résultats classés délivrables, risqués ou inconnus sont acceptés par ce contrôle. Une panne ou une erreur d’identification/crédit Verifalia bloque la soumission lorsque l’option est activée.</p><br />
<p>La confirmation par e-mail reste requise même quand Verifalia est désactivé ou renvoie un résultat accepté. Le jeton aléatoire envoyé au client est stocké sous forme hachée en base, expire selon la durée configurée et ne peut être utilisé qu’une fois. Le renvoi est soumis au délai minimal configuré.</p><br />
<br />
<h2>11. Confirmation et traitement de la facture</h2><br />
<ol><li>À la soumission valide, la demande est enregistrée dans la table de suivi en état <strong>En attente de confirmation</strong>. Le lien de confirmation est envoyé à l’adresse saisie.</li><li>Le client ouvre le lien reçu avant son expiration. Le jeton est consommé et l’état de la demande passe à <strong>Prête</strong>.</li><li>Le traitement recharge la facture et confirme qu’elle provient de TakePOS et qu’elle est payée/clôturée. Un verrou atomique évite le traitement concurrent d’une même demande.</li><li>Le module recherche un tiers par SIRET, puis par SIREN (les neuf premiers chiffres), avec priorité à la correspondance exacte de SIRET. S’il n’existe pas, il crée un tiers client français et laisse Dolibarr attribuer le code client.</li><li>La facture TakePOS est rattachée à ce tiers. Tant qu’elle est encore liée au tiers par défaut du terminal, la préparation et l’envoi EInvoicing sont refusés.</li><li>Le module vérifie qu’EInvoicing est actif, que ses prérequis sont satisfaits et que le protocole configuré est CII ou Factur-X. Il marque uniquement cette facture comme prête à la génération EInvoicing.</li><li>EInvoicing génère le document correspondant au protocole. Pour Factur-X, le PDF Dolibarr source est généré avant de demander le document Factur-X hybride. Pour CII, le protocole produit le fichier XML.</li><li>Le fournisseur configuré dans EInvoicing transmet la facture à la plateforme agréée. Le module mémorise les étapes de génération, de transmission et le format.</li><li>Le module interroge le flux de la plateforme pour récupérer sa ressource <strong>ReadableView</strong>, qui doit être un PDF lisible. Il effectue le nombre de tentatives configuré lorsque la vue n’est pas encore prête.</li><li>Le PDF lisible officiel est enregistré dans le dossier documentaire de la facture et envoyé en pièce jointe au client.</li><li>Après l’envoi réussi de l’e-mail, la demande passe à l’état <strong>Terminée</strong>.</li></ol><br />
<p>Pour le protocole CII, le fichier XML sert à la transmission ; le client reçoit le PDF lisible officiel de la plateforme. Pour Factur-X, le document hybride est généré et transmis, tandis que la pièce jointe client reste la vue lisible PDF récupérée auprès de la plateforme. Le PDF standard Dolibarr n’est pas le document envoyé au client par ce module.</p><br />
<br />
<h2>12. États d’une demande</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">État</th><th style="padding:8px;border:1px solid #dee2e6;">Signification</th><th style="padding:8px;border:1px solid #dee2e6;">Action suivante</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">En attente de confirmation</td><td style="padding:8px;border:1px solid #dee2e6;">La demande est enregistrée, mais l’adresse e-mail n’a pas encore été confirmée.</td><td style="padding:8px;border:1px solid #dee2e6;">Le client doit ouvrir le lien reçu avant expiration.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Prête</td><td style="padding:8px;border:1px solid #dee2e6;">L’e-mail est confirmé et le traitement peut démarrer.</td><td style="padding:8px;border:1px solid #dee2e6;">Traitement automatique ou action Réessayer.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">En cours</td><td style="padding:8px;border:1px solid #dee2e6;">La demande a été réservée pour un traitement.</td><td style="padding:8px;border:1px solid #dee2e6;">Attendre la fin du traitement et consulter l’état détaillé.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Erreur</td><td style="padding:8px;border:1px solid #dee2e6;">Une étape a échoué ; le code d’erreur et l’étape sont conservés.</td><td style="padding:8px;border:1px solid #dee2e6;">Corriger la cause et utiliser Réessayer si l’e-mail a été confirmé.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Terminée</td><td style="padding:8px;border:1px solid #dee2e6;">La transmission et l’envoi du PDF ont réussi.</td><td style="padding:8px;border:1px solid #dee2e6;">Le lien public indique que la demande a déjà été traitée.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Annulée</td><td style="padding:8px;border:1px solid #dee2e6;">La demande ne peut plus utiliser son lien public.</td><td style="padding:8px;border:1px solid #dee2e6;">Aucune relance standard n’est proposée.</td></tr></table><br />
<p>La table conserve également des indicateurs distincts pour la confirmation de l’e-mail, la validation SIRET, le rattachement du tiers, la génération EInvoicing, l’envoi à la plateforme, l’envoi du PDF, le protocole utilisé, l’étape de l’erreur et les dates de création, modification, fin ou annulation.</p><br />
<br />
<h2>13. Suivre et gérer les demandes</h2><br />
<h3>13.1. Liste générale</h3><br />
<p>Ouvrir <strong>Facturation/Paiement &gt; Facture électronique TakePOS</strong>. La liste présente la facture, le tiers lorsqu’il est connu, le SIRET, l’adresse e-mail, l’état, le dernier code d’erreur et la date de création. Les colonnes autorisent le tri et la liste est paginée. Les filtres portent sur la référence de facture, le tiers, le SIRET, l’e-mail et l’état. Les références de facture et de tiers ouvrent leurs fiches Dolibarr.</p><br />
<h3>13.2. Onglet de la facture</h3><br />
<p>Sur la fiche d’une facture TakePOS, ouvrir l’onglet <strong>Facture électronique TakePOS</strong>. Il affiche l’état, les dates de création et de modification, la confirmation e-mail, l’e-mail du demandeur, le SIRET, le protocole, les états de génération/transmission/envoi du PDF et, en cas d’échec, l’étape ainsi que le message d’erreur. Le bouton de téléchargement est disponible si un PDF lisible est présent.</p><br />
<h3>13.3. Réessayer</h3><br />
<p>L’action est proposée pour une demande dont l’e-mail est confirmé et dont l’état est Prête ou Erreur. Le service reprend le traitement et réutilise les indicateurs et le flux de plateforme déjà enregistrés. Si la transmission a déjà réussi, la relance n’envoie pas une deuxième facture ; elle cherche à récupérer la vue PDF et à terminer l’envoi au client.</p><br />
<h3>13.4. Annuler</h3><br />
<p>L’action Annuler demande une confirmation, invalide le lien public et marque la demande comme annulée, tant qu’elle n’est ni terminée ni déjà annulée. Elle est également appelée automatiquement par le déclencheur de facture TakePOS lors de l’annulation de la facture. La demande et son état restent consultables jusqu’à leur éventuelle purge.</p><br />
<br />
<h2>14. Configuration EInvoicing et conditions d’envoi</h2><br />
<p>TakePOS Digital Invoice ne remplace pas EInvoicing et ne configure pas la plateforme agréée. Le module externe doit être activé et configuré séparément<span> </span>: choix de la plateforme, identifiants et protocole. Le parcours de cette version accepte uniquement les valeurs de protocole <code>CII</code> et <code>FACTURX</code>.</p><br />
<p>Le client TakePOS anonyme ne peut pas recevoir une facture électronique tant que la facture demeure liée au tiers générique du terminal. Le module vérifie explicitement ce point, y compris dans le hook qui intercepte les actions directes de génération ou d’envoi EInvoicing sur une facture TakePOS. L’identification du client ne rend éligible que la facture concernée ; elle ne change pas le réglage global d’éligibilité des factures TakePOS.</p><br />
<p>Si le protocole EInvoicing est changé après une transmission, le module bloque le changement de format pour cette demande et demande de rétablir le format associé au flux déjà déposé afin d’éviter une nouvelle transmission incohérente.</p><br />
<br />
<h2>15. Données enregistrées, fichiers et confidentialité</h2><br />
<ul><li><strong>Extrafield facture<span> </span>:</strong> <code>hash</code>, identifiant public aléatoire de 64 caractères. Ne pas le publier séparément ni le modifier manuellement.</li><li><strong>Table des demandes<span> </span>:</strong> entité, facture, tiers éventuel, SIRET, raison sociale, adresse, code postal, ville, e-mail, empreinte de l’adresse IP, empreinte et expiration du jeton, compteurs, états, erreurs et horodatages.</li><li><strong>Documents<span> </span>:</strong> le fichier électronique EInvoicing et le PDF lisible de la plateforme sont enregistrés parmi les documents de la facture, sous le répertoire documentaire de celle-ci.</li><li><strong>Résumé public<span> </span>:</strong> données réduites à l’identification de la vente ; les lignes de facture, les paiements et l’identité du tiers ne sont pas exposés avant identification.</li><li><strong>Journaux<span> </span>:</strong> le journal dédié est <code>DOL_DATA_ROOT/takeposdigitalinvoice/module.log</code>. Des détails d’erreur peuvent aussi se trouver dans les journaux Dolibarr. Ne pas publier ces journaux sans les relire et masquer toute donnée sensible.</li></ul><br />
<p>La tâche de rétention est déclarée avec une fréquence quotidienne. Elle purge les demandes terminées selon leur date de fin et les demandes en erreur selon leur date de modification. Elle ne purge pas dans cette méthode les demandes en attente, prêtes, en cours ou annulées. Les fichiers de facture ne sont pas supprimés par cette tâche de purge des demandes.</p><br />
<br />
<h2>16. Déclencheurs, hooks et substitutions</h2><br />
<ul><li><strong><code>BILL_VALIDATE</code><span> </span>:</strong> pour une facture issue de TakePOS et validée, le trigger s’assure que le hash public existe et le crée s’il manque.</li><li><strong><code>BILL_CANCEL</code><span> </span>:</strong> pour une facture TakePOS annulée, le trigger annule sa demande non terminée.</li><li><strong>Reçu navigateur<span> </span>:</strong> le hook charge les extrafields de la facture avant le traitement des substitutions TakePOS.</li><li><strong>Modèles ESC/POS<span> </span>:</strong> le hook ajoute la description du tag QR à l’aide des modèles et substitue le tag dans le texte envoyé à l’imprimante.</li><li><strong>Actions EInvoicing<span> </span>:</strong> un hook refuse la génération ou l’envoi direct sur une facture TakePOS restée rattachée au tiers par défaut.</li><li><strong>Substitutions<span> </span>:</strong> le module renseigne <code>__DOL_FAC_NUM__</code>, <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code> et <code>__dol_fac_num__</code> pour une facture TakePOS avec hash valide.</li><li><strong>Tâche planifiée<span> </span>:</strong> purge périodiquement les demandes terminées ou en erreur au-delà de leurs durées de conservation.</li></ul><br />
<br />
<h2>17. Dépannage</h2><br />
<h3>Le QR code n’apparaît pas sur le reçu navigateur</h3><p>Vérifier que le module est activé, que la facture provient de TakePOS, que le modèle contient <code>__DOL_FAC_NUM__</code> et que la facture a été validée après activation. Vérifier aussi que le tag n’est pas placé deux fois. Le tag navigateur dépend du hash chargé dans les extrafields.</p><br />
<h3>Le QR code ne sort pas sur l’imprimante ESC/POS</h3><p>Vérifier le modèle RAW/Texte actif, l’orthographe du tag reconnu et que le modèle n’envoie pas déjà un autre tag équivalent. Si le hash n’a pas pu être enregistré, consulter le journal Dolibarr et les permissions d’écriture/base de données.</p><br />
<h3>Le lien public est refusé</h3><p>Le hash doit être valide, la facture doit provenir de TakePOS, être clôturée/payée et rester liée au tiers générique du terminal. Le lien expire selon la durée depuis la validation. Une demande terminée affiche qu’elle a déjà été traitée ; une demande annulée ne peut plus être utilisée.</p><br />
<h3>La vérification SIRET échoue</h3><p>Vérifier les 14 chiffres, l’activité de l’établissement, la raison sociale, le code postal et la ville saisis. Une divergence sur ces valeurs ou une indisponibilité de l’API bloque la demande. Le contrôle ne compare pas actuellement la rue saisie aux données de l’API.</p><br />
<h3>Aucun e-mail de confirmation n’arrive</h3><p>Vérifier l’adresse, le domaine et son enregistrement MX, la configuration générale d’envoi Dolibarr et le dossier de courrier indésirable. Si Verifalia est actif, contrôler les identifiants, le délai configuré et les réponses d’authentification ou de crédit du service.</p><br />
<h3>La confirmation est faite mais le traitement échoue</h3><p>Consulter la dernière erreur et l’étape concernée dans la liste ou l’onglet de facture. Vérifier le rattachement du tiers, l’activation et la configuration d’EInvoicing, le protocole CII/Factur-X et l’accès aux documents Dolibarr, puis utiliser Réessayer lorsque le droit de traitement est attribué.</p><br />
<h3>La transmission est faite mais le PDF n’est pas encore disponible</h3><p>La plateforme peut générer sa vue lisible de manière asynchrone. Réessayer plus tard<span> </span>: le module interroge le flux existant et ne transmet pas à nouveau la facture.</p><br />
<h3>Le bouton de téléchargement est indisponible</h3><p>Le bouton devient actif quand le PDF lisible enregistré est disponible, ou lorsqu’un fichier PDF EInvoicing accessible peut être utilisé comme solution de repli par l’onglet de facture.</p><br />
<br />
<h2>18. Limites et précautions d’exploitation</h2><br />
<ul><li>Le parcours public actuel est réservé aux entreprises françaises avec SIRET actif ; il ne gère pas les particuliers ou sociétés étrangères.</li><li>La cohérence de l’établissement contrôle le nom, le code postal et la ville ; l’adresse de rue n’est pas comparée aux données officielles par le code actuel.</li><li>Une demande par facture est conservée dans le module. Ne pas créer des demandes concurrentes pour une même facture.</li><li>Ne pas supprimer ni modifier manuellement le hash, les jetons ou les indicateurs de traitement dans la base.</li><li>Ne pas changer le protocole EInvoicing au milieu d’une demande déjà transmise sans rétablir le format de son flux.</li><li>Ne pas modifier le tiers de la facture pendant son traitement.</li><li>La purge supprime l’historique des demandes terminées ou en erreur après les durées réglées ; conserver les informations nécessaires au suivi avant ces échéances.</li></ul><br />
<br />
<h2>19. Assistance</h2><br />
<p>Pour obtenir de l’aide ou signaler un problème, contacter [mailto:contact@01consulting.eu contact@01consulting.eu]. Indiquer la version du module et de Dolibarr, le type de reçu, l’étape du parcours, l’état de la demande, le code d’erreur et l’heure approximative. Masquer le SIRET, l’adresse e-mail, les jetons, les identifiants de plateforme, les données de facture et toute autre information confidentielle avant de partager une capture ou un extrait de journal.</p><br />
<br />
</div></div><br />
[[en:TakePOS_Digital_Invoice]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67481Label Designer2026-09-29T14:24:25Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Label Designer User Guide</h1><br />
<p style="line-height:1.6;"><strong>Module version:</strong> 1.0.0<br><strong>Declared compatibility:</strong> Dolibarr 20.0+, PHP 7.4+<br><strong>Last documentation review:</strong> 2026-09-26</p><br />
<p><strong>Demo video:</strong></p><br />
<youtube width="560" height="315">Hcec6UGBJtI</youtube><br />
<p><strong>Demo site:</strong> [https://01consulting.eu/demo/htdocs/ Open the demo site]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">This guide describes, step by step, how to install, configure, and use Label Designer 1.0.0 for Dolibarr.</p><br />
<h2 id="sec-1">1. Module overview</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer lets you visually create label templates and generate PDF files using data stored in Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The module supports four object types:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">products and services;</li><li style="margin:0 0 4px 0;">product batches;</li><li style="margin:0 0 4px 0;">warehouses;</li><li style="margin:0 0 4px 0;">third parties (customers and suppliers).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">One template is created for each object type and reused automatically. You do not need a separate label for every product, batch, warehouse, or third party. When a PDF is generated, template variables are replaced with the current object's data.</p><br />
<h2 id="sec-2">2. Requirements</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Before installation, check that:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 20 or later is installed;</li><li style="margin:0 0 4px 0;">PHP 7.4 or later is available;</li><li style="margin:0 0 4px 0;">Dolibarr's <strong>Barcodes</strong> module is available;</li><li style="margin:0 0 4px 0;">the web server can write to the Dolibarr documents directory.</li></ul><br />
<h2 id="sec-3">3. Installation and activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copy the <code>labeldesigner</code> directory to <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Sign in to Dolibarr with an administrator account.</li><li style="margin:0 0 4px 0;">Go to <strong>Home &gt; Setup &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Find <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Enable the module.</li><li style="margin:0 0 4px 0;">Make sure the <strong>Barcodes</strong> module is also enabled.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">When activated, Label Designer prepares its storage directory in Dolibarr documents and enables barcode use for products and third parties.</p><br />
<h2 id="sec-4">4. Configure user permissions</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the relevant user or group record.</li><li style="margin:0 0 4px 0;">Open the <strong>Permissions</strong> tab.</li><li style="margin:0 0 4px 0;">Grant the required Label Designer permissions:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">read labels;</li><li style="margin:0 0 4px 0;">create and modify templates and PDFs.</li></ul></li><li style="margin:0 0 4px 0;">Make sure the user can also view the relevant object: product, batch, warehouse, or third party.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Without permission to view the object, some data or variables may not be available.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">After an update that adds or changes module permissions, disable and re-enable Label Designer so Dolibarr registers the new permissions. You can then grant <strong>Read labels</strong> and <strong>Create labels</strong> separately to users and groups.</p><br />
<h2 id="sec-5">5. Open a label</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open a product, batch, warehouse, or third-party record.</li><li style="margin:0 0 4px 0;">Click the <strong>Label</strong> tab provided by Label Designer.</li><li style="margin:0 0 4px 0;">The page displays:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">label settings;</li><li style="margin:0 0 4px 0;">the <strong>Card Designer</strong> button;</li><li style="margin:0 0 4px 0;">the <strong>Reset settings</strong> button;</li><li style="margin:0 0 4px 0;">the generated PDF files area;</li><li style="margin:0 0 4px 0;">the <strong>Generate</strong> button.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If another module also adds a tab named <strong>Label</strong>, identify the Label Designer tab by its URL or content.</p><br />
<h2 id="sec-6">6. Set label parameters</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Settings are stored separately for each object type.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Setting</th><th style="padding:10px;border:1px solid #dee2e6;">Purpose</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document width</td><td style="padding:10px;border:1px solid #dee2e6;">Final label width, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document height</td><td style="padding:10px;border:1px solid #dee2e6;">Final label height, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode width</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode width in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode height</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode height in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Bar width</td><td style="padding:10px;border:1px solid #dee2e6;">Visual bar thickness, from 0.2 to 1.0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Pixel size</td><td style="padding:10px;border:1px solid #dee2e6;">QR code image resolution; default: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Show barcode value</td><td style="padding:10px;border:1px solid #dee2e6;">Shows or hides the text below the barcode</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels horizontally</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed horizontally in the final PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels vertically</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed vertically in the final PDF</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To change a value:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Click the pencil icon.</li><li style="margin:0 0 4px 0;">Enter the new value.</li><li style="margin:0 0 4px 0;">Confirm the change.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Barcode and QR code dimensions are synchronized with the Card Designer template. Changing them in the settings updates the template; changing their size in Card Designer also updates the related settings.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Reset settings</strong> button restores the defaults for the displayed object type.</p><br />
<h2 id="sec-7">7. Create a template in Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The supplied templates are empty so that users can create their own labels.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">On the <strong>Label</strong> tab, set the document width and height first.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Use the toolbar to add the elements you need:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Shapes</strong> to add graphical shapes;</li><li style="margin:0 0 4px 0;"><strong>Text</strong> to add free text;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> to add dynamic Dolibarr data;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> to use an uploaded image;</li><li style="margin:0 0 4px 0;"><strong>Stickers</strong> to add a decorative element;</li><li style="margin:0 0 4px 0;"><strong>Color</strong> to change an element's color;</li><li style="margin:0 0 4px 0;"><strong>Align</strong> to position elements;</li><li style="margin:0 0 4px 0;"><strong>Delete</strong> to remove the selected element.</li></ul></li><li style="margin:0 0 4px 0;">Move and resize each element directly on the canvas.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirm the save.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Saving creates only the JSON template; it does not generate a PDF. After confirmation, Card Designer returns to the object record.</p><br />
<h2 id="sec-8">8. Add dynamic variables</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">In Card Designer, click <strong>Product variables</strong>, <strong>Batch variables</strong>, <strong>Warehouse variables</strong>, or <strong>Third-party variables</strong>, depending on the open object. Then click a variable to add it to the template.</p><br />
<h3 id="sec-8-1">8.1. Product variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">price excluding tax;</li><li style="margin:0 0 4px 0;">price including tax;</li><li style="margin:0 0 4px 0;">VAT rate;</li><li style="margin:0 0 4px 0;">category;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">product extra fields.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Prices and the VAT rate are formatted with two decimal places.</p><br />
<h3 id="sec-8-2">8.2. Batch variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">batch reference;</li><li style="margin:0 0 4px 0;">linked product reference;</li><li style="margin:0 0 4px 0;">product label;</li><li style="margin:0 0 4px 0;">product description;</li><li style="margin:0 0 4px 0;">use-by date (DLC);</li><li style="margin:0 0 4px 0;">best-before date (DMD/DLUO);</li><li style="margin:0 0 4px 0;">barcode generated from the batch reference;</li><li style="margin:0 0 4px 0;">QR code generated from the batch reference;</li><li style="margin:0 0 4px 0;">batch extra fields.</li></ul><br />
<h3 id="sec-8-3">8.3. Warehouse variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">location and address;</li><li style="margin:0 0 4px 0;">postal code and city;</li><li style="margin:0 0 4px 0;">linked project, project reference and title;</li><li style="margin:0 0 4px 0;">categories or tags;</li><li style="margin:0 0 4px 0;">barcode generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">QR code generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">warehouse extra fields.</li></ul><br />
<h3 id="sec-8-4">8.4. Third-party variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">third-party name;</li><li style="margin:0 0 4px 0;">customer code;</li><li style="margin:0 0 4px 0;">supplier code;</li><li style="margin:0 0 4px 0;">address, postal code, and city;</li><li style="margin:0 0 4px 0;">email address and phone number;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">third-party extra fields.</li></ul><br />
<h3 id="sec-8-5">8.5. Extra fields</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Extra fields configured in Dolibarr are automatically added to the variables for that object. Their technical names are associated with readable labels in Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If an extra field is empty for the current object, its placeholder may still appear in Card Designer, but no value is printed in the PDF.</p><br />
<h2 id="sec-9">9. Use barcodes and QR codes</h2><br />
<h3>Products and third parties</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code are available only when:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Barcodes module is enabled;</li><li style="margin:0 0 4px 0;">barcode use is enabled for the relevant object type in Dolibarr setup;</li><li style="margin:0 0 4px 0;">the object has a barcode value.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If a product or third party has no barcode, Card Designer may show the variable name as a placeholder, but no fictitious code is printed in the PDF.</p><br />
<h3>Batches and warehouses</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code use the batch or warehouse reference. If the reference is empty, the corresponding area in the PDF is blank.</p><br />
<h3>QR code pixel size</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pixel size controls the resolution of the generated QR code image. A higher value improves sharpness when enlarged but increases the data size. The default value of 250 is suitable for most labels.</p><br />
<h2 id="sec-10">10. Upload and use photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">In Card Designer, click <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">An upload QR code appears.</li><li style="margin:0 0 4px 0;">Scan it with a phone or open the upload page directly.</li><li style="margin:0 0 4px 0;">Select PNG, JPG, or JPEG images to upload.</li><li style="margin:0 0 4px 0;">Confirm the upload.</li><li style="margin:0 0 4px 0;">Return to Card Designer and reopen the <strong>Photos</strong> library if needed.</li><li style="margin:0 0 4px 0;">Click the photo to insert it into the label.</li><li style="margin:0 0 4px 0;">Move and resize the image, then save the template.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The upload page only sends files. Photo layout is done afterward in Card Designer.</p><br />
<h2 id="sec-11">11. Generate the PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the record to print.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Check the settings and object data.</li><li style="margin:0 0 4px 0;">Click <strong>Generate</strong>.</li><li style="margin:0 0 4px 0;">The module loads the template for that object type.</li><li style="margin:0 0 4px 0;">Variables are replaced with the current object's data.</li><li style="margin:0 0 4px 0;">The PDF is generated with Fabric.js and jsPDF.</li><li style="margin:0 0 4px 0;">The file appears in the <strong>Attached files</strong> area.</li><li style="margin:0 0 4px 0;">Click the PDF name or preview icon to view it.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The same template can generate labels for multiple objects in succession. The horizontal and vertical label counts apply only to the final PDF, repeating the label without changing the Card Designer template.</p><br />
<h2 id="sec-12">12. Modify an existing template</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open any object of the relevant type.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Edit the template.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong> and confirm.</li><li style="margin:0 0 4px 0;">Generate the PDF again.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The change applies to future labels of the same type. Previously generated PDFs are not updated automatically.</p><br />
<h2 id="sec-13">13. Configure Bluetooth printing</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Home &gt; Setup &gt; Modules/Applications &gt; Label Designer</strong> page has two options:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner on Bluetooth printer</strong>: enables the features intended for Bluetooth printing;</li><li style="margin:0 0 4px 0;"><strong>Replace accented characters on Bluetooth printers</strong>: replaces characters that some printers cannot print correctly.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Bluetooth printing is disabled by default. The second option is useful only when the first is enabled and the printer has trouble with accented characters.</p><br />
<h2 id="sec-14">14. Design tips</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Set the document dimensions before starting the layout.</li><li style="margin:0 0 4px 0;">Leave a margin around the label to avoid print cutoffs.</li><li style="margin:0 0 4px 0;">Do not stretch a barcode or QR code excessively.</li><li style="margin:0 0 4px 0;">Print a test and check that scanners can read the codes.</li><li style="margin:0 0 4px 0;">Use clear images without unnecessarily high resolution.</li><li style="margin:0 0 4px 0;">Leave enough room for variables whose length changes between objects.</li><li style="margin:0 0 4px 0;">Save the template before leaving Card Designer.</li></ul><br />
<h2 id="sec-15">15. Troubleshooting</h2><br />
<h3>The Save button returns an HTTP 500 error</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the web server can write to the Dolibarr documents directory, especially the folder reserved for Label Designer templates. Disabling and re-enabling the module may recreate the required folder. Also check the PHP or web server log for the exact message.</p><br />
<h3>The PDF is blank</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that a template containing elements has been saved for this object type. Templates installed by default are intentionally empty.</p><br />
<h3>A variable appears in Card Designer but is missing from the PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the field is populated on the object used to generate the PDF. An empty variable is not replaced with a fictitious value.</p><br />
<h3>Extra fields are not visible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that extra fields are enabled for the correct object type and that the user has the required permissions. Reload Card Designer after adding a new field.</p><br />
<h3>The barcode or QR code is unavailable</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">For a product or third party, check that the Barcodes module is enabled, barcode use is enabled for that object type, and the record has a value. For a batch or warehouse, check that its reference is not empty.</p><br />
<h3>A size change does not seem to apply</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Save the value, reload Card Designer if it was already open, then generate a new PDF. Make sure you are viewing the latest file.</p><br />
<h3>The page shows an old version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Hard-refresh the browser page. If needed, clear the Dolibarr and browser caches.</p><br />
<h2 id="sec-16">16. Storage and backups</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Card Designer templates are stored as JSON files in the module's directory under Dolibarr documents. Generated PDFs are stored with the documents associated with each object.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To back up the module configuration, include the following in your backup plan:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Dolibarr database;</li><li style="margin:0 0 4px 0;">the Dolibarr documents directory;</li><li style="margin:0 0 4px 0;">the Label Designer module directory.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Do not manually edit JSON files while a user is working in Card Designer.</p><br />
</div></div><br />
[[fr:Label_Designer_FR]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=TakePOS_Digital_Invoice&diff=67480TakePOS Digital Invoice2026-09-29T14:23:09Z<p>Abahfir: module takepos digital invoice</p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><div style="width:100%;"><br />
<h1>TakePOS Digital Invoice</h1><br />
<p><strong>Summary:</strong> Lets a buyer of a TakePOS sale request an electronic invoice by scanning a QR code on the receipt.<br><strong>Module version:</strong> 1.0.0<br><strong>Declared compatibility:</strong> Dolibarr 23.0 or later, PHP 7.2 or later<br><strong>Last documentation review:</strong> 2026-09-29</p><br />
<p><strong>Demo video:</strong></p><br />
<youtube width="560" height="315">PaenAajCX0E</youtube><br />
<p><strong>Demo site:</strong> [https://01consulting.eu/demo/htdocs/ Open the demo site]</p><br />
<p><strong>Publisher website:</strong> [https://01consulting.eu/ 01Consulting]</p><br />
<p>This guide covers installation, settings, receipt QR codes, the customer workflow, request tracking, EInvoicing integration, permissions, and troubleshooting.</p><br />
<br />
<h2>1. Purpose and scope</h2><br />
<p>TakePOS sales are often recorded against the generic third party assigned to a terminal. This module gives the buyer of a paid sale a way to provide company details, confirm an email address, and request the electronic invoice for that existing sale.</p><br />
<p>The module identifies or creates a customer third party, links the TakePOS invoice to it, prepares the electronic invoice with EInvoicing, sends it to the approved platform configured there, then emails the requester the official readable PDF retrieved from that platform.</p><br />
<p>The public workflow is intended for French companies with an active 14-digit SIRET. It does not create a new commercial invoice; it operates on the already-paid TakePOS invoice. Individuals and foreign companies are not supported.</p><br />
<br />
<h2>2. End-to-end workflow</h2><br />
<ol><li>When a TakePOS invoice is validated, the module creates a random 64-character identifier and stores it in the invoice <code>hash</code> extrafield.</li><li>The receipt prints or displays a QR code that opens the public form for that invoice.</li><li>The buyer submits company details and a SIRET. The module checks the fields, email domain, and available official register data.</li><li>The module sends a confirmation link to the submitted email address. Processing does not start until the link is opened.</li><li>After confirmation, the module reuses the matching third party or creates one, then links the paid invoice to it.</li><li>EInvoicing generates the electronic document using the configured protocol and sends it to the approved platform.</li><li>The module retrieves the platform’s official readable PDF and emails it to the requester.</li></ol><br />
<p>Errors are recorded on the request. An authorized user can retry processing. If the invoice has already been transmitted, the existing platform flow is reused to retrieve the PDF; the invoice is not sent a second time.</p><br />
<br />
<h2>3. Requirements and compatibility</h2><br />
<ul><li><strong>Dolibarr:</strong> the module descriptor declares Dolibarr 23.0 or later; the module was prepared for Dolibarr 23.0.3.</li><li><strong>PHP:</strong> minimum declared version is 7.2.</li><li><strong>Dolibarr modules:</strong> Invoices, TakePOS, and EInvoicing must be enabled.</li><li><strong>EInvoicing:</strong> configure an approved platform, satisfy its prerequisites, and select the CII or Factur-X protocol.</li><li><strong>Email:</strong> outbound email from Dolibarr must be configured.</li><li><strong>Server connectivity:</strong> the server must be able to reach the Company Search API, DNS, and, if enabled, the Verifalia API over HTTPS.</li><li><strong>Customer access:</strong> the public Dolibarr URL must be reachable from the phone scanning the receipt.</li><li><strong>TakePOS terminal:</strong> each relevant point of sale must have a default generic third party, used to determine whether the buyer is still anonymous.</li></ul><br />
<br />
<h2>4. Installation, activation, and updates</h2><br />
<h3>4.1. Install and activate</h3><br />
<ol><li>Copy the <code>takeposdigitalinvoice</code> directory to <code>htdocs/custom</code>.</li><li>In Dolibarr, open <strong>Home &gt; Setup &gt; Modules/Applications</strong>.</li><li>Enable <strong>TakePOS Digital Invoice</strong>. First check that Invoices, TakePOS, and EInvoicing are installed and enabled.</li><li>Open the module configuration and set the <strong>General</strong> and <strong>Email</strong> tabs.</li><li>Grant the required read and process permissions to the relevant users.</li><li>Add the QR tag to the browser receipt template and/or ESC/POS template used by the terminal.</li><li>Make a test sale and verify the QR code, public form, email confirmation, and request tracking.</li></ol><br />
<p>Activation loads the request table, adds the invoice <code>hash</code> extrafield (varchar, 64 characters), declares the tracking menu and invoice tab, registers permissions, and declares the retention scheduled task. An activation migration also handles the former CII tracking columns and, where possible, fills in the format from documents already generated.</p><br />
<h3>4.2. Update</h3><br />
<p>Back up the database and Dolibarr documents before updating. Replace the module files with the new version, then reactivate the module if its menu or tab declaration has changed. Activation runs the migrations declared by the module. Afterward, check the configuration page, request menu, and a TakePOS invoice tab.</p><br />
<h3>4.3. Disable or uninstall</h3><br />
<p>The effects on tables, the extrafield, and documents depend on the operation selected in Dolibarr. Back up data before uninstalling and review the consequences shown by Dolibarr. The public workflow does not operate while the module is disabled.</p><br />
<br />
<h2>5. Permissions, menus, and screens</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Permission or screen</th><th style="padding:8px;border:1px solid #dee2e6;">Purpose</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Read requests</td><td style="padding:8px;border:1px solid #dee2e6;">Opens the request list and tracking tab on a TakePOS invoice. Dolibarr permission to view the invoice is also required.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Process requests</td><td style="padding:8px;border:1px solid #dee2e6;">Allows Retry and Cancel actions in the list and invoice tab.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Administer requests</td><td style="padding:8px;border:1px solid #dee2e6;">Permission declared in the module descriptor. Configuration pages also require Dolibarr administrator status.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Configuration</td><td style="padding:8px;border:1px solid #dee2e6;">Available to Dolibarr administrators from the module settings; includes General, Email, and About tabs.</td></tr></table><br />
<p>The <strong>Billing/Payments &gt; TakePOS Digital Invoice</strong> menu is shown to users with read permission. The invoice tab is shown only on invoices originating from TakePOS and to users with the same permission.</p><br />
<br />
<h2>6. General settings</h2><br />
<p>Open the module settings and select the <strong>General</strong> tab. The defaults below are defined by the configuration page; Dolibarr may retain a value already stored for the entity.</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Default</th><th style="padding:8px;border:1px solid #dee2e6;">Effect</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Public link lifetime</td><td style="padding:8px;border:1px solid #dee2e6;">30 days</td><td style="padding:8px;border:1px solid #dee2e6;">Period from invoice validation; minimum one day.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Maximum attempts</td><td style="padding:8px;border:1px solid #dee2e6;">5</td><td style="padding:8px;border:1px solid #dee2e6;">Limits submissions for the same invoice and hashed IP address.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Rate-limit window</td><td style="padding:8px;border:1px solid #dee2e6;">15 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Time window applied to the attempt counter.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Completed request retention</td><td style="padding:8px;border:1px solid #dee2e6;">365 days</td><td style="padding:8px;border:1px solid #dee2e6;">The scheduled cleanup can delete completed requests after this period.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Error request retention</td><td style="padding:8px;border:1px solid #dee2e6;">90 days</td><td style="padding:8px;border:1px solid #dee2e6;">The scheduled cleanup can delete requests in error after this period.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Privacy policy URL</td><td style="padding:8px;border:1px solid #dee2e6;">Empty</td><td style="padding:8px;border:1px solid #dee2e6;">Optional link displayed below the public form when configured.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">QR code message</td><td style="padding:8px;border:1px solid #dee2e6;">“Scan this QR code to request your electronic invoice.”</td><td style="padding:8px;border:1px solid #dee2e6;">Text printed or displayed with the QR code; an empty message falls back to the translated text.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Public form URL</td><td style="padding:8px;border:1px solid #dee2e6;">Computed</td><td style="padding:8px;border:1px solid #dee2e6;">Read-only value; verify it from outside the server.</td></tr></table><br />
<br />
<h2>7. Email and PDF settings</h2><br />
<p>In the <strong>Email</strong> tab, configure the following:</p><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Initial value</th><th style="padding:8px;border:1px solid #dee2e6;">Description</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Confirmation token lifetime</td><td style="padding:8px;border:1px solid #dee2e6;">24 hours</td><td style="padding:8px;border:1px solid #dee2e6;">The link is single-use and expires at its stored expiry time.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Resend delay</td><td style="padding:8px;border:1px solid #dee2e6;">2 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Minimum delay before requesting another email for the invoice.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Sender name</td><td style="padding:8px;border:1px solid #dee2e6;">Empty</td><td style="padding:8px;border:1px solid #dee2e6;">Optional name used with Dolibarr’s general sender address.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Verifalia verification</td><td style="padding:8px;border:1px solid #dee2e6;">Disabled</td><td style="padding:8px;border:1px solid #dee2e6;">Optional external deliverability check; requires API username and password.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Verifalia timeout</td><td style="padding:8px;border:1px solid #dee2e6;">20 seconds</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 5–30 seconds per call.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">PDF retrieval attempts</td><td style="padding:8px;border:1px solid #dee2e6;">4</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 1–6 checks of the same platform flow.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Delay between attempts</td><td style="padding:8px;border:1px solid #dee2e6;">2 seconds</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 1–5 seconds; no new transmission is made.</td></tr></table><br />
<p>The sender address comes from <code>MAIN_MAIL_EMAIL_FROM</code> in Dolibarr’s general email configuration. The module sender name is used for confirmation and PDF emails. If Verifalia is enabled without credentials, or its service rejects the request, submission is blocked with an appropriate error.</p><br />
<br />
<h2>8. Add the QR code to receipts</h2><br />
<h3>8.1. Browser receipt</h3><br />
<ol><li>Open the TakePOS setup and edit the relevant browser receipt template.</li><li>Insert the <code>__DOL_FAC_NUM__</code> tag once where the QR code should appear.</li><li>Save the template and print a receipt for a newly validated TakePOS invoice.</li></ol><br />
<p>On a browser receipt, the substitution displays a QR image produced by Dolibarr’s TCPDF engine, with the configured message. The module loads the invoice extrafields before performing the substitution.</p><br />
<h3>8.2. ESC/POS printer</h3><br />
<ol><li>In the RAW/Text printer setup, open the receipt template.</li><li>Add <code>{dol_fac_num}</code> once.</li><li>Select this template for the terminal and run a print check.</li></ol><br />
<p>The module documents this tag in the ESC/POS template help and replaces it with the native QR instruction <code>{dol_print_qrcode}</code> followed by the public URL. The ESC/POS replacements also recognize <code>{DOL_FAC_NUM}</code> and <code>{__DOL_FAC_NUM__}</code>. The QR message is sent as ESC/POS text after the code.</p><br />
<p>The module also prepares the substitutions <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code>, and <code>__dol_fac_num__</code>. If a valid hash is unavailable, substitutions are empty; while printing ESC/POS, the module tries to create the hash. If it fails, the tag is removed from the printout and an error is written to the Dolibarr log.</p><br />
<p>Do not add the tag in two locations in the same template. After enabling the module, verify a newly validated invoice: the hash is created by the TakePOS invoice validation trigger. Older receipts are not reprinted automatically.</p><br />
<br />
<h2>9. Public form and requested data</h2><br />
<p>The public page looks up the invoice using its hash. It requires the invoice to originate from TakePOS, the link to be within its lifetime, the invoice to be paid/closed, and the invoice still to be linked to the terminal’s default generic third party.</p><br />
<p>The public summary displays the seller, sale date, total including tax, terminal, and invoice reference masked except for its last four characters. It does not display sale lines, payment information, third-party identity, or the full invoice reference.</p><br />
<p>The form asks for:</p><br />
<ul><li>company name;</li><li>address and optional additional address;</li><li>postal code and town;</li><li>14-digit SIRET;</li><li>email address.</li></ul><br />
<p>The country is set to France in third-party processing; the form does not offer a country selector. The privacy policy link appears only when configured.</p><br />
<br />
<h2>10. Company and email checks</h2><br />
<h3>10.1. SIRET check</h3><br />
<p>The module queries the public Company Search API at <code>https://recherche-entreprises.api.gouv.fr/search?q=</code> using the submitted SIRET. It requires 14 digits, finds the matching establishment, and checks that its administrative status is active. It also compares the company name with the official data after normalizing accents, case, and separators, then compares the postal code and town (case and accents are normalized for the town).</p><br />
<p><strong>Current check limitation:</strong> the submitted street address is stored and may be used to create the third party, but the code does not compare it with the address returned by the API. Consistency checks cover the name, postal code, and town, not the street. A missing, closed, or invalid SIRET, or a mismatch in these checked fields, blocks submission. Network, DNS, TLS, timeout, unreadable-response, and service rate-limit errors produce specific or generic errors and do not create a third party.</p><br />
<h3>10.2. Email address check</h3><br />
<p>The module checks the email format, then uses DNS to check that the domain has an MX record. If Verifalia is enabled, its API is also called: addresses classified as undeliverable or disposable are rejected; deliverable, risky, and unknown results are accepted by this check. A service failure or credentials/credit error blocks submission when the option is enabled.</p><br />
<p>Email confirmation is still required even when Verifalia is disabled or returns an accepted result. The random token sent to the customer is stored hashed in the database, expires according to the configured duration, and can be used once. Resending is subject to the configured minimum delay.</p><br />
<br />
<h2>11. Confirmation and invoice processing</h2><br />
<ol><li>After a valid submission, the request is stored in the tracking table as <strong>Pending confirmation</strong>. A confirmation link is sent to the submitted address.</li><li>The customer opens the link before it expires. The token is consumed and the request changes to <strong>Ready</strong>.</li><li>Processing reloads the invoice and confirms it originates from TakePOS and is paid/closed. An atomic lock prevents the same request from being processed concurrently.</li><li>The module searches for a third party by exact SIRET, then by SIREN (the first nine digits), preferring an exact SIRET match. If none exists, it creates a French customer third party and lets Dolibarr assign the customer code.</li><li>The TakePOS invoice is linked to this third party. Generation or sending through EInvoicing is refused while the invoice is still linked to the terminal’s default third party.</li><li>The module checks that EInvoicing is enabled, its prerequisites are met, and its configured protocol is CII or Factur-X. It marks only this invoice as ready for EInvoicing generation.</li><li>EInvoicing generates a document for the selected protocol. For Factur-X, the Dolibarr source PDF is generated before requesting the hybrid Factur-X document. For CII, the protocol produces an XML file.</li><li>The provider configured in EInvoicing transmits the invoice to the approved platform. The module records the generation, transmission, and format steps.</li><li>The module queries the platform flow for its <strong>ReadableView</strong> resource, which must be a readable PDF. It makes the configured number of attempts if the view is not ready yet.</li><li>The official readable PDF is saved in the invoice document directory and emailed to the customer as an attachment.</li><li>After the email is sent successfully, the request changes to <strong>Completed</strong>.</li></ol><br />
<p>With CII, the XML file is used for transmission and the customer receives the platform’s official readable PDF. With Factur-X, the hybrid document is generated and transmitted, while the customer attachment remains the readable PDF retrieved from the platform. This module does not email the standard Dolibarr PDF to the customer.</p><br />
<br />
<h2>12. Request statuses</h2><br />
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Status</th><th style="padding:8px;border:1px solid #dee2e6;">Meaning</th><th style="padding:8px;border:1px solid #dee2e6;">Next step</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Pending confirmation</td><td style="padding:8px;border:1px solid #dee2e6;">The request is stored, but its email address has not been confirmed.</td><td style="padding:8px;border:1px solid #dee2e6;">The customer must open the link before it expires.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Ready</td><td style="padding:8px;border:1px solid #dee2e6;">Email is confirmed and processing can start.</td><td style="padding:8px;border:1px solid #dee2e6;">Automatic processing or the Retry action.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Processing</td><td style="padding:8px;border:1px solid #dee2e6;">The request is reserved for processing.</td><td style="padding:8px;border:1px solid #dee2e6;">Wait for processing to finish and check detailed status.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Error</td><td style="padding:8px;border:1px solid #dee2e6;">A step failed; its error code and step are retained.</td><td style="padding:8px;border:1px solid #dee2e6;">Fix the cause and retry if email was confirmed.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Completed</td><td style="padding:8px;border:1px solid #dee2e6;">Transmission and PDF email both succeeded.</td><td style="padding:8px;border:1px solid #dee2e6;">The public link reports that the request has already been processed.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Canceled</td><td style="padding:8px;border:1px solid #dee2e6;">The public link can no longer be used.</td><td style="padding:8px;border:1px solid #dee2e6;">No standard retry is offered.</td></tr></table><br />
<p>The table also stores separate indicators for email confirmation, SIRET validation, third-party linking, EInvoicing generation, platform transmission, PDF email, protocol used, error step, and creation, modification, completion, or cancellation dates.</p><br />
<br />
<h2>13. Track and manage requests</h2><br />
<h3>13.1. Request list</h3><br />
<p>Open <strong>Billing/Payments &gt; TakePOS Digital Invoice</strong>. The list shows the invoice, third party when known, SIRET, email address, status, last error code, and creation date. Columns can be sorted and results are paginated. Filters include invoice reference, third party, SIRET, email, and status. Invoice and third-party references open their Dolibarr records.</p><br />
<h3>13.2. Invoice tab</h3><br />
<p>On a TakePOS invoice, open the <strong>TakePOS Digital Invoice</strong> tab. It shows status, creation and modification dates, email confirmation, requester email, SIRET, protocol, generation/transmission/PDF email status, and, on failure, the step and error message. A download button is available when a readable PDF is present.</p><br />
<h3>13.3. Retry</h3><br />
<p>Retry is offered for a request whose email has been confirmed and whose status is Ready or Error. Processing resumes and uses the recorded indicators and platform flow. If transmission already succeeded, retry does not send a second invoice; it attempts to retrieve the PDF and complete delivery to the customer.</p><br />
<h3>13.4. Cancel</h3><br />
<p>Cancel asks for confirmation, invalidates the public link, and marks the request canceled unless it is already completed or canceled. The TakePOS invoice cancellation trigger also cancels a non-completed request. The request remains available for tracking until it is purged.</p><br />
<br />
<h2>14. EInvoicing configuration and sending conditions</h2><br />
<p>TakePOS Digital Invoice does not replace EInvoicing or configure the approved platform. Configure the EInvoicing module separately: select the platform, credentials, and protocol. This version’s workflow accepts only the <code>CII</code> and <code>FACTURX</code> protocol values.</p><br />
<p>An anonymous TakePOS customer cannot receive an electronic invoice while the invoice remains linked to the terminal’s generic third party. The module checks this explicitly, including in the hook that intercepts direct EInvoicing generate or send actions on a TakePOS invoice. Identifying the customer makes only that invoice eligible; it does not change the global TakePOS invoice eligibility setting.</p><br />
<p>If the EInvoicing protocol is changed after transmission, the module blocks using a different format for that request and asks for the format associated with the already-submitted flow to be restored. This avoids an inconsistent or duplicate transmission.</p><br />
<br />
<h2>15. Stored data, files, and privacy</h2><br />
<ul><li><strong>Invoice extrafield:</strong> <code>hash</code>, a random 64-character public identifier. Do not publish it separately or edit it manually.</li><li><strong>Request table:</strong> entity, invoice, optional third party, SIRET, company name, address, postal code, town, email, hashed IP fingerprint, hashed token and expiry, counters, statuses, errors, and timestamps.</li><li><strong>Documents:</strong> the EInvoicing electronic file and the platform’s readable PDF are stored with the invoice documents.</li><li><strong>Public summary:</strong> limited sale-identification details; invoice lines, payments, and third-party identity are not exposed before identification.</li><li><strong>Logs:</strong> the dedicated log is <code>DOL_DATA_ROOT/takeposdigitalinvoice/module.log</code>. Technical error details may also be present in Dolibarr logs. Review and redact logs before sharing them.</li></ul><br />
<p>The retention task is scheduled daily. It deletes completed requests according to completion date and error requests according to modification date. This cleanup method does not delete pending, ready, processing, or canceled requests. The task that purges requests does not delete invoice documents.</p><br />
<br />
<h2>16. Triggers, hooks, and substitutions</h2><br />
<ul><li><strong><code>BILL_VALIDATE</code>:</strong> for a validated TakePOS invoice, the trigger ensures the public hash exists and creates it if missing.</li><li><strong><code>BILL_CANCEL</code>:</strong> for a canceled TakePOS invoice, the trigger cancels its non-completed request.</li><li><strong>Browser receipt:</strong> the hook loads invoice extrafields before TakePOS substitutions are processed.</li><li><strong>ESC/POS templates:</strong> the hook adds the QR tag description to template help and substitutes the tag in the text sent to the printer.</li><li><strong>EInvoicing actions:</strong> a hook blocks direct generation or sending for a TakePOS invoice that remains linked to the default third party.</li><li><strong>Substitutions:</strong> the module provides <code>__DOL_FAC_NUM__</code>, <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code>, and <code>__dol_fac_num__</code> for a TakePOS invoice with a valid hash.</li><li><strong>Scheduled task:</strong> periodically purges completed or error requests after their configured retention periods.</li></ul><br />
<br />
<h2>17. Troubleshooting</h2><br />
<h3>The QR code is missing from the browser receipt</h3><p>Check that the module is enabled, the invoice comes from TakePOS, the template contains <code>__DOL_FAC_NUM__</code>, and the invoice was validated after activation. Check that the tag is not repeated. Browser substitution requires the hash to be loaded in the invoice extrafields.</p><br />
<h3>The QR code is missing from the ESC/POS printout</h3><p>Check the active RAW/Text template, the exact recognized tag, and that the template does not already send an equivalent tag. If the hash could not be stored, check Dolibarr logs and database/write permissions.</p><br />
<h3>The public link is rejected</h3><p>The hash must be valid; the invoice must originate from TakePOS, be closed/paid, and remain linked to the terminal’s generic third party. The link expires based on the validation date and configured duration. A completed request is reported as already processed; a canceled request cannot be used.</p><br />
<h3>SIRET verification fails</h3><p>Check the 14 digits, establishment status, company name, postal code, and town. A mismatch in these values or an unavailable API blocks the request. Current code does not compare the submitted street with the API address.</p><br />
<h3>No confirmation email arrives</h3><p>Check the address, domain and MX record, Dolibarr outbound email setup, and spam folder. If Verifalia is enabled, check the credentials, configured timeout, and service authentication or credit errors.</p><br />
<h3>Confirmation succeeded but processing failed</h3><p>Check the latest error and failed step in the list or invoice tab. Verify the third-party link, EInvoicing activation and setup, CII/Factur-X protocol, and access to Dolibarr documents. Then use Retry if the user has process permission.</p><br />
<h3>Transmission succeeded but the PDF is not ready</h3><p>The platform may create its readable view asynchronously. Retry later; the module checks the existing flow and does not transmit the invoice again.</p><br />
<h3>The download button is unavailable</h3><p>The button is enabled when the saved readable PDF is available, or when the invoice tab can use an accessible EInvoicing PDF as a fallback.</p><br />
<br />
<h2>18. Limitations and operational precautions</h2><br />
<ul><li>The current public workflow is for French companies with an active SIRET; it does not support individuals or foreign companies.</li><li>Establishment consistency checks cover company name, postal code, and town; current code does not compare the street address with official data.</li><li>The module retains one request per invoice. Do not create concurrent requests for the same invoice.</li><li>Do not manually remove or edit the hash, tokens, or processing indicators in the database.</li><li>Do not change the EInvoicing protocol during a request that has already been transmitted without restoring the format of its existing flow.</li><li>Do not edit the invoice’s third party while it is being processed.</li><li>Cleanup removes completed and error request history after the configured retention periods; retain any needed tracking information before then.</li></ul><br />
<br />
<h2>19. Support</h2><br />
<p>For help or to report a problem, contact [mailto:contact@01consulting.eu contact@01consulting.eu]. Include the module and Dolibarr versions, receipt type, workflow step, request status, error code, and approximate time. Redact SIRET, email addresses, tokens, platform credentials, invoice details, and any other confidential information from screenshots and log extracts.</p><br />
<br />
</div></div><br />
[[fr:TakePOS_Digital_Invoice_FR]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer_FR&diff=67473Label Designer FR2026-09-28T08:58:26Z<p>Abahfir: Created page with "<div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"> <div style="width:100%;"> <h1>Guide d’utilisation de Label Designer</h1> <p..."</p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 20.0+, PHP 7.4+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<p><strong>Vidéo de démonstration<span> </span>:</strong></p><br />
<youtube width="200" height="120">Hcec6UGBJtI</youtube><br />
<p><strong>Site de démonstration<span> </span>:</strong> [https://01consulting.eu/demo/htdocs/ Ouvrir le site]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 20 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.4 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur<span> </span>:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</div></div><br />
<!-- You can edit this section but do NOT remove these comments Links below will be automatically replicated on translated pages by PolyglotBot --> [[en:Label_Designer]] <!-- END interlang links --></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67472Label Designer2026-09-28T08:58:14Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Label Designer User Guide</h1><br />
<p style="line-height:1.6;"><strong>Module version:</strong> 1.0.0<br><strong>Declared compatibility:</strong> Dolibarr 20.0+, PHP 7.4+<br><strong>Last documentation review:</strong> 2026-09-26</p><br />
<p><strong>Demo video:</strong></p><br />
<youtube width="200" height="120">Hcec6UGBJtI</youtube><br />
<p><strong>Demo site:</strong> [https://01consulting.eu/demo/htdocs/ Open the demo site]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">This guide describes, step by step, how to install, configure, and use Label Designer 1.0.0 for Dolibarr.</p><br />
<h2 id="sec-1">1. Module overview</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer lets you visually create label templates and generate PDF files using data stored in Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The module supports four object types:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">products and services;</li><li style="margin:0 0 4px 0;">product batches;</li><li style="margin:0 0 4px 0;">warehouses;</li><li style="margin:0 0 4px 0;">third parties (customers and suppliers).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">One template is created for each object type and reused automatically. You do not need a separate label for every product, batch, warehouse, or third party. When a PDF is generated, template variables are replaced with the current object's data.</p><br />
<h2 id="sec-2">2. Requirements</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Before installation, check that:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 20 or later is installed;</li><li style="margin:0 0 4px 0;">PHP 7.4 or later is available;</li><li style="margin:0 0 4px 0;">Dolibarr's <strong>Barcodes</strong> module is available;</li><li style="margin:0 0 4px 0;">the web server can write to the Dolibarr documents directory.</li></ul><br />
<h2 id="sec-3">3. Installation and activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copy the <code>labeldesigner</code> directory to <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Sign in to Dolibarr with an administrator account.</li><li style="margin:0 0 4px 0;">Go to <strong>Home &gt; Setup &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Find <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Enable the module.</li><li style="margin:0 0 4px 0;">Make sure the <strong>Barcodes</strong> module is also enabled.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">When activated, Label Designer prepares its storage directory in Dolibarr documents and enables barcode use for products and third parties.</p><br />
<h2 id="sec-4">4. Configure user permissions</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the relevant user or group record.</li><li style="margin:0 0 4px 0;">Open the <strong>Permissions</strong> tab.</li><li style="margin:0 0 4px 0;">Grant the required Label Designer permissions:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">read labels;</li><li style="margin:0 0 4px 0;">create and modify templates and PDFs.</li></ul></li><li style="margin:0 0 4px 0;">Make sure the user can also view the relevant object: product, batch, warehouse, or third party.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Without permission to view the object, some data or variables may not be available.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">After an update that adds or changes module permissions, disable and re-enable Label Designer so Dolibarr registers the new permissions. You can then grant <strong>Read labels</strong> and <strong>Create labels</strong> separately to users and groups.</p><br />
<h2 id="sec-5">5. Open a label</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open a product, batch, warehouse, or third-party record.</li><li style="margin:0 0 4px 0;">Click the <strong>Label</strong> tab provided by Label Designer.</li><li style="margin:0 0 4px 0;">The page displays:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">label settings;</li><li style="margin:0 0 4px 0;">the <strong>Card Designer</strong> button;</li><li style="margin:0 0 4px 0;">the <strong>Reset settings</strong> button;</li><li style="margin:0 0 4px 0;">the generated PDF files area;</li><li style="margin:0 0 4px 0;">the <strong>Generate</strong> button.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If another module also adds a tab named <strong>Label</strong>, identify the Label Designer tab by its URL or content.</p><br />
<h2 id="sec-6">6. Set label parameters</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Settings are stored separately for each object type.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Setting</th><th style="padding:10px;border:1px solid #dee2e6;">Purpose</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document width</td><td style="padding:10px;border:1px solid #dee2e6;">Final label width, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document height</td><td style="padding:10px;border:1px solid #dee2e6;">Final label height, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode width</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode width in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode height</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode height in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Bar width</td><td style="padding:10px;border:1px solid #dee2e6;">Visual bar thickness, from 0.2 to 1.0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Pixel size</td><td style="padding:10px;border:1px solid #dee2e6;">QR code image resolution; default: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Show barcode value</td><td style="padding:10px;border:1px solid #dee2e6;">Shows or hides the text below the barcode</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels horizontally</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed horizontally in the final PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels vertically</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed vertically in the final PDF</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To change a value:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Click the pencil icon.</li><li style="margin:0 0 4px 0;">Enter the new value.</li><li style="margin:0 0 4px 0;">Confirm the change.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Barcode and QR code dimensions are synchronized with the Card Designer template. Changing them in the settings updates the template; changing their size in Card Designer also updates the related settings.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Reset settings</strong> button restores the defaults for the displayed object type.</p><br />
<h2 id="sec-7">7. Create a template in Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The supplied templates are empty so that users can create their own labels.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">On the <strong>Label</strong> tab, set the document width and height first.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Use the toolbar to add the elements you need:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Shapes</strong> to add graphical shapes;</li><li style="margin:0 0 4px 0;"><strong>Text</strong> to add free text;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> to add dynamic Dolibarr data;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> to use an uploaded image;</li><li style="margin:0 0 4px 0;"><strong>Stickers</strong> to add a decorative element;</li><li style="margin:0 0 4px 0;"><strong>Color</strong> to change an element's color;</li><li style="margin:0 0 4px 0;"><strong>Align</strong> to position elements;</li><li style="margin:0 0 4px 0;"><strong>Delete</strong> to remove the selected element.</li></ul></li><li style="margin:0 0 4px 0;">Move and resize each element directly on the canvas.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirm the save.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Saving creates only the JSON template; it does not generate a PDF. After confirmation, Card Designer returns to the object record.</p><br />
<h2 id="sec-8">8. Add dynamic variables</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">In Card Designer, click <strong>Product variables</strong>, <strong>Batch variables</strong>, <strong>Warehouse variables</strong>, or <strong>Third-party variables</strong>, depending on the open object. Then click a variable to add it to the template.</p><br />
<h3 id="sec-8-1">8.1. Product variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">price excluding tax;</li><li style="margin:0 0 4px 0;">price including tax;</li><li style="margin:0 0 4px 0;">VAT rate;</li><li style="margin:0 0 4px 0;">category;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">product extra fields.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Prices and the VAT rate are formatted with two decimal places.</p><br />
<h3 id="sec-8-2">8.2. Batch variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">batch reference;</li><li style="margin:0 0 4px 0;">linked product reference;</li><li style="margin:0 0 4px 0;">product label;</li><li style="margin:0 0 4px 0;">product description;</li><li style="margin:0 0 4px 0;">use-by date (DLC);</li><li style="margin:0 0 4px 0;">best-before date (DMD/DLUO);</li><li style="margin:0 0 4px 0;">barcode generated from the batch reference;</li><li style="margin:0 0 4px 0;">QR code generated from the batch reference;</li><li style="margin:0 0 4px 0;">batch extra fields.</li></ul><br />
<h3 id="sec-8-3">8.3. Warehouse variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">location and address;</li><li style="margin:0 0 4px 0;">postal code and city;</li><li style="margin:0 0 4px 0;">linked project, project reference and title;</li><li style="margin:0 0 4px 0;">categories or tags;</li><li style="margin:0 0 4px 0;">barcode generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">QR code generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">warehouse extra fields.</li></ul><br />
<h3 id="sec-8-4">8.4. Third-party variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">third-party name;</li><li style="margin:0 0 4px 0;">customer code;</li><li style="margin:0 0 4px 0;">supplier code;</li><li style="margin:0 0 4px 0;">address, postal code, and city;</li><li style="margin:0 0 4px 0;">email address and phone number;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">third-party extra fields.</li></ul><br />
<h3 id="sec-8-5">8.5. Extra fields</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Extra fields configured in Dolibarr are automatically added to the variables for that object. Their technical names are associated with readable labels in Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If an extra field is empty for the current object, its placeholder may still appear in Card Designer, but no value is printed in the PDF.</p><br />
<h2 id="sec-9">9. Use barcodes and QR codes</h2><br />
<h3>Products and third parties</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code are available only when:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Barcodes module is enabled;</li><li style="margin:0 0 4px 0;">barcode use is enabled for the relevant object type in Dolibarr setup;</li><li style="margin:0 0 4px 0;">the object has a barcode value.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If a product or third party has no barcode, Card Designer may show the variable name as a placeholder, but no fictitious code is printed in the PDF.</p><br />
<h3>Batches and warehouses</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code use the batch or warehouse reference. If the reference is empty, the corresponding area in the PDF is blank.</p><br />
<h3>QR code pixel size</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pixel size controls the resolution of the generated QR code image. A higher value improves sharpness when enlarged but increases the data size. The default value of 250 is suitable for most labels.</p><br />
<h2 id="sec-10">10. Upload and use photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">In Card Designer, click <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">An upload QR code appears.</li><li style="margin:0 0 4px 0;">Scan it with a phone or open the upload page directly.</li><li style="margin:0 0 4px 0;">Select PNG, JPG, or JPEG images to upload.</li><li style="margin:0 0 4px 0;">Confirm the upload.</li><li style="margin:0 0 4px 0;">Return to Card Designer and reopen the <strong>Photos</strong> library if needed.</li><li style="margin:0 0 4px 0;">Click the photo to insert it into the label.</li><li style="margin:0 0 4px 0;">Move and resize the image, then save the template.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The upload page only sends files. Photo layout is done afterward in Card Designer.</p><br />
<h2 id="sec-11">11. Generate the PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the record to print.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Check the settings and object data.</li><li style="margin:0 0 4px 0;">Click <strong>Generate</strong>.</li><li style="margin:0 0 4px 0;">The module loads the template for that object type.</li><li style="margin:0 0 4px 0;">Variables are replaced with the current object's data.</li><li style="margin:0 0 4px 0;">The PDF is generated with Fabric.js and jsPDF.</li><li style="margin:0 0 4px 0;">The file appears in the <strong>Attached files</strong> area.</li><li style="margin:0 0 4px 0;">Click the PDF name or preview icon to view it.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The same template can generate labels for multiple objects in succession. The horizontal and vertical label counts apply only to the final PDF, repeating the label without changing the Card Designer template.</p><br />
<h2 id="sec-12">12. Modify an existing template</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open any object of the relevant type.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Edit the template.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong> and confirm.</li><li style="margin:0 0 4px 0;">Generate the PDF again.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The change applies to future labels of the same type. Previously generated PDFs are not updated automatically.</p><br />
<h2 id="sec-13">13. Configure Bluetooth printing</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Home &gt; Setup &gt; Modules/Applications &gt; Label Designer</strong> page has two options:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner on Bluetooth printer</strong>: enables the features intended for Bluetooth printing;</li><li style="margin:0 0 4px 0;"><strong>Replace accented characters on Bluetooth printers</strong>: replaces characters that some printers cannot print correctly.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Bluetooth printing is disabled by default. The second option is useful only when the first is enabled and the printer has trouble with accented characters.</p><br />
<h2 id="sec-14">14. Design tips</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Set the document dimensions before starting the layout.</li><li style="margin:0 0 4px 0;">Leave a margin around the label to avoid print cutoffs.</li><li style="margin:0 0 4px 0;">Do not stretch a barcode or QR code excessively.</li><li style="margin:0 0 4px 0;">Print a test and check that scanners can read the codes.</li><li style="margin:0 0 4px 0;">Use clear images without unnecessarily high resolution.</li><li style="margin:0 0 4px 0;">Leave enough room for variables whose length changes between objects.</li><li style="margin:0 0 4px 0;">Save the template before leaving Card Designer.</li></ul><br />
<h2 id="sec-15">15. Troubleshooting</h2><br />
<h3>The Save button returns an HTTP 500 error</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the web server can write to the Dolibarr documents directory, especially the folder reserved for Label Designer templates. Disabling and re-enabling the module may recreate the required folder. Also check the PHP or web server log for the exact message.</p><br />
<h3>The PDF is blank</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that a template containing elements has been saved for this object type. Templates installed by default are intentionally empty.</p><br />
<h3>A variable appears in Card Designer but is missing from the PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the field is populated on the object used to generate the PDF. An empty variable is not replaced with a fictitious value.</p><br />
<h3>Extra fields are not visible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that extra fields are enabled for the correct object type and that the user has the required permissions. Reload Card Designer after adding a new field.</p><br />
<h3>The barcode or QR code is unavailable</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">For a product or third party, check that the Barcodes module is enabled, barcode use is enabled for that object type, and the record has a value. For a batch or warehouse, check that its reference is not empty.</p><br />
<h3>A size change does not seem to apply</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Save the value, reload Card Designer if it was already open, then generate a new PDF. Make sure you are viewing the latest file.</p><br />
<h3>The page shows an old version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Hard-refresh the browser page. If needed, clear the Dolibarr and browser caches.</p><br />
<h2 id="sec-16">16. Storage and backups</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Card Designer templates are stored as JSON files in the module's directory under Dolibarr documents. Generated PDFs are stored with the documents associated with each object.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To back up the module configuration, include the following in your backup plan:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Dolibarr database;</li><li style="margin:0 0 4px 0;">the Dolibarr documents directory;</li><li style="margin:0 0 4px 0;">the Label Designer module directory.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Do not manually edit JSON files while a user is working in Card Designer.</p><br />
</div></div><br />
[[fr:Label_Designer_FR]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67471Label Designer2026-09-28T08:50:25Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Label Designer User Guide</h1><br />
<p style="line-height:1.6;"><strong>Module version:</strong> 1.0.0<br><strong>Declared compatibility:</strong> Dolibarr 20.0+, PHP 7.4+<br><strong>Last documentation review:</strong> 2026-09-26</p><br />
<p><strong>Demo video:</strong></p><br />
<youtube width="200" height="120">Hcec6UGBJtI</youtube><br />
<p><strong>Demo site:</strong> [https://01consulting.eu/demo/htdocs/ Open the demo site]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">This guide describes, step by step, how to install, configure, and use Label Designer 1.0.0 for Dolibarr.</p><br />
<h2 id="sec-1">1. Module overview</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer lets you visually create label templates and generate PDF files using data stored in Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The module supports four object types:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">products and services;</li><li style="margin:0 0 4px 0;">product batches;</li><li style="margin:0 0 4px 0;">warehouses;</li><li style="margin:0 0 4px 0;">third parties (customers and suppliers).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">One template is created for each object type and reused automatically. You do not need a separate label for every product, batch, warehouse, or third party. When a PDF is generated, template variables are replaced with the current object's data.</p><br />
<h2 id="sec-2">2. Requirements</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Before installation, check that:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 20 or later is installed;</li><li style="margin:0 0 4px 0;">PHP 7.4 or later is available;</li><li style="margin:0 0 4px 0;">Dolibarr's <strong>Barcodes</strong> module is available;</li><li style="margin:0 0 4px 0;">the web server can write to the Dolibarr documents directory.</li></ul><br />
<h2 id="sec-3">3. Installation and activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copy the <code>labeldesigner</code> directory to <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Sign in to Dolibarr with an administrator account.</li><li style="margin:0 0 4px 0;">Go to <strong>Home &gt; Setup &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Find <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Enable the module.</li><li style="margin:0 0 4px 0;">Make sure the <strong>Barcodes</strong> module is also enabled.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">When activated, Label Designer prepares its storage directory in Dolibarr documents and enables barcode use for products and third parties.</p><br />
<h2 id="sec-4">4. Configure user permissions</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the relevant user or group record.</li><li style="margin:0 0 4px 0;">Open the <strong>Permissions</strong> tab.</li><li style="margin:0 0 4px 0;">Grant the required Label Designer permissions:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">read labels;</li><li style="margin:0 0 4px 0;">create and modify templates and PDFs.</li></ul></li><li style="margin:0 0 4px 0;">Make sure the user can also view the relevant object: product, batch, warehouse, or third party.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Without permission to view the object, some data or variables may not be available.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">After an update that adds or changes module permissions, disable and re-enable Label Designer so Dolibarr registers the new permissions. You can then grant <strong>Read labels</strong> and <strong>Create labels</strong> separately to users and groups.</p><br />
<h2 id="sec-5">5. Open a label</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open a product, batch, warehouse, or third-party record.</li><li style="margin:0 0 4px 0;">Click the <strong>Label</strong> tab provided by Label Designer.</li><li style="margin:0 0 4px 0;">The page displays:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">label settings;</li><li style="margin:0 0 4px 0;">the <strong>Card Designer</strong> button;</li><li style="margin:0 0 4px 0;">the <strong>Reset settings</strong> button;</li><li style="margin:0 0 4px 0;">the generated PDF files area;</li><li style="margin:0 0 4px 0;">the <strong>Generate</strong> button.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If another module also adds a tab named <strong>Label</strong>, identify the Label Designer tab by its URL or content.</p><br />
<h2 id="sec-6">6. Set label parameters</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Settings are stored separately for each object type.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Setting</th><th style="padding:10px;border:1px solid #dee2e6;">Purpose</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document width</td><td style="padding:10px;border:1px solid #dee2e6;">Final label width, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Document height</td><td style="padding:10px;border:1px solid #dee2e6;">Final label height, in millimeters</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode width</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode width in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Barcode height</td><td style="padding:10px;border:1px solid #dee2e6;">Barcode height in the template and PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Bar width</td><td style="padding:10px;border:1px solid #dee2e6;">Visual bar thickness, from 0.2 to 1.0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Pixel size</td><td style="padding:10px;border:1px solid #dee2e6;">QR code image resolution; default: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Show barcode value</td><td style="padding:10px;border:1px solid #dee2e6;">Shows or hides the text below the barcode</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels horizontally</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed horizontally in the final PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Labels vertically</td><td style="padding:10px;border:1px solid #dee2e6;">Number of copies placed vertically in the final PDF</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To change a value:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Click the pencil icon.</li><li style="margin:0 0 4px 0;">Enter the new value.</li><li style="margin:0 0 4px 0;">Confirm the change.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Barcode and QR code dimensions are synchronized with the Card Designer template. Changing them in the settings updates the template; changing their size in Card Designer also updates the related settings.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Reset settings</strong> button restores the defaults for the displayed object type.</p><br />
<h2 id="sec-7">7. Create a template in Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The supplied templates are empty so that users can create their own labels.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">On the <strong>Label</strong> tab, set the document width and height first.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Use the toolbar to add the elements you need:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Shapes</strong> to add graphical shapes;</li><li style="margin:0 0 4px 0;"><strong>Text</strong> to add free text;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> to add dynamic Dolibarr data;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> to use an uploaded image;</li><li style="margin:0 0 4px 0;"><strong>Stickers</strong> to add a decorative element;</li><li style="margin:0 0 4px 0;"><strong>Color</strong> to change an element's color;</li><li style="margin:0 0 4px 0;"><strong>Align</strong> to position elements;</li><li style="margin:0 0 4px 0;"><strong>Delete</strong> to remove the selected element.</li></ul></li><li style="margin:0 0 4px 0;">Move and resize each element directly on the canvas.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirm the save.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Saving creates only the JSON template; it does not generate a PDF. After confirmation, Card Designer returns to the object record.</p><br />
<h2 id="sec-8">8. Add dynamic variables</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">In Card Designer, click <strong>Product variables</strong>, <strong>Batch variables</strong>, <strong>Warehouse variables</strong>, or <strong>Third-party variables</strong>, depending on the open object. Then click a variable to add it to the template.</p><br />
<h3 id="sec-8-1">8.1. Product variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">price excluding tax;</li><li style="margin:0 0 4px 0;">price including tax;</li><li style="margin:0 0 4px 0;">VAT rate;</li><li style="margin:0 0 4px 0;">category;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">product extra fields.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Prices and the VAT rate are formatted with two decimal places.</p><br />
<h3 id="sec-8-2">8.2. Batch variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">batch reference;</li><li style="margin:0 0 4px 0;">linked product reference;</li><li style="margin:0 0 4px 0;">product label;</li><li style="margin:0 0 4px 0;">product description;</li><li style="margin:0 0 4px 0;">use-by date (DLC);</li><li style="margin:0 0 4px 0;">best-before date (DMD/DLUO);</li><li style="margin:0 0 4px 0;">barcode generated from the batch reference;</li><li style="margin:0 0 4px 0;">QR code generated from the batch reference;</li><li style="margin:0 0 4px 0;">batch extra fields.</li></ul><br />
<h3 id="sec-8-3">8.3. Warehouse variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">reference;</li><li style="margin:0 0 4px 0;">label;</li><li style="margin:0 0 4px 0;">description;</li><li style="margin:0 0 4px 0;">location and address;</li><li style="margin:0 0 4px 0;">postal code and city;</li><li style="margin:0 0 4px 0;">linked project, project reference and title;</li><li style="margin:0 0 4px 0;">categories or tags;</li><li style="margin:0 0 4px 0;">barcode generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">QR code generated from the warehouse reference;</li><li style="margin:0 0 4px 0;">warehouse extra fields.</li></ul><br />
<h3 id="sec-8-4">8.4. Third-party variables</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The main available variables are:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">third-party name;</li><li style="margin:0 0 4px 0;">customer code;</li><li style="margin:0 0 4px 0;">supplier code;</li><li style="margin:0 0 4px 0;">address, postal code, and city;</li><li style="margin:0 0 4px 0;">email address and phone number;</li><li style="margin:0 0 4px 0;">barcode;</li><li style="margin:0 0 4px 0;">QR code;</li><li style="margin:0 0 4px 0;">third-party extra fields.</li></ul><br />
<h3 id="sec-8-5">8.5. Extra fields</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Extra fields configured in Dolibarr are automatically added to the variables for that object. Their technical names are associated with readable labels in Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If an extra field is empty for the current object, its placeholder may still appear in Card Designer, but no value is printed in the PDF.</p><br />
<h2 id="sec-9">9. Use barcodes and QR codes</h2><br />
<h3>Products and third parties</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code are available only when:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Barcodes module is enabled;</li><li style="margin:0 0 4px 0;">barcode use is enabled for the relevant object type in Dolibarr setup;</li><li style="margin:0 0 4px 0;">the object has a barcode value.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">If a product or third party has no barcode, Card Designer may show the variable name as a placeholder, but no fictitious code is printed in the PDF.</p><br />
<h3>Batches and warehouses</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The barcode and QR code use the batch or warehouse reference. If the reference is empty, the corresponding area in the PDF is blank.</p><br />
<h3>QR code pixel size</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pixel size controls the resolution of the generated QR code image. A higher value improves sharpness when enlarged but increases the data size. The default value of 250 is suitable for most labels.</p><br />
<h2 id="sec-10">10. Upload and use photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">In Card Designer, click <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">An upload QR code appears.</li><li style="margin:0 0 4px 0;">Scan it with a phone or open the upload page directly.</li><li style="margin:0 0 4px 0;">Select PNG, JPG, or JPEG images to upload.</li><li style="margin:0 0 4px 0;">Confirm the upload.</li><li style="margin:0 0 4px 0;">Return to Card Designer and reopen the <strong>Photos</strong> library if needed.</li><li style="margin:0 0 4px 0;">Click the photo to insert it into the label.</li><li style="margin:0 0 4px 0;">Move and resize the image, then save the template.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The upload page only sends files. Photo layout is done afterward in Card Designer.</p><br />
<h2 id="sec-11">11. Generate the PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open the record to print.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Check the settings and object data.</li><li style="margin:0 0 4px 0;">Click <strong>Generate</strong>.</li><li style="margin:0 0 4px 0;">The module loads the template for that object type.</li><li style="margin:0 0 4px 0;">Variables are replaced with the current object's data.</li><li style="margin:0 0 4px 0;">The PDF is generated with Fabric.js and jsPDF.</li><li style="margin:0 0 4px 0;">The file appears in the <strong>Attached files</strong> area.</li><li style="margin:0 0 4px 0;">Click the PDF name or preview icon to view it.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The same template can generate labels for multiple objects in succession. The horizontal and vertical label counts apply only to the final PDF, repeating the label without changing the Card Designer template.</p><br />
<h2 id="sec-12">12. Modify an existing template</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Open any object of the relevant type.</li><li style="margin:0 0 4px 0;">Go to its <strong>Label</strong> tab.</li><li style="margin:0 0 4px 0;">Click <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Edit the template.</li><li style="margin:0 0 4px 0;">Click <strong>Save</strong> and confirm.</li><li style="margin:0 0 4px 0;">Generate the PDF again.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The change applies to future labels of the same type. Previously generated PDFs are not updated automatically.</p><br />
<h2 id="sec-13">13. Configure Bluetooth printing</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">The <strong>Home &gt; Setup &gt; Modules/Applications &gt; Label Designer</strong> page has two options:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner on Bluetooth printer</strong>: enables the features intended for Bluetooth printing;</li><li style="margin:0 0 4px 0;"><strong>Replace accented characters on Bluetooth printers</strong>: replaces characters that some printers cannot print correctly.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Bluetooth printing is disabled by default. The second option is useful only when the first is enabled and the printer has trouble with accented characters.</p><br />
<h2 id="sec-14">14. Design tips</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Set the document dimensions before starting the layout.</li><li style="margin:0 0 4px 0;">Leave a margin around the label to avoid print cutoffs.</li><li style="margin:0 0 4px 0;">Do not stretch a barcode or QR code excessively.</li><li style="margin:0 0 4px 0;">Print a test and check that scanners can read the codes.</li><li style="margin:0 0 4px 0;">Use clear images without unnecessarily high resolution.</li><li style="margin:0 0 4px 0;">Leave enough room for variables whose length changes between objects.</li><li style="margin:0 0 4px 0;">Save the template before leaving Card Designer.</li></ul><br />
<h2 id="sec-15">15. Troubleshooting</h2><br />
<h3>The Save button returns an HTTP 500 error</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the web server can write to the Dolibarr documents directory, especially the folder reserved for Label Designer templates. Disabling and re-enabling the module may recreate the required folder. Also check the PHP or web server log for the exact message.</p><br />
<h3>The PDF is blank</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that a template containing elements has been saved for this object type. Templates installed by default are intentionally empty.</p><br />
<h3>A variable appears in Card Designer but is missing from the PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that the field is populated on the object used to generate the PDF. An empty variable is not replaced with a fictitious value.</p><br />
<h3>Extra fields are not visible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Check that extra fields are enabled for the correct object type and that the user has the required permissions. Reload Card Designer after adding a new field.</p><br />
<h3>The barcode or QR code is unavailable</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">For a product or third party, check that the Barcodes module is enabled, barcode use is enabled for that object type, and the record has a value. For a batch or warehouse, check that its reference is not empty.</p><br />
<h3>A size change does not seem to apply</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Save the value, reload Card Designer if it was already open, then generate a new PDF. Make sure you are viewing the latest file.</p><br />
<h3>The page shows an old version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Hard-refresh the browser page. If needed, clear the Dolibarr and browser caches.</p><br />
<h2 id="sec-16">16. Storage and backups</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Card Designer templates are stored as JSON files in the module's directory under Dolibarr documents. Generated PDFs are stored with the documents associated with each object.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">To back up the module configuration, include the following in your backup plan:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">the Dolibarr database;</li><li style="margin:0 0 4px 0;">the Dolibarr documents directory;</li><li style="margin:0 0 4px 0;">the Label Designer module directory.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Do not manually edit JSON files while a user is working in Card Designer.</p><br />
</div></div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67468Label Designer2026-09-27T21:56:09Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<p><strong>Vidéo de démonstration<span> </span>:</strong></p><br />
<youtube width="200" height="120">Hcec6UGBJtI</youtube><br />
<p><strong>Site de démonstration<span> </span>:</strong> [https://01consulting.eu/demo/htdocs/ Ouvrir le site]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.1 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur<span> </span>:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</div></div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67467Label Designer2026-09-27T21:53:57Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<p><strong>Vidéo de démonstration<span> </span>:</strong></p><br />
<youtube width="200" height="120">Hcec6UGBJtI</youtube><br />
<p><strong>Site de démonstration<span> </span>:</strong> [https://01consulting.eu/demo/htdocs/ Ouvrir le site]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.1 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><br />
<thead style="background:#f8f9fa;"></thead><tbody></tbody><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur<span> </span>:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</div></div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67466Label Designer2026-09-27T21:50:40Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<p><strong>Vidéo de démonstration<span> </span>:</strong></p><br />
<p><iframe width="200" height="120" src="//www.youtube-nocookie.com/embed/Hcec6UGBJtI?" frameborder="0" allowfullscreen=""></iframe></p><br />
<p><strong>Site de démonstration<span> </span>:</strong> [https://01consulting.eu/demo/htdocs/ Ouvrir le site]</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.1 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><br />
<thead style="background:#f8f9fa;"></thead><tbody></tbody><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur<span> </span>:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</div></div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67460Label Designer2026-09-26T20:14:13Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<p style="line-height:1.6;"><strong>Démonstration<span> </span>:</strong> <a href="https://www.youtube.com/watch?v=Hcec6UGBJtI">Voir la vidéo de démonstration</a> · <a href="https://01consulting.eu/demo/htdocs/">Accéder au site de démonstration</a></p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.1 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><br />
<thead style="background:#f8f9fa;"></thead><tbody></tbody><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur<span> </span>:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</div></div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67458Label Designer2026-09-26T10:53:30Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.1 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><br />
<thead style="background:#f8f9fa;"></thead><tbody></tbody><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur<span> </span>:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</div></div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67457Label Designer2026-09-26T10:52:40Z<p>Abahfir: </p>
<hr />
<div><div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><br />
<div style="background-color:#f8f9fa;padding:16px;border:1px solid #e9ecef;border-radius:5px;margin:0 0 24px 0;"><br />
<h2>Sommaire</h2><br />
<ul><br />
<li><a href="#sec-1">1. Présentation du module</a></li><br />
<li><a href="#sec-2">2. Prérequis</a></li><br />
<li><a href="#sec-3">3. Installation et activation</a></li><br />
<li><a href="#sec-4">4. Configuration des droits utilisateurs</a></li><br />
<li><a href="#sec-5">5. Accéder à une étiquette</a></li><br />
<li><a href="#sec-6">6. Régler les paramètres de l’étiquette</a></li><br />
<li><a href="#sec-7">7. Créer un modèle dans Card Designer</a></li><br />
<li><a href="#sec-8">8. Ajouter des variables dynamiques</a></li><br />
<li><a href="#sec-9">9. Utiliser les codes-barres et les QR codes</a></li><br />
<li><a href="#sec-10">10. Importer et utiliser des photos</a></li><br />
<li><a href="#sec-11">11. Générer le PDF</a></li><br />
<li><a href="#sec-12">12. Modifier un modèle existant</a></li><br />
<li><a href="#sec-13">13. Configuration de l’impression Bluetooth</a></li><br />
<li><a href="#sec-14">14. Conseils de conception</a></li><br />
<li><a href="#sec-15">15. Dépannage</a></li><br />
<li><a href="#sec-16">16. Stockage et sauvegarde</a></li><br />
</ul><br />
</div><br />
<div style="width:100%;"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p style="line-height:1.6;"><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les produits et services ;</li><li style="margin:0 0 4px 0;">les lots de produits ;</li><li style="margin:0 0 4px 0;">les entrepôts ;</li><li style="margin:0 0 4px 0;">les tiers (clients et fournisseurs).</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dolibarr 15 ou une version supérieure est installé ;</li><li style="margin:0 0 4px 0;">PHP 7.1 ou une version supérieure est disponible ;</li><li style="margin:0 0 4px 0;">le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li style="margin:0 0 4px 0;">le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li style="margin:0 0 4px 0;">Se connecter à Dolibarr avec un compte administrateur.</li><li style="margin:0 0 4px 0;">Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li style="margin:0 0 4px 0;">Rechercher <strong>Label Designer</strong>.</li><li style="margin:0 0 4px 0;">Activer le module.</li><li style="margin:0 0 4px 0;">Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Permissions</strong>.</li><li style="margin:0 0 4px 0;">Accorder les droits Label Designer nécessaires<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">lecture des étiquettes ;</li><li style="margin:0 0 4px 0;">création et modification des modèles et des PDF.</li></ul></li><li style="margin:0 0 4px 0;">Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li style="margin:0 0 4px 0;">Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li style="margin:0 0 4px 0;">La page affiche<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">les paramètres de l’étiquette ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Card Designer</strong> ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li style="margin:0 0 4px 0;">la zone des fichiers PDF générés ;</li><li style="margin:0 0 4px 0;">le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div style="overflow-x:auto;margin:12px 0 20px 0;"><br />
<thead style="background:#f8f9fa;"></thead><tbody></tbody><table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:10px;border:1px solid #dee2e6;">Paramètre</th><th style="padding:10px;border:1px solid #dee2e6;">Utilisation</th></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du document</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Largeur des barres</td><td style="padding:10px;border:1px solid #dee2e6;">Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Taille pixel</td><td style="padding:10px;border:1px solid #dee2e6;">Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Afficher la valeur du code-barres</td><td style="padding:10px;border:1px solid #dee2e6;">Affiche ou masque le texte sous le code-barres</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes horizontalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td style="padding:10px;border:1px solid #dee2e6;">Nombre d’étiquettes verticalement</td><td style="padding:10px;border:1px solid #dee2e6;">Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour modifier une valeur<span> </span>:</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Cliquer sur l’icône en forme de crayon.</li><li style="margin:0 0 4px 0;">Saisir la nouvelle valeur.</li><li style="margin:0 0 4px 0;">Valider la modification.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Formes</strong> pour insérer des formes graphiques ;</li><li style="margin:0 0 4px 0;"><strong>Texte</strong> pour ajouter un texte libre ;</li><li style="margin:0 0 4px 0;"><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li style="margin:0 0 4px 0;"><strong>Photos</strong> pour utiliser une image importée ;</li><li style="margin:0 0 4px 0;"><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li style="margin:0 0 4px 0;"><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li style="margin:0 0 4px 0;"><strong>Aligner</strong> pour positionner les éléments ;</li><li style="margin:0 0 4px 0;"><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li style="margin:0 0 4px 0;">Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong>.</li><li style="margin:0 0 4px 0;">Confirmer l’enregistrement.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">prix hors taxes ;</li><li style="margin:0 0 4px 0;">prix toutes taxes comprises ;</li><li style="margin:0 0 4px 0;">taux de TVA ;</li><li style="margin:0 0 4px 0;">catégorie ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du produit.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence du lot ;</li><li style="margin:0 0 4px 0;">référence du produit lié ;</li><li style="margin:0 0 4px 0;">libellé du produit ;</li><li style="margin:0 0 4px 0;">description du produit ;</li><li style="margin:0 0 4px 0;">DLC ;</li><li style="margin:0 0 4px 0;">DMD/DLUO ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence du lot ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">référence ;</li><li style="margin:0 0 4px 0;">libellé ;</li><li style="margin:0 0 4px 0;">description ;</li><li style="margin:0 0 4px 0;">lieu et adresse ;</li><li style="margin:0 0 4px 0;">code postal et ville ;</li><li style="margin:0 0 4px 0;">projet lié, référence du projet et titre du projet ;</li><li style="margin:0 0 4px 0;">catégories ou tags ;</li><li style="margin:0 0 4px 0;">code-barres créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">QR code créé à partir de la référence de l’entrepôt ;</li><li style="margin:0 0 4px 0;">champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les principales variables disponibles sont<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">nom du tiers ;</li><li style="margin:0 0 4px 0;">code client ;</li><li style="margin:0 0 4px 0;">code fournisseur ;</li><li style="margin:0 0 4px 0;">adresse, code postal et ville ;</li><li style="margin:0 0 4px 0;">adresse électronique et téléphone ;</li><li style="margin:0 0 4px 0;">code-barres ;</li><li style="margin:0 0 4px 0;">QR code ;</li><li style="margin:0 0 4px 0;">champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">le module Codes-barres est activé ;</li><li style="margin:0 0 4px 0;">l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li style="margin:0 0 4px 0;">l’objet possède une valeur de code-barres.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li style="margin:0 0 4px 0;">Un QR code d’importation apparaît.</li><li style="margin:0 0 4px 0;">Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li style="margin:0 0 4px 0;">Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li style="margin:0 0 4px 0;">Valider l’importation.</li><li style="margin:0 0 4px 0;">Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li style="margin:0 0 4px 0;">Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li style="margin:0 0 4px 0;">Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir la fiche de l’objet à imprimer.</li><li style="margin:0 0 4px 0;">Accéder à son onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Vérifier les paramètres et les données de l’objet.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Générer</strong>.</li><li style="margin:0 0 4px 0;">Le module charge le modèle du type d’objet.</li><li style="margin:0 0 4px 0;">Les variables sont remplacées par les données de l’objet courant.</li><li style="margin:0 0 4px 0;">Le PDF est généré avec Fabric.js et jsPDF.</li><li style="margin:0 0 4px 0;">Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Ouvrir n’importe quel objet du type concerné.</li><li style="margin:0 0 4px 0;">Accéder à l’onglet <strong>Étiquette</strong>.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Card Designer</strong>.</li><li style="margin:0 0 4px 0;">Modifier le modèle.</li><li style="margin:0 0 4px 0;">Cliquer sur <strong>Save</strong> et confirmer.</li><li style="margin:0 0 4px 0;">Générer de nouveau le PDF.</li></ol><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;"><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li style="margin:0 0 4px 0;"><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">Définir les dimensions du document avant de commencer la mise en page.</li><li style="margin:0 0 4px 0;">Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li style="margin:0 0 4px 0;">Ne pas étirer excessivement un code-barres ou un QR code.</li><li style="margin:0 0 4px 0;">Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li style="margin:0 0 4px 0;">Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li style="margin:0 0 4px 0;">Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li style="margin:0 0 4px 0;">Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul style="margin:0 0 16px 0;padding-left:24px;line-height:1.6;"><li style="margin:0 0 4px 0;">la base de données Dolibarr ;</li><li style="margin:0 0 4px 0;">le répertoire des documents Dolibarr ;</li><li style="margin:0 0 4px 0;">le dossier du module Label Designer.</li></ul><br />
<p style="margin:0 0 14px 0;line-height:1.6;">Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</div></div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Label_Designer&diff=67456Label Designer2026-09-26T10:06:47Z<p>Abahfir: creation de wiki du module label designer de 01consulting</p>
<hr />
<div><style><br />
.ld-doc{display:flex;flex-wrap:wrap;gap:24px;align-items:flex-start}.ld-nav{flex:1 1 220px;max-width:280px;position:static;background:#f8f9fa;padding:16px;border:1px solid #e9ecef;border-radius:5px}.ld-nav h3{margin-top:0;font-size:1.1em;border-bottom:2px solid #ccc;padding-bottom:10px}.ld-nav ul{list-style:none;padding-left:0;margin-bottom:0;font-size:.95em;line-height:1.7}.ld-nav a{text-decoration:none;color:#333}.ld-main{flex:3 1 520px;min-width:0;overflow-wrap:anywhere}.ld-main h1{margin-top:0}.ld-main h2{padding-top:24px;margin-top:24px}.ld-main h3,.ld-main h4{padding-top:12px;margin-top:18px}.ld-table{overflow-x:auto}.ld-table table{width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left}.ld-table thead{background:#f8f9fa}.ld-table th,.ld-table td{padding:10px;border:1px solid #dee2e6}<br />
</style><br />
<article lang="fr" class="ld-doc"><br />
<nav class="ld-nav"><h3>Sommaire</h3><ul><li><a href="#sec-1">1. Présentation du module</a></li><li><a href="#sec-2">2. Prérequis</a></li><li><a href="#sec-3">3. Installation et activation</a></li><li><a href="#sec-4">4. Configuration des droits utilisateurs</a></li><li><a href="#sec-5">5. Accéder à une étiquette</a></li><li><a href="#sec-6">6. Régler les paramètres de l’étiquette</a></li><li><a href="#sec-7">7. Créer un modèle dans Card Designer</a></li><li><a href="#sec-8">8. Ajouter des variables dynamiques</a></li><li><a href="#sec-9">9. Utiliser les codes-barres et les QR codes</a></li><li><a href="#sec-10">10. Importer et utiliser des photos</a></li><li><a href="#sec-11">11. Générer le PDF</a></li><li><a href="#sec-12">12. Modifier un modèle existant</a></li><li><a href="#sec-13">13. Configuration de l’impression Bluetooth</a></li><li><a href="#sec-14">14. Conseils de conception</a></li><li><a href="#sec-15">15. Dépannage</a></li><li><a href="#sec-16">16. Stockage et sauvegarde</a></li></ul></nav><br />
<main class="ld-main"><br />
<h1>Guide d’utilisation de Label Designer</h1><br />
<p><strong>Version du module<span> </span>:</strong> 1.0.0<br><strong>Compatibilité déclarée<span> </span>:</strong> Dolibarr 15.0+, PHP 7.1+<br><strong>Dernière vérification documentaire<span> </span>:</strong> 2026-09-26</p><br />
<hr><br />
<p>Ce document décrit, étape par étape, l’installation, la configuration et l’utilisation du module <strong>Label Designer 1.0.0</strong> pour Dolibarr.</p><br />
<h2 id="sec-1">1. Présentation du module</h2><br />
<p>Label Designer permet de créer des modèles d’étiquettes visuellement, puis de générer des fichiers PDF à partir des données présentes dans Dolibarr.</p><br />
<p>Le module prend en charge quatre types d’objets<span> </span>:</p><br />
<ul><li>les produits et services ;</li><li>les lots de produits ;</li><li>les entrepôts ;</li><li>les tiers (clients et fournisseurs).</li></ul><br />
<p>Un modèle est créé pour chaque type d’objet. Ce modèle est réutilisé automatiquement<span> </span>: il n’est donc pas nécessaire de concevoir une étiquette différente pour chaque produit, lot, entrepôt ou tiers. Lors de la génération du PDF, les variables du modèle sont remplacées par les données de l’objet courant.</p><br />
<h2 id="sec-2">2. Prérequis</h2><br />
<p>Avant l’installation, vérifier les éléments suivants<span> </span>:</p><br />
<ul><li>Dolibarr 15 ou une version supérieure est installé ;</li><li>PHP 7.1 ou une version supérieure est disponible ;</li><li>le module <strong>Codes-barres</strong> de Dolibarr est disponible ;</li><li>le serveur web dispose d’un accès en écriture au répertoire des documents Dolibarr.</li></ul><br />
<h2 id="sec-3">3. Installation et activation</h2><br />
<ol><li>Copier le dossier <code>labeldesigner</code> dans <code>htdocs/custom/</code>.</li><li>Se connecter à Dolibarr avec un compte administrateur.</li><li>Ouvrir <strong>Accueil &gt; Configuration &gt; Modules/Applications</strong>.</li><li>Rechercher <strong>Label Designer</strong>.</li><li>Activer le module.</li><li>Vérifier que le module <strong>Codes-barres</strong> est également activé.</li></ol><br />
<p>Lors de son activation, Label Designer prépare son répertoire de stockage dans les documents Dolibarr et active l’utilisation des codes-barres pour les produits et les tiers.</p><br />
<h2 id="sec-4">4. Configuration des droits utilisateurs</h2><br />
<ol><li>Ouvrir la fiche de l’utilisateur ou du groupe concerné.</li><li>Accéder à l’onglet <strong>Permissions</strong>.</li><li>Accorder les droits Label Designer nécessaires<span> </span>:<ul><li>lecture des étiquettes ;</li><li>création et modification des modèles et des PDF.</li></ul></li><li>Vérifier que l’utilisateur possède aussi le droit de consulter l’objet concerné<span> </span>: produit, lot, entrepôt ou tiers.</li></ol><br />
<p>Sans les permissions de l’objet, certaines données ou variables peuvent ne pas être accessibles.</p><br />
<p>Après une mise à jour ayant ajouté ou modifié les permissions du module, désactiver puis réactiver Label Designer afin que Dolibarr enregistre les nouvelles permissions. Il est ensuite possible d’accorder séparément <strong>Lire les étiquettes</strong> et <strong>Créer les étiquettes</strong> aux utilisateurs et aux groupes.</p><br />
<h2 id="sec-5">5. Accéder à une étiquette</h2><br />
<ol><li>Ouvrir la fiche d’un produit, d’un lot, d’un entrepôt ou d’un tiers.</li><li>Cliquer sur l’onglet <strong>Étiquette</strong> appartenant à Label Designer.</li><li>La page affiche<span> </span>:<ul><li>les paramètres de l’étiquette ;</li><li>le bouton <strong>Card Designer</strong> ;</li><li>le bouton <strong>Réinitialiser les paramètres</strong> ;</li><li>la zone des fichiers PDF générés ;</li><li>le bouton <strong>Générer</strong>.</li></ul></li></ol><br />
<p>Si un autre module ajoute également un onglet nommé <strong>Étiquette</strong>, identifier celui de Label Designer à partir de son adresse ou de son contenu.</p><br />
<h2 id="sec-6">6. Régler les paramètres de l’étiquette</h2><br />
<p>Les paramètres sont enregistrés séparément pour chaque type d’objet.</p><br />
<div class="ld-table"><br />
<thead></thead><tbody></tbody><table border="1"><tr><th>Paramètre</th><th>Utilisation</th></tr><tr><td>Largeur du document</td><td>Largeur finale d’une étiquette, en millimètres</td></tr><tr><td>Hauteur du document</td><td>Hauteur finale d’une étiquette, en millimètres</td></tr><tr><td>Largeur du code-barres</td><td>Largeur du code-barres dans le modèle et le PDF</td></tr><tr><td>Hauteur du code-barres</td><td>Hauteur du code-barres dans le modèle et le PDF</td></tr><tr><td>Largeur des barres</td><td>Épaisseur visuelle des barres, entre 0,2 et 1,0 mm</td></tr><tr><td>Taille pixel</td><td>Résolution de génération du QR code ; valeur par défaut<span> </span>: 250</td></tr><tr><td>Afficher la valeur du code-barres</td><td>Affiche ou masque le texte sous le code-barres</td></tr><tr><td>Nombre d’étiquettes horizontalement</td><td>Nombre de copies placées horizontalement dans le PDF final</td></tr><tr><td>Nombre d’étiquettes verticalement</td><td>Nombre de copies placées verticalement dans le PDF final</td></tr></table></div><br />
<p>Pour modifier une valeur<span> </span>:</p><br />
<ol><li>Cliquer sur l’icône en forme de crayon.</li><li>Saisir la nouvelle valeur.</li><li>Valider la modification.</li></ol><br />
<p>Les dimensions du code-barres et du QR code sont synchronisées avec le modèle Card Designer. Une modification effectuée dans les paramètres met à jour le modèle ; une modification de taille effectuée dans Card Designer met également à jour les paramètres concernés.</p><br />
<p>Le bouton <strong>Réinitialiser les paramètres</strong> restaure les valeurs par défaut du type d’objet affiché.</p><br />
<h2 id="sec-7">7. Créer un modèle dans Card Designer</h2><br />
<p>Les modèles fournis sont vides afin de laisser l’utilisateur construire sa propre étiquette.</p><br />
<ol><li>Depuis l’onglet <strong>Étiquette</strong>, régler d’abord la largeur et la hauteur du document.</li><li>Cliquer sur <strong>Card Designer</strong>.</li><li>Utiliser la barre d’outils pour ajouter les éléments souhaités<span> </span>:<ul><li><strong>Formes</strong> pour insérer des formes graphiques ;</li><li><strong>Texte</strong> pour ajouter un texte libre ;</li><li><strong>Variables</strong> pour ajouter une donnée dynamique de Dolibarr ;</li><li><strong>Photos</strong> pour utiliser une image importée ;</li><li><strong>Autocollants</strong> pour ajouter un élément décoratif ;</li><li><strong>Couleur</strong> pour modifier la couleur d’un élément ;</li><li><strong>Aligner</strong> pour positionner les éléments ;</li><li><strong>Supprimer</strong> pour retirer l’élément sélectionné.</li></ul></li><li>Déplacer et redimensionner chaque élément directement sur la zone de travail.</li><li>Cliquer sur <strong>Save</strong>.</li><li>Confirmer l’enregistrement.</li></ol><br />
<p>L’enregistrement crée uniquement le modèle JSON. Il ne génère pas de PDF. Après confirmation, Card Designer retourne vers la fiche de l’objet.</p><br />
<h2 id="sec-8">8. Ajouter des variables dynamiques</h2><br />
<p>Dans Card Designer, cliquer sur <strong>Variables du produit</strong>, <strong>Variables du lot</strong>, <strong>Variables de l’entrepôt</strong> ou <strong>Variables du tiers</strong>, selon l’objet ouvert. Cliquer ensuite sur une variable pour l’ajouter au modèle.</p><br />
<h3 id="sec-8-1">8.1. Variables de produit</h3><br />
<p>Les principales variables disponibles sont<span> </span>:</p><br />
<ul><li>référence ;</li><li>libellé ;</li><li>description ;</li><li>prix hors taxes ;</li><li>prix toutes taxes comprises ;</li><li>taux de TVA ;</li><li>catégorie ;</li><li>code-barres ;</li><li>QR code ;</li><li>champs supplémentaires du produit.</li></ul><br />
<p>Les prix et le taux de TVA sont formatés avec deux chiffres après la virgule.</p><br />
<h3 id="sec-8-2">8.2. Variables de lot</h3><br />
<p>Les principales variables disponibles sont<span> </span>:</p><br />
<ul><li>référence du lot ;</li><li>référence du produit lié ;</li><li>libellé du produit ;</li><li>description du produit ;</li><li>DLC ;</li><li>DMD/DLUO ;</li><li>code-barres créé à partir de la référence du lot ;</li><li>QR code créé à partir de la référence du lot ;</li><li>champs supplémentaires du lot.</li></ul><br />
<h3 id="sec-8-3">8.3. Variables d’entrepôt</h3><br />
<p>Les principales variables disponibles sont<span> </span>:</p><br />
<ul><li>référence ;</li><li>libellé ;</li><li>description ;</li><li>lieu et adresse ;</li><li>code postal et ville ;</li><li>projet lié, référence du projet et titre du projet ;</li><li>catégories ou tags ;</li><li>code-barres créé à partir de la référence de l’entrepôt ;</li><li>QR code créé à partir de la référence de l’entrepôt ;</li><li>champs supplémentaires de l’entrepôt.</li></ul><br />
<h3 id="sec-8-4">8.4. Variables de tiers</h3><br />
<p>Les principales variables disponibles sont<span> </span>:</p><br />
<ul><li>nom du tiers ;</li><li>code client ;</li><li>code fournisseur ;</li><li>adresse, code postal et ville ;</li><li>adresse électronique et téléphone ;</li><li>code-barres ;</li><li>QR code ;</li><li>champs supplémentaires du tiers.</li></ul><br />
<h3 id="sec-8-5">8.5. Champs supplémentaires</h3><br />
<p>Les champs supplémentaires configurés dans Dolibarr sont ajoutés automatiquement à la liste des variables de l’objet. Leur nom technique est associé à un libellé lisible dans Card Designer.</p><br />
<p>Si un champ supplémentaire est vide pour l’objet courant, son emplacement peut apparaître sous forme de variable dans Card Designer, mais aucune valeur ne sera imprimée dans le PDF.</p><br />
<h2 id="sec-9">9. Utiliser les codes-barres et les QR codes</h2><br />
<h3>Produits et tiers</h3><br />
<p>Le code-barres et le QR code sont proposés uniquement si<span> </span>:</p><br />
<ul><li>le module Codes-barres est activé ;</li><li>l’utilisation des codes-barres est activée pour le type d’objet concerné dans la configuration Dolibarr ;</li><li>l’objet possède une valeur de code-barres.</li></ul><br />
<p>Si le produit ou le tiers ne possède pas de code-barres, Card Designer peut afficher le nom de la variable comme repère, mais aucun code fictif n’est imprimé dans le PDF.</p><br />
<h3>Lots et entrepôts</h3><br />
<p>Le code-barres et le QR code utilisent la référence du lot ou de l’entrepôt. Une référence vide produit donc un emplacement vide dans le PDF.</p><br />
<h3>Taille pixel du QR code</h3><br />
<p>La taille pixel contrôle la résolution de l’image générée pour le QR code. Une valeur plus élevée améliore la netteté lors d’un agrandissement, mais augmente le poids des données. La valeur par défaut de 250 convient à la majorité des étiquettes.</p><br />
<h2 id="sec-10">10. Importer et utiliser des photos</h2><br />
<ol><li>Dans Card Designer, cliquer sur <strong>Photos</strong>.</li><li>Un QR code d’importation apparaît.</li><li>Scanner ce QR code avec un téléphone, ou ouvrir directement la page d’importation.</li><li>Sélectionner les images à envoyer au format PNG, JPG ou JPEG.</li><li>Valider l’importation.</li><li>Revenir dans Card Designer et rouvrir la bibliothèque <strong>Photos</strong> si nécessaire.</li><li>Cliquer sur la photo souhaitée pour l’insérer dans l’étiquette.</li><li>Déplacer et redimensionner l’image, puis enregistrer le modèle.</li></ol><br />
<p>La page d’importation sert uniquement à envoyer les fichiers. La mise en page de la photo se fait ensuite dans Card Designer.</p><br />
<h2 id="sec-11">11. Générer le PDF</h2><br />
<ol><li>Ouvrir la fiche de l’objet à imprimer.</li><li>Accéder à son onglet <strong>Étiquette</strong>.</li><li>Vérifier les paramètres et les données de l’objet.</li><li>Cliquer sur <strong>Générer</strong>.</li><li>Le module charge le modèle du type d’objet.</li><li>Les variables sont remplacées par les données de l’objet courant.</li><li>Le PDF est généré avec Fabric.js et jsPDF.</li><li>Le fichier apparaît dans la zone <strong>Fichiers joints</strong>.</li><li>Cliquer sur le nom du PDF ou sur l’icône d’aperçu pour le consulter.</li></ol><br />
<p>Le même modèle peut donc produire successivement les étiquettes de plusieurs objets différents.</p><br />
<p>Le nombre d’étiquettes horizontal et vertical est appliqué uniquement au PDF final. Il permet de répéter l’étiquette sans modifier le modèle Card Designer.</p><br />
<h2 id="sec-12">12. Modifier un modèle existant</h2><br />
<ol><li>Ouvrir n’importe quel objet du type concerné.</li><li>Accéder à l’onglet <strong>Étiquette</strong>.</li><li>Cliquer sur <strong>Card Designer</strong>.</li><li>Modifier le modèle.</li><li>Cliquer sur <strong>Save</strong> et confirmer.</li><li>Générer de nouveau le PDF.</li></ol><br />
<p>La modification s’applique à toutes les prochaines étiquettes du même type. Les PDF déjà générés ne sont pas modifiés automatiquement.</p><br />
<h2 id="sec-13">13. Configuration de l’impression Bluetooth</h2><br />
<p>La page <strong>Accueil &gt; Configuration &gt; Modules/Applications &gt; Label Designer</strong> contient deux options activables<span> </span>:</p><br />
<ul><li><strong>Labeldesigner sur imprimante Bluetooth</strong><span> </span>: active les fonctions prévues pour l’impression Bluetooth ;</li><li><strong>Remplacer les caractères accentués sur imprimantes Bluetooth</strong><span> </span>: remplace les caractères que certaines imprimantes ne savent pas imprimer correctement.</li></ul><br />
<p>L’impression Bluetooth est désactivée par défaut. La seconde option n’est utile que lorsque la première est activée et que l’imprimante rencontre des problèmes avec les caractères accentués.</p><br />
<h2 id="sec-14">14. Conseils de conception</h2><br />
<ul><li>Définir les dimensions du document avant de commencer la mise en page.</li><li>Conserver une marge autour de l’étiquette pour éviter les coupures à l’impression.</li><li>Ne pas étirer excessivement un code-barres ou un QR code.</li><li>Effectuer un test d’impression et vérifier la lecture des codes avec un scanner.</li><li>Utiliser des images suffisamment nettes, sans résolution inutilement élevée.</li><li>Laisser assez d’espace pour les variables dont la longueur change selon l’objet.</li><li>Enregistrer le modèle avant de quitter Card Designer.</li></ul><br />
<h2 id="sec-15">15. Dépannage</h2><br />
<h3>Le bouton Save retourne une erreur HTTP 500</h3><br />
<p>Vérifier que le serveur web peut écrire dans le répertoire des documents Dolibarr, notamment dans le dossier réservé aux modèles Label Designer. Désactiver puis réactiver le module peut recréer le dossier nécessaire. Consulter également le journal PHP ou le journal du serveur web pour obtenir le message exact.</p><br />
<h3>Le PDF est vide</h3><br />
<p>Vérifier qu’un modèle contenant des éléments a été enregistré pour ce type d’objet. Les modèles installés par défaut sont volontairement vides.</p><br />
<h3>Une variable est visible dans Card Designer mais absente du PDF</h3><br />
<p>Vérifier que le champ est renseigné sur l’objet utilisé pour la génération. Une variable vide n’est pas remplacée par une valeur fictive.</p><br />
<h3>Les champs supplémentaires ne sont pas visibles</h3><br />
<p>Vérifier que les champs supplémentaires sont activés pour le bon type d’objet et que l’utilisateur dispose des permissions nécessaires. Recharger Card Designer après l’ajout d’un nouveau champ.</p><br />
<h3>Le code-barres ou le QR code n’est pas disponible</h3><br />
<p>Pour un produit ou un tiers, vérifier l’activation du module Codes-barres, l’option d’utilisation pour le type d’objet et la présence d’une valeur sur la fiche. Pour un lot ou un entrepôt, vérifier que la référence n’est pas vide.</p><br />
<h3>Une modification de taille ne semble pas appliquée</h3><br />
<p>Enregistrer la valeur, recharger Card Designer si celui-ci était déjà ouvert, puis générer un nouveau PDF. Vérifier que l’on consulte bien le dernier fichier produit.</p><br />
<h3>L’affichage conserve une ancienne version</h3><br />
<p>Actualiser la page avec un rechargement complet du navigateur. Si nécessaire, vider le cache de Dolibarr et le cache du navigateur.</p><br />
<h2 id="sec-16">16. Stockage et sauvegarde</h2><br />
<p>Les modèles Card Designer sont enregistrés sous forme de fichiers JSON dans le répertoire des documents Dolibarr réservé au module. Les PDF générés sont stockés dans les documents associés aux objets.</p><br />
<p>Pour sauvegarder entièrement la configuration du module, inclure dans la stratégie de sauvegarde<span> </span>:</p><br />
<ul><li>la base de données Dolibarr ;</li><li>le répertoire des documents Dolibarr ;</li><li>le dossier du module Label Designer.</li></ul><br />
<p>Ne pas modifier manuellement les fichiers JSON pendant qu’un utilisateur travaille dans Card Designer.</p><br />
</main></article></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=File:01consulting_rectangle_clair_petit.png&diff=67063File:01consulting rectangle clair petit.png2026-08-26T08:24:11Z<p>Abahfir: </p>
<hr />
<div></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=List_of_modules_id&diff=61930List of modules id2024-11-19T18:55:50Z<p>Abahfir: /* ID 100000 - 499999 */</p>
<hr />
<div>{{TemplateDocDevEn}}<br />
{{TemplateDocDevEs}}<br />
{{TemplateDocDevFr}}<br />
{{TemplateDocDevZh}}<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
{{Flag en}}<br />
<br />
This page list all reserved modules numbers / ID. If you build or want to build your own modules (like thi , you should take an ID range here. Please pick range into existing holes first.<br />
<br />
{{Flag fr}}<br />
Cette page recense tous les numéros / ID réservés de modules. Si vous avez réalisé ou voulez réaliser vos propres modules (comme les [[:Category:Modules complémentaires|modules complémentaires suivant]]), vous devriez prendre une plage d'ID ici. Merci de prendre dans les trous existant en priorité !<br />
<br />
{{Flag sp}}<br />
Esta página contiene un listado de todos los id reservados para los módulos. Si ha creado o quiere realizar sus propios módulos, (como estos [[:Category:Módulos_complementarios|módulos complementarios]]), deberá reservarse un rango de ID aquí.<br />
<br />
{{Flag zh}}<br />
此页面列出了所有保留的模块ID/编号。如果您正在构建或想要构建自己的模块（如 [[:Category:Complementary_modules|扩展模块]]），您应该在此处声明一个ID范围。感谢您优先考虑现有空当！<br />
<br />
{{Flag tr}}<br />
<br />
Bu sayfa tüm ayrılmış modül numaralarını / kimliklerini listeler. Kendi modüllerinizi oluşturuyorsanız veya oluşturmak istiyorsanız ([[:Category:Módulos complementarios|bu gibi]]), burada bir kimlik aralığı almalısınız. Lütfen önce mevcut deliklerden aralığı seçin.<br />
<br />
=ID 0 - 99999=<br />
{{Flag en}}Reserved for Dolibarr's internal modules.<br />
<br />
{{Flag fr}}<br />
Réservé aux modules internes de Dolibarr.<br />
<br />
{{Flag sp}}Reservado a los módulos internos de Dolibarr.<br />
<br />
{{Flag zh}}<br />
为Dolibarr的内部模块保留。<br />
<br />
{{Flag tr}}<br />
Dolibarr'ın dahili modülleri için ayrılmıştır.<br />
<br />
=ID 100000 - 499999=<br />
{{Flag en}}'''Reserved area for editors in need for an ID range. You can edit this page to add your own range (take a range of 50 numbers only the first time, ask us for more)'''<br />
<br />
{{Flag fr}}Zone réservée aux éditeurs qui ont besoin d'une plage d'ID spécifiques. Vous pouvez modifier cette page pour réserver votre plage (limitée à 50 valeurs la première fois, demandez nous pour plus)<br />
<br />
{{Flag sp}}Área reservada para los partners que necesiten un rango de ID. Puede modificar esta página para reservar su rango (limitado a 50 valores por editor)<br />
<br />
{{Flag zh}}为需要特定ID范围的开发者保留的区域。您可以更改此页面以预订您自己的范围（第一次限制为50个值，请向我们咨询更多信息）。<br />
如果您预订超过50个ID，我们可能会在没有通知的情况下自动更改您的预订范围，您将来可能会遇到与其他模块的冲突，因此请遵守规则！<br />
<br />
{{Flag tr}}Kimlik aralığına ihtiyaç duyan editörler için ayrılmış alan. Kendi aralığınızı eklemek için bu sayfayı düzenleyebilirsiniz (yalnızca ilk seferde 50 sayı aralığını alın, daha fazlasını isteyin)<br />
<br />
<br />
[[File:Warning.png]] If you reserve more than 50, we may automatically change your reservation range without information and you may experience conflicts with other modules in a future, so please follow the rules! <br />
<br />
*ID 100000 - 100999: OpenThink (http://www.openthink.be) - Belgium<br />
*ID 101000 - 101999: NLTechno (https://www.nltechno.com) - France<br />
*ID 102000 - 102999: Tiaris (http://www.tiaris.fr) - France<br />
*ID 103000 - 103999: Open-concept.pro (http://www.open-concept.pro) - France<br />
*ID 104000 - 104999: ATM Consulting (http://www.atm-consulting.fr) - France<br />
*ID 105000 - 105999: GPC.solutions - France<br />
*ID 106000 - 106999: PHPASSO<br />
*ID 107000 - 107999: TecLib (http://www.teclib.com) / Auguria (http://www.auguria.net) - France<br />
*ID 108000 - 108999: ETHICWEB<br />
*ID 109000 - 109999: Aplose ([http://www.aplose.fr https://www.aplose.fr]) - France<br />
*ID 110000 - 110999: Association Dolibarr (https://www.dolibarr.org)<br />
*ID 111000 - 111999: Asset IT (www.assetit.ch) - Suisse<br />
*ID 112000 - 112999: Aarboard AG (www.aarboard.ch) - Suisse<br />
*ID 113000 - 113999: Asilib - Alexandre Spangaro<br />
*ID 114000 - 114999: Iceleaf OÜ<br />
*ID 115000 - 115999: 2A2C Conseil - Cyril ZEKSER<br />
*ID 116000 - 116999: Wolftec GmbH<br />
*ID 117000 - 117999: Oscim (http://www.oscim.fr)<br />
*ID 118000 - 118999: Oarces Web (dev.oarces.com)<br />
*ID 119000 - 119999: Manuel Berrocal - Absolacom<br />
*ID 120000 - 120999: Régis Houssin (http://www.inodbox.com) - France<br />
*ID 121000 - 121999: Oscss - Shop - France<br />
*ID 122000 - 122999: MrSof - la Nation du Web<br />
*ID 123000 - 123999: Bruno Généré (webiseasy.org)<br />
*ID 124000 - 124999: backbone internet service (www.backbone.co.at) - Austria<br />
*ID 125000 - 125999: ProgSI (www.progsi.ma)<br />
*ID 126000 - 126999: Catalanet<br />
*ID 127000 - 127999: Virgilio Filho pt-BR Brasil (@dolibarr.br) - Brazil<br />
*ID 128000 - 128999: Nicolas Frappé France (www.sospc.info)<br />
*ID 129000 - 129999: Adeo-Informatique<br />
*ID 130000 - 130999: Technicks ICT (http://www.technicks.eu) - Italy<br />
*ID 131000 - 131999: Joan Louis (itaca.fr) - France<br />
*ID 132000 - 132999: Jean-Marie Arsac (https://azimut.fr) - France<br />
*ID 133000 - 133999: Oriel Systems Ltd, UK. (www.orielsystems.com)<br />
*ID 134000 - 134999: ALSOFT PVT. LTD. (https://www.alsoft.org)<br />
*ID 135000 - 135999: Net-Logic (https://netlogic.fr)<br />
*ID 136000 - 136050: MONA.RE - France<br />
*ID 136051 - 136099: La Vida Marketing<br />
*ID 136100 - 136149: Synergies-Tech France. (https://www.synergies-france.fr/)<br />
*ID 136150 - 136199: Lyta<br />
*ID 136200 - 136219: Maison Théophile Leclerc<br />
*ID 136220 - 136270: SegoFount - Spain<br />
*ID 136271 - 136320: Labor Dispatch (Simon Sheng , China)<br />
*ID 136321 - 136370: MB Informatique (https://www.mb-informatique.fr)<br />
*ID 136371 - 136420: Daxit Solutions (https://www.daxit.be)<br />
*ID 136421 - 136470: HUSCH GmbH (https://husch-gmbh.de)<br />
*ID 136471 - 138999: NSINFO (https://www.ns-info.fr)<br />
*ID 139000 - 139999: Synergies-Tech France. (https://www.synergies-france.fr/)<br />
*ID 140000 - 140999: Altairis (http://altairis.fr)<br />
*ID 141000 - 141050: Projet2Team (https://www.projet2team.fr)<br />
*ID 141051 - 141099: Elistair (http://elistair.com)<br />
*ID 141100 - 141149: Blue Networks Technologies (https://www.blnt.fr)<br />
*ID 141150 - 141199: Mainlab S.r.l. (https://www.mainlabonline.it) - Italy<br />
*ID 141200 - 141249: Florian DUFOURG - France<br />
*ID 141250 - 141299: SoftAddicts - Canada<br />
*ID 141300 - 141349: Finanboo - (https://www.finanboo.com)<br />
*ID 141350 - 141399: ConstruxZion Soft - Colombia (https://www.construxzionsoft.com.co)<br />
*ID 141400 - 141450: COEXDIS - République Démocratique du Congo (https://www.coexdis.com)<br />
*ID 141451 - 141501: HALFWARE - Algeria (https://www.half-ware.com)<br />
*ID 141502 - 141552: Quantraum (https://quantraum.com)<br />
*ID 141553 - 141603: Nateo Group<br />
*ID 141604 - 141653: digital centric GmbH (https://www.digitalcentric.de/dolibarr)<br />
*ID 141654 - 141699: Decrypting (https://www.decrypting.fr)<br />
*ID 141700 - 141949: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 141950 - 141999: MB Informatique (https://www.mb-informatique.fr)<br />
*ID 142000 - 142049: ITANéA (https://www.itanea.fr)<br />
*ID 142050 - 142099: ERP Consulting NZ ([https://www.erpconsulting.co.nz www.erpconsulting.co.nz])<br />
*ID 142100 - 142149: Bloxera GmbH (https://www.bloxera.com)<br />
*ID 142150 - 142199: Evangelos Souglakos - Greece<br />
*ID 142200 - 142249: Luc CALARESU - France<br />
*ID 142250 - 142299: OmnIT Services - Belgique (https://www.omnitservices.biz)<br />
*ID 142300 - 142349: Gwadeyes - Guadeloupe (https://www.gwadeyes-informatique.com/)<br />
*ID 142350 - 142399: Solution Libre (https://www.solution-libre.fr/)<br />
*ID 142400 - 142449: Res Digital (https://res.digital)<br />
*ID 142450 - 142499: itopie informatique (https://www.itopie.ch)<br />
*ID 142500 - 142549: Weblinx.IT GbR (https://weblinx.it/) - Germany<br />
*ID 142550 - 142599: ASCI-Automation - Mexico (https://asci-automation.com.mx/)<br />
*ID 142600 - 142649: ZENKO Design - Japan / France / Spain<br />
*ID 142650 - 142699: AWeerWolf<br />
*ID 142700 - 148749: Lysis (https://lysis.net/)<br />
*ID 142750 - 142799: Hadritech (https://www.hadritech.com/)<br />
*ID 142800 - 142849: Bloxera GmbH (https://www.bloxera.com)<br />
*ID 142850 - 148999: Everlats S.L. - España (https://www.everlats.com)<br />
*ID 149000 - 149999: SydTech - America Central (https://www.sydtech.io/)<br />
*ID 150000 - 150999: Jeffinfo<br />
*ID 151000 - 151999: Konverseo (https://konverseo.com)<br />
*ID 152000 - 152049: Tanguy Pénet (http://tanguype.net)<br />
*ID 152050 - 152099: Web Solutions<br />
*ID 152100 - 152149: MagicNet (https://www.magicnet.it)<br />
*ID 152150 - 156499: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 156500 - 156549: ACE Recycling (https://www.acerecycling.net.au/)<br />
*ID 156550 - 156599: Kreativität Works ([http://www.kreativitat.com http://kreativitat.com])<br />
*ID 156600 - 156649: [https://pierre-couy.dev Pierre Couy]<br />
*ID 156650 - 156699: CXI (https://cyrix.co.za)<br />
*ID 156700 - 159999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 160000 - 160999: Charles-François BENKE (http://www.patas-monkey.com)<br />
*ID 161000 - 161999: Abbes Bahfir (https://01consulting.eu)<br />
*ID 162000 - 162999: Jacques Rébiscoul<br />
*ID 163000 - 163999: Open-DSI (https://www.open-dsi.fr)<br />
*ID 164000 - 164999: Pixelada S. Coop. And. (https://pixelada.org)<br />
*ID 165000 - 165049: DovConnect<br />
*ID 165050 - 165099: Mind Operated Systems (https://www.mosystems.biz)<br />
*ID 165100 - 165150: SD-Formation (https://sdformation.fr)<br />
*ID 165151 - 165199: NUM'X (https://www.numx-sets.eu)<br />
*ID 165200 - 165249: Benjam Préjent (https://www.benjam-prejent.fr)<br />
*ID 165250 - 165299: Dhi Loka Private Limited, India (https://www.dhiloka.com)<br />
*ID 165300 - 169999: Accellier Limited (https://www.accellier.com/)<br />
*ID 170000 - 170999: TRIDENT CONSULTING LTD (www.tridentdxb.com)<br />
*ID 171000 - 171999: LVSInformatique (www.lvsinformatique.com)<br />
*ID 172000 - 172299: Ray Soft-Systems (https://www.ray-soft-systems.com)<br />
*ID 172300 - 172349: Günter Lukas Consulting (https://gl.co.at)<br />
*ID 172350 - 172399: MB Informatique (https://www.mb-informatique.fr)<br />
*ID 172400 - 172449: Professional Structures Limited (https://pstructures.com)<br />
*ID 172450 - 172699: IT-BS (https://www.it-bs.fr)<br />
*ID 172700 - 172749: Indelog (https://www.indelog.fr)<br />
*ID 172750 - 172799: NS-INFO90 (https://www.ns-info90.fr)<br />
*ID 172800 - 172849: E-Concept Applications (https://e-concept-applications.fr)<br />
*ID 172850 - 179999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 180000 - 180999: Triangle Ingénierie<br />
*ID 181000 - 181999: TI Sin Problemas (https://www.tisinproblemas.com)<br />
*ID 182000 - 182049: Chipserv Pawel Wlizlo (https://www.testware.it)<br />
*ID 182050 - 182999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 183000 - 183999: BB2A Anthony Berton (https://www.bb2a.fr)<br />
*ID 184000 - 184999: DPS PRINTING & DOCUMENTS SOCIEDAD ANONIMA (https://www.dps-lat.com)<br />
*ID 185000 - 185049: Telioskour (https://github.com/telioskour)<br />
*ID 185050 - 189999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 190000 - 190999: Diciannove (http://19.coop)<br />
*ID 191000 - 191999: Elonet (https://elonet.fr)<br />
*ID 192000 - 192049: IDFOR Consulting (https://www.idfor-consulting.fr/)<br />
*ID 192050 - 198999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 199000 - 199999: RFMS<br />
*ID 200000 - 200999: Noxiome<br />
*ID 201000 - 201999: Sasa Ostrouska (saxa)<br />
*ID 202000 - 202999: Z-Application<br />
*ID 203000 - 203099: Elidee - elidee.com<br />
*ID 203100 - 203999: Garcia MICHEL (soamichel.fr)<br />
*ID 204000 - 204999: Ari Elbaz elarifr - accedinfo.com<br />
*ID 205000 - 205999: Kreiz IT<br />
*ID 206000 - 206999: GBINFO (www.gbinfo.fr)<br />
*ID 207000 - 207099: MacroProg (https://www.macroprog.com)<br />
*ID 207100 - 207149: Reactiva Software<br />
*ID 207150 - 207199: Ndejje University Water Research and Development Centre ([https://github.com/NDUWRDC/LIMS/])<br />
*ID 207200 - 207299: Massaoud Bouzenad ([https://www.dzprod.net dzprod.net])<br />
*ID 207300 - 207349: Ksar<br />
*ID 207350 - 207399: Easylinux (www.easylinux.fr)<br />
*ID 207400 - 207449: Arthur LENOBLE<br />
*ID 207450 - 212099: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 212100 - 212149: Audio Vidéo Technologies (https://www.avtek.fr)<br />
*ID 212150 - 221999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 222000 - 222999: dolibit (https://www.dolibit.de)<br />
*ID 223000 - 223049: Tráfico Canada<br />
*ID 223050 - 229949: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 229950 - 229999: Solucions Informàtiques, Serveis i Innovació SLU (https://6innova.es)<br />
*ID 230000 - 230049: Unareil (https://www.unareil.eu)<br />
*ID 230050 - 230099: Lyra Network (https://www.lyra.com/)<br />
*ID 230100 - 230149: Gheorghe Iftimi - CTW - RO<br />
*ID 230150 - 230199: MEMA Machinery & Tools (https://www.mema.be)<br />
*ID 230200 - 230249: Teleassist<br />
*ID 230250 - 230299: Nh Developer<br />
*ID 230300 - 230499: Chickenforce/code-chicken, IT Services Hahn (https://github.com/code-chicken [http://itservices-hahn.de/ https://itservices-hahn.de])<br />
*ID 230500 - 230549: Hidup Consulting (https://consulting.hidup.io)<br />
*ID 230550 - 230599 : CMR Conseil (https://www.weblockup.fr)<br />
*ID 230600 - 230649 : aFreeMind Studio<br />
*ID 230650 - 230699 : Unideal (https://www.uni-deal.com)<br />
*ID 230700 - 230749 : DevLansdes (https://devlandes.com/)<br />
*ID 230750 - 262699: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 262700 - 262799: Scopen (https://www.scopen.fr)<br />
*ID 262800 - 274249: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 274250 - 274299: Nerv Project (www.nerv-project.eu)<br />
*ID 274300 - 274349: Knowhere Consulting S.L. (https://www.knowhere-consulting.eu)<br />
*ID 274350 - 274399: Milen karaganski (https://blacktiehost.com)<br />
*ID 274400 - 274449: Vincent MAURY ([https://www.timgroup.fr www.timgroup.fr])<br />
*ID 274450 - 274499: Daraelmin<br />
*ID 274500 - 274549: Emilie LAFORET (http://www.ermvallon.com)<br />
*ID 274550 - 278999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 279000 - 279049: VSDigital Electronics (https://vsdigital.ar) - Argentina<br />
*ID 279050 - 279999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 280000 - 280049: Bingroup (https://www.beinng.com)<br />
*ID 280050 - 280099: Medialta (https://medialta.com)<br />
*ID 280100 - 280149: Cédric Ancelin - Ancode (https://www.dolistore.com/fr/recherche?search_query=ancode)<br />
*ID 280150 - 289999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 290000 - 290099: BNS - Project doliBRA ([https://www.beinng.com https://www.bns.net.br]) - Brasil<br />
*ID 290100 - 299999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 300000 - 300049: RapidProgress (https://www.rapidprogress.eu) - Bulgaria<br />
*ID 300050 : 300099: M@ Solution (https://www.ma-solution.fr/)<br />
*ID 300100 : 300149: LAVA RUN (https://www.lavarun.re)<br />
*ID 300150 - 300199: PsyCrow Code<br />
*ID 300200 : 300249 : Computences (https://www.computences.com/)<br />
*ID 300250 : 300299 : LEVEL IT (https://levelit.com.ar)<br />
*ID 300300 : 300349 : Progiseize (https://progiseize.fr)<br />
*ID 300350 - 300399: MB Informatique (https://www.mb-informatique.fr)<br />
*ID 300400 - 300449: Anouar Touati<br />
*ID 300450 - 300499: Martin Danger<br />
*ID 300500 - 301499: Whale Blows<br />
*ID 301500 - 301549: Tom Trust - International<br />
*ID 301550 - 302499: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 302500 - 302549: Diamubi (https://diamubi.com)<br />
*ID 302550 - 302599: Datolab (https://www.datolab.com)<br />
*ID 302600 - 302649: DuMaCo (https://www.dumaco.de)<br />
*ID 302650 - 302699: Resilio SA<br />
*ID 302700 - 302749: Aroga<br />
*ID 302750 - 302799: Productivix (https://www.productivix.com)<br />
*ID 302800 - 302849: Slibzz<br />
*ID 302850 - 302899: idea design (https://ideadesign.dz)<br />
*ID 302900 - 302949: AL MISBAH INFORMATIQUE (https://www.almisbah.ma)<br />
*ID 302950 - 302999: Atis Solutions - France<br />
*ID 303000 - 303499: Obixav - Nigeria<br />
*ID 303500 - 303549: buschler plus GmbH, Germany (https://buschler.plus)<br />
*ID 303550 - 303599: Prestalidaire - France (https://prestalidaire.com)<br />
*ID 303600 - 309999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 310000 - 310049: Neilson Dufour (<nowiki>https://hypercode.ca</nowiki>)<br />
*ID 310050 - 313999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 314000 - 314049: Ruemmler IT Solutions (https://www.ruemmler.net)<br />
*ID 314050 - 314149: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 314150 - 314199: Benoît PASCAL<br />
*ID 314200 - 319999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 320000 - 320999: Novus Studios (www.novusstudios.it)<br />
*ID 321000 - 321999: AtooNet (http://www.atoo-net.com)<br />
*ID 322000 - 329999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 330000 - 330049: XTEC Industries (www.xtec-ind.com)<br />
*ID 330050 - 330099: 10100 S.R.L. - (www.10100.to)<br />
*ID 330100 - 330149: AES Dana SRL (https://aes-dana.be)<br />
*ID 330150 - 330199: Freshcore (https://www.freshcore.fr)<br />
*ID 330200 - 331999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 332000 - 332099: Gecka (https://gecka.nc)<br />
*ID 332100 - 332149: Agence Milkshake (http://agencemilkshake.com)<br />
*ID 332150 - 332199: Daniel Prowald IT – Service (https://prowald-it.de)<br />
*ID 332200 - 332249: UNITICE (https://unitice.com)<br />
*ID 332250 - 332299: Sidonie Moulart<br />
*ID 332300 - 332349: LTDJ (Antonin MARCHAL - Le Temple du Jeu)<br />
*ID 332350 - 333299: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 333300 - 333349: Sense Africa (http://sense.africa)<br />
*ID 333350 - 349999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 350000 - 350049: SOUNDOU & MIDAS (https://www.soundou.org/)<br />
*ID 350050 - 350099: Ildefonso González ('''https://igontek.es''')<br />
*ID 359000 - 359049: Milen Karaganski0<br />
*ID 350100 - 399999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 400000 - 400999: 2byte.es (http://www.2byte.es)<br />
*ID 401000 - 401999: B&D Informática<br />
*ID 402000 - 402999: Marcos García de La Fuente (marcosgdf)<br />
*ID 403000 - 403999: Sergibyte<br />
*ID 404000 - 404999: Aikhan<br />
*ID 405000 - 405999: AIME (http://www.aime.mx)<br />
*ID 406000 - 406999: Som Núvol (https://somnuvol.coop)<br />
*ID 407000 - 408999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 409000 - 409999: LliureTIC (https://www.lliuretic.cat)<br />
*ID 410000 - 410999: DoliGov<br />
*ID 411000 - 411049: GATTEK SARL (https://www.ga-ttek.com)<br />
*ID 411050 - 419999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 420000 - 420099: BBS Concept<br />
*ID 420100 - 420199: LeMousticProduction (www.lemousticproduction.info) -< module DoliRH<br />
*ID 420200 - 421199: VatCheck (www.abnc.be)<br />
*ID 421200 - 422199: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 422200 - 422999: Artaban (http://artaban.fr)<br />
*ID 423000 - 423049: cyberesprit<br />
*ID 423050 - 423099: R.Bossard<br />
*ID 423100 - 423199: Joliciel (www.joliciel.fr)<br />
*ID 423200 - 423999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 424000 - 424049: A3sys - Mon-Dolibarr (http://www.mon-dolibarr.fr) by Philazerty<br />
*ID 424050 - 424099: Pragma-tech (www.pragma-tech.fr)<br />
*ID 424100 - 424149: Ohoo Solutions (http://www.ohoosolutions.com)<br />
*ID 424150 - 424199: DAGARCAM Informática (https://www.dagarcam.com/)<br />
*ID 424200 - 424999: Lab51 (https://github.com/lab51org)<br />
*ID 425000 - 425999: Sébastien SERRE Thivinfo (www.thivinfo.com)<br />
*ID 426000 - 426099: Arkesis-Solution<br />
*ID 426100 - 426149: GetLandy (www.getlandy.com)<br />
*ID 426150 - 426649: OOB Software<br />
*ID 426650 - 426849: Soft-Task Serviços e Sistemas (www.soft-task.com.br)<br />
*ID 426850 - 426999: Bruno Caldas (https://github.com/BCaldas)<br />
*ID 427000 - 427999: Kevin GUERRIER (alias xcl.saian)<br />
*ID 428000 - 428099: af83<br />
*ID 428100 - 428199: Arnaud Serrut - Adalon<br />
*ID 428200 - 428249: imschweiler consulting (http://www.imschweiler-consulting.de'''<nowiki/>''')<br />
*ID 428250 - 428299: AL1FO<br />
*ID 428300 - 428349: Federico García-Patiño Barbolani (<federico.garcia.patino@gmail.com>)<br />
*ID 428350 - 428399: INTM Groupe - France (www.intm.com)<br />
*ID 428400 - 428449: Nick Fragoulis - Greece<br />
*ID 428450 - 428499: Letusgeek - France<br />
*ID 428500 - 428549: hkwhitten - USA<br />
*ID 428550 - 428999: SmartOne<br />
*ID 429000 - 429999: induslab<br />
*ID 430000 - 430099: Mixity sprl (www.mixity.be)<br />
*ID 430100 - 430199: sgiraud<br />
*ID 430200 - 430299: Merlion TI (www.merlion-si.com.br)<br />
*ID 430300 - 431299: Libre Expert (www.libre-expert.com)<br />
*ID 431300 - 431399: ptibogxiv (www.ptibogxiv.net)<br />
*ID 431400 - 431499: Befox (www.befox.fr)<br />
*ID 431500 - 431599: rue Béjo (www.ruebejo.fr)<br />
*ID 431600 - 431699: Avizzeo (www.avizzeo.com)<br />
*ID 431700 - 432199: Multisistemas (www.multisistemas.com.sv)<br />
*ID 432200 - 432399: Burbuja - Chile (www.burbuja.cl)<br />
*ID 432400 - 433399: INOVEA CONSEIL (https://www.inovea-conseil.com)<br />
*ID 433400 - 434399: Rachid HRICH - Maroc (HricH ServiceS.)<br />
*ID 434400 - 435399: Lance Bleakley - LanceIT (www.lanceit.net)<br />
*ID 435400 - 435999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 436000 - 436099: SOWEBIO (www.soweb.io)<br />
*ID 436100 - 436199: CAP-REL (www.cap-rel.fr)<br />
*ID 436200 - 436300: TDE-INFORMATIQUE (www.tde-informatique.fr)<br />
*ID 436301 - 436349: Evarisk ([https://www.evarisk.com/id-module-dolibarr/ www.evarisk.com])<br />
*ID 436350 - 436399: Eoxia ([https://www.eoxia.com/dolibarr/modules/ www.eoxia.com])<br />
*ID 436400 - 437399: Mohamed AHERDANE - Morocco - IT Consultant ( www.wave.ma )<br />
*ID 437400 - 437449: Martin Neubauer - Germany<br />
*ID 437450 - 437599: Club1click (www.club1click.es)<br />
*ID 437600 - 437629: Coulon Vincent (https://github.com/HoverEpic)<br />
*ID 437630 - 437649: Aytechnet (https://www.aytechnet.fr/) - François Pons<br />
*ID 437650 - 437699: LibreMaster (https://libremaster.com) - Christophe T.<br />
*ID 437700 - 437749: STELLAR Broadband (https://www.stellarbb.com) - U.S.A. - Philip Laycock<br />
*ID 437750 - 437799: DIGITA.LU Ajous Solutions<br />
*ID 437800 - 437850: iProspective (https://iprospective.fr) - Mathieu Moulin<br />
*ID 437851 - 437900: Theobald Groupe.<br />
*ID 437901 - 437950: Neuronnexion (http://neuronnexion.coop)<br />
*ID 437951 - 437952: jmbc - APIA-ASSO (https://www.apia-asso.fr)<br />
*ID 437953 - 438002: IPCZEN SARL (https://www.ipczeninformatique.fr/)<br />
*ID 438003 - 438052: FESF IT Department (https://fesf.org.pk)<br />
*ID 438053 - 438103: Pilot Engineering team<br />
*ID 438104 - 438153: u2042 (https://u2042.com)<br />
*ID 438154 - 438204: Djair E Pereira (ocultooooo@gmail.com) - Brasil<br />
*ID 438205 - 438255: yoandm (https://yoandm.com)<br />
*ID 438256 - 438299: Free<br />
*ID 438300 - 438399: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 438400 - 439399: Tetras Libre - France - Développement logiciels libres (www.tetras-libre.fr)<br />
*ID 439400 - 440399: Dolibarr-pro - France - Développement Dolibarr (www.dolibarr-pro.com)<br />
*ID 440400 - 441399: Quidlab Co., Ltd - Thailand - ( www.quidlab.com )<br />
*ID 441400 - 442399: Ide@log - France - (https://www.idealog-info.net) - Laurent Leblanc<br />
*ID 442400 - 443399: Valerio Bianchi (www.valeriobianchi.com)<br />
*ID 443400 - 444399: delassalle - France - (www.delassalle.fr) - Joseph Delassalle<br />
*ID 444400 - 445399: Webartis - Maroc - (www.webartis.net) - François Dry<br />
*ID 445400 - 445499: SCOP Au-delà des nuages - France<br />
*ID 445500 - 445549: X Net Systems - Egypt - (https://www.xneteg.com)<br />
*ID 445550 - 445999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 446000 - 446999: iouston (http://www.iouston.com) - France - Julien Marchand<br />
*ID 447000 - 447999: rSanjoSEO - Rafael San José Tovar (www.rsanjoseo.com) - Spain<br />
*ID 448000 - 448999: Code 42 (www.code42.fr)<br />
*ID 449000 - 449999: TakePOS (www.takepos.com)<br />
*ID 450000 - 450999: Pierre ARDOIN<br />
*ID 451000 - 451999: Éditeur depordi.fr<br />
*ID 452000 - 452999: Dylan NAKONG<br />
*ID 453000 - 453999: Menahd Ouchenir - France - menahd-ouchenir.com<br />
*ID 454000 - 454999: Withheld - Canada<br />
*ID 455000 - 455999: Gaëtan MAISON - Info Libre @ Dom - France (https://www.infolibreadom.com)<br />
*ID 456000 - 456999: Laurent LEBLEU - B.L.C. - Blue Line Company - Lille - France (www.bluelinecompany.fr/dolibarr)<br />
*ID 457000 - 457999: Sébastien BOUCHER<br />
*ID 458000 - 458999: Lester HERNÁNDEZ - Argentina - (freelancerlrhd@gmail.com)<br />
*ID 459000 - 459999: Infopen - France<br />
*ID 460000 - 460049: torvista - Spain<br />
*ID 460050 - 460999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 461000 - 461999: MEGALOGI - Maroc (www.erpcloud.ma)<br />
*ID 462000 - 462999: Making Digital (www.making-digital.fr) - France<br />
*ID 463000 - 463999: linx s.r.l.s.<br />
*ID 464000 - 464999: NimbleCubed Inc. (www.nimblecubed.com)<br />
*ID 465000 - 465999: Artefacts - CourantAlternatif<br />
*ID 466000 - 466999: CDM Consultores - (www.cdm.guru)<br />
*ID 467000 - 467999: M71 Service GmbH - (www.m71-service.de)<br />
*ID 468000 - 468049: Clément Segonzac - France (clement.segonzac@gmail.com)<br />
*ID 468050 - 468099: Flavien Belli - France (https://github.com/Marshlyin || belliflaviencontactpro@gmail.com)<br />
*ID 468100 - 468119: Chl (https://code.bugness.org/Dolibarr)<br />
*ID 468120 - 468169: Commotron GmbH (https://www.commotron.com/)<br />
*ID 468170 - '''468219''': Infans Group (franck.lauby@infans.fr)<br />
*ID '''468175''' - '''468199''': Gaëlle Rauffet - France (kiwiscan.net)<br />
*ID '''468200''' - 468249: Paulo Oliveira - Brasil (paulorcdo@gmail.com)<br />
*ID 468250 - 468269: CD-Systems - France (https://www.cd-systems.fr)<br />
*ID 468270 - 468299: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 468300 - 468349: Uvensys - Germany (https://uvensys.de)<br />
*ID 468350 - 468399: Laudeco - Belgium (http://github.com/laudeco)<br />
*ID 468400 - 468449: Alexis LAURIER - France (https://www.alexislaurier.fr)<br />
*ID 468450 - 468499: Mehdi Belkhayat - Maroc (https://opensi.ma)<br />
*ID 468500 - 468599: InvIT GmbH - Germany (https://invit.sh)<br />
*ID 468600 - 468649: Ricardo Sequeira - Portugal (https://ricardo-sequeira.com)<br />
*ID 468650 - 468699: J-IT - Belgique (https://www.j-it.be)<br />
*ID 468700 - 468749: Fidesio - France (https://www.fidesio.com/)<br />
*ID 468750 - 468799: Sgestion - Spain (http://www.sgestion.net/)<br />
*ID 468800 - 468849: Denis JULIEN - Brasil (matrinxa@free.fr)<br />
*ID 468850 - 468899: Mmariko - Module GED - Effios<br />
*ID 468900 - 468949: Maazou Amadou Abdoul aziz - Maroc (yaronfada@gmail.com)<br />
*ID 468950 - 468999: Alexis LAURIER - France (https://www.alexislaurier.fr)<br />
*ID 469000 - 469049: John Livingston (https://github.com/JohnXLivingston/)<br />
*ID 469050 - 469099: Macrorom ICT-services (https://macrorom.nl/)<br />
*ID 469100 - 469149: HABOT IT - France (https://habot.it)<br />
*ID 469150 - 469159: CaribbeanConsult.Com CCC - France Guadeloupe (https://dolibarr.ccc.gp)<br />
*ID 469160 - 469171: GMBG - Portugal<br />
*ID 469172 - 469199: BGi Lda - Portugal<br />
*ID 469200 - 469949: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 469950 - 469999: Goldoweb (http://goldoweb.com)<br />
*ID 470000 - 470999: Reindeer Digital (https://rdeer.cz)<br />
*ID 471000 - 471099: CAP-REL (www.cap-rel.fr)<br />
*ID 471100 - 471199: M. Morillon<br />
*ID 471200 - 471209: Pablo Nuñez<br />
*ID 471210 - 471249: FANEL A.Ş (https://www.fanel.com.tr) [[mail@fanel.com.tr]]<br />
*ID 471250 - 480999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 481000 - 481999: Alhaidab-ITIS (https://alhaidab.dolibarr.sd)<br />
*ID 482000 - 482999: Basix IT (https://www.basix.de)<br />
*ID 483000 - 483049: SASCO SpA (https://www.sasco.cl)<br />
*ID 483050 - 483099: WIP Engineering (https://www.wip-gmbh.com)<br />
*ID 483100 - 483149: J.Kaiser<br />
*ID 483150 - 483199: CodLines (https://www.codlines.com)<br />
*ID 483200 - 484999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 485000 - 485049: Gest Info Service Plus (contact@gest-plus.fr)<br />
*ID 485050 - 489999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 490000 - 490049: VOLD (https://vold.lu)<br />
*ID 490050 - 490999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 491000 - 491049: NORD ERP CRM (https://www.nord-erp-crm.fr/)<br />
*ID 491050 - 491099: KJR-online (https://kjr-online.fr/)<br />
*ID 491100 - 491149: eNova<br />
*ID 491150 - 491199: App 4 Business<br />
*ID 491200 - 491249: Mil24 (http://www.mil24.com.py)<br />
*ID 491250 - 491299: M2AM<br />
*ID 491300 - 491349: luigifab (https://github.com/luigifab), also reuse id:105009 for Sentry fork<br />
*ID 491350 - 491399: Frédéric France (https://github.com/frederic34)<br />
*ID 491400 - 491449: E-dem (https://www.e-dem.com/)<br />
*ID 491450 - 491499: Burofree (https://burofree.es)<br />
*ID 491500 - 491549: EMDELEN (https://emdelen.fr/)<br />
*ID 491550 - 491999: '''Free (take ranges of 50 only please at once, ask us for more)'''<br />
*ID 492000 - 492999: Anura (https://www.anura.fr/)<br />
*ID 493000 - 493050: Bourez Bastien EI (https://bastien-b.fr/)<br />
*ID 499000 - 499999: IT GENIUSES (https://www.itgeniuses.com)<br />
<br />
DO NOT ADD RECORD HERE, PLEASE FILL HOLES FIRST !!!!<br />
...<br />
<br />
=ID > 500000=<br />
<br />
This range can't be reserved. It is a common range. If you don't plan to distribute your module, you can use an ID in this range with no need to reserve it.<br />
<br />
<br /><br />
<br />
{{Flag en}}If you don't already have reserved ids and need some, please don't use hazardous number and use a number higher than 500000, but it is better to ask a wiki account, and reserve your own range by editing the 100000 - 499999 range (50 ids at once).<br />
<br />
{{Flag fr}}Si vous n'avez pas de numéros réservés et en avez besoin, n'utilisez pas de chiffres au hasard et utilisez une valeur supérieure à 500000, toutefois, il est préférable d'obtenir un compte wiki, et réserver vous-même votre plage en ajoutant votre entrée dans la zone 100000 - 499999 (par lot de 50 d'abord).{{Flag sp}}Si no dispone de número reservado y necesita, no use cifras redondeadas y usa un valor superior a 500000. Si tiene una cuenta wiki, puede reservarse usted mismo sus id añadiendo su entrada en la zona 100000 - 499999.<br />
<br />
{{Flag zh}}如果您没有预留ID，并且现在需要预留，请不要使用随机数字，要使用大于500000的值。但最好是获得一个wiki帐户，并通过在字段100000-499999中添加您的条目来保留您的ID范围（第一次限制为50个ID）。{{Flag tr}}Bu aralık rezerve edilemez. Bu ortak bir aralıktır. Modülünüzü dağıtmayı planlamıyorsanız, bu aralıktaki bir kimliği rezerve etmenize gerek kalmadan kullanabilirsiniz.</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestionnaire_de_menu_abbes_FR&diff=53383Module Gestionnaire de menu abbes FR2022-04-06T11:24:59Z<p>Abahfir: /* Résumé :[edit | edit source] */</p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> {{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Gestionnaire de menu abbes<br />
|editor=Dolipar.org<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 9.0.x, 10.0.x<br />
=<nowiki>Résumé :[edit | edit source]</nowiki>=<br />
Le gestionnaire de menu Abbes a été le premier outil dans sa catégorie. Il a été créé dans le but de faciliter la navigation dans les menus de Dolibarr, en simplifiant la gestion des éléments de menu et en offrant toutes les possibilités de personnalisation imaginables. <br />
<br />
Il permet notamment de remplacer le menu de gauche par un menu déroulant qui apparaît au passage de la souris sur les éléments du menu du haut, puis d'accéder aux éléments du menu de gauche en un clic au lie de deux ou plus. Il permet aussi de fixer la barre de menus de haut dans les pages de listings d’éléments<br />
<br />
La dernière version inclut la sauvegarde et restauration de menus et les ascenseurs dans les menus déroulants.<br />
<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_menupar-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/menupar.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
=Configuration=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Autres", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Page de configuration de MenuPar]]<br />
On a une liste de 4 paramètres avec un point d'interrogation qui affiche une explication détaillée dés qu'on place la souris dessus. :<br />
<br />
#Afficher une entrée de menu pour chaque catégorie de produits : Par défaut, il existe seulement une entrée dans le menu pour lister les produits. Activez cette option pour afficher une entrée pour chaque catégorie de produits pour les utilisateurs définis par l'option USERCAT.<br />
#USERCAT Utilisateurs de menus de catégories de produits : Ce paramètre contient tous les login des utilisateurs ayant une entrée dans les de menus de catégories de produits.<br />
#Ascenseurs : Affiche des ascenseurs dans les menus déroulants<br />
#Longueur de la liste déroulante : Longueur fixe de la liste déroulante à ascenseurs en 1 et 1000 pixels.<br />
<br />
=Activation et Utilisation=<br />
L'activation du gestionnaire de menu Abbes est distincte de l'activation du module. Elle se fait à la suite de celle-ci dans le menu accueil configuration menus :<br />
[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activation du gestionnaire de menu abbes]]<br />
Une fois le gestionnaire de menu activé, la colonne de gauche disparaît immédiatement et les menus déroulants correspondants aux éléments du menu du haut apparaissent dés qu'on positionne la souris dessus :<br />
[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menu accueil]]<br />
Le quatre éléments du haut du menu accueil sont dépliables. Ce qui permet d'accéder du premier coup aux éléments de menu finaux.<br />
[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menu Produits|Services]]<br />
Comme tous les éléments de menus de gauche sont affichés sur un seul niveau, leurs nombres dans les menus déroulants peut-être important. On peut alors, configurer le gestionnaire pour leur associer un ascenseur et limiter leur pour tous les menus déroulants autres le menu accueil. Sur l'image, on voit aussi les éléments permettant de lister les produits par catégorie disponibles à travers le deuxième paramètre de configuration. <br />
<br />
=Fonctions avancées :=<br />
<br />
==Edition de menu :==<br />
Le gestionnaire de menu MenuPar est basé sur le menu Auguria. On peut donc ajouter, modifier, ou supprimer les éléments de menu en accédant à accueil configuration menus Edition de menu :<br />
[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edition du menu]]<br />
<br />
==Sauvegarde de menus:==<br />
<br />
<br />
Après avoir effectué des modifications dans la structure du menu, il est possible de sauvegarder les changements effectués et les recharger au besoin. Cette fonction est accessible sur depuis la page de configuration du module à travers le bouton '''Sauvegarde/Restauration de la table de menus''' :<br />
[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Sauvegarde de menus]]<br />
La fonction de sauvegarde de menus de MenuPar est en tout point identique à celle de sauvegarde de la base de données de Dolibarr. La différence réside en ce que la fonction de sauvegarde de menus de MenuPar fait la sauvegarde de la seule table de menus llx_menu et l'existence d'un bouton de restauration à coté de chaque fichier de sauvegarde.<br />
=Autres sources d'information :=<br />
<br />
Page d'informations sur le module sur Dolipar.org :http://dolipar.org/content/menupar<br />
<br />
Site de demo : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212 <br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307 <br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<nowiki/>Lien sur Dolistore :[https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-MenuPar.html https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html]<br />
[[Category:Modules complémentaires]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=DevCamp_Valence_2021_Organization&diff=52075DevCamp Valence 2021 Organization2021-09-22T05:10:46Z<p>Abahfir: /* Attendees registration */</p>
<hr />
<div>{{TemplateAssoEn}}<br />
[[Category:DevCamps]]<br />
<br />
=Event=<br />
<br />
'''Dolibarr DevCamp 2021'''<br />
<br />
3rd edition of the Dolibarr DevCamp in Valence, '''reserved to Dolibarr community major developers or contributors'''.<br />
<br />
[[File:Warning.png]] '''Only 35 seats available: Priority to [https://partners.dolibarr.org Preferred Partner] will be done if we have more.'''<br />
<br />
[[File:Warning.png]] '''Warning, a Covid health pass is mandatory to attend this event'''<br />
<br />
==Dates==<br />
<br />
October 2021, 21th - 24th<br />
<br />
==Location==<br />
<br />
Ibis Hotel, 2-4 avenue de la Gare, Alixan (near Valence), France<br />
<br />
==How to come==<br />
<br />
*Airplane: Lyon airport then train to Valence TGV<br />
*Train: Valence TGV train station<br />
*Car: Exit the A7 highway at Valence North or Valence South and follow TGV Station (Gare TGV)<br />
<br />
==Main languages==<br />
French / English<br />
<br />
==Organizers==<br />
<br />
*Main: ATM Consulting (maxime@atm-consulting.fr)<br />
*Hosting: ATM Consulting (maxime@atm-consulting.fr)<br />
*Lodging and Catering: ATM Consulting (maxime@atm-consulting.fr)<br />
<br />
==Lodging and catering==<br />
<br />
Ibis Hotel rooms and restaurant<br />
<br />
Saturday evening in a restaurant "La cuisine" in Valence center<br />
<br />
=Planning=<br />
<br />
==Day 1 (Thursday)==<br />
<br />
*2:00 PM : Devcamp starts<br />
<br />
==Day 2 (Friday)==<br />
<br />
*TBD<br />
<br />
==Day 3 (Saturday)==<br />
<br />
*10:00 am - 12:00 am : Bug fix contest<br />
<br />
==Day 4 (Sunday)==<br />
<br />
*12:00 PM : Devcamp ends<br />
<br />
=Topics and issues to work on=<br />
<br />
*[https://github.com/Dolibarr/dolibarr/labels/Bug Bug fix contest]<br />
*Sharing of good practices throughout the developers community<br />
*Discussion on any topics, like [https://github.com/Dolibarr/dolibarr/issues?q=is%3Aopen+is%3Aissue+label%3A%22Priority+Top+Strategic%22 Top strategic Feature Requests]...<br />
<br />
=Validate your registration=<br />
<br />
[[File:warning.png]] To validate your registration (required to have your registration validated), you must make a '''payment of 50 € per person''' before the 30th of september [https://admin.dolibarr.org/public/eventorganization/attendee_register.php?id=9&type=global&securekey=13a8cfcfc13b9366340809bd7a299406 from this page]<br />
<br />
If you can't pay using a credit card, fill the form and cancel the payment process. Then contact us at tresorier@dolibarr.org to make your payment with a bank transfer.<br />
<br />
During the devcamp, the hostel may be paid by the Dolibarr association . Take a look at the rules defined for what is paid by the Dolibarr foundation for DevCamp [https://wiki.dolibarr.org/index.php/Remboursement_frais#Formule_de_remboursement_.22DevCamp.22_Dolibarr available here]<br />
<br />
=Attendees registration=<br />
<br />
This list contains the registration requests. [https://www.dolibarr.org/fr/dolibarr-devcamp-valence-2021.php See this page to get the status of registration].<br />
<br />
<br />
[[File:Laurent magnin.jpg||40px]] + 3 from Eoxia (Theo, Nicolas, Jules)<br />
<br />
*Lastname Firstname: Laurent Magnin<br />
*Age: 47<br />
*Coming from (town, country): Montpellier (34), France<br />
*Arrival date and hour: Thursday 12h00<br />
*Departure date and hour: Sunday 14h00<br />
*Transportation (Train/Bus/Car/Plane): Car from Montpellier<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: laurent@eoxia.com<br />
<br />
<br />
[[File:Maxime_Kohlhaas.png|40px]] + 3 from ATM Consulting (John, Léna and Florian)<br />
<br />
*Firstname Lastname: [[Maxime Kohlhaas]]<br />
*Age: 34<br />
*Coming from (town, country): Valence (26000), France<br />
*Arrival date and hour: Thursday 14:00<br />
*Departure date and hour: Sunday 12:00<br />
*Transportation (Train/Bus/Car/Plane): Car<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): None<br />
*Book hotel for me (yes/no): No<br />
*Contact email: maxime@atm-consulting.fr<br />
<br />
<br />
[[File:Laurent Destailleur.png|40px]] + 1 from DoliCloud (Laurent + Lucas)<br />
<br />
*Firstname Lastname: [[Laurent Destailleur]]<br />
*Age: 48<br />
*Coming from (town, country): Pessac (33600), France<br />
*Arrival date and hour: Thursday 14:00<br />
*Departure date and hour: Sunday 12:00<br />
*Transportation (Train/Bus/Car/Plane): TBD<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): Common booked hotel<br />
*Book hotel for me (yes/no): Yes<br />
*Contact email: contact@dolicloud.com<br />
<br />
<br />
[[File:Nicolas Zabouri.png|left|52x52px]]<br />
+ 2 from Inovea Conseil (Florian, Ilies)<br />
<br />
*Lastname Firstname: [[Nicolas Zabouri]]<br />
*Age: 39<br />
*Coming from (town, country): Charmes (88)<br />
*Arrival date and hour: Thursday 12h00<br />
*Departure date and hour: Sunday 14h00<br />
*Transportation (Train/Bus/Car/Plane): Car from Charmes<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: info@inovea-conseil.com<br />
<br />
<br />
*Firstname Lastname: Éric Seigne (CAP-REL)<br />
*Age: 42<br />
*Coming from (town, country): Alès (30), France<br />
*Arrival date and hour: Thursday 14:00<br />
*Departure date and hour: Maybe Sunday 12:00 (to be precised)<br />
*Transportation (Train/Bus/Car/Plane): Car<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): None<br />
*Book hotel for me (yes/no): yes<br />
*Contact email: eric.seigne@cap-rel.fr<br />
<br />
<br />
*Firstname Lastname: Andreu Bisquerra Gaya<br />
*Age: 38<br />
*Coming from (town, country): Mallorca, SPAIN (I will come with PCR)<br />
*Arrival date and hour: Thursday 14:00<br />
*Departure date and hour: Maybe Sunday 12:00 (to be precised)<br />
*Transportation (Train/Bus/Car/Plane): Car<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): Yes<br />
*Book hotel for me (yes/no): yes<br />
*Contact email: jove@bisquerra.com<br />
<br />
<br />
+ 4 from Code 42 (Eric, F***, C****, H****)<br />
<br />
*Firstname Lastname: Eric GROULT<br />
*Age: 40<br />
*Coming from (town, country): NANTES (44100), France<br />
*Arrival date and hour: Thursday 14:00<br />
*Departure date and hour: Sunday 12:00<br />
*Transportation (Train/Bus/Car/Plane): Train & Plane<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): None<br />
*Book hotel for me (yes/no): yes<br />
*Contact email: eric@code42.fr<br />
<br />
<br />
*Firstname Lastname: Philippe GRAND<br />
*Age: 00<br />
*Coming from (town, country): OLIVET, France<br />
*Arrival date and hour: Thursday 14:00<br />
*Departure date and hour: Maybe Sunday 12:00<br />
*Transportation (Train/Bus/Car/Plane): Train<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): Yes<br />
*Book hotel for me (yes/no): yes<br />
*Contact email: philippe.grand@atoo-net.com<br />
<br />
<br />
*Company : Groupe Theobald<br />
*Firstname Lastname: Franck MOREAU<br />
*Age: 43<br />
*Coming from (town, country): Thionville (57), France<br />
*Arrival date and hour: Thursday 10h00<br />
*Departure date and hour: Sunday 16h00<br />
*Transportation (Train/Bus/Car/Plane): Car from Thionville<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: moreauf@theobald-groupe.com<br />
<br />
<br /><br />
<br />
*Company : IT-BS<br />
*Firstname Lastname: Nicolas SILOBRE<br />
*Age: 46<br />
*Coming from (town, country): Belfort (90), France<br />
*Arrival date and hour: Thursday 10h00<br />
*Departure date and hour: Sunday 16h00<br />
*Transportation (Train/Bus/Car/Plane): train<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: nicolas.silobre@it-bs.fr<br />
<br />
<br />
*Company : Tiaris<br />
*Firstname Lastname: Jean Heimburger<br /><br />
*Age: 61<br />
*Coming from (town, country): Walscheid (57), France<br />
*Arrival date and hour: Thursday 14h00<br />
*Departure date and hour: Sunday 12h00<br />
*Transportation (Train/Bus/Car/Plane): train<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: [[Mailto:jean.heimburger@tiaris.info|jean.heimburger@tiaris.info]]<br />
<br />
<br />
[[File:Florian Henry.png|left|52x52px]]<br />
<br />
*Company : Association Dolibarr<br />
*Firstname Lastname: [[User:Florian_Henry]]<br />
*Age: 40<br />
*Coming from (town, country): France<br />
*Arrival date and hour: Thursday 14h00<br />
*Departure date and hour: Friday 17h00<br />
*Transportation (Train/Bus/Car/Plane): Car<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): None / Self<br />
*Book hotel for me (yes/no): no<br />
*Email for contact: [[Mailto:jean.heimburger@tiaris.info|jean.heimburger@tiaris.info]]<br />
<br />
<br /><br />
<br />
*Company : Opendsi<br />
*Firstname Lastname: Philippe Scoffoni<br />
*Age: 53<br />
*Coming from (town, country): Lyon<br />
*Arrival date and hour: Thursday 14h00<br />
*Departure date and hour: Friday 18h00<br />
*Transportation (Train/Bus/Car/Plane): train<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: [[Mailto:pscoffoni@open-dsi.fr]]<br />
<br />
<br /><br />
<br />
*Company : Net Logic<br />
*Firstname Lastname: Gilles Poirier<br />
*Age: 60<br />
*Coming from (town, country): Noisy Le grand<br />
*Arrival date and hour: Thursday 14h00<br />
*Departure date and hour: Friday 17h00<br />
*Transportation (Train/Bus/Car/Plane): train<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: [[Mailto:gilles.poirier@netlogic.fr]]<br />
<br />
<br /><br />
<br />
*Company : Net Logic<br />
*Firstname Lastname: Frédéric France<br />
*Age: 55<br />
*Coming from (town, country): Montpellier (St Drézéry)<br />
*Arrival date and hour: Thursday 14h00<br />
*Departure date and hour: Friday 17h00<br />
*Transportation (Train/Bus/Car/Plane): car<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: [[Mailto:frederic.france@netlogic.fr]]<br />
<br />
<br /><br />
<br />
*Company : Oscss Shop<br />
*Firstname Lastname: Norbert PENEL<br />
*Age: 43<br />
*Coming from (town, country): Grenoble<br />
*Arrival date and hour: Friday 9h00<br />
*Departure date and hour: Sunday at the end of E.<br />
*Transportation (Train/Bus/Car/Plane): car<br />
*Food (Special diet, allergies, vegetarian…): No fish<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: [[Mailto:n.penel@oscss-shop.fr]]<br />
<br />
*Company : Oscss Shop<br />
*Firstname Lastname: Aurélien IMHOF<br />
*Age: 46<br />
*Coming from (town, country): Chartres<br />
*Arrival date and hour: Friday 11h00<br />
*Departure date and hour: Sunday at the end of E.<br />
*Transportation (Train/Bus/Car/Plane): Train<br />
*Food (Special diet, allergies, vegetarian…): No fish<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
<br />
<br />
*Company : Jeffinfo SARL<br />
*Firstname Lastname: Olivier Geffroy<br />
*Age: 44<br />
*Coming from (town, country): Lille<br />
*Arrival date and hour: Friday 9h00<br />
*Departure date and hour: Sunday at the end of E.<br />
*Transportation (Train/Bus/Car/Plane): car<br />
*Food (Special diet, allergies, vegetarian…):<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: jeff@jeffinfo.com<br />
<br />
*Company : Business Assistante<br />
*Firstname Lastname: Stephanie Leman<br />
*Age: 44<br />
*Coming from (town, country): Lille<br />
*Arrival date and hour: Friday 9h00<br />
*Departure date and hour: Sunday at the end of E.<br />
*Transportation (Train/Bus/Car/Plane): car<br />
*Food (Special diet, allergies, vegetarian…):<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: stephanie@businessassistante.com<br />
<br />
<br /><br />
<br />
*Company : PRAGMA-TECH<br />
*Firstname Lastname: Barrouillet Nicolas<br />
*Age: 44<br />
*Coming from (town, country): PAU<br />
<br />
*Arrival date and hour: thursday 21st 20h00<br />
*Departure date and hour: sunday 24th 07h30 morning<br />
*Transportation (Train/Bus/Car/Plane): train<br />
*Food (Special diet, allergies, vegetarian…):<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: nicolas@pragma-tech.fr<br />
<br />
<br /><br />
<br />
*Company : Ab1 Consulting<br />
*Firstname Lastname: Abbes Bahfir<br />
*Age: 55<br />
*Coming from (town, country): Marseille<br />
<br />
*Arrival date and hour: thursday 21st Moring<br />
*Departure date and hour: sunday 24th Afternoon<br />
*Transportation (Train/Bus/Car/Plane): car<br />
*Food (Special diet, allergies, vegetarian…):<br />
*Accommodation (Common booking hotel/self…): Common booking<br />
*Book hotel for me (yes/no): yes<br />
*Email for contact: bafbes@gmail.com<br />
<br />
<br /></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=File:Ab1consulting_logo.png&diff=50396File:Ab1consulting logo.png2021-04-19T20:07:11Z<p>Abahfir: logo ab1consulting</p>
<hr />
<div>== Summary ==<br />
logo ab1consulting</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=DevCamp_Valence_2020_Organization&diff=48490DevCamp Valence 2020 Organization2020-10-07T11:19:35Z<p>Abahfir: /* Attendees registration */</p>
<hr />
<div>__NOINDEX__<br />
{{TemplateAssoEn}}<br />
[[Category:DevCamps]]<br />
<br />
=Event=<br />
<br />
'''Dolibarr Christmas DevCamp 2020'''<br />
<br />
3rd edition of the Christmas Devcamp in Valence after 2016 and 2018, strongly technical oriented, goal is to work on bug fixes for Dolibarr 13.0 ;)<br />
<br />
'''! Places are limited !'''<br />
<br />
==Dates==<br />
<br />
November 2020, 27-28-29<br />
<br />
==Location==<br />
<br />
Ibis Hotel, 2-4 avenue de la Gare, Alixan (near Valence), France (https://all.accor.com/hotel/8717/index.fr.shtml)<br />
<br />
==How to come==<br />
<br />
*Airplane: Lyon airport then train to Valence TGV<br />
*Train: Valence TGV train station<br />
*Car: Exit the A7 highway at Valence North or Valence South and follow TGV Station (Gare TGV)<br />
<br />
==Main languages==<br />
<br />
*French / English<br />
<br />
==Organizers==<br />
<br />
*Main: ATM Consulting (maxime@atm-consulting.fr)<br />
*Hosting: ATM Consulting (maxime@atm-consulting.fr)<br />
*Lodging and Catering: ATM Consulting (maxime@atm-consulting.fr)<br />
<br />
==Lodging and catering==<br />
<br />
Meals and bedrooms will be provided during the devcamp by the Ibis hotel. Feel free to bring sweets and beverages at your convenience !<br />
<br />
=Planning=<br />
<br />
==Day 1 (Friday)==<br />
<br />
*14:00 - Devcamp begins !<br />
*20:00 - Dinner<br />
<br />
==Day 2 (Saturday)==<br />
<br />
*09:00 - Devcamp continues !<br />
*12:00 - Lunch<br />
*20:00 - Dinner<br />
<br />
==Day 3 (Sunday)==<br />
<br />
*09:00 - Devcamp continues !<br />
*12:00 - Lunch<br />
*14:00 - Devcamp ends<br />
<br />
=Topics and issues to work on=<br />
<br />
*TakePOS present, roadmap and new TakePOS connector<br />
<br />
=Attendees registration=<br />
[[File:Maxime_Kohlhaas.png|40px]] + ? from ATM Consulting<br />
<br />
*Firstname Lastname:[[Maxime Kohlhaas]]<br />
*Age: 33<br />
*Coming from (town, country): Valence (26000), France<br />
*Arrival date and hour: Friday 12:00<br />
*Departure date and hour: Sunday 16:00<br />
*Transportation (Train/Bus/Car/Plane): Car<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): None<br />
*Book hotel for me (yes/no): No<br />
*Contact email: maxime@atm-consulting.fr<br />
<br />
------------------------------------------<br />
<br />
*Firstname Lastname: Andreu Bisquerra Gaya<br />
*Age: 37<br />
*Coming from (town, country): Mallorca - Spain (I come from Spain, but I will come with a negative PCR)<br />
*Arrival date and hour: Friday 12:00<br />
*Departure date and hour: Sunday 16:00<br />
*Transportation (Train/Bus/Car/Plane): Car<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): None<br />
*Book hotel for me (yes/no): Yes<br />
*Contact email: jove@bisquerra.com<br />
<br />
------------------------------------------<br />
<br />
[[File:Laurent_Destailleur.png|40px]] + ? from NLTechno<br />
<br />
*Firstname Lastname:[[Laurent Destailleur]]<br />
*Age: 48<br />
*Coming from (town, country): Pessac (33600), France<br />
*Arrival date and hour: Friday 15:00<br />
*Departure date and hour: Sunday 14:00<br />
*Transportation (Train/Bus/Car/Plane): Train<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): None<br />
*Book hotel for me (yes/no): Yes<br />
*Contact email: contact@nltechno.com<br />
------------------------------------------<br />
<br />
*Firstname Lastname:[[Bahfir Abbes]]<br />
*Age: 53<br />
*Coming from (town, country): Algiers, Algeria<br />
*Arrival date and hour: Thursday 15:00<br />
*Departure date and hour: Sunday 14:00<br />
*Transportation (Train/Bus/Car/Plane): Plane+Train<br />
*Food (Special diet, allergies, vegetarian…): None<br />
*Accommodation (Common booked hotel/self…): None<br />
*Book hotel for me (yes/no): Yes<br />
*Contact email: bafbes@gmail.com</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestor_de_menu_Abbes_ES&diff=48464Module Gestor de menu Abbes ES2020-09-23T22:15:25Z<p>Abahfir: </p>
<hr />
<div>{{DISPLAYTITLE:Módulo Gestor de menús Abbes ES}}<!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> <br />
{{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=información=<br />
{{TemplateModuleInfo<br />
|modulename=Gestor de menús Abbes<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Requisitos previos=<br />
Dolibarr 9.0.x<br />
<br />
=Resumen:=<br />
El Gestor de menús Abbes fue la primera herramienta en su categoría. Fue creado para facilitar la navegación en los menús de Dolibarr, simplificando la gestión de los elementos del menú y ofreciendo todas las posibilidades de personalización imaginables.<br />
<br />
=Instalación=<br />
<br />
*Descargue el archivo (.zip) del módulo del sitio web www.dolistore.com o recupérelo de cualquier otra manera.<br />
*Coloque el archivo en el directorio raíz de dolibarr o cree una carpeta personalizada en la raíz de dolibarr para colocarlo allí con todos sus módulos adicionales (si elige esta solución, recuerde descomentar las dos líneas del archivo conf en relación)<br />
*Descomprima el archivo con el comando descomprimir module_menupar-X.Y.Z.zip<br />
*La ubicación correcta del módulo debe ser del tipo: htdocs/custom/menupar.<br />
*Vaya a la ubicación de instalación del módulo y otorgue privilegios de lectura y escritura al servidor PHP para los siguientes archivos:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
El módulo está operativo y se puede activar.<br />
<br />
=Configuración=<br />
Para usar este módulo, primero debe activarlo. Para hacer esto, después de iniciar sesión con una cuenta de administrador, vaya a la página " '''Inicio - Configuración - Módulos''' ". El módulo aparece en la categoría "Otros", haga clic en "Activar". Aparece un pictograma al final de la línea del módulo, haga clic en él para acceder a la página de configuración específica de este módulo:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Página de configuración de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]Tenemos una lista de 4 parámetros con un signo de interrogación que muestra una explicación detallada tan pronto como colocamos el ratón sobre ella. :<br />
<br />
#Mostrar una entrada de menú para cada categoría de producto : De manera predeterminada, solo hay una entrada en el menú para enumerar los productos. Active esta opción para mostrar una entrada para cada categoría de producto para los usuarios definidos por la opción USERCAT.<br />
#USERCAT→ Usuarios de de los menús de categorías de productos: este parámetro contiene todos los nombres de inicio de sesión de los usuarios con una entrada en los menús de categorías de productos.<br />
#Scrolls: muestra los scrolls en menús desplegables<br />
#Longitud de la lista desplegable: longitud fija de la lista desplegable con scrolls en 1 y 1000 píxeles.<br />
<br />
=Activación y uso=<br />
La activación del administrador de menús de MenuPar es independiente de la activación del módulo. Se hace trás la activación del módulo en el menú de configuración del menú de inicio :[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activación del administrador de menús de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Una vez que se activa el administrador de menús, la columna izquierda desaparece inmediatamente y los menús desplegables correspondientes a los elementos en el menú superior aparecen tan pronto como se coloca el ratón sobre él :[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menú principal|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]Los cuatro elementos en la parte superior del menú de inicio son expandibles. Esto le da acceso inmediato a los elementos finales del menú.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menú Productos|Servicios|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Dado que todos los elementos del menú de la izquierda se ven en un solo nivel, sus números en los menús desplegables pueden ser significativos. Luego podemos configurar el administrador para asociar un scroll con ellos y limitarlos para todos los menús desplegables que no sean el menú de inicio. En la imagen, también vemos los elementos que permiten enumerar los productos por categoría disponibles a través del segundo parámetro de configuración.<br />
<br />
=Funciones avanzadas:=<br />
<br />
==Edición del menú:==<br />
El administrador de menús de MenuPar se basa en el menú de Auguria. Por lo tanto, podemos agregar, modificar o eliminar elementos del menú accediendo a principal→configuración→menús→edición de menu :[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edición del menú|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br /><br />
<br />
==Guardar menús:==<br />
Después de realizar cambios en la estructura del menú, es posible guardar los cambios realizados y volver a cargarlos cuando lo necesitamos. Se puede acceder a esta función desde la página de configuración del módulo a través del botón '''Copia de seguridad/Restaurar la tabla de menús''' :[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Guardar menús|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]La función de copia de seguridad del menú de MenuPar es idéntica en todos los aspectos a la de la copia de seguridad de la base de datos Dolibarr. La diferencia consta en que la función de copia de seguridad del menú MenuPar realiza una copia de seguridad de la única tabla de menú llx_menu y la existencia de un botón de restauración junto a cada archivo de copia de seguridad.<br />
<br />
=Otras fuentes de información:=<br />
Página de información del módulo en Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Sitio de demostración : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Enlace en Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
[[Category:Módulos complementarios]]<br />
{{DEFAULTSORT:Módulo MenuPar ES}}</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestor_de_menu_Abbes_ES&diff=48463Module Gestor de menu Abbes ES2020-09-23T22:11:49Z<p>Abahfir: </p>
<hr />
<div>{{DISPLAYTITLE:Módulo Gestor de menús Abbes ES}}<!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> <br />
{{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=información=<br />
{{TemplateModuleInfo<br />
|modulename=Gestor de menús Abbes<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Requisitos previos=<br />
Dolibarr 9.0.x<br />
<br />
=Resumen:=<br />
El Gestor de menús MenuPar fue la primera herramienta en su categoría. Fue creado para facilitar la navegación en los menús de Dolibarr, simplificando la gestión de los elementos del menú y ofreciendo todas las posibilidades de personalización imaginables.<br />
<br />
=Instalación=<br />
<br />
*Descargue el archivo (.zip) del módulo del sitio web www.dolistore.com o recupérelo de cualquier otra manera.<br />
*Coloque el archivo en el directorio raíz de dolibarr o cree una carpeta personalizada en la raíz de dolibarr para colocarlo allí con todos sus módulos adicionales (si elige esta solución, recuerde descomentar las dos líneas del archivo conf en relación)<br />
*Descomprima el archivo con el comando descomprimir module_menupar-X.Y.Z.zip<br />
*La ubicación correcta del módulo debe ser del tipo: htdocs/custom/menupar.<br />
*Vaya a la ubicación de instalación del módulo y otorgue privilegios de lectura y escritura al servidor PHP para los siguientes archivos:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
El módulo está operativo y se puede activar.<br />
<br />
=Configuración=<br />
Para usar este módulo, primero debe activarlo. Para hacer esto, después de iniciar sesión con una cuenta de administrador, vaya a la página " '''Inicio - Configuración - Módulos''' ". El módulo aparece en la categoría "Otros", haga clic en "Activar". Aparece un pictograma al final de la línea del módulo, haga clic en él para acceder a la página de configuración específica de este módulo:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Página de configuración de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]Tenemos una lista de 4 parámetros con un signo de interrogación que muestra una explicación detallada tan pronto como colocamos el ratón sobre ella. :<br />
<br />
#Mostrar una entrada de menú para cada categoría de producto : De manera predeterminada, solo hay una entrada en el menú para enumerar los productos. Active esta opción para mostrar una entrada para cada categoría de producto para los usuarios definidos por la opción USERCAT.<br />
#USERCAT→ Usuarios de de los menús de categorías de productos: este parámetro contiene todos los nombres de inicio de sesión de los usuarios con una entrada en los menús de categorías de productos.<br />
#Scrolls: muestra los scrolls en menús desplegables<br />
#Longitud de la lista desplegable: longitud fija de la lista desplegable con scrolls en 1 y 1000 píxeles.<br />
<br />
=Activación y uso=<br />
La activación del administrador de menús de MenuPar es independiente de la activación del módulo. Se hace trás la activación del módulo en el menú de configuración del menú de inicio :[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activación del administrador de menús de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Una vez que se activa el administrador de menús, la columna izquierda desaparece inmediatamente y los menús desplegables correspondientes a los elementos en el menú superior aparecen tan pronto como se coloca el ratón sobre él :[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menú principal|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]Los cuatro elementos en la parte superior del menú de inicio son expandibles. Esto le da acceso inmediato a los elementos finales del menú.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menú Productos|Servicios|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Dado que todos los elementos del menú de la izquierda se ven en un solo nivel, sus números en los menús desplegables pueden ser significativos. Luego podemos configurar el administrador para asociar un scroll con ellos y limitarlos para todos los menús desplegables que no sean el menú de inicio. En la imagen, también vemos los elementos que permiten enumerar los productos por categoría disponibles a través del segundo parámetro de configuración.<br />
<br />
=Funciones avanzadas:=<br />
<br />
==Edición del menú:==<br />
El administrador de menús de MenuPar se basa en el menú de Auguria. Por lo tanto, podemos agregar, modificar o eliminar elementos del menú accediendo a principal→configuración→menús→edición de menu :[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edición del menú|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br /><br />
<br />
==Guardar menús:==<br />
Después de realizar cambios en la estructura del menú, es posible guardar los cambios realizados y volver a cargarlos cuando lo necesitamos. Se puede acceder a esta función desde la página de configuración del módulo a través del botón '''Copia de seguridad/Restaurar la tabla de menús''' :[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Guardar menús|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]La función de copia de seguridad del menú de MenuPar es idéntica en todos los aspectos a la de la copia de seguridad de la base de datos Dolibarr. La diferencia consta en que la función de copia de seguridad del menú MenuPar realiza una copia de seguridad de la única tabla de menú llx_menu y la existencia de un botón de restauración junto a cada archivo de copia de seguridad.<br />
<br />
=Otras fuentes de información:=<br />
Página de información del módulo en Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Sitio de demostración : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Enlace en Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
[[Category:Módulos complementarios]]<br />
{{DEFAULTSORT:Módulo MenuPar ES}}</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestor_de_menu_Abbes_ES&diff=48462Module Gestor de menu Abbes ES2020-09-23T22:10:57Z<p>Abahfir: </p>
<hr />
<div>{{DISPLAYTITLE:Módulo Gestor de menús Abbes ES}}<!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> <br />
{{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=información=<br />
{{TemplateModuleInfo<br />
|modulename=Gestor de menús Abbes<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Requisitos previos=<br />
Dolibarr 9.0.x, 10.0.x<br />
<br />
=Resumen:=<br />
El Gestor de menús MenuPar fue la primera herramienta en su categoría. Fue creado para facilitar la navegación en los menús de Dolibarr, simplificando la gestión de los elementos del menú y ofreciendo todas las posibilidades de personalización imaginables.<br />
<br />
=Instalación=<br />
<br />
*Descargue el archivo (.zip) del módulo del sitio web www.dolistore.com o recupérelo de cualquier otra manera.<br />
*Coloque el archivo en el directorio raíz de dolibarr o cree una carpeta personalizada en la raíz de dolibarr para colocarlo allí con todos sus módulos adicionales (si elige esta solución, recuerde descomentar las dos líneas del archivo conf en relación)<br />
*Descomprima el archivo con el comando descomprimir module_menupar-X.Y.Z.zip<br />
*La ubicación correcta del módulo debe ser del tipo: htdocs/custom/menupar.<br />
*Vaya a la ubicación de instalación del módulo y otorgue privilegios de lectura y escritura al servidor PHP para los siguientes archivos:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
El módulo está operativo y se puede activar.<br />
<br />
=Configuración=<br />
Para usar este módulo, primero debe activarlo. Para hacer esto, después de iniciar sesión con una cuenta de administrador, vaya a la página " '''Inicio - Configuración - Módulos''' ". El módulo aparece en la categoría "Otros", haga clic en "Activar". Aparece un pictograma al final de la línea del módulo, haga clic en él para acceder a la página de configuración específica de este módulo:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Página de configuración de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]Tenemos una lista de 4 parámetros con un signo de interrogación que muestra una explicación detallada tan pronto como colocamos el ratón sobre ella. :<br />
<br />
#Mostrar una entrada de menú para cada categoría de producto : De manera predeterminada, solo hay una entrada en el menú para enumerar los productos. Active esta opción para mostrar una entrada para cada categoría de producto para los usuarios definidos por la opción USERCAT.<br />
#USERCAT→ Usuarios de de los menús de categorías de productos: este parámetro contiene todos los nombres de inicio de sesión de los usuarios con una entrada en los menús de categorías de productos.<br />
#Scrolls: muestra los scrolls en menús desplegables<br />
#Longitud de la lista desplegable: longitud fija de la lista desplegable con scrolls en 1 y 1000 píxeles.<br />
<br />
=Activación y uso=<br />
La activación del administrador de menús de MenuPar es independiente de la activación del módulo. Se hace trás la activación del módulo en el menú de configuración del menú de inicio :[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activación del administrador de menús de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Una vez que se activa el administrador de menús, la columna izquierda desaparece inmediatamente y los menús desplegables correspondientes a los elementos en el menú superior aparecen tan pronto como se coloca el ratón sobre él :[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menú principal|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]Los cuatro elementos en la parte superior del menú de inicio son expandibles. Esto le da acceso inmediato a los elementos finales del menú.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menú Productos|Servicios|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Dado que todos los elementos del menú de la izquierda se ven en un solo nivel, sus números en los menús desplegables pueden ser significativos. Luego podemos configurar el administrador para asociar un scroll con ellos y limitarlos para todos los menús desplegables que no sean el menú de inicio. En la imagen, también vemos los elementos que permiten enumerar los productos por categoría disponibles a través del segundo parámetro de configuración.<br />
<br />
=Funciones avanzadas:=<br />
<br />
==Edición del menú:==<br />
El administrador de menús de MenuPar se basa en el menú de Auguria. Por lo tanto, podemos agregar, modificar o eliminar elementos del menú accediendo a principal→configuración→menús→edición de menu :[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edición del menú|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br /><br />
<br />
==Guardar menús:==<br />
Después de realizar cambios en la estructura del menú, es posible guardar los cambios realizados y volver a cargarlos cuando lo necesitamos. Se puede acceder a esta función desde la página de configuración del módulo a través del botón '''Copia de seguridad/Restaurar la tabla de menús''' :[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Guardar menús|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]La función de copia de seguridad del menú de MenuPar es idéntica en todos los aspectos a la de la copia de seguridad de la base de datos Dolibarr. La diferencia consta en que la función de copia de seguridad del menú MenuPar realiza una copia de seguridad de la única tabla de menú llx_menu y la existencia de un botón de restauración junto a cada archivo de copia de seguridad.<br />
<br />
=Otras fuentes de información:=<br />
Página de información del módulo en Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Sitio de demostración : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Enlace en Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
[[Category:Módulos complementarios]]<br />
{{DEFAULTSORT:Módulo MenuPar ES}}</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestor_de_menu_Abbes_ES&diff=48461Module Gestor de menu Abbes ES2020-09-23T22:10:26Z<p>Abahfir: </p>
<hr />
<div>{{DISPLAYTITLE:Módulo Gestor de menús Abbes ES}}<!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> <br />
{{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=información=<br />
{{TemplateModuleInfo<br />
|modulename=MenuPar<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Requisitos previos=<br />
Dolibarr 9.0.x, 10.0.x<br />
<br />
=Resumen:=<br />
El Gestor de menús MenuPar fue la primera herramienta en su categoría. Fue creado para facilitar la navegación en los menús de Dolibarr, simplificando la gestión de los elementos del menú y ofreciendo todas las posibilidades de personalización imaginables.<br />
<br />
=Instalación=<br />
<br />
*Descargue el archivo (.zip) del módulo del sitio web www.dolistore.com o recupérelo de cualquier otra manera.<br />
*Coloque el archivo en el directorio raíz de dolibarr o cree una carpeta personalizada en la raíz de dolibarr para colocarlo allí con todos sus módulos adicionales (si elige esta solución, recuerde descomentar las dos líneas del archivo conf en relación)<br />
*Descomprima el archivo con el comando descomprimir module_menupar-X.Y.Z.zip<br />
*La ubicación correcta del módulo debe ser del tipo: htdocs/custom/menupar.<br />
*Vaya a la ubicación de instalación del módulo y otorgue privilegios de lectura y escritura al servidor PHP para los siguientes archivos:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
El módulo está operativo y se puede activar.<br />
<br />
=Configuración=<br />
Para usar este módulo, primero debe activarlo. Para hacer esto, después de iniciar sesión con una cuenta de administrador, vaya a la página " '''Inicio - Configuración - Módulos''' ". El módulo aparece en la categoría "Otros", haga clic en "Activar". Aparece un pictograma al final de la línea del módulo, haga clic en él para acceder a la página de configuración específica de este módulo:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Página de configuración de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]Tenemos una lista de 4 parámetros con un signo de interrogación que muestra una explicación detallada tan pronto como colocamos el ratón sobre ella. :<br />
<br />
#Mostrar una entrada de menú para cada categoría de producto : De manera predeterminada, solo hay una entrada en el menú para enumerar los productos. Active esta opción para mostrar una entrada para cada categoría de producto para los usuarios definidos por la opción USERCAT.<br />
#USERCAT→ Usuarios de de los menús de categorías de productos: este parámetro contiene todos los nombres de inicio de sesión de los usuarios con una entrada en los menús de categorías de productos.<br />
#Scrolls: muestra los scrolls en menús desplegables<br />
#Longitud de la lista desplegable: longitud fija de la lista desplegable con scrolls en 1 y 1000 píxeles.<br />
<br />
=Activación y uso=<br />
La activación del administrador de menús de MenuPar es independiente de la activación del módulo. Se hace trás la activación del módulo en el menú de configuración del menú de inicio :[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activación del administrador de menús de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Una vez que se activa el administrador de menús, la columna izquierda desaparece inmediatamente y los menús desplegables correspondientes a los elementos en el menú superior aparecen tan pronto como se coloca el ratón sobre él :[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menú principal|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]Los cuatro elementos en la parte superior del menú de inicio son expandibles. Esto le da acceso inmediato a los elementos finales del menú.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menú Productos|Servicios|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Dado que todos los elementos del menú de la izquierda se ven en un solo nivel, sus números en los menús desplegables pueden ser significativos. Luego podemos configurar el administrador para asociar un scroll con ellos y limitarlos para todos los menús desplegables que no sean el menú de inicio. En la imagen, también vemos los elementos que permiten enumerar los productos por categoría disponibles a través del segundo parámetro de configuración.<br />
<br />
=Funciones avanzadas:=<br />
<br />
==Edición del menú:==<br />
El administrador de menús de MenuPar se basa en el menú de Auguria. Por lo tanto, podemos agregar, modificar o eliminar elementos del menú accediendo a principal→configuración→menús→edición de menu :[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edición del menú|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br /><br />
<br />
==Guardar menús:==<br />
Después de realizar cambios en la estructura del menú, es posible guardar los cambios realizados y volver a cargarlos cuando lo necesitamos. Se puede acceder a esta función desde la página de configuración del módulo a través del botón '''Copia de seguridad/Restaurar la tabla de menús''' :[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Guardar menús|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]La función de copia de seguridad del menú de MenuPar es idéntica en todos los aspectos a la de la copia de seguridad de la base de datos Dolibarr. La diferencia consta en que la función de copia de seguridad del menú MenuPar realiza una copia de seguridad de la única tabla de menú llx_menu y la existencia de un botón de restauración junto a cada archivo de copia de seguridad.<br />
<br />
=Otras fuentes de información:=<br />
Página de información del módulo en Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Sitio de demostración : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Enlace en Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
[[Category:Módulos complementarios]]<br />
{{DEFAULTSORT:Módulo MenuPar ES}}</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_MenuPar_ES&diff=48460Module MenuPar ES2020-09-23T22:08:19Z<p>Abahfir: Abahfir moved page Module MenuPar ES to Module Gestor de menu Abbes ES</p>
<hr />
<div>#REDIRECT [[Module Gestor de menu Abbes ES]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestor_de_menu_Abbes_ES&diff=48459Module Gestor de menu Abbes ES2020-09-23T22:08:19Z<p>Abahfir: Abahfir moved page Module MenuPar ES to Module Gestor de menu Abbes ES</p>
<hr />
<div>{{DISPLAYTITLE:Módulo MenuPar ES}}<!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> <br />
{{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=información=<br />
{{TemplateModuleInfo<br />
|modulename=MenuPar<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Requisitos previos=<br />
Dolibarr 9.0.x, 10.0.x<br />
<br />
=Resumen:=<br />
El administrador de menús MenuPar fue la primera herramienta en su categoría. Fue creado para facilitar la navegación en los menús de Dolibarr, simplificando la gestión de los elementos del menú y ofreciendo todas las posibilidades de personalización imaginables.<br />
<br />
=Instalación=<br />
<br />
*Descargue el archivo (.zip) del módulo del sitio web www.dolistore.com o recupérelo de cualquier otra manera.<br />
*Coloque el archivo en el directorio raíz de dolibarr o cree una carpeta personalizada en la raíz de dolibarr para colocarlo allí con todos sus módulos adicionales (si elige esta solución, recuerde descomentar las dos líneas del archivo conf en relación)<br />
*Descomprima el archivo con el comando descomprimir module_menupar-X.Y.Z.zip<br />
*La ubicación correcta del módulo debe ser del tipo: htdocs/custom/menupar.<br />
*Vaya a la ubicación de instalación del módulo y otorgue privilegios de lectura y escritura al servidor PHP para los siguientes archivos:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
El módulo está operativo y se puede activar.<br />
<br />
=Configuración=<br />
Para usar este módulo, primero debe activarlo. Para hacer esto, después de iniciar sesión con una cuenta de administrador, vaya a la página " '''Inicio - Configuración - Módulos''' ". El módulo aparece en la categoría "Otros", haga clic en "Activar". Aparece un pictograma al final de la línea del módulo, haga clic en él para acceder a la página de configuración específica de este módulo:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Página de configuración de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]Tenemos una lista de 4 parámetros con un signo de interrogación que muestra una explicación detallada tan pronto como colocamos el ratón sobre ella. :<br />
<br />
#Mostrar una entrada de menú para cada categoría de producto : De manera predeterminada, solo hay una entrada en el menú para enumerar los productos. Active esta opción para mostrar una entrada para cada categoría de producto para los usuarios definidos por la opción USERCAT.<br />
#USERCAT→ Usuarios de de los menús de categorías de productos: este parámetro contiene todos los nombres de inicio de sesión de los usuarios con una entrada en los menús de categorías de productos.<br />
#Scrolls: muestra los scrolls en menús desplegables<br />
#Longitud de la lista desplegable: longitud fija de la lista desplegable con scrolls en 1 y 1000 píxeles.<br />
<br />
=Activación y uso=<br />
La activación del administrador de menús de MenuPar es independiente de la activación del módulo. Se hace trás la activación del módulo en el menú de configuración del menú de inicio :[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activación del administrador de menús de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Una vez que se activa el administrador de menús, la columna izquierda desaparece inmediatamente y los menús desplegables correspondientes a los elementos en el menú superior aparecen tan pronto como se coloca el ratón sobre él :[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menú principal|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]Los cuatro elementos en la parte superior del menú de inicio son expandibles. Esto le da acceso inmediato a los elementos finales del menú.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menú Productos|Servicios|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Dado que todos los elementos del menú de la izquierda se ven en un solo nivel, sus números en los menús desplegables pueden ser significativos. Luego podemos configurar el administrador para asociar un scroll con ellos y limitarlos para todos los menús desplegables que no sean el menú de inicio. En la imagen, también vemos los elementos que permiten enumerar los productos por categoría disponibles a través del segundo parámetro de configuración.<br />
<br />
=Funciones avanzadas:=<br />
<br />
==Edición del menú:==<br />
El administrador de menús de MenuPar se basa en el menú de Auguria. Por lo tanto, podemos agregar, modificar o eliminar elementos del menú accediendo a principal→configuración→menús→edición de menu :[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edición del menú|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br /><br />
<br />
==Guardar menús:==<br />
Después de realizar cambios en la estructura del menú, es posible guardar los cambios realizados y volver a cargarlos cuando lo necesitamos. Se puede acceder a esta función desde la página de configuración del módulo a través del botón '''Copia de seguridad/Restaurar la tabla de menús''' :[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Guardar menús|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]La función de copia de seguridad del menú de MenuPar es idéntica en todos los aspectos a la de la copia de seguridad de la base de datos Dolibarr. La diferencia consta en que la función de copia de seguridad del menú MenuPar realiza una copia de seguridad de la única tabla de menú llx_menu y la existencia de un botón de restauración junto a cada archivo de copia de seguridad.<br />
<br />
=Otras fuentes de información:=<br />
Página de información del módulo en Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Sitio de demostración : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Enlace en Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
[[Category:Módulos complementarios]]<br />
{{DEFAULTSORT:Módulo MenuPar ES}}</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestor_de_menu_Abbes_ES&diff=48458Module Gestor de menu Abbes ES2020-09-23T22:07:56Z<p>Abahfir: </p>
<hr />
<div>{{DISPLAYTITLE:Módulo MenuPar ES}}<!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> <br />
{{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=información=<br />
{{TemplateModuleInfo<br />
|modulename=MenuPar<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Requisitos previos=<br />
Dolibarr 9.0.x, 10.0.x<br />
<br />
=Resumen:=<br />
El administrador de menús MenuPar fue la primera herramienta en su categoría. Fue creado para facilitar la navegación en los menús de Dolibarr, simplificando la gestión de los elementos del menú y ofreciendo todas las posibilidades de personalización imaginables.<br />
<br />
=Instalación=<br />
<br />
*Descargue el archivo (.zip) del módulo del sitio web www.dolistore.com o recupérelo de cualquier otra manera.<br />
*Coloque el archivo en el directorio raíz de dolibarr o cree una carpeta personalizada en la raíz de dolibarr para colocarlo allí con todos sus módulos adicionales (si elige esta solución, recuerde descomentar las dos líneas del archivo conf en relación)<br />
*Descomprima el archivo con el comando descomprimir module_menupar-X.Y.Z.zip<br />
*La ubicación correcta del módulo debe ser del tipo: htdocs/custom/menupar.<br />
*Vaya a la ubicación de instalación del módulo y otorgue privilegios de lectura y escritura al servidor PHP para los siguientes archivos:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
El módulo está operativo y se puede activar.<br />
<br />
=Configuración=<br />
Para usar este módulo, primero debe activarlo. Para hacer esto, después de iniciar sesión con una cuenta de administrador, vaya a la página " '''Inicio - Configuración - Módulos''' ". El módulo aparece en la categoría "Otros", haga clic en "Activar". Aparece un pictograma al final de la línea del módulo, haga clic en él para acceder a la página de configuración específica de este módulo:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Página de configuración de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]Tenemos una lista de 4 parámetros con un signo de interrogación que muestra una explicación detallada tan pronto como colocamos el ratón sobre ella. :<br />
<br />
#Mostrar una entrada de menú para cada categoría de producto : De manera predeterminada, solo hay una entrada en el menú para enumerar los productos. Active esta opción para mostrar una entrada para cada categoría de producto para los usuarios definidos por la opción USERCAT.<br />
#USERCAT→ Usuarios de de los menús de categorías de productos: este parámetro contiene todos los nombres de inicio de sesión de los usuarios con una entrada en los menús de categorías de productos.<br />
#Scrolls: muestra los scrolls en menús desplegables<br />
#Longitud de la lista desplegable: longitud fija de la lista desplegable con scrolls en 1 y 1000 píxeles.<br />
<br />
=Activación y uso=<br />
La activación del administrador de menús de MenuPar es independiente de la activación del módulo. Se hace trás la activación del módulo en el menú de configuración del menú de inicio :[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activación del administrador de menús de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Una vez que se activa el administrador de menús, la columna izquierda desaparece inmediatamente y los menús desplegables correspondientes a los elementos en el menú superior aparecen tan pronto como se coloca el ratón sobre él :[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menú principal|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]Los cuatro elementos en la parte superior del menú de inicio son expandibles. Esto le da acceso inmediato a los elementos finales del menú.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menú Productos|Servicios|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Dado que todos los elementos del menú de la izquierda se ven en un solo nivel, sus números en los menús desplegables pueden ser significativos. Luego podemos configurar el administrador para asociar un scroll con ellos y limitarlos para todos los menús desplegables que no sean el menú de inicio. En la imagen, también vemos los elementos que permiten enumerar los productos por categoría disponibles a través del segundo parámetro de configuración.<br />
<br />
=Funciones avanzadas:=<br />
<br />
==Edición del menú:==<br />
El administrador de menús de MenuPar se basa en el menú de Auguria. Por lo tanto, podemos agregar, modificar o eliminar elementos del menú accediendo a principal→configuración→menús→edición de menu :[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edición del menú|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br /><br />
<br />
==Guardar menús:==<br />
Después de realizar cambios en la estructura del menú, es posible guardar los cambios realizados y volver a cargarlos cuando lo necesitamos. Se puede acceder a esta función desde la página de configuración del módulo a través del botón '''Copia de seguridad/Restaurar la tabla de menús''' :[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Guardar menús|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]La función de copia de seguridad del menú de MenuPar es idéntica en todos los aspectos a la de la copia de seguridad de la base de datos Dolibarr. La diferencia consta en que la función de copia de seguridad del menú MenuPar realiza una copia de seguridad de la única tabla de menú llx_menu y la existencia de un botón de restauración junto a cada archivo de copia de seguridad.<br />
<br />
=Otras fuentes de información:=<br />
Página de información del módulo en Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Sitio de demostración : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Enlace en Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
[[Category:Módulos complementarios]]<br />
{{DEFAULTSORT:Módulo MenuPar ES}}</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_MenuPar_EN&diff=48457Module MenuPar EN2020-09-23T22:05:05Z<p>Abahfir: Abahfir moved page Module MenuPar EN to Module Abbes menu manager EN</p>
<hr />
<div>#REDIRECT [[Module Abbes menu manager EN]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Abbes_menu_manager_EN&diff=48456Module Abbes menu manager EN2020-09-23T22:05:05Z<p>Abahfir: Abahfir moved page Module MenuPar EN to Module Abbes menu manager EN</p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <br />
[[fr:Module MenuPar FR]]<br />
[[es:Module MenuPar ES]]<br />
<!-- END interlang links --> {{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Summary: [edit | edit source]=<br />
Abbes menu manager was the first tool in its category. It was created in order to facilitate navigation in Dolibarr menus, by simplifying management of menu items and offering all imaginable possibilities of personalization.<br />
<br />
=Installation=<br />
<br />
*Download the module archive file (.zip) from the website www.dolistore.com or recover it in any other way.<br />
*Place the file in dolibarr root directory or create a custom folder in dolibarr root and place it there with all your additional modules (If you choose this solution, remember to uncomment the two lines of the conf file in report)<br />
*Unzip the file with the command unzip module_menupar-X.Y.Z.zip<br />
*The correct module location must be of the type: htdocs/custom/menupar.<br />
*Go to the installation location of the module and give read and write privileges to the PHP server for the following files:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
The module is operational and can be activated.<br />
<br />
=Configuration=<br />
To use this module, you must first activate it. To do this, after logging in with an administrator account, go to the " '''Home - Configuration - Modules''' " page. The module appears in "Others", click on "Activate". A pictogram appears at the end of the module line, click on it to access the configuration page specific to this module:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|MenuPar configuration Page|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]We have a list of 4 parameters with a question mark which displays a detailed explanation as soon as we place the mouse on it :<br />
<br />
#Display a menu entry for each product category: By default, there is only one entry in the menu to list the products. Activate this option to display an entry for each product category for users defined by the USERCAT option.<br />
#USERCAT→ Users of product category menus: This parameter contains all the login names of users with an entry in the product category menus.<br />
#Scrolls: Displays Scrolls in drop-down menus<br />
#Length of the drop-down list: Fixed length of the drop-down list with scroll between 1 and 1000 pixels.<br />
<br />
=Activation and Use=<br />
Activating the MenuPar menu manager is different from activating the module. This is done after module activation in home menu →configuration→ menu:[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activation de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Once the menu manager is activated, the left column immediately disappears and in the drop-down menus corresponding to top menu items appear as soon as you position the mouse on it:[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Home Menu |link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]The four items at the top of the home menu are foldable. This gives immediate access to the final menu items.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Products|Services menu|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Since all of the menu items on the left are displayed on one level, their numbers in the drop-down menus may be significant. We can then configure the menu manager to associate a scroll with them and limit their size for all the drop-down menus other than the home menu. On the image, we also see the menu elements allowing to list products by categories available through the second configuration parameter.<br />
<br />
=Advanced functions:=<br />
<br />
==Menu edition:==<br />
The MenuPar menu manager is based on the Auguria menu. One can therefore add, modify or delete menu items by accessing home→configuration→menus→Edit menu:[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edit menu|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br />
==Menu backup :==<br />
After making changes in the menu structure, it is possible to backup the changes made and reload them when needed. This function is accessible from the module configuration page through the '''Backup/Restore''' '''the menu table''' button:[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Menu backup|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]The menu backup function of MenuPar is identical in all respects to that of Dolibarr database backup. The difference is that MenuPar menu backup function backs up only llx_menu menu table and that there exists a restore button next to each backup file.<br />
<br />
=Other sources of information:=<br />
Information page of the module on Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Demo site : [[dolipar.org/dolibarr]]<br />
<br />
Videos in French on Youtube of demonstration of the first version of MenuPar of 2014: [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Videos in English on Youtube of demonstration of the first version of MenuPar of 2014: [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Videos in Spanish on Youtube of demonstration of the first version of MenuPar of 2014: [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Link on Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
<br />
*<br />
<br />
[[Category:Complementary modules]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Abbes_menu_manager_EN&diff=48455Module Abbes menu manager EN2020-09-23T22:04:34Z<p>Abahfir: </p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <br />
[[fr:Module MenuPar FR]]<br />
[[es:Module MenuPar ES]]<br />
<!-- END interlang links --> {{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|editor=Ab13.fr<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
<br />
=Summary: [edit | edit source]=<br />
Abbes menu manager was the first tool in its category. It was created in order to facilitate navigation in Dolibarr menus, by simplifying management of menu items and offering all imaginable possibilities of personalization.<br />
<br />
=Installation=<br />
<br />
*Download the module archive file (.zip) from the website www.dolistore.com or recover it in any other way.<br />
*Place the file in dolibarr root directory or create a custom folder in dolibarr root and place it there with all your additional modules (If you choose this solution, remember to uncomment the two lines of the conf file in report)<br />
*Unzip the file with the command unzip module_menupar-X.Y.Z.zip<br />
*The correct module location must be of the type: htdocs/custom/menupar.<br />
*Go to the installation location of the module and give read and write privileges to the PHP server for the following files:<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
The module is operational and can be activated.<br />
<br />
=Configuration=<br />
To use this module, you must first activate it. To do this, after logging in with an administrator account, go to the " '''Home - Configuration - Modules''' " page. The module appears in "Others", click on "Activate". A pictogram appears at the end of the module line, click on it to access the configuration page specific to this module:[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|MenuPar configuration Page|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_15-39-50.png]]We have a list of 4 parameters with a question mark which displays a detailed explanation as soon as we place the mouse on it :<br />
<br />
#Display a menu entry for each product category: By default, there is only one entry in the menu to list the products. Activate this option to display an entry for each product category for users defined by the USERCAT option.<br />
#USERCAT→ Users of product category menus: This parameter contains all the login names of users with an entry in the product category menus.<br />
#Scrolls: Displays Scrolls in drop-down menus<br />
#Length of the drop-down list: Fixed length of the drop-down list with scroll between 1 and 1000 pixels.<br />
<br />
=Activation and Use=<br />
Activating the MenuPar menu manager is different from activating the module. This is done after module activation in home menu →configuration→ menu:[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activation de MenuPar|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_17-55-25.png]]Once the menu manager is activated, the left column immediately disappears and in the drop-down menus corresponding to top menu items appear as soon as you position the mouse on it:[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Home Menu |link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-27-18.png]]The four items at the top of the home menu are foldable. This gives immediate access to the final menu items.[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Products|Services menu|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-19-42.png]]Since all of the menu items on the left are displayed on one level, their numbers in the drop-down menus may be significant. We can then configure the menu manager to associate a scroll with them and limit their size for all the drop-down menus other than the home menu. On the image, we also see the menu elements allowing to list products by categories available through the second configuration parameter.<br />
<br />
=Advanced functions:=<br />
<br />
==Menu edition:==<br />
The MenuPar menu manager is based on the Auguria menu. One can therefore add, modify or delete menu items by accessing home→configuration→menus→Edit menu:[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edit menu|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_18-46-35.png]]<br />
==Menu backup :==<br />
After making changes in the menu structure, it is possible to backup the changes made and reload them when needed. This function is accessible from the module configuration page through the '''Backup/Restore''' '''the menu table''' button:[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Menu backup|link=https://wiki.dolibarr.org/index.php/File:Capture_d%E2%80%99%C3%A9cran_de_2019-12-15_19-44-46.png]]The menu backup function of MenuPar is identical in all respects to that of Dolibarr database backup. The difference is that MenuPar menu backup function backs up only llx_menu menu table and that there exists a restore button next to each backup file.<br />
<br />
=Other sources of information:=<br />
Information page of the module on Dolipar.org: http://dolipar.org/content/menupar<br />
<br />
Demo site : [[dolipar.org/dolibarr]]<br />
<br />
Videos in French on Youtube of demonstration of the first version of MenuPar of 2014: [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Videos in English on Youtube of demonstration of the first version of MenuPar of 2014: [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Videos in Spanish on Youtube of demonstration of the first version of MenuPar of 2014: [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212<br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307<br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<br />
<br />
Link on Dolistore: https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
<br />
<br /><br />
<br />
*<br />
<br />
[[Category:Complementary modules]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_MenuPar_FR&diff=48454Module MenuPar FR2020-09-23T21:47:14Z<p>Abahfir: Abahfir moved page Module MenuPar FR to Module Gestionnaire de menu abbes FR</p>
<hr />
<div>#REDIRECT [[Module Gestionnaire de menu abbes FR]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestionnaire_de_menu_abbes_FR&diff=48453Module Gestionnaire de menu abbes FR2020-09-23T21:47:14Z<p>Abahfir: Abahfir moved page Module MenuPar FR to Module Gestionnaire de menu abbes FR</p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> {{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Gestionnaire de menu abbes<br />
|editor=Dolipar.org<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 9.0.x, 10.0.x<br />
=<nowiki>Résumé :[edit | edit source]</nowiki>=<br />
Le gestionnaire de menu MenuPar a été le premier outil dans sa catégorie. Il a été créé dans le but de faciliter la navigation dans les menus de Dolibarr, en simplifiant la gestion des éléments de menu et en offrant toutes les possibilités de personnalisation imaginables. <br />
<br />
Il permet notamment de remplacer le menu de gauche par un menu déroulant qui apparaît au passage de la souris sur les éléments du menu du haut, puis d'accéder aux éléments du menu de gauche en un clic au lie de deux ou plus. Il permet aussi de fixer la barre de menus de haut dans les pages de listings d’éléments<br />
<br />
La dernière version inclut la sauvegarde et restauration de menus et les ascenseurs dans les menus déroulants.<br />
<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_menupar-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/menupar.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
=Configuration=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Autres", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Page de configuration de MenuPar]]<br />
On a une liste de 4 paramètres avec un point d'interrogation qui affiche une explication détaillée dés qu'on place la souris dessus. :<br />
<br />
#Afficher une entrée de menu pour chaque catégorie de produits : Par défaut, il existe seulement une entrée dans le menu pour lister les produits. Activez cette option pour afficher une entrée pour chaque catégorie de produits pour les utilisateurs définis par l'option USERCAT.<br />
#USERCAT Utilisateurs de menus de catégories de produits : Ce paramètre contient tous les login des utilisateurs ayant une entrée dans les de menus de catégories de produits.<br />
#Ascenseurs : Affiche des ascenseurs dans les menus déroulants<br />
#Longueur de la liste déroulante : Longueur fixe de la liste déroulante à ascenseurs en 1 et 1000 pixels.<br />
<br />
=Activation et Utilisation=<br />
L'activation du gestionnaire de menu MenuPar est distincte de l'activation du module. Elle se fait à la suite de celle-ci dans le menu accueil configuration menus :<br />
[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activation de MenuPar]]<br />
Une fois le gestionnaire de menu activé, la colonne de gauche disparaît immédiatement et les menus déroulants correspondants aux éléments du menu du haut apparaissent dés qu'on positionne la souris dessus :<br />
[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menu accueil]]<br />
Le quatre éléments du haut du menu accueil sont dépliables. Ce qui permet d'accéder du premier coup aux éléments de menu finaux.<br />
[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menu Produits|Services]]<br />
Comme tous les éléments de menus de gauche sont affichés sur un seul niveau, leurs nombres dans les menus déroulants peut-être important. On peut alors, configurer le gestionnaire pour leur associer un ascenseur et limiter leur pour tous les menus déroulants autres le menu accueil. Sur l'image, on voit aussi les éléments permettant de lister les produits par catégorie disponibles à travers le deuxième paramètre de configuration. <br />
<br />
=Fonctions avancées :=<br />
<br />
==Edition de menu :==<br />
Le gestionnaire de menu MenuPar est basé sur le menu Auguria. On peut donc ajouter, modifier, ou supprimer les éléments de menu en accédant à accueil configuration menus Edition de menu :<br />
[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edition du menu]]<br />
<br />
==Sauvegarde de menus:==<br />
<br />
<br />
Après avoir effectué des modifications dans la structure du menu, il est possible de sauvegarder les changements effectués et les recharger au besoin. Cette fonction est accessible sur depuis la page de configuration du module à travers le bouton '''Sauvegarde/Restauration de la table de menus''' :<br />
[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Sauvegarde de menus]]<br />
La fonction de sauvegarde de menus de MenuPar est en tout point identique à celle de sauvegarde de la base de données de Dolibarr. La différence réside en ce que la fonction de sauvegarde de menus de MenuPar fait la sauvegarde de la seule table de menus llx_menu et l'existence d'un bouton de restauration à coté de chaque fichier de sauvegarde.<br />
=Autres sources d'information :=<br />
<br />
Page d'informations sur le module sur Dolipar.org :http://dolipar.org/content/menupar<br />
<br />
Site de demo : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212 <br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307 <br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<nowiki/>Lien sur Dolistore :[https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-MenuPar.html https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html]<br />
[[Category:Modules complémentaires]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestionnaire_de_menu_abbes_FR&diff=48452Module Gestionnaire de menu abbes FR2020-09-23T21:46:26Z<p>Abahfir: </p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> {{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Gestionnaire de menu abbes<br />
|editor=Dolipar.org<br />
|webbuy=https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-abbes.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 9.0.x, 10.0.x<br />
=<nowiki>Résumé :[edit | edit source]</nowiki>=<br />
Le gestionnaire de menu MenuPar a été le premier outil dans sa catégorie. Il a été créé dans le but de faciliter la navigation dans les menus de Dolibarr, en simplifiant la gestion des éléments de menu et en offrant toutes les possibilités de personnalisation imaginables. <br />
<br />
Il permet notamment de remplacer le menu de gauche par un menu déroulant qui apparaît au passage de la souris sur les éléments du menu du haut, puis d'accéder aux éléments du menu de gauche en un clic au lie de deux ou plus. Il permet aussi de fixer la barre de menus de haut dans les pages de listings d’éléments<br />
<br />
La dernière version inclut la sauvegarde et restauration de menus et les ascenseurs dans les menus déroulants.<br />
<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_menupar-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/menupar.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
=Configuration=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Autres", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Page de configuration de MenuPar]]<br />
On a une liste de 4 paramètres avec un point d'interrogation qui affiche une explication détaillée dés qu'on place la souris dessus. :<br />
<br />
#Afficher une entrée de menu pour chaque catégorie de produits : Par défaut, il existe seulement une entrée dans le menu pour lister les produits. Activez cette option pour afficher une entrée pour chaque catégorie de produits pour les utilisateurs définis par l'option USERCAT.<br />
#USERCAT Utilisateurs de menus de catégories de produits : Ce paramètre contient tous les login des utilisateurs ayant une entrée dans les de menus de catégories de produits.<br />
#Ascenseurs : Affiche des ascenseurs dans les menus déroulants<br />
#Longueur de la liste déroulante : Longueur fixe de la liste déroulante à ascenseurs en 1 et 1000 pixels.<br />
<br />
=Activation et Utilisation=<br />
L'activation du gestionnaire de menu MenuPar est distincte de l'activation du module. Elle se fait à la suite de celle-ci dans le menu accueil configuration menus :<br />
[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activation de MenuPar]]<br />
Une fois le gestionnaire de menu activé, la colonne de gauche disparaît immédiatement et les menus déroulants correspondants aux éléments du menu du haut apparaissent dés qu'on positionne la souris dessus :<br />
[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menu accueil]]<br />
Le quatre éléments du haut du menu accueil sont dépliables. Ce qui permet d'accéder du premier coup aux éléments de menu finaux.<br />
[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menu Produits|Services]]<br />
Comme tous les éléments de menus de gauche sont affichés sur un seul niveau, leurs nombres dans les menus déroulants peut-être important. On peut alors, configurer le gestionnaire pour leur associer un ascenseur et limiter leur pour tous les menus déroulants autres le menu accueil. Sur l'image, on voit aussi les éléments permettant de lister les produits par catégorie disponibles à travers le deuxième paramètre de configuration. <br />
<br />
=Fonctions avancées :=<br />
<br />
==Edition de menu :==<br />
Le gestionnaire de menu MenuPar est basé sur le menu Auguria. On peut donc ajouter, modifier, ou supprimer les éléments de menu en accédant à accueil configuration menus Edition de menu :<br />
[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edition du menu]]<br />
<br />
==Sauvegarde de menus:==<br />
<br />
<br />
Après avoir effectué des modifications dans la structure du menu, il est possible de sauvegarder les changements effectués et les recharger au besoin. Cette fonction est accessible sur depuis la page de configuration du module à travers le bouton '''Sauvegarde/Restauration de la table de menus''' :<br />
[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Sauvegarde de menus]]<br />
La fonction de sauvegarde de menus de MenuPar est en tout point identique à celle de sauvegarde de la base de données de Dolibarr. La différence réside en ce que la fonction de sauvegarde de menus de MenuPar fait la sauvegarde de la seule table de menus llx_menu et l'existence d'un bouton de restauration à coté de chaque fichier de sauvegarde.<br />
=Autres sources d'information :=<br />
<br />
Page d'informations sur le module sur Dolipar.org :http://dolipar.org/content/menupar<br />
<br />
Site de demo : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212 <br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307 <br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<nowiki/>Lien sur Dolistore :[https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-MenuPar.html https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html]<br />
[[Category:Modules complémentaires]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestionnaire_de_menu_abbes_FR&diff=48450Module Gestionnaire de menu abbes FR2020-09-23T21:44:45Z<p>Abahfir: </p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> {{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Gestionnaire de menu abbes<br />
|editor=Dolipar.org<br />
|webbuy=https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 9.0.x, 10.0.x<br />
=<nowiki>Résumé :[edit | edit source]</nowiki>=<br />
Le gestionnaire de menu MenuPar a été le premier outil dans sa catégorie. Il a été créé dans le but de faciliter la navigation dans les menus de Dolibarr, en simplifiant la gestion des éléments de menu et en offrant toutes les possibilités de personnalisation imaginables. <br />
<br />
Il permet notamment de remplacer le menu de gauche par un menu déroulant qui apparaît au passage de la souris sur les éléments du menu du haut, puis d'accéder aux éléments du menu de gauche en un clic au lie de deux ou plus. Il permet aussi de fixer la barre de menus de haut dans les pages de listings d’éléments<br />
<br />
La dernière version inclut la sauvegarde et restauration de menus et les ascenseurs dans les menus déroulants.<br />
<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_menupar-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/menupar.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
=Configuration=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Autres", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Page de configuration de MenuPar]]<br />
On a une liste de 4 paramètres avec un point d'interrogation qui affiche une explication détaillée dés qu'on place la souris dessus. :<br />
<br />
#Afficher une entrée de menu pour chaque catégorie de produits : Par défaut, il existe seulement une entrée dans le menu pour lister les produits. Activez cette option pour afficher une entrée pour chaque catégorie de produits pour les utilisateurs définis par l'option USERCAT.<br />
#USERCAT Utilisateurs de menus de catégories de produits : Ce paramètre contient tous les login des utilisateurs ayant une entrée dans les de menus de catégories de produits.<br />
#Ascenseurs : Affiche des ascenseurs dans les menus déroulants<br />
#Longueur de la liste déroulante : Longueur fixe de la liste déroulante à ascenseurs en 1 et 1000 pixels.<br />
<br />
=Activation et Utilisation=<br />
L'activation du gestionnaire de menu MenuPar est distincte de l'activation du module. Elle se fait à la suite de celle-ci dans le menu accueil configuration menus :<br />
[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activation de MenuPar]]<br />
Une fois le gestionnaire de menu activé, la colonne de gauche disparaît immédiatement et les menus déroulants correspondants aux éléments du menu du haut apparaissent dés qu'on positionne la souris dessus :<br />
[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menu accueil]]<br />
Le quatre éléments du haut du menu accueil sont dépliables. Ce qui permet d'accéder du premier coup aux éléments de menu finaux.<br />
[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menu Produits|Services]]<br />
Comme tous les éléments de menus de gauche sont affichés sur un seul niveau, leurs nombres dans les menus déroulants peut-être important. On peut alors, configurer le gestionnaire pour leur associer un ascenseur et limiter leur pour tous les menus déroulants autres le menu accueil. Sur l'image, on voit aussi les éléments permettant de lister les produits par catégorie disponibles à travers le deuxième paramètre de configuration. <br />
<br />
=Fonctions avancées :=<br />
<br />
==Edition de menu :==<br />
Le gestionnaire de menu MenuPar est basé sur le menu Auguria. On peut donc ajouter, modifier, ou supprimer les éléments de menu en accédant à accueil configuration menus Edition de menu :<br />
[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edition du menu]]<br />
<br />
==Sauvegarde de menus:==<br />
<br />
<br />
Après avoir effectué des modifications dans la structure du menu, il est possible de sauvegarder les changements effectués et les recharger au besoin. Cette fonction est accessible sur depuis la page de configuration du module à travers le bouton '''Sauvegarde/Restauration de la table de menus''' :<br />
[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Sauvegarde de menus]]<br />
La fonction de sauvegarde de menus de MenuPar est en tout point identique à celle de sauvegarde de la base de données de Dolibarr. La différence réside en ce que la fonction de sauvegarde de menus de MenuPar fait la sauvegarde de la seule table de menus llx_menu et l'existence d'un bouton de restauration à coté de chaque fichier de sauvegarde.<br />
=Autres sources d'information :=<br />
<br />
Page d'informations sur le module sur Dolipar.org :http://dolipar.org/content/menupar<br />
<br />
Site de demo : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212 <br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307 <br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<nowiki/>Lien sur Dolistore :[https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-MenuPar.html https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html]<br />
[[Category:Modules complémentaires]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Gestionnaire_de_menu_abbes_FR&diff=47802Module Gestionnaire de menu abbes FR2020-07-04T22:08:10Z<p>Abahfir: text</p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_CashdeskPar_EN --> <!-- END interlang links --> {{TemplateDocDevEn}} {{TemplateDocUser}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
<br />
<br /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=MenuPar<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/menupar<br />
|webbuy=https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html<br />
|status=stable<br />
|prerequisites=<br />
|minversion=9.0.0<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 9.0.x, 10.0.x<br />
=<nowiki>Résumé :[edit | edit source]</nowiki>=<br />
Le gestionnaire de menu MenuPar a été le premier outil dans sa catégorie. Il a été créé dans le but de faciliter la navigation dans les menus de Dolibarr, en simplifiant la gestion des éléments de menu et en offrant toutes les possibilités de personnalisation imaginables. <br />
<br />
Il permet notamment de remplacer le menu de gauche par un menu déroulant qui apparaît au passage de la souris sur les éléments du menu du haut, puis d'accéder aux éléments du menu de gauche en un clic au lie de deux ou plus. Il permet aussi de fixer la barre de menus de haut dans les pages de listings d’éléments<br />
<br />
La dernière version inclut la sauvegarde et restauration de menus et les ascenseurs dans les menus déroulants.<br />
<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_menupar-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/menupar.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#menupar_consts.php<br />
#menupar_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
=Configuration=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Autres", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
[[File:Capture d’écran de 2019-12-15 15-39-50.png|alt=Page de configuration de MenuPar|none|thumb|1300x1300px|Page de configuration de MenuPar]]<br />
On a une liste de 4 paramètres avec un point d'interrogation qui affiche une explication détaillée dés qu'on place la souris dessus. :<br />
<br />
#Afficher une entrée de menu pour chaque catégorie de produits : Par défaut, il existe seulement une entrée dans le menu pour lister les produits. Activez cette option pour afficher une entrée pour chaque catégorie de produits pour les utilisateurs définis par l'option USERCAT.<br />
#USERCAT Utilisateurs de menus de catégories de produits : Ce paramètre contient tous les login des utilisateurs ayant une entrée dans les de menus de catégories de produits.<br />
#Ascenseurs : Affiche des ascenseurs dans les menus déroulants<br />
#Longueur de la liste déroulante : Longueur fixe de la liste déroulante à ascenseurs en 1 et 1000 pixels.<br />
<br />
=Activation et Utilisation=<br />
L'activation du gestionnaire de menu MenuPar est distincte de l'activation du module. Elle se fait à la suite de celle-ci dans le menu accueil configuration menus :<br />
[[File:Capture d’écran de 2019-12-15 17-55-25.png|alt=Activation de MenuPar|none|thumb|1300x1300px|Activation de MenuPar]]<br />
Une fois le gestionnaire de menu activé, la colonne de gauche disparaît immédiatement et les menus déroulants correspondants aux éléments du menu du haut apparaissent dés qu'on positionne la souris dessus :<br />
[[File:Capture d’écran de 2019-12-15 18-27-18.png|alt=Menu accueil|none|thumb|1300x1300px|Menu accueil]]<br />
Le quatre éléments du haut du menu accueil sont dépliables. Ce qui permet d'accéder du premier coup aux éléments de menu finaux.<br />
[[File:Capture d’écran de 2019-12-15 18-19-42.png|none|thumb|1300x1300px|Menu Produits|Services]]<br />
Comme tous les éléments de menus de gauche sont affichés sur un seul niveau, leurs nombres dans les menus déroulants peut-être important. On peut alors, configurer le gestionnaire pour leur associer un ascenseur et limiter leur pour tous les menus déroulants autres le menu accueil. Sur l'image, on voit aussi les éléments permettant de lister les produits par catégorie disponibles à travers le deuxième paramètre de configuration. <br />
<br />
=Fonctions avancées :=<br />
<br />
==Edition de menu :==<br />
Le gestionnaire de menu MenuPar est basé sur le menu Auguria. On peut donc ajouter, modifier, ou supprimer les éléments de menu en accédant à accueil configuration menus Edition de menu :<br />
[[File:Capture d’écran de 2019-12-15 18-46-35.png|alt=Edition du menu|none|thumb|1300x1300px|Edition du menu]]<br />
<br />
==Sauvegarde de menus:==<br />
<br />
<br />
Après avoir effectué des modifications dans la structure du menu, il est possible de sauvegarder les changements effectués et les recharger au besoin. Cette fonction est accessible sur depuis la page de configuration du module à travers le bouton '''Sauvegarde/Restauration de la table de menus''' :<br />
[[File:Capture d’écran de 2019-12-15 19-44-46.png|alt=Sauvegarde de menus|none|thumb|1300x1300px|Sauvegarde de menus]]<br />
La fonction de sauvegarde de menus de MenuPar est en tout point identique à celle de sauvegarde de la base de données de Dolibarr. La différence réside en ce que la fonction de sauvegarde de menus de MenuPar fait la sauvegarde de la seule table de menus llx_menu et l'existence d'un bouton de restauration à coté de chaque fichier de sauvegarde.<br />
=Autres sources d'information :=<br />
<br />
Page d'informations sur le module sur Dolipar.org :http://dolipar.org/content/menupar<br />
<br />
Site de demo : [[dolipar.org/dolibarr]]<br />
<br />
Vidéo en Français sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=k7tgj7Wevu0 Gestionnaire de menu abbes pour Dolibarr]<br />
<br />
Vidéo en Anglais sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=Qxk2T5BXK0E Abbes menu manager for Dolibarr v. 1.0]<br />
<br />
Vidéo en Espagnol sur Youtube de démonstration de la première version de MenuPar de 2014 : [https://www.youtube.com/watch?v=bPoEgsng-z8 Gestor de menu Abbes para Dolibarr v. 1.0]<br />
<br />
English Forum : https://www.dolibarr.org/forum/t/cashdeskpar-news/18212 <br />
<br />
Forum Français : https://www.dolibarr.fr/forum/t/gestionnaire-de-menu-menupar/31307 <br />
<br />
Foro en Español : https://www.dolibarr.es/foro/viewtopic.php?f=15&t=10576<nowiki/>Lien sur Dolistore :[https://www.dolistore.com/fr/modules/1158-Gestionnaire-de-menu-MenuPar.html https://www.dolistore.com/modules/1158-Gestionnaire-de-menu-MenuPar.html]<br />
[[Category:Modules complémentaires]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45681Module Parametrage FR2020-01-26T16:58:41Z<p>Abahfir: </p>
<hr />
<div>{{DISPLAYTITLE:Module de Parametrage FR}}<!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> <br />
{{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
<br />
=Remarques sur le paramétrage logiciel en général et dans Dolibarr :=<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Description de notre solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=Configuration du module=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=La composition de configurations :=<br />
Ci dessous la page de composition de configuration obtenue en cliquant sur le bouton de composition complète . Les trois images sont obtenues en déroulant la page :<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
<br />
<br />
Nous obtenons un formulaires composé de 3 sections et un bouton '''composer''' pour l’envoyer. Chaque section est composée de sous-sections et chaque sous-section présente une série de paramètres dans une Datatable<br />
<br />
Les 3 sections sont structurées comme ci-dessous :<br />
<br />
#Paramètres dans le fichier de configuration actuel : Contient les paramètres du fichier de configuration actuel du module de paramétrage. Ils son présentés filtrés par type. On a donc un maximum de 3 sous sections :<br />
##Paramètres du core : commençant avec MAIN_ ou ne contenant pas de caractères soulignés.<br />
##Paramètres de modules non paramétrables : Autres paramètres de la base de données.<br />
##Paramètres de modules paramétrables : Paramètres déclarés par l’instruction '''define'''.<br />
#Paramètres dans les fichiers de configuration de modules paramétrables : Les fichiers de configuration des modules paramétrables sont structurés tout comme le fichier de configurations du module de paramétrage. On a donc pour chaque module paramétrable présent dans l’installation le paramètres :<br />
##Paramètres du core.<br />
##Paramètres de modules non paramétrables.<br />
##Paramètres de modules paramétrables.<br />
#Paramètres dans la base de données : Les paramètres contenus dans la table '''llx_const''' de la base de données de Dolibarr partagés en deux sous-sections :<br />
##Paramètres du core.<br />
##Paramètres de modules non paramétrables.<br />
<br />
Chaque paramètre est représenté sur cinq colonnes :<br />
<br />
#Sélection : Case à cocher pour sélectionner/désélectionner l’élément.<br />
#Module : Pour les paramètres de modules paramétrables ou non paramétrables. Il est vide pour les paramètres du core.<br />
#Paramètre : Nom complet du paramètre.<br />
#Valeur : Valeur du paramètre.<br />
#Note : Contient le commentaire affiché si le commentaire dans le fichier de configuration est vide et que le paramètre n’existe pas dans le fichier de langue<br />
<br />
Chaque groupe de paramètres est représenté dans un élément Jquery Datatable est accompagné d’un bouton pour sélectionner l’ensemble du groupe.<br />
<br />
La différence entre la composition complète et la composition de base réside en ce que dans la première, tous les paramètres présents dans les fichiers de configuration sont présélectionnes alors qu’aucun paramètre n’est sélectionné dans la seconde.<br />
<br />
En appuyant sur le bouton composer, on lance la recréation du fichier de configuration du module de paramétrage avec les paramètres sélectionnés. En case de conflit de paramètre en double un message est affiché indiquant la localisation des conflits et en appliquant le style de surbrillance aux deux paramètres en double et en invitant à désélectionner l’une des deux comme dans l’exemple suivant ( Dans la deuxième image, la page est déroulée pour faire apparaître le deuxième élément ) :<br />
[[File:Capture d’écran de 2020-01-26 13-58-07.png|alt=Conflit de paramètres 1/2|none|thumb|1300x1300px|Conflit de paramètres 1/2]]<br />
[[File:Capture d’écran de 2020-01-26 13-58-14.png|alt=Conflit de paramètres 2/2|none|thumb|1300x1300px|Conflit de paramètres 2/2]]<br />
<br /><br />
<br />
=8 -Création de sections de paramétrage dans des pages spécifiques de Dolibarr=<br />
La création de sections de paramétrage dans les pages spécifique de Dolibarr fait seulement appel aux paramètres de la base de données, paramètres du core ou de modules non paramétrables. Les paramètres de modules paramétrables existant dans les fichiers de configuration de leurs modules sont conçus pour être utilisés seulement dans les pages de ce dernier. Si on a besoin de faire appel à un paramètre de ce type, on peut toujours le déclarer en tant paramètres base de données à l’intérieur du module paramétrable.<br />
<br />
C’est cette fonction qui a permis de rendre obsolètes les modules Facturepar, Facturepar plus et corepar. Le module Facturepar affichait une section de paramétrage dans la page d’édition de factures clients avec environ 24 paramètres alors que grâce au module de paramétrage, on a 81 paramètres contrôlables dans la cette page et on peut procéder de façon similaires pour toutes les pages de Dolibarr y compris celle de modules externe<br />
<br />
Pour créer une section de paramétrage pour une page spécifique de de Dolibarr, il faut procéder en plusieurs étapes :<br />
<br />
#Composition et sauvegarde dans des fichier d’une ou plusieurs configurations.<br />
#Création manuelle d’un fichier de configuration en combinant les paramètres des fichiers composés.<br />
#Création d’une entrée dans le dictionnaire de correspondance de configuration vers urls du module de paramétrage.<br />
<br />
Pour la page d’édition de factures (ex : Facturepar) on a créé une entrée dans le dictionnaire comme dans l’image suivante :<br />
[[File:Dictionnaire des correspondances config. vers url.png|alt=Dictionnaire des correspondances configurations / urls|none|thumb|1300x1300px|Dictionnaire des correspondances configurations / urls]]<br />
Ce qui donne une section de paramétrage dans la page d’édition de factures comme dans l’image suivante accessible dans le site démo dans le lien http://dolipar.org/dolibarr/htdocs/compta/facture/card.php?facid=245 : <br />
[[File:Facturepar.png|alt=Page de l'ex module Facturepar|none|thumb|1300x1300px|Page de l'ex module Facturepar]]<br />
<br /><br />
[[Category:Modules complémentaires]]<br />
{{DEFAULTSORT:Module de Parametrage FR}}</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45680Module Parametrage FR2020-01-26T16:57:48Z<p>Abahfir: /* 8 -Création de sections de paramétrage dans des pages spécifiques de Dolibarr */</p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> {{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
<br />
=Remarques sur le paramétrage logiciel en général et dans Dolibarr :=<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Description de notre solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=Configuration du module=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=La composition de configurations :=<br />
Ci dessous la page de composition de configuration obtenue en cliquant sur le bouton de composition complète . Les trois images sont obtenues en déroulant la page :<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
<br />
<br />
Nous obtenons un formulaires composé de 3 sections et un bouton '''composer''' pour l’envoyer. Chaque section est composée de sous-sections et chaque sous-section présente une série de paramètres dans une Datatable<br />
<br />
Les 3 sections sont structurées comme ci-dessous :<br />
<br />
#Paramètres dans le fichier de configuration actuel : Contient les paramètres du fichier de configuration actuel du module de paramétrage. Ils son présentés filtrés par type. On a donc un maximum de 3 sous sections :<br />
##Paramètres du core : commençant avec MAIN_ ou ne contenant pas de caractères soulignés.<br />
##Paramètres de modules non paramétrables : Autres paramètres de la base de données.<br />
##Paramètres de modules paramétrables : Paramètres déclarés par l’instruction '''define'''.<br />
#Paramètres dans les fichiers de configuration de modules paramétrables : Les fichiers de configuration des modules paramétrables sont structurés tout comme le fichier de configurations du module de paramétrage. On a donc pour chaque module paramétrable présent dans l’installation le paramètres :<br />
##Paramètres du core.<br />
##Paramètres de modules non paramétrables.<br />
##Paramètres de modules paramétrables.<br />
#Paramètres dans la base de données : Les paramètres contenus dans la table '''llx_const''' de la base de données de Dolibarr partagés en deux sous-sections :<br />
##Paramètres du core.<br />
##Paramètres de modules non paramétrables.<br />
<br />
Chaque paramètre est représenté sur cinq colonnes :<br />
<br />
#Sélection : Case à cocher pour sélectionner/désélectionner l’élément.<br />
#Module : Pour les paramètres de modules paramétrables ou non paramétrables. Il est vide pour les paramètres du core.<br />
#Paramètre : Nom complet du paramètre.<br />
#Valeur : Valeur du paramètre.<br />
#Note : Contient le commentaire affiché si le commentaire dans le fichier de configuration est vide et que le paramètre n’existe pas dans le fichier de langue<br />
<br />
Chaque groupe de paramètres est représenté dans un élément Jquery Datatable est accompagné d’un bouton pour sélectionner l’ensemble du groupe.<br />
<br />
La différence entre la composition complète et la composition de base réside en ce que dans la première, tous les paramètres présents dans les fichiers de configuration sont présélectionnes alors qu’aucun paramètre n’est sélectionné dans la seconde.<br />
<br />
En appuyant sur le bouton composer, on lance la recréation du fichier de configuration du module de paramétrage avec les paramètres sélectionnés. En case de conflit de paramètre en double un message est affiché indiquant la localisation des conflits et en appliquant le style de surbrillance aux deux paramètres en double et en invitant à désélectionner l’une des deux comme dans l’exemple suivant ( Dans la deuxième image, la page est déroulée pour faire apparaître le deuxième élément ) :<br />
[[File:Capture d’écran de 2020-01-26 13-58-07.png|alt=Conflit de paramètres 1/2|none|thumb|1300x1300px|Conflit de paramètres 1/2]]<br />
[[File:Capture d’écran de 2020-01-26 13-58-14.png|alt=Conflit de paramètres 2/2|none|thumb|1300x1300px|Conflit de paramètres 2/2]]<br />
<br /><br />
<br />
=8 -Création de sections de paramétrage dans des pages spécifiques de Dolibarr=<br />
La création de sections de paramétrage dans les pages spécifique de Dolibarr fait seulement appel aux paramètres de la base de données, paramètres du core ou de modules non paramétrables. Les paramètres de modules paramétrables existant dans les fichiers de configuration de leurs modules sont conçus pour être utilisés seulement dans les pages de ce dernier. Si on a besoin de faire appel à un paramètre de ce type, on peut toujours le déclarer en tant paramètres base de données à l’intérieur du module paramétrable.<br />
<br />
C’est cette fonction qui a permis de rendre obsolètes les modules Facturepar, Facturepar plus et corepar. Le module Facturepar affichait une section de paramétrage dans la page d’édition de factures clients avec environ 24 paramètres alors que grâce au module de paramétrage, on a 81 paramètres contrôlables dans la cette page et on peut procéder de façon similaires pour toutes les pages de Dolibarr y compris celle de modules externe<br />
<br />
Pour créer une section de paramétrage pour une page spécifique de de Dolibarr, il faut procéder en plusieurs étapes :<br />
<br />
#Composition et sauvegarde dans des fichier d’une ou plusieurs configurations.<br />
#Création manuelle d’un fichier de configuration en combinant les paramètres des fichiers composés.<br />
#Création d’une entrée dans le dictionnaire de correspondance de configuration vers urls du module de paramétrage.<br />
<br />
Pour la page d’édition de factures (ex : Facturepar) on a créé une entrée dans le dictionnaire comme dans l’image suivante :<br />
[[File:Dictionnaire des correspondances config. vers url.png|alt=Dictionnaire des correspondances configurations / urls|none|thumb|1300x1300px|Dictionnaire des correspondances configurations / urls]]<br />
Ce qui donne une section de paramétrage dans la page d’édition de factures comme dans l’image suivante accessible dans le site démo dans le lien http://dolipar.org/dolibarr/htdocs/compta/facture/card.php?facid=245 : <br />
[[File:Facturepar.png|alt=Page de l'ex module Facturepar|none|thumb|1300x1300px|Page de l'ex module Facturepar]]<br />
<br /><br />
[[Category:Modules complémentaires]]</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45679Module Parametrage FR2020-01-26T16:52:21Z<p>Abahfir: </p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> {{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
<br />
=Remarques sur le paramétrage logiciel en général et dans Dolibarr :=<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Description de notre solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=Configuration du module=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=La composition de configurations :=<br />
Ci dessous la page de composition de configuration obtenue en cliquant sur le bouton de composition complète . Les trois images sont obtenues en déroulant la page :<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
<br />
<br />
Nous obtenons un formulaires composé de 3 sections et un bouton '''composer''' pour l’envoyer. Chaque section est composée de sous-sections et chaque sous-section présente une série de paramètres dans une Datatable<br />
<br />
Les 3 sections sont structurées comme ci-dessous :<br />
<br />
#Paramètres dans le fichier de configuration actuel : Contient les paramètres du fichier de configuration actuel du module de paramétrage. Ils son présentés filtrés par type. On a donc un maximum de 3 sous sections :<br />
##Paramètres du core : commençant avec MAIN_ ou ne contenant pas de caractères soulignés.<br />
##Paramètres de modules non paramétrables : Autres paramètres de la base de données.<br />
##Paramètres de modules paramétrables : Paramètres déclarés par l’instruction '''define'''.<br />
#Paramètres dans les fichiers de configuration de modules paramétrables : Les fichiers de configuration des modules paramétrables sont structurés tout comme le fichier de configurations du module de paramétrage. On a donc pour chaque module paramétrable présent dans l’installation le paramètres :<br />
##Paramètres du core.<br />
##Paramètres de modules non paramétrables.<br />
##Paramètres de modules paramétrables.<br />
#Paramètres dans la base de données : Les paramètres contenus dans la table '''llx_const''' de la base de données de Dolibarr partagés en deux sous-sections :<br />
##Paramètres du core.<br />
##Paramètres de modules non paramétrables.<br />
<br />
Chaque paramètre est représenté sur cinq colonnes :<br />
<br />
#Sélection : Case à cocher pour sélectionner/désélectionner l’élément.<br />
#Module : Pour les paramètres de modules paramétrables ou non paramétrables. Il est vide pour les paramètres du core.<br />
#Paramètre : Nom complet du paramètre.<br />
#Valeur : Valeur du paramètre.<br />
#Note : Contient le commentaire affiché si le commentaire dans le fichier de configuration est vide et que le paramètre n’existe pas dans le fichier de langue<br />
<br />
Chaque groupe de paramètres est représenté dans un élément Jquery Datatable est accompagné d’un bouton pour sélectionner l’ensemble du groupe.<br />
<br />
La différence entre la composition complète et la composition de base réside en ce que dans la première, tous les paramètres présents dans les fichiers de configuration sont présélectionnes alors qu’aucun paramètre n’est sélectionné dans la seconde.<br />
<br />
En appuyant sur le bouton composer, on lance la recréation du fichier de configuration du module de paramétrage avec les paramètres sélectionnés. En case de conflit de paramètre en double un message est affiché indiquant la localisation des conflits et en appliquant le style de surbrillance aux deux paramètres en double et en invitant à désélectionner l’une des deux comme dans l’exemple suivant ( Dans la deuxième image, la page est déroulée pour faire apparaître le deuxième élément ) :<br />
[[File:Capture d’écran de 2020-01-26 13-58-07.png|alt=Conflit de paramètres 1/2|none|thumb|1300x1300px|Conflit de paramètres 1/2]]<br />
[[File:Capture d’écran de 2020-01-26 13-58-14.png|alt=Conflit de paramètres 2/2|none|thumb|1300x1300px|Conflit de paramètres 2/2]]<br />
<br /><br />
<br />
= 8 -Création de sections de paramétrage dans des pages spécifiques de Dolibarr =<br />
La création de sections de paramétrage dans les pages spécifique de Dolibarr fait seulement appel aux paramètres de la base de données, paramètres du core ou de modules non paramétrables. Les paramètres de modules paramétrables existant dans les fichiers de configuration de leurs modules sont conçus pour être utilisés seulement dans les pages de ce dernier. Si on a besoin de faire appel à un paramètre de ce type, on peut toujours le déclarer en tant paramètres base de données à l’intérieur du module paramétrable.<br />
<br />
C’est cette fonction qui a permis de rendre obsolètes les modules Facturepar, Facturepar plus et corepar. Le module Facturepar affichait une section de paramétrage dans la page d’édition de factures clients avec environ 24 paramètres alors que grâce au module de paramétrage, on a 81 paramètres contrôlables dans la cette page et on peut procéder de façon similaires pour toutes les pages de Dolibarr y compris celle de modules externe<br />
<br />
Pour créer une section de paramétrage pour une page spécifique de de Dolibarr, il faut procéder en plusieurs étapes :<br />
<br />
# Composition et sauvegarde dans des fichier d’une ou plusieurs configurations.<br />
# Création manuelle d’un fichier de configuration en combinant les paramètres des fichiers composés.<br />
# Création d’une entrée dans le dictionnaire de correspondance de configuration vers urls du module de paramétrage.<br />
<br />
Pour la page d’édition de factures (ex : Facturepar) on a créé une entrée dans le dictionnaire comme dans l’image suivante :<br />
[[File:Dictionnaire des correspondances config. vers url.png|alt=Dictionnaire des correspondances configurations / urls|none|thumb|1300x1300px|Dictionnaire des correspondances configurations / urls]]<br />
Ce qui donne une section de paramétrage dans la page d’édition de factures comme dans l’image suivante accessible dans le site démo dans le lien <nowiki>http://dolipar.org/dolibarr/htdocs/compta/facture/card.php?facid=245</nowiki> : <br />
[[File:Facturepar.png|alt=Page de l'ex module Facturepar|none|thumb|1300x1300px|Page de l'ex module Facturepar]]<br />
<br /></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=File:Capture_d%E2%80%99%C3%A9cran_de_2020-01-26_13-58-14.png&diff=45678File:Capture d’écran de 2020-01-26 13-58-14.png2020-01-26T16:43:50Z<p>Abahfir: </p>
<hr />
<div>Conflit de paramètres 2/2</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=File:Capture_d%E2%80%99%C3%A9cran_de_2020-01-26_13-58-07.png&diff=45677File:Capture d’écran de 2020-01-26 13-58-07.png2020-01-26T16:42:05Z<p>Abahfir: </p>
<hr />
<div>Conflit de paramètres 1/2</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45676Module Parametrage FR2020-01-26T16:39:28Z<p>Abahfir: </p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> {{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
<br />
=Remarques sur le paramétrage logiciel en général et dans Dolibarr :=<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Description de notre solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=Configuration du module=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=La composition de configurations :=<br />
Ci dessous la page de composition de configuration obtenue en cliquant sur le bouton de composition complète . Les trois images sont obtenues en déroulant la page :<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
<br />
<br />
Nous obtenons un formulaires composé de 3 sections et un bouton '''composer''' pour l’envoyer. Chaque section est composée de sous-sections et chaque sous-section présente une série de paramètres dans une Datatable<br />
<br />
Les 3 sections sont structurées comme ci-dessous :<br />
<br />
# Paramètres dans le fichier de configuration actuel : Contient les paramètres du fichier de configuration actuel du module de paramétrage. Ils son présentés filtrés par type. On a donc un maximum de 3 sous sections :<br />
## Paramètres du core : commençant avec MAIN_ ou ne contenant pas de caractères soulignés.<br />
## Paramètres de modules non paramétrables : Autres paramètres de la base de données.<br />
## Paramètres de modules paramétrables : Paramètres déclarés par l’instruction '''define'''.<br />
# Paramètres dans les fichiers de configuration de modules paramétrables : Les fichiers de configuration des modules paramétrables sont structurés tout comme le fichier de configurations du module de paramétrage. On a donc pour chaque module paramétrable présent dans l’installation le paramètres :<br />
## Paramètres du core.<br />
## Paramètres de modules non paramétrables.<br />
## Paramètres de modules paramétrables.<br />
# Paramètres dans la base de données : Les paramètres contenus dans la table '''llx_const''' de la base de données de Dolibarr partagés en deux sous-sections :<br />
## Paramètres du core.<br />
## Paramètres de modules non paramétrables.<br />
<br />
Chaque paramètre est représenté sur cinq colonnes :<br />
<br />
# Sélection : Case à cocher pour sélectionner/désélectionner l’élément.<br />
# Module : Pour les paramètres de modules paramétrables ou non paramétrables. Il est vide pour les paramètres du core.<br />
# Paramètre : Nom complet du paramètre.<br />
# Valeur : Valeur du paramètre.<br />
# Note : Contient le commentaire affiché si le commentaire dans le fichier de configuration est vide et que le paramètre n’existe pas dans le fichier de langue<br />
<br />
Chaque groupe de paramètres est représenté dans un élément Jquery Datatable est accompagné d’un bouton pour sélectionner l’ensemble du groupe.<br />
<br />
La différence entre la composition complète et la composition de base réside en ce que dans la première, tous les paramètres présents dans les fichiers de configuration sont présélectionnes alors qu’aucun paramètre n’est sélectionné dans la seconde.<br />
<br />
En appuyant sur le bouton composer, on lance la recréation du fichier de configuration du module de paramétrage avec les paramètres sélectionnés. En case de conflit de paramètre en double un message est affiché indiquant la localisation des conflits et en appliquant le style de surbrillance aux deux paramètres en double et en invitant à désélectionner l’une des deux comme dans l’exemple suivant ( Dans la deuxième image, la page est déroulée pour faire apparaître le deuxième élément ) :</div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45675Module Parametrage FR2020-01-26T09:04:47Z<p>Abahfir: /* La composition de configurations : */</p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> {{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
<br />
=Remarques sur le paramétrage logiciel en général et dans Dolibarr :=<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Description de notre solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=Configuration du module=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=La composition de configurations :=<br />
Ci dessous la page de composition de configuration obtenue en cliquant sur le bouton de composition complète . Les trois images sont obtenues en déroulant la page :<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
Nous obtenons les 3 sections suivantes:<br /></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45674Module Parametrage FR2020-01-26T09:01:21Z<p>Abahfir: </p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> {{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
<br />
=Remarques sur le paramétrage logiciel en général et dans Dolibarr :=<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Description de notre solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=Configuration du module=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=La composition de configurations :=<br />
<br />Ci dessous la page de composition de configuration ( composition complète ):<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
<br /></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45673Module Parametrage FR2020-01-26T08:54:25Z<p>Abahfir: </p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> {{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
<br />
= Etude Analytique du paramétrage logiciel dans Dolibarr : =<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Définition d’une solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=Configuration du module=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=La composition de configurations :=<br />
<br />Ci dessous la page de composition de configuration ( composition complète ):<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
<br /></div>Abahfirhttps://wiki.dolibarr.org/index.php?title=Module_Parametrage_FR&diff=45672Module Parametrage FR2020-01-25T21:47:40Z<p>Abahfir: /* La composition de configurations : */</p>
<hr />
<div><!-- BEGIN interlang links --> <!-- Do NOT edit this section<br />
Links below are automatically managed by PolyglotBot<br />
You can edit links on the English source page : Module_Parametrage_EN --> <!-- END interlang links --> {{TemplateDocDevFr}} {{TemplateDocUtil}}<br />
<br />
<seo metak="Ultimatepdf, Dolibarr, models, design, interface, invoice, order, proposal, project" /><br />
=Informations=<br />
{{TemplateModuleInfo<br />
|modulename=Parametrage<br />
|editor=Dolipar.org<br />
|web=http://dolipar.org/content/parametrage<br />
|webbuy=<br />
|status=stable<br />
|prerequisites=<br />
|minversion=10.0.X<br />
|note=<br />
}}<br />
=Prérequis=<br />
Dolibarr 10.0.x<br />
=Résumé=<br />
Le module de paramétrage est le point d'arrivée de tous les modules paramétrables de Dolipar.org que sont les modules Cashdeskpar et Menupar. Les modules Facturepar et Corepar ont disparu au profit de ce module qui permet de créer à la volée toutes leurs fonctionnalités et plus.<br />
=Installation=<br />
<br />
*Téléchargez le fichier archive du module (.zip) depuis le site web www.dolistore.com ou récupérez le par toute autre manière.<br />
*Placez le fichier dans le répertoire racine de dolibarr ou bien créez un dossier custom à la racine de dolibarr pour l'y placer avec tous vos modules supplémentaires ( Si vous choisissez cette solution, pensez à dé-commenter les deux lignes du fichier de conf en rapport)<br />
*Décompressez le fichier par la commande unzip module_parametrage-X.Y.Z.zip<br />
*L'emplacement correct du module doit être du type : htdocs/custom/parametrage.<br />
*Aller dans l'emplacement d'installation du module et donner les privilèges de lecture et d'écriture au seveur PHP pour les fichiers suivants :<br />
<br />
#parametrage_consts.php<br />
#parametrage_default_consts.php<br />
<br />
Le module est opérationnel et peut être activé.<br />
=Configuration=<br />
Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "'''Accueil - Configuration - Modules'''". Le module apparaît dans "Dolipar", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de configuration spécifique à ce module :<br />
<br />
Comme le module de paramétrage est un module système, toutes ses fonctionnalités se retrouvent dans la page de configuration suivante :<br />
[[File:Page de configuration du module.png|alt=Page de configuration du module|none|thumb|1300x1300px|Page de configuration du module]]<br />
La page de configuration se compose de deux parties :<br />
<br />
#La section de configuration et d'utilisation du module, qui comprend :<br />
##Le bouton d'activation du contrôle de modules paramétrables à travers le module de paramétrage : Ce bouton permet de remplacer tous les réglages dans les modules paramétrables par ceux définis dans le module de paramétrages. Actuellement, les deux seuls modules paramétrables existant concernés sont les modules Cashdeskpar et le gestionaire de menu Menupar. D'autres modules vont certainement étoffer cette liste dans le futur proche.<br />
##Les boutons de composition de configurations: Permettent de composer le fichier de configuration du module de paramétrage. La composition complète permet d'auto-sélectionner au départ tous les paramètres de la configuration actuelle alors que la composition de base permet de partir d'une sélection vide ( Voir paragraphe : Composition de configurations)<br />
##Le bouton de sauvegarde de configurations : Permet de sauvegarder la configuration actuelle dans un fichier. Il faut fournir un nom de fichier avant d'appuyer sur le bouton '''enregistrer'''.<br />
##Le bouton de suppression de configurations : Permet de supprimer des fichiers de configuration préalablement enregistrés.<br />
#La section de paramétrage du module de paramétrage : Cette section affiche tous les paramètres du module obtenus à travers la fonction de composition. Le bouton '''RAFRAICHIR LA PAGE''' commun à tous les modules paramétrables, permet de rafraîchir la page sans s'y déplacer pour visualiser immédiatement les effets de modification d'un paramètre<br />
<br />
=Analyse du paramétrage logiciel dans Dolibarr :=<br />
Pour bien comprendre les fonctions du module, il est nécessaire de connaitre quelques notions sur le paramétrage de logiciel en général, puis pourquoi et comment on a implémenté toute une méthodologie de paramétrage dans Dolibarr avec les bénéfices qu'elle apporte.<br />
<br />
====Les types de paramètres du logiciel:====<br />
Par convention dans les solutions logicielles web, on utilise trois types de paramètres :<br />
<br />
1. Les paramètres base de données ( En majorité ) : Ce sont des paramètres stockés dans la base de données dans le but de pouvoir être gérés comme n’importe quel autre type de données. <br />
<br />
2. Les paramètres fichiers : Utilisés pour définir des paramètres qui dépendent de la plateforme ou qui définissent les paramètres d’accès à la base de données et ne peuvent donc pas être stockés en base de données.<br />
<br />
3. Les paramètres utilisateurs : Ce troisième type de paramètres concerne ceux qui sont spécifiques aux utilisateurs. Dans la plupart des applications, ces paramètres sont stockés au niveau du navigateur, dans les cookies ou dans sa base de données locale.<br />
<br />
====Les types de paramètres dans Dolibarr :====<br />
Dans Dolibarr, comme dans la plupart des applications web, les constantes base de données sont utilisées pour configurer les différentes options de l’application qui sont appelées à être modifiées au cours du sa mise en œuvre et sont stockées dans la table « llx_const ».<br />
<br />
En plus de stocker les paramètres d’accès à la base de données, les constantes fichier sont utilisées pour référencer les chemins des différents sous-ensembles de l’application ainsi que le mode de fonctionnement (développement ou production). En un sens, les constantes fichiers concernent les paramètres à qui on affecte des valeurs une seule fois et ne sont pas destinés à être changés dans une installation. <br />
<br />
Pour les paramètres utilisateurs , on utilise dans Dolibarr une table spéciale « llx_user_param » pour enregistrer les données de l’utilisateur. Les cookies sont seulement utilisées pour identifier la session.<br />
<br />
====Le concept de configuration au sens large :====<br />
On désigne comme configuration au sens large, l’ensemble de tous les paramètres d’une application adaptés à une entreprise ou une activité déterminée. Un ERP tel que Dolibarr pourrait par exemple être utilisé par une entreprise de commerce de détail ou par une entreprise de production avec deux configurations complètement différentes. Les deux entreprises peuvent utiliser des modules communs avec des paramètres communs ou de modules, spécifiques au type d’entreprise. <br />
<br />
De la, on peut définir une configuration comme un ensemble de valeurs affectées à des paramètres. On peut utiliser une configuration pour enregistrer l’ensemble de valeurs de paramètres associés à chacun des deux types d’entreprises. Ceci inclut les modules activés, les valeurs de paramètres associés à chacun de ces modules ainsi que des valeurs associées à des paramètres de Dolibarr.<br />
<br />
====Considérations pour le stockage des paramètres de configurations :====<br />
On peut stocker les paramètres qui définissent une configuration dans une table de la base de données ou bien dans un fichier. Bien que traditionnellement on préfère utiliser les constantes base de données pour stocker les paramètres de l’application, on distingue plusieurs avantages pour l’utilisation de fichiers à la place: <br />
<br />
#Un fichier est plus facilement consultable qu’une table de base de données. Il peut même être consulté sans installation de Dolibarr.<br />
#Les modifications dans un fichier peuvent être gérées par un gestionnaire de versions tel que GIT. Dans le cas d’une table, Il faudra créer une table spéciale pour gérer l’historique avec le traitement qui s’ensuit.<br />
#Dans le cas de Dolibarr, il existe encore un troisième avantage, qui est celui de pouvoir définir des métadonnées en commentaires sur les paramètres au lieu d'utiliser les champs limités de la table llx_const. C'est ce qui a permis de définir plusieurs types de données dans les fichiers de configurations de modules paramétrable (Voir ci dessous).<br />
<br />
Il existe toutefois quelques inconvénients mineurs :<br />
<br />
1. Les requêtes SQL sont très utiles pour faire des consultations complexes. Un effort de programmation plus important est nécessaire pour faire des recherches complexes dans des fichiers texte.<br />
<br />
=Définition d’une solution de gestion de configurations dans Dolibarr :=<br />
Dans le cas de Dolibarr, une configuration est un simple fichier php avec des directives '''define''' pour chaque paramètre de module paramétrable et une instruction du type $conf->global->XX=YY pour les paramètres base de données. C’est l’exécution de ce fichier qui définit la configuration choisie. Ces paramètres peuvent être modifiés pour ajuster la configuration. On peut aussi créer de nouvelles configurations par modification de configurations préexistantes. <br />
<br />
Cette solution inclut les modules paramétrables, les modules paramétrables et le module de paramétrage. <br />
<br />
===Les modules paramétrables :===<br />
Les modules paramétrables sont des modules conçus pour interagir efficacement avec le module de paramétrage. Ils se limitent actuellement à '''Cashdeskpar''' et '''Menupar'''. Leurs caractéristiques sont :<br />
<br />
#Tous les paramètres de ces modules sont inscrits sur un fichier de configuration.<br />
#Les paramètres sont consultables et modifiables dans la configuration du module.<br />
#On définit 3 types de paramètres : chaîne,intervalle et booléens.<br />
#Dans la page de configuration du module, on peut définir une ou plusieurs pages qui affichent une section de paramétrage pour changer les valeurs de paramètres à la volée.<br />
#Chaque paramètre peut être configuré pour apparaître ou non dans les sections de paramétrage autres que la page de configuration du module.<br />
<br />
===Les modules non paramétrables :===<br />
Tous les modules sur Dolistore ainsi que les modules inclus dans la distribution standard de Dolibarr font partie de cette catégorie. Leur paramètres de configuration sont enregistrés dans la base de données de Dolibarr dans la table '''llx_const'''. Par convention, le nom du module est inclu dans le nom du paramètre et est composé des premières lettres de ce dernier avant le caractère souligné. <br />
<br />
===Le module de paramétrage :===<br />
Ses tâches essentielles sont :<br />
<br />
#La composition de configurations par chargement de paramètres de la base de données et de fichiers de configuration de modules paramétrables.<br />
#La modification des valeurs des paramètres actuels.<br />
#La sauvegarde et restauration de configurations.<br />
#L’inclusion de sections de paramétrage adaptées à des pages spécifiques.<br />
<br />
Le module gère deux types de paramètres :<br />
<br />
#Les paramètres base de données : Ils sont enregistrés dans la table '''llx_const''' et sont composés de deux sous-types :<br />
##Les paramètres du core : sont tous les paramètres commençant par MAIN_ ou qui ne contiennent pas de caractères soulignés.<br />
##Les paramètres de modules non paramétrables :sont tous les paramètres commençant par un nom de module suivi d'un caractère souligné.<br />
#Les paramètres de modules paramétrables : sont des paramètres enregistrés sous forme de constantes PHP et sont définis dans les fichiers de configuration de modules à l'aide d'instructions '''define'''.<br />
<br />
=Exemple de module paramétrable et de son fichier de configuration :=<br />
L'exemple le plus représentatif de module paramétrable est le module Cashdeskpar dont la démo est disponible sous le lien: http://dolipar.org/dolibarr/htdocs/custom_dolipar/cashdeskpar/affIndex.php?menu=facturation <br />
<br />
Ci dessous une copie d'écran de sa page principale :<br />
[[File:Capture d’écran de 2020-01-25 14-24-10.png|alt=Page principale de Cashdeskpar|none|thumb|1000x1000px|Page principale de Cashdeskpar]]<br />
<br />
<br />
Ci dessous le contenu de son fichier de configuration cashdespar_default_consts.php :<br />
<br />
<br />
''<?php''<br />
<br />
''global $conf;''<br />
<br />
''//param_BD''<br />
<br />
''$conf->global->CHARTOFACCOUNTS='113';//Plan comptable'' <br />
<br />
''//param_CASHDESKPAR--------------''<br />
<br />
''define('CASHDESKPAR_AUTOCOMPLETE',0);//bm//0//1-requiert 2:Formulaire autocomplete pour sélection''<br />
<br />
''define('CASHDESKPAR_DONT_POPUP_TICKET',0);//bm//0//2-inhibe l'ouverture automatique du ticket''<br />
<br />
''define('CASHDESKPAR_DONT_PRINT_TICKET',0);//bm//0//3-inhibe l'impression automatique du ticket''<br />
<br />
''define('CASHDESKPAR_FOCUS_LISTE',0);//bm//0//4-Rend le focus à la liste si ref vide''<br />
<br />
''define('CASHDESKPAR_HIDE_REMISE_PERCENT',0);//bm//0//5-Cacher remise en pourcentage''<br />
<br />
''define('CASHDESKPAR_HIDE_TVA',0);//bm//0//6-cache TVA dans cashdesk''<br />
<br />
''define('CASHDESKPAR_MODIFIABLE_PRICE',0);//bm//0//7-prix modifiable''<br />
<br />
''define('CASHDESKPAR_MODIFY_DELETED',1);//bm//0//8-Modifier une ligne aprés suppression''<br />
<br />
''define('CASHDESKPAR_MONNAIE_CODE',1);//bm//////9-xx''<br />
<br />
''define('CASHDESKPAR_MONNAIE_VIDE',0);//bm//0//10-Ticket sans type de monnaie''<br />
<br />
''define('CASHDESKPAR_PANIER_RAPIDE',0);//bm//0//11-saisie rapide''<br />
<br />
''define('CASHDESKPAR_PAIEMENT_AUTO',0);//bm//0//12-saisie automatique du paiement égal au montant total''<br />
<br />
''define('CASHDESKPAR_PARAMETRES',1);//bm//0//13-Formulaire de parametrage''<br />
<br />
''define('CASHDESKPAR_QTE_ENTER_KEY',1);//bm//0//14-Faire passer au champ suivant à la validation sur le champ Qte''<br />
<br />
''define('CASHDESKPAR_SHOW_LINES',1);//bm//0//15-Voir les lignes facture''<br />
<br />
''define('CASHDESKPAR_SHOW_TEL',1);//bm//0//16-Affiche le nº de telephone dans le ticket''<br />
<br />
''define('CASHDESKPAR_THEME_31',0);//bm//////17-''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE_POPUP',1);//bm//0//18-requiert 4:Montre le ticket en popup''<br />
<br />
''define('CASHDESKPAR_TICKET_RAPIDE',0);//bm//0//19-4:Bouton ticket direct''<br />
<br />
''define('CASHDESKPAR_TICKET_TITRE_BONLIVRAISON',1);//bm//0//20-requiert 3:Titre ticket (Bon de livraison)''<br />
<br />
''define('CASHDESKPAR_CREATION_CHANGEMENT_CLIENTS',0);//bm//0//21-Créer et changer le client''<br />
<br />
''define('CASHDESKPAR_SEARCH_POS',-1);//im-1:10//0//22-Position de début pour recherche totale''<br />
<br />
''define('CASHDESKPAR_MOBILE_LAYOUT',0);//bm//0//23-Adapter le thème à l'écran de téléphone''<br />
<br />
''define('CASHDESKPAR_ANDROID_TICKET',1);//bm//0//24-Le ticket sera stocké dans une image sur laquelle un programme est lancé pour imprimer l'étiquette''<br />
<br />
''define('CASHDESKPAR_ANDROID_JS_TICKET',1);//bm//0//25-Le ticket stocké dans une image sera imprimé dans une webview par Javascript''<br />
<br />
''define('CASHDESKPAR_OPEN_SECTIONS',0);//bm//0//26-Ouvrir les sections au lancement de la page''<br />
<br />
''//param_PRODUCT--------------''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOCOMPLETE_LIMIT_RESULTS_VALUE',22);//im1-100//0//nombre de résultats d'autocomplete''<br />
<br />
''define('CASHDESKPAR_PRODUCT_ZY_AUTOSELECT_LENGTH',2);//im1-10//1//Nombre de caractéres minimum pour recherche''<br />
<br />
''define('CASHDESKPAR_PRODUCT_SELECT_BY_REFS',0);//bm//0//Activer Autoselect sur les références seulement''<br />
<br />
''define('CASHDESKPAR_PRODUCT_FORM_LIST_SORT_KEY',0);//bm//0//xxx''<br />
<br />
<br />
Ce fichier de configuration composé de plusieurs sections. L'analyseur syntaxique de configuration interprète des métadonnées en commentaires pour présenter les paramètres de configuration dans la section de paramétrage :<br />
<br />
#Chaque ligne de définition de paramètre est suivie d'un commentaire servant de métadonnées pour l'analyseur syntaxique.<br />
#Les lignes de commentaires tels que //param_PRODUCT-------------- définissent une sous section pliable sous laquelle sont présentés les paramètres en dessous regroupés sous le terme PRODUCT. Le fichier de langue contient le message contenant le nom de la sous section avec la clé param_PRODUCT.<br />
#La ligne //Param_BD-------------- définit une sous section pliable pour les paramètres de la base de données. Les paramètres qu'elle contient sont de la forme $conf->global->XX='YY';//ZZ. XX étant le nom du paramètre, YY sa valeur et ZZ un commentaire qui si il existe il est affiché en priorité dans la section de paramétrage.<br />
#Les paramètres de modules paramétrables sont déclarés en tant que constantes par une instruction '''define''' avec les premières lettres avant souligné définissent le nom du module.<br />
#Le texte en commentaire après la définition du paramètre de module paramétrable est composé de métadonnées reconnaissables par l’analyseur syntaxique de la fonction de paramétrage. On a dans l’ordre séparés par des ‘//’:<br />
##Le type et statut :<br />
###La première lettre peut prendre les valeurs '''b''' pour booléens, '''i''' pour intervalle et '''s''' pour chaine de caractère.<br />
###La deuxième lettre peut prendre les valeurs '''m''' pour modifiable, '''u''' pour non modifiable et '''h''' pour hidden ou invisible. Les paramètres invisibles dans la page d’utilisation de la fonction de paramétrage restent visibles dans la page de configuration, depuis laquelle on peut activer ou désactiver le statut visible des paramètres (Voir le wiki de Cashdeskpar dans [[Module CashdeskPar FR|https://wiki.dolibarr.org/index.php/Module_CashdeskPar_FR]])<br />
###Les paramètres de type intervalle sont suivis par une indication de la borne inférieure et supérieure séparés par ‘''':'''’.<br />
##La valeur par défaut<br />
##Le commentaire affiché s’il n’existe pas de traduction du paramètre en clé dans le fichier de langues.<br />
<br />
=La composition de configurations :=<br />
<br />Ci dessous la page de composition de configuration ( composition complète ):<br />
[[File:Page de composition complète.png|alt=Page de composition complète 1/3|none|thumb|1300x1300px|Page de composition complète 1/3]]<br />
[[File:Page de composition complète 2-3.png|alt=Page de composition complète 2/3|none|thumb|1300x1300px|Page de composition complète 2/3]]<br />
[[File:Page de composition complète 3-3.png|none|thumb|1300x1300px|Page de composition complète 3/3]]<br />
<br /></div>Abahfir