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 |
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-06-20 |
| Note / Nota | Compatible Dolibarr v24 |
Installation
- Télécharger le module et le déposer dans le répertoire
htdocs/custom/ultimateqrcode/ - Depuis Dolibarr : Accueil → Configuration → Modules/Applications
- Trouver le module UltimateQRcode dans la section Atoo-Net et l'activer
- Les droits sont à configurer par groupe d'utilisateurs (voir Droits et permissions)
Configuration du module
Accéder à la configuration via Accueil → Configuration → Modules/Applications → UltimateQRcode (icône clé) ou directement via le menu d'administration.
La page de configuration comporte trois onglets.
Onglet « QR codes » (générateur libre)
Cet onglet propose un générateur de QR code à la demande :
| Champ | Description |
|---|---|
| Data | Le contenu à encoder : URL, adresse e-mail, texte libre, vCard, etc. |
| ECC | Niveau de correction d'erreur : • L (≈7% — smallest) : taille minimale • M (≈15%) : usage courant • Q (≈25%) : bonne résistance • H (≈30% — best) : très résistant (recommandé avec logo) |
| Size | Taille du point (de 1 à 10 pixels par module QR) |
| Bouton GENERATE | Génère et affiche immédiatement le QR code |
Cliquer sur Comme ceci dans le texte d'aide pour voir un exemple de génération.
Onglet « QR avec logo »
Cet onglet permet de générer un QR code avec un logo inséré au centre :
| Champ | Description |
|---|---|
| Data | URL ou contenu à encoder (par défaut : https://www.atoo-net.com/) |
| Taille | De 1 à 10 — contrôle la résolution de l'image générée |
| Choisir un fichier | Logo PNG à intégrer au centre du QR code |
| Bouton GENERATE | Génère le QR code avec le logo et le sauvegarde |
| Sélectionner un QR code à afficher | Choisir parmi les QR déjà générés pour l'afficher |
| Bouton AFFICHER | Affiche le QR code sélectionné |
| Icône corbeille | Supprime le fichier QR sélectionné (avec confirmation) |
La section Logos téléchargés liste tous les fichiers PNG déposés, avec leur taille et date d'upload. Un bouton de suppression est disponible sur chaque ligne.
- Note : Le niveau ECC conseillé pour un QR avec logo est H (30%), car le logo masque une partie du code — la correction d'erreur compense.
Onglet « À propos »
Affiche les informations sur la version du module, l'auteur et le lien vers la documentation.
Utilisation dans les fiches
Le module ajoute un onglet QR code dans les fiches des objets suivants :
| Object | Added tab(s) |
|---|---|
| Tiers | QR code + QR-Url (onglets séparés) |
| Contact | QR code |
| Produit / Service | QR code |
| Lot / Numéro de série | QR code |
| Entrepôt | QR code |
| Proposal (Quote) | QR code |
| Customer order | QR code |
| Supplier order | QR code |
| Customer invoice | QR code |
| Supplier invoice | QR code |
| Contract | QR code |
| Intervention | QR code |
| Project | QR code |
| Member (foundation) | QR code |
| User group | QR code |
| User | QR code |
Structure commune de l'onglet QR code
[Nouveau v24] Chaque onglet QR code est désormais organisé en cinq zones :
Zone 1 — Barre de réglages
En haut de chaque onglet QR code, une barre de réglages permet de configurer :
| Réglage | Description |
|---|---|
| Taille | Résolution du QR code (de 2 à 10 pixels par module). Plus la valeur est élevée, plus le QR code est grand et lisible. |
| Qualité (ECC) | Niveau de correction d'erreur : Basse (L ≈ 7%), Moyenne (M ≈ 15%), Intermédiaire (Q ≈ 25%), Haute (H ≈ 30%). |
| Logo | Logo PNG intégré au centre du QR code, sélectionnable parmi les logos uploadés. |
- Note : Quand un logo est sélectionné, la qualité ECC est automatiquement forcée à Haute (H) pour garantir la lisibilité malgré le logo. La mention (Forcé en Haute avec un logo) s'affiche à côté du sélecteur.
Ces réglages sont sauvegardés indépendamment par type d'objet (facture, devis, commande, etc.) et s'appliquent aux deux QR codes affichés (données et URL).
Zone 2 — Tableau de sélection du logo
Le tableau liste les logos disponibles dans le répertoire documents/mycompany/logos/ :
| Colonne | Description |
|---|---|
| Radio | Bouton radio pour sélectionner le logo (ou « Aucun logo ») |
| Logo | Nom du fichier PNG avec icône d'aperçu |
| Taille | Taille du fichier en octets |
| Date | Date du dernier upload |
| Aperçu | Icône loupe pour prévisualiser le logo |
| Actions | Icônes renommer et supprimer |
Un formulaire d'upload en bas de page permet d'ajouter de nouveaux logos PNG.
- Sécurité : si le logo est trop grand par rapport à la capacité du QR code, le module bascule automatiquement en mode sans logo pour éviter une erreur. Un message est enregistré dans les logs Dolibarr.
Zone 3 — QR code de données configurables
L'utilisateur choisit les champs à inclure dans le QR code via des cases à cocher :
- La colonne de gauche contient la case à cocher
- La colonne centrale indique le libellé du champ et sa valeur actuelle (grisée si non cochée)
- La colonne de droite affiche le QR code généré (avec ou sans logo selon la sélection)
Les champs disponibles dépendent de l'objet :
| Objet | Champs disponibles |
|---|---|
| Tiers | Société, Adresse, Code postal, Ville, Pays, Téléphone, Email, URL + Champs extra |
| Produit | Réf., Libellé, Description, Prix HT, Prix TTC, Code-barres, Poids, Volume, URL + Champs extra |
| Entrepôt | Libellé, Nom court de l'emplacement, Description, Adresse, Code postal, Ville, Pays, URL + Champs extra |
| Utilisateur | Identifiant, Prénom, Nom, Téléphone, Tél. portable, Email, Adresse, Code postal, Ville, Pays, URL + Champs extra |
| Contact | Civilité, Prénom, Nom, Société, Poste, Téléphone, Mobile, Email, Adresse, etc. |
| Facture | Réf., Réf. client, Société, Email, Téléphone, Date facturation, Date limite règlement, Total HT, Total TTC, Note publique, URL |
| (autres) | Champs spécifiques à chaque objet |
- Note : Les champs extra (attributs complémentaires) définis dans Dolibarr sont automatiquement ajoutés à la liste des champs disponibles.
Le QR code affiché est cliquable : un clic ouvre la fenêtre d'impression d'étiquette.
Zone 4 — QR code URL de la fiche
La partie basse affiche :
- Le libellé URL de la fiche [objet]
- Le lien cliquable vers la fiche Dolibarr
- Un second QR code encodant l'URL directe vers la fiche (également cliquable pour l'impression d'étiquette)
- Les boutons ENREGISTRER et ANNULER
Zone 5 — QR code vCard (Contact, Utilisateur, Tiers, Adhérent)
Les fiches Contact, Utilisateur, Tiers (société) et Adhérent disposent d'un QR code vCard supplémentaire en bas de page.
Scanner ce QR code avec un smartphone permet d'ajouter le contact directement dans le répertoire téléphonique. Le contenu vCard encodé est affiché en clair sous le QR code.
Aperçu dynamique (Live Preview)
[Nouveau v24] Les QR codes se mettent à jour en temps réel lorsque l'utilisateur modifie :
- la taille du QR code
- le niveau de qualité ECC
- le logo sélectionné
- les champs cochés (QR de données)
Aucun rechargement de page n'est nécessaire. L'aperçu utilise une requête AJAX avec un délai de 300 ms pour éviter les appels excessifs. Cette fonctionnalité est disponible sur les 16 pages QR du module.
Sélection automatique des champs par défaut
Au premier affichage (aucune configuration enregistrée), le module sélectionne automatiquement les champs dont la valeur est non vide. Cela garantit un QR code pertinent dès la première ouverture.
Enregistrement de la configuration
Cocher/décocher les champs souhaités puis cliquer sur ENREGISTRER. La sélection est sauvegardée et s'applique à tous les objets du même type (une configuration par type d'objet, globale).
Onglet QR code — Exemples par objet
Facture client
[Nouveau v24]
Exemple de configuration pour une facture client : Réf., Société, Email, Téléphone, Date facturation, Date limite règlement, Total HT et Total TTC cochés. Le logo expert_dolibarr.png est sélectionné et intégré au centre du QR code. La qualité ECC est automatiquement forcée à Haute (H).
Produit
Exemple de configuration pour un produit : Réf. et Libellé cochés, ainsi que les champs extra Ecotax et ControlHistoryLink. Le QR encode ces quatre valeurs concaténées.
Entrepôt
Utile pour l'identification physique des emplacements de stockage. Le champ Nom court de l'emplacement (lieu) permet de préciser la zone de stockage.
Utilisateur
Le QR code utilisateur encode les informations de contact (identifiant, prénom, nom, téléphone, mobile, email, pays...). Pratique pour les badges ou cartes de visite internes.
- Note : L'onglet QR code de l'utilisateur n'est visible que par l'utilisateur lui-même ou par les utilisateurs ayant le droit de lire les fiches utilisateurs.
Onglet QR-Url (Tiers uniquement)
Les fiches Tiers disposent d'un second onglet QR appelé QR-Url, spécialisé dans la génération de QR codes avec logo intégré encodant l'URL de la fiche.
Fonctionnalités :
| Élément | Fonction |
|---|---|
| Taille (1-10) | Résolution du QR code généré |
| Choisir un fichier + TÉLÉCHARGER LE LOGO | Uploader un logo PNG à intégrer au centre |
| Sélectionner un QR code à afficher | Choisir parmi les QR déjà générés pour ce tiers |
| Bouton AFFICHER | Affiche le QR sélectionné |
| Section Logos téléchargés | Liste des logos disponibles avec téléchargement et suppression |
Le QR affiché encode l'URL de la fiche du tiers, avec le logo choisi inséré au centre de l'image.
Impression d'étiquette
Cliquer sur un QR code dans n'importe quel onglet ouvre une fenêtre contextuelle d'impression optimisée pour les étiquettes au format 120 × 57 mm (compatible avec les imprimantes d'étiquettes standard).
L'étiquette contient :
- À gauche : le QR code de données configurables
- Au centre : les informations textuelles clés (référence, libellé, nom, etc. selon l'objet)
- À droite : le QR code URL de la fiche
La fenêtre déclenche automatiquement la boîte de dialogue d'impression du navigateur.
- Note : Pour une impression optimale sur étiquettes adhésives, configurer l'imprimante sur le format 120×57mm et désactiver les marges dans les options d'impression du navigateur.
Droits et permissions
Le module définit deux niveaux de droits, à attribuer par groupe d'utilisateurs dans Configuration → Groupes et utilisateurs :
| Droit | Description | Effet |
|---|---|---|
| Read qrcode outcomes | Lire les QR codes | Permet de voir les onglets QR code et d'afficher les QR générés |
| Create/Modify qrcode outcomes | Créer / Modifier | Permet de cocher/décocher les champs et d'enregistrer la configuration |
- Note : Sans le droit Read, les onglets QR code ne sont pas visibles. Sans le droit Write, l'utilisateur voit les QR codes mais ne peut pas modifier la sélection des champs.
Nouveautés et compatibilité v24
[Nouveau v24] Le module UltimateQRcode version 24 apporte les évolutions suivantes :
Nouvelles fonctionnalités
| Fonctionnalité | Description |
|---|---|
| Réglages par page | Taille, qualité ECC et logo configurables directement sur chaque fiche QR code |
| Logo intégré | Possibilité d'intégrer un logo PNG au centre de chaque QR code, sur toutes les pages |
| Aperçu dynamique | Mise à jour en temps réel des QR codes lors du changement de taille, ECC, logo ou champs cochés (AJAX, sans rechargement) |
| QR code vCard | QR code vCard pour les contacts, utilisateurs, tiers et adhérents permettant l'ajout direct dans le répertoire téléphonique |
| Gestion des logos | Upload, aperçu, renommage et suppression des logos depuis l'interface de chaque fiche |
Compatibilité Dolibarr v24
| Correction | Détail |
|---|---|
| Picto du module | Ajout de l'extension .png dans la propriété $this->picto du descripteur de module, conformément à l'avertissement Dolibarr v23+.
|
| Devise | Remplacement de $conf->currency (déprécié) par getDolCurrency().
|
| Constantes | Remplacement de l'écriture directe $conf->global->XXX = value (dépréciée) par dolibarr_set_const().
|
Corrections de bugs
| Bug | Correction |
|---|---|
| Onglet facture non trouvé | Correction de la casse de la clé d'onglet dans le descripteur de module. |
| Paramètre admin obsolète | Suppression du paramètre « Taille d'affichage des QR codes (en pixels) » devenu inutile avec le réglage de taille directement sur chaque fiche. |
| Débordement logo | Ajout d'un mécanisme try/catch pour gérer le dépassement de capacité quand le logo est trop grand : bascule automatique en mode sans logo. |
Traductions
Ajout des clés de traduction manquantes dans les 5 fichiers de langue (FR, EN, DE, ES, IT) pour les nouvelles fonctionnalités : sélection de qualité ECC, 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 tous les champs cochés ont une valeur vide dans la fiche. Cocher au moins un champ avec une valeur et cliquer sur ENREGISTRER.
- L'étiquette ne s'imprime pas à la bonne taille
- Vérifier que le format papier de l'imprimante est bien configuré en 120×57mm. Désactiver les marges dans les options d'impression du navigateur.
- Les champs extra n'apparaissent pas
- Les attributs complémentaires doivent être définis dans Configuration → Attributs complémentaires pour l'objet concerné.
- Le QR avec logo n'est pas lisible
- Le logo occupe trop de surface. Utiliser un logo plus petit (idéalement carré, moins de 100×100 pixels) ou augmenter le niveau ECC à H pour améliorer la correction d'erreur. Avec le module v24, la qualité ECC est automatiquement forcée à H quand un logo est sélectionné.
- Le QR code s'affiche sans logo alors que j'en ai sélectionné un
- Le logo est probablement trop volumineux par rapport au contenu encodé. Le module bascule automatiquement en mode sans logo pour éviter une erreur. Essayez avec un logo plus petit ou réduisez le nombre de champs cochés.
- Les QR codes ne se mettent pas à jour quand je change les réglages
- L'aperçu dynamique nécessite JavaScript activé dans le navigateur. Vérifiez qu'aucun bloqueur de scripts n'est actif. Les QR codes se mettent à jour automatiquement 300 ms après chaque modification.
- L'onglet QR code n'apparaît pas sur certaines fiches
- Vérifier que le module est bien activé et que l'utilisateur possède le droit Read qrcode outcomes.