Module Ultimateqrcode FR: Difference between revisions

Jump to navigation Jump to search

Module Ultimateqrcode FR (view source)

Revision as of 19:35, 29 September 2026

9,958 bytes added ,  1 month ago
no edit summary
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]]
Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/65694...67544"

Navigation menu