Module Ultimateqrcode FR
Informations
| Module name | Ultimateqrcode |
| Editor / Editeur | Atoo.Net - https://www.atoo-net.com |
| Download or buy page / Page achat ou téléchargement | External module - www.dolistore.com |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | PHP 8.2 minimum, extension PHP GD
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-09-29 |
| Note / Nota | Compatible Dolibarr v25 et PHP 8.5 |
UltimateQRcode ajoute des QR codes sur les fiches Dolibarr (tiers, contacts, produits, documents commerciaux, projets…). Chaque QR code encode les champs que vous choisissez, peut porter un logo en son centre et s'imprime sur une étiquette de 120 × 57 mm. Les fiches de personnes proposent en plus un QR code vCard à scanner pour ajouter le contact dans un smartphone.
Prérequis
| Élément | Version |
|---|---|
| Dolibarr | 25.0.0 ou supérieure |
| PHP | 8.2 minimum (testé jusqu'à PHP 8.5) |
| Extension PHP | GD (génération des images PNG) |
| Modules Dolibarr | Aucun module obligatoire. Les onglets n'apparaissent que sur les objets dont le module est activé (Factures, Stocks, Projets…) |
Les bibliothèques chillerlan/php-qrcode et michelf/php-markdown sont livrées dans le module : aucune installation Composer n'est nécessaire.
Installation
- Télécharger l'archive
module_ultimateqrcode-25.0.x.zipdepuis le DoliStore - Dans Dolibarr : Accueil → Configuration → Modules/Applications, onglet Déployer/Installer un module externe, envoyer l'archive. À défaut, décompresser l'archive dans
htdocs/custom/: on doit obtenirhtdocs/custom/ultimateqrcode/ - Trouver le module UltimateQRcode dans la liste et l'activer
- Attribuer les droits aux utilisateurs ou aux groupes (voir Droits et permissions)
- Mise à jour depuis une version antérieure : remplacer le dossier
ultimateqrcode, puis désactiver et réactiver le module pour que Dolibarr recharge les onglets et les droits.
Configuration du module
Accéder à la configuration via Accueil → Configuration → Modules/Applications → UltimateQRcode (icône engrenage).
La page de configuration comporte quatre onglets : QR codes, QR avec logo, Guide utilisateur et À propos.
Onglet « QR codes » (générateur libre)
Cet onglet est un générateur de QR code à la demande : le QR code créé ici n'est rattaché à aucune fiche Dolibarr et peut encoder n'importe quel contenu.
| Champ | Description |
|---|---|
| Saisissez ici les données à afficher dans le QR code | Le contenu à encoder : URL, adresse e-mail, numéro de téléphone, texte libre… |
| Qualité | Niveau de correction d'erreur : • Basse (L, ≈ 7 %) : QR code le plus compact • Moyenne (M, ≈ 15 %) : usage courant • Intermédiaire (Q, ≈ 25 %) : bonne résistance • Haute (H, ≈ 30 %) : très résistant aux salissures et aux rayures |
| Taille | De 1 à 10 pixels par module du QR code |
| Bouton GÉNÉRER | Génère et affiche le QR code |
| Bouton IMPRIMER L'ÉTIQUETTE | Ouvre le QR code sur une étiquette de 120 × 57 mm (voir Impression d'étiquette) |
Onglet « QR avec logo »
Cet onglet crée un QR code libre portant un logo en son centre. Les QR codes générés sont conservés dans le dossier temporaire du module et peuvent être réaffichés, imprimés ou supprimés.
| Élément | Description |
|---|---|
| Saisissez ici les données à afficher dans le QR code | URL ou contenu à encoder |
| Taille | De 2 à 10, contrôle la résolution de l'image |
| Tableau des logos | Logos disponibles dans documents/mycompany/logos/, avec taille, date, aperçu (loupe), renommage et suppression. Le bouton radio choisit le logo à intégrer
|
| Bouton GÉNÉRER | Crée le QR code avec le logo choisi |
| ENVOYER FICHIER | Ajoute un nouveau logo (PNG conseillé) |
| Sélectionnez un QR code à afficher + AFFICHER | Réaffiche un QR code déjà généré |
| Icône corbeille | Supprime le QR code sélectionné, après confirmation |
| Bouton IMPRIMER L'ÉTIQUETTE | Imprime le QR code affiché sur une étiquette de 120 × 57 mm |
- Note : la correction d'erreur est forcée en qualité Haute, car le logo masque une partie de la matrice.
Onglet « Guide utilisateur »
Le guide utilisateur complet est consultable directement dans Dolibarr, dans la langue de l'utilisateur (français, anglais, allemand, espagnol ou italien).
Onglet « À propos »
Affiche la version du module, l'auteur, la licence et les liens vers la documentation.
Utilisation dans les fiches
Le module ajoute un onglet QR code sur les fiches des 16 objets suivants :
| Objet | Onglet ajouté | QR code vCard |
|---|---|---|
| Tiers | QR code | Oui |
| Contact / Adresse | QR code | Oui |
| Utilisateur | QR code | Oui |
| Adhérent | QR code | Oui |
| Groupe d'utilisateurs | QR code | |
| Produit / Service | QR code | |
| Lot / Numéro de série | QR code | |
| Entrepôt | QR code | |
| Proposition commerciale | QR code | |
| Commande client | QR code | |
| Commande fournisseur | QR code | |
| Facture client | QR code | |
| Facture fournisseur | QR code | |
| Contrat | QR code | |
| Intervention | QR code | |
| Projet | QR code |
Structure commune de l'onglet QR code
Chaque onglet QR code est organisé en cinq zones.
Zone 1 — Barre de réglages
En haut de l'onglet, une barre de réglages permet de choisir :
| Réglage | Description |
|---|---|
| Taille | Résolution du QR code, de 2 à 10 pixels par module |
| Qualité | Correction d'erreur : Basse (L), Moyenne (M), Intermédiaire (Q) ou Haute (H) |
| Logo | Logo à intégrer au centre du QR code, choisi dans le tableau de la zone 2 |
- Note : dès qu'un logo est sélectionné, la qualité est forcée en Haute (H) et la mention (Forcé en Haute avec un logo) s'affiche à côté du sélecteur.
Ces réglages sont enregistrés par type d'objet (factures, propositions, commandes…) et s'appliquent à tous les QR codes de l'onglet.
Zone 2 — Tableau de sélection du logo
Le tableau liste les logos du dossier documents/mycompany/logos/ :
| Colonne | Description |
|---|---|
| Bouton radio | Sélectionne le logo, ou « Aucun logo » |
| Logo | Nom du fichier |
| Taille | Taille du fichier en octets |
| Date | Date d'envoi du fichier |
| Aperçu | Loupe pour afficher le logo |
| Actions | Renommer et supprimer |
Un formulaire en bas de page permet d'envoyer de nouveaux logos.
- Sécurité : si le logo est trop grand par rapport à la capacité du QR code, le module génère le QR code sans logo au lieu de provoquer une erreur, et consigne l'incident dans le journal Dolibarr.
Zone 3 — QR code des données
Vous choisissez les champs à encoder en les cochant :
- la case à cocher inclut ou exclut le champ ;
- la colonne centrale affiche le libellé et la valeur actuelle du champ (grisée s'il n'est pas coché) ;
- le QR code généré s'affiche à côté du tableau, avec ou sans logo, accompagné du bouton IMPRIMER L'ÉTIQUETTE.
Champs proposés selon l'objet :
| Objet | Champs disponibles |
|---|---|
| Tiers | Société, Adresse, Code postal, Ville, Pays, Téléphone, Email, URL |
| Contact | Prénom, Nom, Téléphone, Tél. portable, Email, Adresse, Code postal, Ville, Pays, URL |
| Utilisateur | Identifiant, Prénom, Nom, Téléphone, Tél. portable, Email, Adresse, Code postal, Ville, Pays, URL |
| Adhérent | Prénom, Nom, Téléphone, Tél. perso, Email, Adresse, Code postal, Ville, Pays, URL |
| Groupe d'utilisateurs | Nom du groupe, Description, URL |
| Produit / Service | Réf., Libellé, Description, Prix HT, Prix TTC, Code-barres, Poids, Volume, URL |
| Lot / Numéro de série | Lot/Série, Date limite de consommation, Date limite de vente, URL |
| Entrepôt | Libellé, Nom court de l'emplacement, Description, Adresse, Code postal, Ville, Pays, URL |
| Proposition commerciale | Réf., Réf. client, Société, Email, Téléphone, Date, Date de fin de validité, Total HT, Total TTC, Note publique, URL |
| Commande client | Réf., Réf. client, Société, Email, Téléphone, Date, Total HT, Total TTC, Note publique, URL |
| Commande fournisseur | Réf., Réf. fournisseur, Société, Email, Téléphone, Date, Total HT, Total TTC, Note publique, URL |
| Facture client | Réf., Réf. client, Société, Email, Téléphone, Date facturation, Date limite règlement, Total HT, Total TTC, Note publique, URL |
| Facture fournisseur | Réf., Réf. fournisseur, Société, Email, Téléphone, Date facturation, Date limite règlement, Total HT, Total TTC, Note publique, URL |
| Contrat | Réf., Réf. client, Réf. fournisseur, Société, Email, Téléphone, Date du contrat, Note publique, URL |
| Intervention | Réf., Société, Email, Téléphone, Date, Description, URL |
| Projet | Réf., Libellé du projet, Société, Email, Téléphone, Date de début, Date de fin, Note publique, URL |
- Note : les attributs supplémentaires (extrafields) renseignés sur la fiche sont ajoutés automatiquement à la liste, sous la forme Champ supplémentaire : libellé. Ceux créés par d'autres modules sont ignorés.
Zone 4 — QR code de l'URL de la fiche
À droite (ou sous le tableau selon la largeur de l'écran), l'onglet affiche :
- le libellé URL de la fiche suivi d'un lien vers la fiche ;
- un second QR code encodant l'URL directe de la fiche, lui aussi imprimable sur étiquette ;
- en bas de page, les boutons ENREGISTRER et ANNULER.
Zone 5 — QR code vCard (Tiers, Contact, Utilisateur, Adhérent)
Les fiches Tiers, Contact, Utilisateur et Adhérent affichent en plus un QR code vCard. Scanné avec un smartphone, il propose d'ajouter directement le contact au répertoire. Le contenu vCard 3.0 encodé est affiché en clair à côté du QR code.
Aperçu dynamique
Les QR codes se mettent à jour en temps réel quand vous changez :
- la taille ;
- la qualité ;
- le logo ;
- les champs cochés.
Aucun rechargement de page n'est nécessaire. L'aperçu passe par une requête AJAX déclenchée 300 ms après la dernière modification. Il fonctionne sur les 16 onglets QR code.
Sélection automatique des champs par défaut
Au premier affichage, tant qu'aucune configuration n'a été enregistrée, le module coche automatiquement les champs renseignés sur la fiche. Le QR code est ainsi pertinent dès la première ouverture.
Enregistrement de la configuration
Cochez ou décochez les champs, puis cliquez sur ENREGISTRER. La sélection s'applique à tous les objets du même type (une configuration par type d'objet).
Onglet QR code — Exemples par objet
Facture client
Exemple sur une facture client : Réf., Société, Email, Téléphone, Date facturation, Date limite règlement, Total HT, Total TTC et URL sont cochés. Le logo expert_dolibarr.png est intégré au centre des deux QR codes et la qualité est forcée en Haute (H).
Produit
Sur un produit, le QR code peut encoder la référence, le libellé, les prix, le code-barres, le poids et le volume : pratique pour l'étiquetage en rayon ou en réserve.
Entrepôt
Utile pour identifier physiquement les emplacements de stockage. Le champ Nom court de l'emplacement précise la zone (allée, rack…).
Utilisateur
Le QR code utilisateur encode les coordonnées professionnelles (identifiant, prénom, nom, téléphones, email, adresse…), et le QR code vCard permet de les ajouter à un répertoire. Pratique pour les badges ou les cartes de visite internes.
- Note : l'onglet QR code d'un utilisateur n'est visible que par l'utilisateur lui-même ou par ceux qui ont le droit de lire les fiches utilisateurs.
Image de QR code réutilisable (QR avec logo)
Pour obtenir une image de QR code avec logo à réutiliser ailleurs (site web, plaquette, signature d'e-mail), utilisez l'onglet d'administration QR avec logo :
- saisissez l'URL de la fiche ou tout autre contenu dans la zone de saisie ;
- choisissez la taille et le logo, puis cliquez sur GÉNÉRER ;
- réaffichez le QR code à tout moment avec Sélectionnez un QR code à afficher, imprimez-le ou supprimez-le.
- Note : l'ancien onglet « QR-Url » des tiers, qui n'était plus déclaré par le module, a été retiré. Le QR code de l'URL de la fiche reste disponible dans la zone 4 de chaque onglet QR code.
Impression d'étiquette
Le bouton IMPRIMER L'ÉTIQUETTE, ou un clic sur un QR code, ouvre une fenêtre d'impression au format 120 × 57 mm, adapté aux imprimantes d'étiquettes courantes.
L'étiquette d'une fiche contient :
- à gauche : le QR code des données ;
- au centre : les informations clés de la fiche (référence, tiers, total…, selon l'objet) ;
- à droite : le QR code de l'URL de la fiche.
Les générateurs des onglets QR codes et QR avec logo impriment de la même façon le QR code qu'ils viennent de créer.
La fenêtre ouvre automatiquement la boîte de dialogue d'impression du navigateur.
- Note : pour une impression optimale sur étiquettes adhésives, réglez l'imprimante sur le format 120 × 57 mm et supprimez les marges dans les options d'impression du navigateur.
Droits et permissions
Le module définit deux droits, à attribuer par utilisateur ou par groupe dans Utilisateurs & Groupes :
| Droit | Effet |
|---|---|
| Lire les QR codes | Affiche les onglets QR code et les QR codes générés |
| Créer / Modifier les QR codes | Permet de cocher ou décocher les champs et d'enregistrer la configuration |
- Note : sans le droit de lecture, les onglets QR code ne sont pas visibles. Sans le droit de modification, l'utilisateur voit les QR codes mais ne peut pas changer la sélection des champs. L'envoi, le renommage et la suppression des logos sont réservés aux administrateurs.
Nouveautés et compatibilité v25
La version 25.0.0 aligne UltimateQRcode sur Dolibarr 25.
| Évolution | Détail |
|---|---|
| Versions minimales | Dolibarr 25.0.0 et PHP 8.2 |
| PHP 8.4 et 8.5 | Aucune dépréciation émise par le module : propriétés du descripteur alignées sur le core, page « À propos » sans avertissement |
| Onglets de paiement | Les onglets « QR code » des paiements clients et fournisseurs, qui pointaient vers des pages inexistantes (erreur 404), ont été retirés |
| Onglet QR-Url | La page orpheline de l'ancien onglet QR-Url des tiers a été supprimée ; la documentation renvoie vers l'onglet QR avec logo |
| Droits traduits | Les deux droits s'affichent désormais dans la langue de l'utilisateur (« Lire les QR codes », « Créer / Modifier les QR codes ») |
| Affichage vCard | Le contenu vCard et les adresses sur plusieurs lignes s'affichent correctement, sans « \n » visible ni débordement de la page |
| Attributs supplémentaires | Le libellé « Champ supplémentaire » est traduit (il s'affichait « ExtraField ») |
| Guide utilisateur | Nouvel onglet d'administration affichant le guide complet dans les 5 langues |
| Intégration continue | Chaque fichier PHP du module est vérifié par php -l sous PHP 8.4 et 8.5
|
Historique v24
Nouvelles fonctionnalités v24
| Fonctionnalité | Description |
|---|---|
| Réglages par fiche | Taille, qualité et logo configurables directement dans chaque onglet QR code |
| Logo intégré | Logo PNG au centre de chaque QR code, sur toutes les pages |
| Aperçu dynamique | Mise à jour des QR codes en temps réel lors du changement de taille, de qualité, de logo ou de champs cochés |
| QR code vCard | Pour les tiers, contacts, utilisateurs et adhérents |
| Gestion des logos | Envoi, aperçu, renommage et suppression des logos depuis chaque fiche |
Compatibilité Dolibarr v24
| Correction | Détail |
|---|---|
| Picto du module | Ajout de l'extension .png dans la propriété $this->picto du descripteur
|
| Devise | getDolCurrency() au lieu de $conf->currency (déprécié)
|
| Constantes | dolibarr_set_const() au lieu de l'écriture directe dans $conf->global
|
Corrections de bugs v24
| Bug | Correction |
|---|---|
| Onglet facture introuvable | Casse de la clé d'onglet corrigée dans le descripteur |
| Paramètre d'administration obsolète | Suppression de « Taille d'affichage des QR codes (en pixels) », remplacé par le réglage de taille de chaque fiche |
| Logo trop grand | Bascule automatique en mode sans logo au lieu d'une erreur |
Traductions v24
Clés de traduction manquantes ajoutées dans les 5 langues (FR, EN, DE, ES, IT) : qualité, gestion du logo et tous les types d'objets.
FAQ
- Le QR code est vide ou affiche « Aucune donnée »
- Aucun champ n'est coché, ou les champs cochés sont vides sur la fiche. Cochez au moins un champ renseigné et cliquez sur ENREGISTRER.
- L'étiquette ne s'imprime pas à la bonne taille
- Vérifiez que le format de papier de l'imprimante est réglé sur 120 × 57 mm et supprimez les marges dans les options d'impression du navigateur.
- Les attributs supplémentaires n'apparaissent pas
- Seuls les attributs renseignés sur la fiche sont proposés. Ils se définissent dans la configuration du module concerné (par exemple Tiers → Attributs supplémentaires).
- Le QR code avec logo n'est pas lisible
- Le logo occupe trop de surface. Utilisez un logo plus petit, idéalement carré. La qualité est déjà forcée en Haute (H) dès qu'un logo est sélectionné.
- Le QR code s'affiche sans logo alors que j'en ai sélectionné un
- Le logo est trop volumineux par rapport au contenu encodé : le module génère alors le QR code sans logo. Essayez un logo plus petit ou cochez moins de champs.
- Les QR codes ne se mettent pas à jour quand je change les réglages
- L'aperçu dynamique nécessite JavaScript. Vérifiez qu'aucun bloqueur de scripts n'est actif.
- L'onglet QR code n'apparaît pas sur certaines fiches
- Vérifiez que le module est activé, que le module Dolibarr de l'objet l'est aussi, et que l'utilisateur possède le droit Lire les QR codes. Après une mise à jour, désactivez puis réactivez UltimateQRcode.
- Où est passé l'onglet QR-Url des tiers ?
- Il a été retiré. Le QR code de l'URL de la fiche figure dans l'onglet QR code (zone 4), et l'onglet d'administration QR avec logo crée des images réutilisables.