Module Ultimateqrcode FR: Difference between revisions

Module Ultimateqrcode FR (view source)

Revision as of 18:06, 20 June 2026

6,591 bytes added , 4 months ago

no edit summary

VisualWikitext

Grandoc

Administrators

1,953

edits

@@ Line 19: / Line 19: @@
 |prerequisites=
 |minversion=17.0.0
-|note=
+|note=Compatible Dolibarr v24
 }}
@@ Line 134: / Line 134: @@
 == Structure commune de l'onglet QR code ==
-Chaque onglet QR code est organisé en '''deux parties''' :
+{{VersionBadge|v24}} Chaque onglet QR code est désormais organisé en '''cinq zones''' :
-=== Partie haute — QR code de données configurables ===
+=== Zone 1 — Barre de réglages ===
+[[File:Ultimateqrcode-v24-settings-panel-fr.png|center|900px|Panneau de réglages : taille, qualité ECC et sélection du logo]]
+En haut de chaque onglet QR code, une barre de réglages permet de configurer :
+{| class="wikitable"
+! Réglage !! Description
+|-
+| '''Taille''' || Résolution du QR code (de 2 à 10 pixels par module). Plus la valeur est élevée, plus le QR code est grand et lisible.
+|-
+| '''Qualité (ECC)''' || Niveau de correction d'erreur : Basse (L ≈ 7%), Moyenne (M ≈ 15%), Intermédiaire (Q ≈ 25%), Haute (H ≈ 30%).
+|-
+| '''Logo''' || Logo PNG intégré au centre du QR code, sélectionnable parmi les logos uploadés.
+|}
+{{Note|Quand un logo est sélectionné, la qualité ECC est automatiquement '''forcée à Haute (H)''' pour garantir la lisibilité malgré le logo. La mention ''(Forcé en Haute avec un logo)'' s'affiche à côté du sélecteur.}}
+Ces réglages sont sauvegardés '''indépendamment par type d'objet''' (facture, devis, commande, etc.) et s'appliquent aux deux QR codes affichés (données et URL).
+=== Zone 2 — Tableau de sélection du logo ===
+Le tableau liste les logos disponibles dans le répertoire <code>documents/mycompany/logos/</code> :
+{| class="wikitable"
+! Colonne !! Description
+|-
+| '''Radio''' || Bouton radio pour sélectionner le logo (ou « ''Aucun logo'' »)
+|-
+| '''Logo''' || Nom du fichier PNG avec icône d'aperçu
+|-
+| '''Taille''' || Taille du fichier en octets
+|-
+| '''Date''' || Date du dernier upload
+|-
+| '''Aperçu''' || Icône loupe pour prévisualiser le logo
+|-
+| '''Actions''' || Icônes renommer et supprimer
+|}
+Un formulaire d'upload en bas de page permet d'ajouter de nouveaux logos PNG.
+{{Note|'''Sécurité :''' si le logo est trop grand par rapport à la capacité du QR code, le module bascule automatiquement en mode sans logo pour éviter une erreur. Un message est enregistré dans les logs Dolibarr.}}
+=== Zone 3 — QR code de données configurables ===
 [[File:Ultimateqrcode-thirdparty-qrcode-top-fr.png|center|900px|Onglet QR code d'un tiers — sélection des champs]]
@@ Line 144: / Line 188: @@
 * 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)
+* La colonne de droite affiche le '''QR code généré''' (avec ou sans logo selon la sélection)
 Les champs disponibles dépendent de l'objet :
@@ Line 160: / Line 204: @@
 |-
 | Contact || Civilité, Prénom, Nom, Société, Poste, Téléphone, Mobile, Email, Adresse, etc.
+|-
+| Facture || Réf., Réf. client, Société, Email, Téléphone, Date facturation, Date limite règlement, Total HT, Total TTC, Note publique, URL
 |-
 | (autres) || Champs spécifiques à chaque objet
@@ Line 168: / Line 214: @@
 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 ===
+=== Zone 4 — 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]]
@@ Line 178: / Line 224: @@
 * Un second '''QR code encodant l'URL directe''' vers la fiche (également cliquable pour l'impression d'étiquette)
 * Les boutons '''ENREGISTRER''' et '''ANNULER'''
+=== Zone 5 — QR code vCard (Contact, Utilisateur, Tiers, Adhérent) ===
+[[File:Ultimateqrcode-v24-contact-vcard-fr.png|center|900px|QR code vCard sur une fiche contact]]
+Les fiches '''Contact''', '''Utilisateur''', '''Tiers''' (société) et '''Adhérent''' disposent d'un '''QR code vCard''' supplémentaire en bas de page.
+Scanner ce QR code avec un smartphone permet d'ajouter le contact directement dans le répertoire téléphonique. Le contenu vCard encodé est affiché en clair sous le QR code.
+=== Aperçu dynamique (Live Preview) ===
+{{VersionBadge|v24}} Les QR codes se mettent à jour '''en temps réel''' lorsque l'utilisateur modifie :
+* la taille du QR code
+* le niveau de qualité ECC
+* le logo sélectionné
+* les champs cochés (QR de données)
+'''Aucun rechargement de page n'est nécessaire.''' L'aperçu utilise une requête AJAX avec un délai de 300 ms pour éviter les appels excessifs. Cette fonctionnalité est disponible sur les '''16 pages QR''' du module.
 === Sélection automatique des champs par défaut ===
@@ Line 190: / Line 254: @@
 = Onglet QR code — Exemples par objet =
+== Facture client ==
+{{VersionBadge|v24}}
+[[File:Ultimateqrcode-v24-invoice-qr-complete-fr.png|center|900px|Onglet QR code d'une facture avec logo intégré]]
+Exemple de configuration pour une facture client : '''Réf.''', '''Société''', '''Email''', '''Téléphone''', '''Date facturation''', '''Date limite règlement''', '''Total HT''' et '''Total TTC''' cochés. Le logo ''expert_dolibarr.png'' est sélectionné et intégré au centre du QR code. La qualité ECC est automatiquement forcée à Haute (H).
 == Produit ==
@@ Line 271: / Line 343: @@
 {{Note|Sans le droit '''Read''', les onglets QR code ne sont pas visibles. Sans le droit '''Write''', l'utilisateur voit les QR codes mais ne peut pas modifier la sélection des champs.}}
+----
+= Nouveautés et compatibilité v24 =
+{{VersionBadge|v24}} Le module UltimateQRcode version 24 apporte les évolutions suivantes :
+== Nouvelles fonctionnalités ==
+{| class="wikitable"
+! Fonctionnalité !! Description
+|-
+| '''Réglages par page''' || Taille, qualité ECC et logo configurables directement sur chaque fiche QR code
+|-
+| '''Logo intégré''' || Possibilité d'intégrer un logo PNG au centre de chaque QR code, sur toutes les pages
+|-
+| '''Aperçu dynamique''' || Mise à jour en temps réel des QR codes lors du changement de taille, ECC, logo ou champs cochés (AJAX, sans rechargement)
+|-
+| '''QR code vCard''' || QR code vCard pour les contacts, utilisateurs, tiers et adhérents permettant l'ajout direct dans le répertoire téléphonique
+|-
+| '''Gestion des logos''' || Upload, aperçu, renommage et suppression des logos depuis l'interface de chaque fiche
+|}
+== Compatibilité Dolibarr v24 ==
+{| class="wikitable"
+! Correction !! Détail
+|-
+| '''Picto du module''' || Ajout de l'extension <code>.png</code> dans la propriété <code>$this->picto</code> du descripteur de module, conformément à l'avertissement Dolibarr v23+.
+|-
+| '''Devise''' || Remplacement de <code>$conf->currency</code> (déprécié) par <code>getDolCurrency()</code>.
+|-
+| '''Constantes''' || Remplacement de l'écriture directe <code>$conf->global->XXX = value</code> (dépréciée) par <code>dolibarr_set_const()</code>.
+|}
+== Corrections de bugs ==
+{| class="wikitable"
+! Bug !! Correction
+|-
+| Onglet facture non trouvé || Correction de la casse de la clé d'onglet dans le descripteur de module.
+|-
+| Paramètre admin obsolète || Suppression du paramètre « Taille d'affichage des QR codes (en pixels) » devenu inutile avec le réglage de taille directement sur chaque fiche.
+|-
+| Débordement logo || Ajout d'un mécanisme try/catch pour gérer le dépassement de capacité quand le logo est trop grand : bascule automatique en mode sans logo.
+|}
+== Traductions ==
+Ajout des clés de traduction manquantes dans les '''5 fichiers de langue''' (FR, EN, DE, ES, IT) pour les nouvelles fonctionnalités : sélection de qualité ECC, gestion du logo, et tous les types d'objets.
 ----
@@ Line 286: / Line 408: @@
 ; '''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.
+: Le logo occupe trop de surface. Utiliser un logo plus petit (idéalement carré, moins de 100×100 pixels) ou augmenter le niveau ECC à '''H''' pour améliorer la correction d'erreur. Avec le module v24, la qualité ECC est automatiquement forcée à '''H''' quand un logo est sélectionné.
+; '''Le QR code s'affiche sans logo alors que j'en ai sélectionné un'''
+: Le logo est probablement trop volumineux par rapport au contenu encodé. Le module bascule automatiquement en mode sans logo pour éviter une erreur. Essayez avec un logo plus petit ou réduisez le nombre de champs cochés.
+; '''Les QR codes ne se mettent pas à jour quand je change les réglages'''
+: L'aperçu dynamique nécessite JavaScript activé dans le navigateur. Vérifiez qu'aucun bloqueur de scripts n'est actif. Les QR codes se mettent à jour automatiquement 300 ms après chaque modification.
 ; '''L'onglet QR code n'apparaît pas sur certaines fiches'''

Module Ultimateqrcode FR: Difference between revisions

Module Ultimateqrcode FR (view source)

Revision as of 18:06, 20 June 2026

Navigation menu

Search