Module Ultimateqrcode FR

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

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-03-20
Note / Nota

Installation

  1. Télécharger le module et le déposer dans le répertoire htdocs/custom/ultimateqrcode/
  2. Depuis Dolibarr : Accueil → Configuration → Modules/Applications
  3. Trouver le module UltimateQRcode dans la section Atoo-Net et l'activer
  4. 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)

Générateur de QR code 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 »

Générateur QR avec logo intégré

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.

Template:Note

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

Chaque onglet QR code est organisé en deux parties :

Partie haute — QR code de données configurables

Onglet QR code d'un tiers — sélection des champs

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é (couvrant toute la hauteur du tableau)

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.
(autres) Champs spécifiques à chaque objet

Template:Note

Le QR code affiché est cliquable : un clic ouvre la fenêtre d'impression d'étiquette.

Partie basse — QR code URL de la fiche

Onglet QR code — partie basse avec QR URL et boutons Save/Cancel

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

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

Produit

Onglet QR code d'un 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

Onglet QR code d'un 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

Onglet QR code d'un 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.

Template:Note


Onglet QR-Url (Tiers uniquement)

Onglet QR-Url d'un tiers avec logo

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

Fenêtre d'impression d'étiquette 120×57mm

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.

Template:Note


Droits et permissions

Droits du module UltimateQRcode

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

Template:Note


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 ou augmenter le niveau ECC à H pour améliorer la correction d'erreur.
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.

Voir aussi