Module Ultimateqrcode FR: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
No edit summary
Tag: 2017 source edit
No edit summary
Tag: 2017 source edit
 
(3 intermediate revisions by the same user not shown)
Line 4: Line 4:
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
[[en:Module_Ultimateqrcode_EN]]
[[en:Module_Ultimateqrcode_EN]]
[[de:Module_Ultimateqrcode_DE]]
[[es:Module_Ultimateqrcode_ES]]
[[it:Module_Ultimateqrcode_IT]]
<!-- END interlang links -->
<!-- END interlang links -->


Line 17: Line 20:
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=PHP 8.2 minimum, extension PHP GD
|minversion=17.0.0
|minversion=25.0.0
|note=
|note=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 =
{| class="wikitable"
! É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 =
= Installation =


# Télécharger le module et le déposer dans le répertoire <code>htdocs/custom/ultimateqrcode/</code>
# Télécharger l'archive <code>module_ultimateqrcode-25.0.x.zip</code> depuis le [https://www.dolistore.com DoliStore]
# Depuis Dolibarr : '''Accueil → Configuration → Modules/Applications'''
# Dans Dolibarr : '''Accueil → Configuration → Modules/Applications''', onglet '''Déployer/Installer un module externe''', envoyer l'archive. À défaut, décompresser l'archive dans <code>htdocs/custom/</code> : on doit obtenir <code>htdocs/custom/ultimateqrcode/</code>
# Trouver le module '''UltimateQRcode''' dans la section ''Atoo-Net'' et l'activer
# Trouver le module '''UltimateQRcode''' dans la liste et l'activer
# Les droits sont à configurer par groupe d'utilisateurs (voir [[#Droits_et_permissions|Droits et permissions]])
# Attribuer les droits aux utilisateurs ou aux groupes (voir [[#Droits et permissions|Droits et permissions]])
 
: '''Mise à jour depuis une version antérieure :''' remplacer le dossier <code>ultimateqrcode</code>, puis '''désactiver et réactiver''' le module pour que Dolibarr recharge les onglets et les droits.


----
----
Line 33: Line 60:
= Configuration du module =
= Configuration du module =


Accéder à la configuration via '''Accueil → Configuration → Modules/Applications → UltimateQRcode''' (icône clé) ou directement via le menu d'administration.
Accéder à la configuration via '''Accueil → Configuration → Modules/Applications → UltimateQRcode''' (icône engrenage).


La page de configuration comporte trois onglets.
La page de configuration comporte quatre onglets : '''QR codes''', '''QR avec logo''', '''Guide utilisateur''' et '''À propos'''.


== Onglet « QR codes » (générateur libre) ==
== Onglet « QR codes » (générateur libre) ==


[[File:Ultimateqrcode-admin-qrcodes-fr.png|center|900px|Générateur de QR code libre]]
[[File:Ultimateqrcode-v25-admin-qrcodes-fr.png|center|900px|Générateur de QR code libre]]


Cet onglet propose un '''générateur de QR code à la demande''' :
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.


{| class="wikitable"
{| class="wikitable"
! Champ !! Description
! Champ !! Description
|-
|-
| '''Data''' || Le contenu à encoder : URL, adresse e-mail, texte libre, vCard, etc.
| '''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…
|-
|-
| '''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)
| '''Qualité''' || Niveau de correction d'erreur :<br/>• '''Basse''' (L, ≈ 7 %) : QR code le plus compact<br/>• '''Moyenne''' (M, ≈ 15 %) : usage courant<br/>• '''Intermédiaire''' (Q, ≈ 25 %) : bonne résistance<br/>• '''Haute''' (H, ≈ 30 %) : très résistant aux salissures et aux rayures
|-
|-
| '''Size''' || Taille du point (de 1 à 10 pixels par module QR)
| '''Taille''' || De 1 à 10 pixels par module du QR code
|-
|-
| Bouton '''GENERATE''' || Génère et affiche immédiatement le 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|Impression d'étiquette]])
|}
|}
Cliquer sur '''Comme ceci''' dans le texte d'aide pour voir un exemple de génération.


== Onglet « QR avec logo » ==
== Onglet « QR avec logo » ==


[[File:Ultimateqrcode-admin-qrwithlogo-fr.png|center|900px|Générateur QR avec logo intégré]]
[[File:Ultimateqrcode-v25-admin-qrwithlogo-fr.png|center|900px|Générateur de QR code avec logo]]


Cet onglet permet de générer un '''QR code avec un logo inséré au centre''' :
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.


{| class="wikitable"
{| class="wikitable"
! Champ !! Description
! Élément !! Description
|-
| '''Saisissez ici les données à afficher dans le QR code''' || URL ou contenu à encoder
|-
|-
| '''Data''' || URL ou contenu à encoder (par défaut : https://www.atoo-net.com/)
| '''Taille''' || De 2 à 10, contrôle la résolution de l'image
|-
|-
| '''Taille''' || De 1 à 10 — contrôle la résolution de l'image générée
| '''Tableau des logos''' || Logos disponibles dans <code>documents/mycompany/logos/</code>, avec taille, date, aperçu (loupe), renommage et suppression. Le bouton radio choisit le logo à intégrer
|-
|-
| '''Choisir un fichier''' || Logo PNG à intégrer au centre du QR code
| Bouton '''GÉNÉRER''' || Crée le QR code avec le logo choisi
|-
|-
| Bouton '''GENERATE''' || Génère le QR code avec le logo et le sauvegarde
| '''ENVOYER FICHIER''' || Ajoute un nouveau logo (PNG conseillé)
|-
|-
| '''Sélectionner un QR code à afficher''' || Choisir parmi les QR déjà générés pour l'afficher
| '''Sélectionnez un QR code à afficher''' + '''AFFICHER''' || Réaffiche un QR code déjà généré
|-
|-
| Bouton '''AFFICHER''' || Affiche le QR code sélectionné
| Icône '''corbeille''' || Supprime le QR code sélectionné, après confirmation
|-
|-
| Icône '''corbeille''' || Supprime le fichier QR sélectionné (avec confirmation)
| Bouton '''IMPRIMER L'ÉTIQUETTE''' || Imprime le QR code affiché sur une étiquette de 120 × 57 mm
|}
|}


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 :''' la correction d'erreur est '''forcée en qualité Haute''', car le logo masque une partie de la matrice.


{{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 « Guide utilisateur » ==
 
[[File:Ultimateqrcode-v25-admin-guide-fr.png|center|900px|Guide utilisateur intégré]]
 
Le guide utilisateur complet est consultable directement dans Dolibarr, dans la langue de l'utilisateur (français, anglais, allemand, espagnol ou italien).


== Onglet « À propos » ==
== Onglet « À propos » ==


Affiche les informations sur la version du module, l'auteur et le lien vers la documentation.
Affiche la version du module, l'auteur, la licence et les liens vers la documentation.


----
----
Line 93: Line 126:
= Utilisation dans les fiches =
= Utilisation dans les fiches =


Le module ajoute un onglet '''QR code''' dans les fiches des objets suivants :
Le module ajoute un onglet '''QR code''' sur les fiches des 16 objets suivants :


{| class="wikitable"
{| class="wikitable"
!Object!!Added tab(s)
! Objet !! Onglet ajouté !! QR code vCard
|-
|-
|Tiers ||QR code + QR-Url (onglets séparés)
| Tiers || QR code || Oui
|-
|-
|Contact||QR code
| Contact / Adresse || QR code || Oui
|-
|-
|Produit / Service||QR code
| Utilisateur || QR code || Oui
|-
|-
|Lot / Numéro de série||QR code
| Adhérent || QR code || Oui
|-
|-
|Entrepôt||QR code
| Groupe d'utilisateurs || QR code ||
|-
|-
|Proposal (Quote)||QR code
| Produit / Service || QR code ||
|-
|-
|Customer order||QR code
| Lot / Numéro de série || QR code ||
|-
|-
|Supplier order||QR code
| Entrepôt || QR code ||
|-
|-
|Customer invoice||QR code
| Proposition commerciale || QR code ||
|-
|-
|Supplier invoice||QR code
| Commande client || QR code ||
|-
|-
|Contract||QR code
| Commande fournisseur || QR code ||
|-
|-
|Intervention||QR code
| Facture client || QR code ||
|-
|-
|Project||QR code
| Facture fournisseur || QR code ||
|-
|-
|Member (foundation)||QR code
| Contrat || QR code ||
|-
|-
|User group||QR code
| Intervention || QR code ||
|-
|-
|User||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 :
 
{| class="wikitable"
! 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 <code>documents/mycompany/logos/</code> :
{| class="wikitable"
! 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
|}
|}


== Structure commune de l'onglet QR code ==
Un formulaire en bas de page permet d'envoyer de nouveaux logos.


Chaque onglet QR code est organisé en '''deux parties''' :
: '''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.


