Module Ultimateqrcode FR: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
Tag: 2017 source edit
No edit summary
Tag: 2017 source edit
Line 22: Line 22:
}}
}}


=Fonctionnalités=
= Installation =


[[File:UltimateQRcode 01.png|left|thumb|Créer un QR code classique à partir d'un texte]]  
# Télécharger le module et le déposer dans le répertoire <code>htdocs/custom/ultimateqrcode/</code>
# 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|Droits et permissions]])


[[File:UltimateQRcode 02.png|left|thumb|Créer un QR code classique à partir d'un texte]]
----


[[File:UltimateQRcode 03.png|left|thumb|Créer un QR code avec logo de sa société]]
= Configuration du module =


[[File:UltimateQRcode 04.png|left|thumb|Ajout d'un onglet QR code dans le module adhérent]]
Accéder à la configuration via '''Accueil → Configuration → Modules/Applications → UltimateQRcode''' (icône clé) ou directement via le menu d'administration.


[[File:UltimateQRcode 05.png|left|thumb|Ajout d'un onglet QR code dans le module utilisateur]]
La page de configuration comporte trois onglets.


[[File:UltimateQRcode 06.png|left|thumb|Ajout d'un onglet QR code dans le module tiers]]
== Onglet « QR codes » (générateur libre) ==


[[File:UltimateQRcode 07.png|left|thumb|Ajout d'un onglet QR code dans le module contact]]
[[File:Ultimateqrcode-admin-qrcodes-fr.png|center|900px|Générateur de QR code libre]]


[[File:UltimateQRcode 08.png|left|thumb|Ajout d'un onglet QR code dans le module produits/services]]
Cet onglet propose un '''générateur de QR code à la demande''' :


[[File:UltimateQRcode 09.png|left|thumb|Ajout d'un onglet QR code dans le module commandes]]
{| class="wikitable"
! Champ !! Description
|-
| '''Data''' || Le contenu à encoder : URL, adresse e-mail, texte libre, vCard, etc.
|-
| '''ECC''' || Niveau de correction d'erreur :<br/>• '''L''' (≈7% — smallest) : taille minimale<br/>• '''M''' (≈15%) : usage courant<br/>• '''Q''' (≈25%) : bonne résistance<br/>• '''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
|}


=Prérequis=
Cliquer sur '''Comme ceci''' dans le texte d'aide pour voir un exemple de génération.


=Procédure d'installation=
== Onglet « QR avec logo » ==


*Télécharger le fichier archive du module (.zip)
[[File:Ultimateqrcode-admin-qrwithlogo-fr.png|center|900px|Générateur QR avec logo intégré]]
*Placer le fichier dans le répertoire racine de dolibarr
*Décompressez le fichier zip par la commande unzip module_ultimateqrcode-X.0.0.zip
*L'emplacement correct du module doit être du type : htdocs/custom/ultimateqrcode
*Le module est alors disponible et activable


Vous pouvez également utiliser l'outil "Déployer/Installer un module externe" depuis le menu Configuration > Modules/applications (disponible à partir de la version Dolibarr 6).
Cet onglet permet de générer un '''QR code avec un logo inséré au centre''' :


=Configuration=
{| class="wikitable"
! 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 :
 
{| class="wikitable"
! Objet !! Onglet(s) ajouté(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
|-
| Devis (Propal) | 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
|-
| Membre (association) | QR code
|-
| Groupe utilisateur | QR code
|-
| Utilisateur | QR code
|-
| Paiement client | QR code
|-
| Paiement fournisseur | QR code
|-
| Sondage (OpenSurvey) | 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 ===
 
[[File:Ultimateqrcode-thirdparty-qrcode-top-fr.png|center|900px|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 :
 
{| class="wikitable"
! 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
|}
 
{{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.27étiquette|impression d'étiquette]].
 
=== Partie basse — QR code URL de la fiche ===
 
[[File:Ultimateqrcode-thirdparty-qrcode-bottom-fr.png|center|900px|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 ==
 
[[File:Ultimateqrcode-product-qrcode-fr.png|center|900px|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 ==
 
[[File:Ultimateqrcode-stock-qrcode-fr.png|center|900px|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 ==
 
[[File:Ultimateqrcode-user-qrcode-fr.png|center|900px|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.
 
{{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) =
 
[[File:Ultimateqrcode-thirdparty-qrurl-fr.png|center|900px|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 :
 
{| class="wikitable"
! É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 =
 
[[File:Ultimateqrcode-label-print-fr.png|center|700px|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.
 
{{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 =
 
[[File:Ultimateqrcode-permissions-fr.png|center|700px|Droits du module UltimateQRcode]]
 
Le module définit deux niveaux de droits, à attribuer par groupe d'utilisateurs dans '''Configuration → Groupes et utilisateurs''' :
 
{| class="wikitable"
! 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.}}
 
----
 
= 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 =
 
* [[Module_Ultimateqrcode_EN|Module UltimateQRcode — English documentation]]
* [https://www.dolistore.com Dolistore]
* [https://www.atoo-net.com Atoo-Net]
 
[[Category:Module externe]]
[[Category:QR Code]]
[[Category:Atoo-Net]]

Revision as of 18:26, 20 March 2026

Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

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 :

Objet Onglet(s) ajouté(s)
QR code + QR-Url (onglets séparés)
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
QR code
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

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_Ultimateqrcode_FR&oldid=65690"