Module Ultimateqrcode FR: Difference between revisions

Jump to navigation Jump to search

Module Ultimateqrcode FR (view source)

Revision as of 18:26, 20 March 2026

9,605 bytes added ,  7 months ago
no edit summary
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]]
Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/65690"

Navigation menu