=== Partie haute — QR code de données configurables ===
=== Zone 3 — QR code des données ===


[[File:Ultimateqrcode-thirdparty-qrcode-top-fr.png|center|900px|Onglet QR code d'un tiers — sélection des champs]]
[[File:Ultimateqrcode-v25-thirdparty-qrcode-fr.png|center|900px|Onglet QR code d'un tiers : champs, QR code des données, QR code de l'URL et QR code vCard]]


L'utilisateur choisit les '''champs à inclure dans le QR code''' via des cases à cocher :
Vous choisissez les '''champs à encoder''' en les cochant :


* La colonne de gauche contient la case à cocher
* la case à cocher inclut ou exclut le champ ;
* La colonne centrale indique le libellé du champ et sa valeur actuelle (grisée si non cochée)
* la colonne centrale affiche le libellé et la valeur actuelle du champ (grisée s'il n'est pas coché) ;
* La colonne de droite affiche le '''QR code généré''' (couvrant toute la hauteur du tableau)
* le QR code généré s'affiche à côté du tableau, avec ou sans logo, accompagné du bouton '''IMPRIMER L'ÉTIQUETTE'''.


Les champs disponibles dépendent de l'objet :
Champs proposés selon l'objet :


{| class="wikitable"
{| class="wikitable"
! Objet !! Champs disponibles
! Objet !! Champs disponibles
|-
|-
| Tiers || Société, Adresse, Code postal, Ville, Pays, Téléphone, Email, URL + Champs extra
| 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
|-
|-
| Produit || Réf., Libellé, Description, Prix HT, Prix TTC, Code-barres, Poids, Volume, URL + Champs extra
| Commande client || Réf., Réf. client, Société, Email, Téléphone, Date, Total HT, Total TTC, Note publique, URL
|-
|-
| Entrepôt || Libellé, Nom court de l'emplacement, Description, Adresse, Code postal, Ville, Pays, URL + Champs extra
| Commande fournisseur || Réf., Réf. fournisseur, Société, Email, Téléphone, Date, Total HT, Total TTC, Note publique, URL
|-
|-
| Utilisateur || Identifiant, Prénom, Nom, Téléphone, Tél. portable, Email, Adresse, Code postal, Ville, Pays, URL + Champs extra
| 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
|-
|-
| Contact || Civilité, Prénom, Nom, Société, Poste, Téléphone, Mobile, Email, Adresse, etc.
| 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
|-
|-
| (autres) || Champs spécifiques à chaque objet
| 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 '''champs extra''' (attributs complémentaires) définis dans Dolibarr sont automatiquement ajoutés à la liste des champs disponibles.}}
: '''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.


Le QR code affiché est '''cliquable''' : un clic ouvre la fenêtre d'[[#Impression_d.27étiquette|impression d'étiquette]].
=== Zone 4 — QR code de l'URL de la fiche ===


=== Partie basse — QR code URL de la fiche ===
À droite (ou sous le tableau selon la largeur de l'écran), l'onglet affiche :


[[File:Ultimateqrcode-thirdparty-qrcode-bottom-fr.png|center|900px|Onglet QR code — partie basse avec QR URL et boutons Save/Cancel]]
* 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'''.


La partie basse affiche :
=== Zone 5 — QR code vCard (Tiers, Contact, Utilisateur, Adhérent) ===


* Le libellé '''URL de la fiche [objet]'''
[[File:Ultimateqrcode-v25-contact-vcard-fr.png|center|900px|QR code vCard sur une fiche contact]]
* 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 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.
* Les boutons '''ENREGISTRER''' et '''ANNULER'''
 
=== 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 ===
=== 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.
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 ===
=== 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).
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 =
= Onglet QR code — Exemples par objet =
== Facture client ==
[[File:Ultimateqrcode-v25-invoice-qrcode-fr.png|center|900px|Onglet QR code d'une facture avec logo intégré]]
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 ==
== Produit ==


[[File:Ultimateqrcode-product-qrcode-fr.png|center|900px|Onglet QR code d'un produit]]
[[File:Ultimateqrcode-v25-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.
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 ==
== Entrepôt ==


[[File:Ultimateqrcode-stock-qrcode-fr.png|center|900px|Onglet QR code d'un entrepôt]]
[[File:Ultimateqrcode-v25-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.
Utile pour identifier physiquement les emplacements de stockage. Le champ '''Nom court de l'emplacement''' précise la zone (allée, rack…).


== Utilisateur ==
== Utilisateur ==


[[File:Ultimateqrcode-user-qrcode-fr.png|center|900px|Onglet QR code d'un 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''' :


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.
# 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'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.}}
: '''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.


----
----


= Onglet QR-Url (Tiers uniquement) =
= Impression d'étiquette =
 
[[File:Ultimateqrcode-v25-label-print-fr.png|center|466px|Étiquette de 120 × 57 mm]]
 
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.


[[File:Ultimateqrcode-thirdparty-qrurl-fr.png|center|900px|Onglet QR-Url d'un tiers avec logo]]
: '''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.


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 :
= Droits et permissions =
 
[[File:Ultimateqrcode-v25-permissions-fr.png|center|900px|Droits du module UltimateQRcode]]
 
Le module définit deux droits, à attribuer par utilisateur ou par groupe dans '''Utilisateurs & Groupes''' :


{| class="wikitable"
{| class="wikitable"
! Élément !! Fonction
! Droit !! Effet
|-
| '''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é
| '''Lire les QR codes''' || Affiche les onglets QR code et les QR codes générés
|-
|-
| Section '''Logos téléchargés''' || Liste des logos disponibles avec téléchargement et suppression
| '''Créer / Modifier les QR codes''' || Permet de cocher ou décocher les champs et d'enregistrer la configuration
|}
|}


Le QR affiché encode l'URL de la fiche du tiers, avec le logo choisi inséré au centre de l'image.
: '''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.


----
----


= Impression d'étiquette =
= Nouveautés et compatibilité v25 =


[[File:Ultimateqrcode-label-print-fr.png|center|700px|Fenêtre d'impression d'étiquette 120×57mm]]
La version 25.0.0 aligne UltimateQRcode sur Dolibarr 25.


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).
{| class="wikitable"
! É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 <code>php -l</code> sous PHP 8.4 et 8.5
|}


L'étiquette contient :
== Historique v24 ==
* '''À 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.
=== Nouvelles fonctionnalités v24 ===


{{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.}}
{| class="wikitable"
! 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 ===


= Droits et permissions =
{| class="wikitable"
 
! Correction !! Détail
[[File:Ultimateqrcode-permissions-fr.png|center|700px|Droits du module UltimateQRcode]]
|-
| '''Picto du module''' || Ajout de l'extension <code>.png</code> dans la propriété <code>$this->picto</code> du descripteur
|-
| '''Devise''' || <code>getDolCurrency()</code> au lieu de <code>$conf->currency</code> (déprécié)
|-
| '''Constantes''' || <code>dolibarr_set_const()</code> au lieu de l'écriture directe dans <code>$conf->global</code>
|}


Le module définit deux niveaux de droits, à attribuer par groupe d'utilisateurs dans '''Configuration → Groupes et utilisateurs''' :
=== Corrections de bugs v24 ===


{| class="wikitable"
{| class="wikitable"
! Droit !! Description !! Effet
! Bug !! Correction
|-
| Onglet facture introuvable || Casse de la clé d'onglet corrigée dans le descripteur
|-
|-
| '''Read qrcode outcomes''' || Lire les QR codes || Permet de voir les onglets QR code et d'afficher les QR générés
| 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
|-
|-
| '''Create/Modify qrcode outcomes''' || Créer / Modifier || Permet de cocher/décocher les champs et d'enregistrer la configuration
| Logo trop grand || Bascule automatique en mode sans logo au lieu d'une erreur
|}
|}


{{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.}}
=== 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.


----
----
Line 276: Line 447:
= FAQ =
= FAQ =


; '''Le QR code est vide ou affiche "Aucune donnée"'''
; '''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.
: 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'''
; '''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.
: 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 champs extra n'apparaissent pas'''
; '''Les attributs supplémentaires n'apparaissent pas'''
: Les attributs complémentaires doivent être définis dans '''Configuration → Attributs complémentaires''' pour l'objet concerné.
: 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 avec logo n'est pas lisible'''
; '''Le QR code 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.
: 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'''
; '''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'''.
: 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.


----
----
Line 295: Line 475:
= Voir aussi =
= Voir aussi =


* [[Module_Ultimateqrcode_EN|Module UltimateQRcode — English documentation]]
* [[Module_Ultimateqrcode_EN|English]]
* [https://www.dolistore.com Dolistore]
* [[Module_Ultimateqrcode_DE|Deutsch]]
* [[Module_Ultimateqrcode_ES|Español]]
* [[Module_Ultimateqrcode_IT|Italiano]]
* [https://www.dolistore.com/search.php?search_query=ultimateqrcode UltimateQRcode sur le DoliStore]
* [https://www.atoo-net.com Atoo-Net]
* [https://www.atoo-net.com Atoo-Net]
[[Category:Module externe]]
[[Category:QR Code]]
[[Category:Atoo-Net]]

Latest revision as of 19:35, 29 September 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 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

  1. Télécharger l'archive module_ultimateqrcode-25.0.x.zip depuis le DoliStore
  2. 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 obtenir htdocs/custom/ultimateqrcode/
  3. Trouver le module UltimateQRcode dans la liste et l'activer
  4. 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)

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

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

Guide utilisateur intégré

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.

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

Onglet QR code d'un tiers : champs, QR code des données, QR code de l'URL et QR code vCard

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)

QR code vCard sur une fiche contact

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

Onglet QR code d'une facture avec logo intégré

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

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

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

  1. saisissez l'URL de la fiche ou tout autre contenu dans la zone de saisie ;
  2. choisissez la taille et le logo, puis cliquez sur GÉNÉRER ;
  3. 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

Étiquette de 120 × 57 mm

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

Droits du module UltimateQRcode

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.

Voir aussi

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