Module Ultimateqrcode IT: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
(Created page with "<!-- BEGIN interlang links --> <!-- Do NOT edit this section Links below are automatically managed by PolyglotBot You can edit links on the English source page : Mod...")
Tag: 2017 source edit
 
No edit summary
Tag: 2017 source edit
 
Line 3: Line 3:
     Links below are automatically managed by PolyglotBot
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
[[fr:Module_Ultimateqrcode_FR]]
[[en:Module_Ultimateqrcode_EN]]
[[en:Module_Ultimateqrcode_EN]]
[[fr:Module_Ultimateqrcode_FR]]
[[de:Module_Ultimateqrcode_DE]]
[[de:Module_Ultimateqrcode_DE]]
[[es:Module_Ultimateqrcode_ES]]
[[es:Module_Ultimateqrcode_ES]]
<!-- END interlang links -->
<!-- END interlang links -->


[[Category:Moduli complementari]]
[[Category:Moduli aggiuntivi]]
[[Category:Ultimateqrcode]]
[[Category:Ultimateqrcode]]
{{TemplateDocDev}}
{{TemplateDocDev}}
Line 20: Line 20:
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=PHP 8.2 come minimo, estensione PHP GD
|minversion=17.0.0
|minversion=25.0.0
|note=Compatibile con Dolibarr v24
|note=Compatibile con Dolibarr v25 e PHP 8.5
}}
}}
UltimateQRcode aggiunge '''codici QR''' alle schede di Dolibarr (soggetti terzi, contatti, prodotti, documenti commerciali, progetti…). Ogni codice QR codifica i campi scelti, può portare un logo al centro e si stampa su un'etichetta di 120 × 57 mm. Le schede delle persone offrono inoltre un '''codice QR vCard''' che uno smartphone scansiona per aggiungere il contatto alla rubrica.
----
= Requisiti =
{| class="wikitable"
! Elemento !! Versione
|-
| '''Dolibarr''' || 25.0.0 o superiore
|-
| '''PHP''' || 8.2 come minimo (testato fino a PHP 8.5)
|-
| '''Estensione PHP''' || GD (generazione delle immagini PNG)
|-
| '''Moduli Dolibarr''' || Nessun modulo obbligatorio. Le schede compaiono solo sugli oggetti il cui modulo è attivato (Fatture, Magazzino, Progetti…)
|}
Le librerie ''chillerlan/php-qrcode'' e ''michelf/php-markdown'' sono fornite con il modulo: non serve alcuna installazione con Composer.
----


= Installazione =
= Installazione =


# Scaricare il modulo e depositarlo nella cartella <code>htdocs/custom/ultimateqrcode/</code>
# Scaricare l'archivio <code>module_ultimateqrcode-25.0.x.zip</code> dal [https://www.dolistore.com DoliStore]
# In Dolibarr: '''Home → Configurazione → Moduli/Applicazioni'''
# In Dolibarr: '''Home → Impostazioni → Moduli/Applicazioni''', scheda '''Distribuisci/installa un modulo esterno''', caricare l'archivio. In alternativa, decomprimere l'archivio in <code>htdocs/custom/</code>: si deve ottenere <code>htdocs/custom/ultimateqrcode/</code>
# Cercare il modulo '''UltimateQRcode''' nella sezione ''Atoo-Net'' e attivarlo
# Cercare il modulo '''UltimateQRcode''' nell'elenco e attivarlo
# I permessi devono essere configurati per gruppo di utenti (vedere [[#Diritti_e_permessi|Diritti e permessi]])
# Assegnare le autorizzazioni agli utenti o ai gruppi (vedere [[#Autorizzazioni|Autorizzazioni]])
 
: '''Aggiornamento da una versione precedente:''' sostituire la cartella <code>ultimateqrcode</code>, poi '''disattivare e riattivare''' il modulo affinché Dolibarr ricarichi le schede e le autorizzazioni.


----
----
Line 36: Line 60:
= Configurazione del modulo =
= Configurazione del modulo =


Si accede alla configurazione da '''Home → Configurazione → Moduli/Applicazioni → UltimateQRcode''' (icona a chiave inglese) oppure direttamente dal menu di amministrazione.
Si accede alla configurazione da '''Home → Impostazioni → Moduli/Applicazioni → UltimateQRcode''' (icona a forma di ingranaggio).


La pagina di configurazione è composta da tre schede.
La pagina di configurazione ha quattro schede: '''Codici QR''', '''QR con logo''', '''Guida utente''' e '''Informazioni'''.


== Scheda «Codici QR» (generatore libero) ==
== Scheda «Codici QR» (generatore libero) ==


[[File:Ultimateqrcode-admin-qrcodes-fr.png|center|900px|Generatore libero di codice QR]]
[[File:Ultimateqrcode-v25-admin-qrcodes-it.png|center|900px|Generatore libero di codici QR]]


Questa scheda offre un '''generatore di codice QR su richiesta''':
Questa scheda è un '''generatore di codici QR su richiesta''': il codice QR creato qui non è collegato ad alcuna scheda Dolibarr e può codificare qualsiasi contenuto.


{| class="wikitable"
{| class="wikitable"
! Campo !! Descrizione
! Campo !! Descrizione
|-
|-
| '''Data''' || Il contenuto da codificare: URL, indirizzo e-mail, testo libero, vCard, ecc.
| '''Inserire qui i dati da codificare nel QR code''' || Il contenuto da codificare: URL, indirizzo e-mail, numero di telefono, testo libero…
|-
|-
| '''ECC''' || Livello di correzione degli errori:<br/>• '''L''' (≈7% — il più piccolo): dimensione minima<br/>• '''M''' (≈15%): uso comune<br/>• '''Q''' (≈25%): buona resistenza<br/>• '''H''' (≈30% — il migliore): molto resistente (consigliato con logo)
| '''Qualità''' || Livello di correzione degli errori:<br/>• '''Bassa''' (L, ≈ 7 %): codice QR più compatto<br/>• '''Media''' (M, ≈ 15 %): uso comune<br/>• '''Intermedia''' (Q, ≈ 25 %): buona resistenza<br/>• '''Alta''' (H, ≈ 30 %): molto resistente a sporco e graffi
|-
|-
| '''Size''' || Dimensione del punto (da 1 a 10 pixel per modulo del codice QR)
| '''Dimensione''' || Da 1 a 10 pixel per modulo del codice QR
|-
|-
| Pulsante '''GENERATE''' || Genera e visualizza immediatamente il codice QR
| Pulsante '''GENERA''' || Genera e visualizza il codice QR
|-
| Pulsante '''STAMPA ETICHETTA''' || Apre il codice QR su un'etichetta di 120 × 57 mm (vedere [[#Stampa delle etichette|Stampa delle etichette]])
|}
|}
Cliccare su '''Like this''' nel testo di aiuto per vedere un esempio di generazione.


== Scheda «QR con logo» ==
== Scheda «QR con logo» ==


[[File:Ultimateqrcode-admin-qrwithlogo-fr.png|center|900px|Generatore di QR con logo incorporato]]
[[File:Ultimateqrcode-v25-admin-qrwithlogo-it.png|center|900px|Generatore di codici QR con logo]]


Questa scheda consente di creare un '''codice QR con un logo inserito al centro''':
Questa scheda crea un '''codice QR libero con un logo al centro'''. I codici QR generati sono conservati nella cartella temporanea del modulo e possono essere rivisualizzati, stampati o eliminati.


{| class="wikitable"
{| class="wikitable"
! Campo !! Descrizione
! Elemento !! Descrizione
|-
| '''Inserire qui i dati da codificare nel QR code''' || URL o contenuto da codificare
|-
|-
| '''Data''' || URL o contenuto da codificare (predefinito: https://www.atoo-net.com/)
| '''Dimensione''' || Da 2 a 10, controlla la risoluzione dell'immagine
|-
|-
| '''Dimensione''' || Da 1 a 10 — controlla la risoluzione dell'immagine generata
| '''Tabella dei loghi''' || Loghi disponibili in <code>documents/mycompany/logos/</code>, con dimensione, data, anteprima (lente), rinomina ed eliminazione. Il pulsante di opzione sceglie il logo da integrare
|-
|-
| '''Seleziona file''' || Logo PNG da incorporare al centro del codice QR
| Pulsante '''GENERA''' || Crea il codice QR con il logo scelto
|-
|-
| Pulsante '''GENERATE''' || Genera il codice QR con il logo e lo salva
| '''UPLOAD''' || Aggiunge un nuovo logo (PNG consigliato)
|-
|-
| '''Seleziona codice QR da visualizzare''' || Selezione tra i codici QR già generati per visualizzarli
| '''Selezionare un codice QR da visualizzare''' + '''VISUALIZZA''' || Rivisualizza un codice QR già generato
|-
|-
| Pulsante '''MOSTRA''' || Mostra il codice QR selezionato
| Icona '''cestino''' || Elimina il codice QR selezionato, previa conferma
|-
|-
| Icona '''Cestino''' || Elimina il file QR selezionato (con conferma)
| Pulsante '''STAMPA ETICHETTA''' || Stampa il codice QR visualizzato su un'etichetta di 120 × 57 mm
|}
|}


La sezione '''Loghi caricati''' elenca tutti i file PNG depositati con la loro dimensione e la data di caricamento. Ogni riga dispone di un pulsante di eliminazione.
: '''Nota:''' la correzione degli errori è '''forzata alla qualità Alta''', perché il logo copre una parte della matrice.
 
== Scheda «Guida utente» ==
 
[[File:Ultimateqrcode-v25-admin-guide-it.png|center|900px|Guida utente integrata]]


: '''Nota:''' Il livello ECC consigliato per un codice QR con logo è '''H''' (30%), poiché il logo copre una parte del codice: la correzione d'errore compensa questa perdita.
La guida utente completa è consultabile direttamente in Dolibarr, nella lingua dell'utente (francese, inglese, tedesco, spagnolo o italiano).


== Scheda «Informazioni sul modulo» ==
== Scheda «Informazioni» ==


Mostra informazioni sulla versione del modulo, sull'autore e il link alla documentazione.
Mostra la versione del modulo, l'autore, la licenza e i collegamenti alla documentazione.


----
----


= Utilizzo nelle schede =
= Uso nelle schede =


Il modulo aggiunge una scheda '''Codice QR''' nelle schede dei seguenti oggetti:
Il modulo aggiunge una scheda '''Codice QR''' alle schede dei 16 oggetti seguenti:


{| class="wikitable"
{| class="wikitable"
! Oggetto !! Scheda/e aggiunta/e
! Oggetto !! Scheda aggiunta !! Codice QR vCard
|-
| Cliente/Fornitore || Codice QR + QR-Url (schede separate)
|-
|-
| Contatto || Codice QR
| Soggetto terzo || Codice QR || Sì
|-
|-
| Prodotto / Servizio || Codice QR
| Contatto / Indirizzo || Codice QR || Sì
|-
|-
| Lotto / Numero di serie || Codice QR
| Utente || Codice QR || Sì
|-
|-
| Magazzino || Codice QR
| Membro || Codice QR || Sì
|-
|-
| Preventivo || Codice QR
| Gruppo di utenti || Codice QR ||
|-
|-
| Ordine cliente || Codice QR
| Prodotto / Servizio || Codice QR ||
|-
|-
| Ordine fornitore || Codice QR
| Lotto / Numero di serie || Codice QR ||
|-
|-
| Fattura cliente || Codice QR
| Magazzino || Codice QR ||
|-
|-
| Fattura fornitore || Codice QR
| Preventivo || Codice QR ||
|-
|-
| Contratto || Codice QR
| Ordine cliente || Codice QR ||
|-
|-
| Intervento || Codice QR
| Ordine fornitore || Codice QR ||
|-
|-
| Progetto || Codice QR
| Fattura attiva || Codice QR ||
|-
|-
| Aderente (associazione) || Codice QR
| Fattura passiva || Codice QR ||
|-
|-
| Gruppo di utenti || Codice QR
| Contratto || Codice QR ||
|-
|-
| Utente || Codice QR
| Intervento || Codice QR ||
|-
|-
| Progetto || Codice QR ||
|}
|}


== Struttura comune della scheda Codice QR ==
== Struttura comune della scheda Codice QR ==


'''[Novità v24]''' Ogni scheda di codice QR è ora organizzata in '''cinque zone''':
Ogni scheda Codice QR è organizzata in '''cinque zone'''.


=== Zona 1 — Barra delle impostazioni ===
=== Zona 1 — Barra delle impostazioni ===


[[File:Ultimateqrcode-v24-settings-panel-fr.png|center|900px|Pannello impostazioni: dimensione, qualità ECC e selezione del logo]]
In alto nella scheda, una barra delle impostazioni permette di scegliere:
 
Nella parte superiore di ogni scheda di codice QR, una barra delle impostazioni consente di configurare:


{| class="wikitable"
{| class="wikitable"
! Impostazione !! Descrizione
! Impostazione !! Descrizione
|-
|-
| '''Dimensione''' || Risoluzione del codice QR (da 2 a 10 pixel per modulo). Più alto è il valore, più grande e leggibile sarà il codice QR.
| '''Dimensione''' || Risoluzione del codice QR, da 2 a 10 pixel per modulo
|-
|-
| '''Qualità (ECC)''' || Livello di correzione degli errori: Basso (L ≈ 7%), Medio (M ≈ 15%), Quartile (Q ≈ 25%), Alto (H ≈ 30%).
| '''Qualità''' || Correzione degli errori: Bassa (L), Media (M), Intermedia (Q) o Alta (H)
|-
|-
| '''Logo''' || Logo PNG da incorporare al centro del codice QR, selezionabile tra i loghi caricati.
| '''Logo''' || Logo integrato al centro del codice QR, scelto nella tabella della zona 2
|}
|}


: '''Nota:''' Quando viene selezionato un logo, la qualità ECC viene forzata automaticamente su '''Alto (H)''' per garantire la leggibilità nonostante il logo. Viene mostrato l'avviso ''(Forzato su Alto con logo)'' accanto al selettore.
: '''Nota:''' non appena si seleziona un logo, la qualità è '''forzata ad Alta (H)''' e accanto al selettore compare la dicitura ''(Forzata ad Alta con logo)''.


Queste impostazioni vengono salvate in modo '''indipendente per tipo di oggetto''' (fattura, preventivo, ordine, ecc.) e si applicano a entrambi i codici QR visualizzati (dati e URL).
Queste impostazioni sono salvate '''per tipo di oggetto''' (fatture, preventivi, ordini…) e si applicano a tutti i codici QR della scheda.


=== Zona 2 — Tabella di selezione del logo ===
=== Zona 2 — Tabella di selezione del logo ===


La tabella elenca i loghi disponibili nella cartella <code>documents/mycompany/logos/</code>:
La tabella elenca i loghi della cartella <code>documents/mycompany/logos/</code>:


{| class="wikitable"
{| class="wikitable"
! Colonna !! Descrizione
! Colonna !! Descrizione
|-
|-
| '''Radio''' || Pulsante di opzione per selezionare il logo (o «''Nessun logo''»)
| '''Pulsante di opzione''' || Seleziona il logo, oppure «''Nessun logo''»
|-
|-
| '''Logo''' || Nome del file PNG con icona di anteprima
| '''Logo''' || Nome del file
|-
|-
| '''Dimensione''' || Dimensione del file in byte
| '''Dimensione''' || Dimensione del file in byte
|-
|-
| '''Data''' || Data dell'ultimo caricamento
| '''Data''' || Data di caricamento del file
|-
|-
| '''Anteprima''' || Icona a lente per l'anteprima del logo
| '''Anteprima''' || Lente per visualizzare il logo
|-
|-
| '''Azioni''' || Icone per rinominare ed eliminare
| '''Azioni''' || Rinomina ed elimina
|}
|}


Un modulo di caricamento in fondo alla pagina consente di aggiungere nuovi loghi PNG.
Un modulo in fondo alla pagina permette di caricare nuovi loghi.


: '''Sicurezza:''' Se il logo è troppo grande rispetto alla capacità del codice QR, il modulo passa automaticamente alla modalità senza logo per evitare un errore. Un messaggio viene registrato nei log di Dolibarr.
: '''Sicurezza:''' se il logo è troppo grande rispetto alla capacità del codice QR, il modulo genera il codice QR senza logo invece di provocare un errore, e registra l'incidente nel log di Dolibarr.


=== Zona 3 — Codice QR con dati configurabili ===
=== Zona 3 — Codice QR dei dati ===


[[File:Ultimateqrcode-thirdparty-qrcode-top-fr.png|center|900px|Scheda codice QR di un cliente/fornitore — selezione dei campi]]
[[File:Ultimateqrcode-v25-thirdparty-qrcode-it.png|center|900px|Scheda Codice QR di un soggetto terzo: campi, codice QR dei dati, codice QR dell'URL e codice QR vCard]]


L'utente seleziona tramite caselle di controllo i '''campi da includere nel codice QR''':
Si scelgono i '''campi da codificare''' spuntandoli:


* La colonna sinistra contiene la casella di controllo
* la casella include o esclude il campo;
* La colonna centrale mostra l'etichetta del campo e il suo valore attuale (in grigio se non selezionato)
* la colonna centrale mostra l'etichetta e il valore attuale del campo (in grigio se non spuntato);
* La colonna destra mostra il '''codice QR generato''' (con o senza logo, a seconda della selezione)
* il codice QR generato compare accanto alla tabella, con o senza logo, insieme al pulsante '''STAMPA ETICHETTA'''.


I campi disponibili dipendono dall'oggetto:
Campi disponibili per oggetto:


{| class="wikitable"
{| class="wikitable"
! Oggetto !! Campi disponibili
! Oggetto !! Campi disponibili
|-
|-
| Cliente/Fornitore || Azienda, Indirizzo, CAP, Città, Paese, Telefono, E-mail, URL + campi aggiuntivi
| Soggetto terzo || Società, Indirizzo, CAP, Città, Paese, Telefono, Email, URL
|-
| Contatto || Nome, Cognome, Telefono, Cellulare, Email, Indirizzo, CAP, Città, Paese, URL
|-
| Utente || Login, Nome, Cognome, Telefono, Cellulare, Email, Indirizzo, CAP, Città, Paese, URL
|-
| Membro || Nome, Cognome, Telefono, Telefono personale, Email, Indirizzo, CAP, Città, Paese, URL
|-
| Gruppo di utenti || Nome del gruppo, Descrizione, URL
|-
| Prodotto / Servizio || Rif., Etichetta, Descrizione, Prezzo netto, Prezzo lordo, Codice a barre, Peso, Volume, URL
|-
| Lotto / Numero di serie || Lotto/Serie, Data di scadenza, Data limite di vendita, URL
|-
| Magazzino || Etichetta, Nome breve dell'ubicazione, Descrizione, Indirizzo, CAP, Città, Paese, URL
|-
| Preventivo || Rif., Rif. cliente, Società, Email, Telefono, Data, Data di fine validità, Totale netto, Totale lordo, Nota pubblica, URL
|-
| Ordine cliente || Rif., Rif. cliente, Società, Email, Telefono, Data, Totale netto, Totale lordo, Nota pubblica, URL
|-
|-
| Prodotto || Rif., Descrizione, Dettaglio, Prezzo netto, Prezzo lordo, Codice a barre, Peso, Volume, URL + campi aggiuntivi
| Ordine fornitore || Rif., Rif. fornitore, Società, Email, Telefono, Data, Totale netto, Totale lordo, Nota pubblica, URL
|-
|-
| Magazzino || Etichetta, Nome breve dell'ubicazione, Descrizione, Indirizzo, CAP, Città, Paese, URL + campi aggiuntivi
| Fattura attiva || Rif., Rif. cliente, Società, Email, Telefono, Data fattura, Scadenza pagamento, Totale netto, Totale lordo, Nota pubblica, URL
|-
|-
| Utente || Login, Nome, Cognome, Telefono, Cellulare, E-mail, Indirizzo, CAP, Città, Paese, URL + campi aggiuntivi
| Fattura passiva || Rif., Rif. fornitore, Società, Email, Telefono, Data fattura, Scadenza pagamento, Totale netto, Totale lordo, Nota pubblica, URL
|-
|-
| Contatto || Titolo, Nome, Cognome, Azienda, Funzione, Telefono, Cellulare, E-mail, Indirizzo, ecc.
| Contratto || Rif., Rif. cliente, Rif. fornitore, Società, Email, Telefono, Data del contratto, Nota pubblica, URL
|-
|-
| Fattura || Rif., Rif. cliente, Azienda, E-mail, Telefono, Data fattura, Scadenza, Totale netto, Totale lordo, Nota pubblica, URL
| Intervento || Rif., Società, Email, Telefono, Data, Descrizione, URL
|-
|-
| (altri) || Campi specifici dell'oggetto
| Progetto || Rif., Etichetta del progetto, Società, Email, Telefono, Data di inizio, Data di fine, Nota pubblica, URL
|}
|}


: '''Nota:''' I '''campi aggiuntivi''' (attributi complementari) definiti in Dolibarr vengono aggiunti automaticamente all'elenco dei campi disponibili.
: '''Nota:''' i '''campi aggiuntivi''' compilati nella scheda vengono aggiunti automaticamente all'elenco, nella forma ''Campo aggiuntivo : etichetta''. Quelli creati da altri moduli vengono ignorati.
 
Il codice QR mostrato è '''cliccabile''': un clic apre la finestra di [[#Stampa_etichette|stampa etichette]].


=== Zona 4 — Codice QR dell'URL della scheda ===
=== Zona 4 — Codice QR dell'URL della scheda ===


[[File:Ultimateqrcode-thirdparty-qrcode-bottom-fr.png|center|900px|Scheda codice QR — zona inferiore con QR dell'URL e pulsanti Salva/Annulla]]
A destra (o sotto la tabella a seconda della larghezza dello schermo), la scheda mostra:


La zona inferiore mostra:
* l'etichetta '''URL della scheda''' seguita da un collegamento alla scheda;
* un secondo '''codice QR che codifica l'URL diretto''' della scheda, anch'esso stampabile su etichetta;
* in fondo alla pagina, i pulsanti '''SALVA''' e '''ANNULLA'''.


* L'etichetta '''URL della scheda [Oggetto]'''
=== Zona 5 — Codice QR vCard (Soggetto terzo, Contatto, Utente, Membro) ===
* Il link cliccabile verso la scheda Dolibarr
* Un secondo '''codice QR che codifica l'URL diretto''' verso la scheda (anch'esso cliccabile per la stampa etichette)
* I pulsanti '''SALVA''' e '''ANNULLA'''


=== Zona 5 — Codice QR vCard (Contatto, Utente, Cliente/Fornitore, Aderente) ===
[[File:Ultimateqrcode-v25-contact-vcard-it.png|center|900px|Codice QR vCard su una scheda contatto]]


[[File:Ultimateqrcode-v24-contact-vcard-fr.png|center|900px|Codice QR vCard su una scheda contatto]]
Le schede '''Soggetto terzo''', '''Contatto''', '''Utente''' e '''Membro''' mostrano inoltre un '''codice QR vCard'''. Scansionato con uno smartphone, propone di aggiungere il contatto direttamente alla rubrica. Il contenuto vCard 3.0 codificato è mostrato in chiaro accanto al codice QR.


Le schede '''Contatto''', '''Utente''', '''Cliente/Fornitore''' (azienda) e '''Aderente''' dispongono di un '''codice QR vCard''' aggiuntivo in fondo alla pagina.
=== Anteprima dinamica ===


La scansione di questo codice QR con uno smartphone consente di aggiungere direttamente il contatto alla rubrica telefonica. Il contenuto vCard codificato viene mostrato in testo semplice sotto il codice QR.
I codici QR si aggiornano '''in tempo reale''' quando si modifica:
* la dimensione;
* la qualità;
* il logo;
* i campi spuntati.


=== Anteprima in tempo reale ===
'''Non serve ricaricare la pagina.''' L'anteprima usa una richiesta AJAX inviata 300 ms dopo l'ultima modifica. Funziona su tutte le 16 schede Codice QR.
 
'''[Novità v24]''' I codici QR vengono aggiornati '''in tempo reale''' quando l'utente modifica:
* la dimensione del codice QR
* il livello di qualità ECC
* il logo selezionato
* i campi selezionati (QR dati)
 
'''Non è necessario ricaricare la pagina.''' L'anteprima utilizza una richiesta AJAX con un ritardo di 300 ms per evitare chiamate eccessive. Questa funzione è disponibile su tutte le '''16 pagine di codice QR''' del modulo.


=== Selezione automatica dei campi predefiniti ===
=== Selezione automatica dei campi predefiniti ===


Alla prima visualizzazione (nessuna configurazione salvata), il modulo seleziona automaticamente i campi il cui valore non è vuoto. Ciò garantisce un codice QR pertinente fin dalla prima apertura.
Alla prima visualizzazione, finché non è stata salvata alcuna configurazione, il modulo spunta i campi compilati nella scheda. Il codice QR è così pertinente fin dalla prima apertura.


=== Salvataggio della configurazione ===
=== Salvataggio della configurazione ===


Selezionare o deselezionare i campi desiderati e cliccare su '''SALVA'''. La selezione viene salvata e si applica a '''tutti gli oggetti dello stesso tipo''' (una configurazione globale per tipo di oggetto).
Spuntare o togliere la spunta ai campi, poi fare clic su '''SALVA'''. La selezione si applica a '''tutti gli oggetti dello stesso tipo''' (una configurazione per tipo di oggetto).


----
----
Line 258: Line 296:
= Scheda Codice QR — Esempi per oggetto =
= Scheda Codice QR — Esempi per oggetto =


== Fattura cliente ==
== Fattura attiva ==


'''[Novità v24]'''
[[File:Ultimateqrcode-v25-invoice-qrcode-it.png|center|900px|Scheda Codice QR di una fattura con logo integrato]]


[[File:Ultimateqrcode-v24-invoice-qr-complete-fr.png|center|900px|Scheda codice QR di una fattura con logo incorporato]]
Esempio su una fattura attiva: '''Rif.''', '''Società''', '''Email''', '''Telefono''', '''Data fattura''', '''Scadenza pagamento''', '''Totale netto''', '''Totale lordo''' e '''URL''' sono spuntati. Il logo ''expert_dolibarr.png'' è integrato al centro di entrambi i codici QR e la qualità è forzata ad Alta (H).
 
Esempio di configurazione per una fattura cliente: '''Rif.''', '''Azienda''', '''E-mail''', '''Telefono''', '''Data fattura''', '''Scadenza''', '''Totale netto''' e '''Totale lordo''' selezionati. Il logo ''expert_dolibarr.png'' è selezionato e incorporato al centro del codice QR. La qualità ECC viene forzata automaticamente su Alto (H).


== Prodotto ==
== Prodotto ==


[[File:Ultimateqrcode-product-qrcode-fr.png|center|900px|Scheda codice QR di un prodotto]]
[[File:Ultimateqrcode-v25-product-qrcode-it.png|center|900px|Scheda Codice QR di un prodotto]]


Esempio di configurazione per un prodotto: '''Rif.''' e '''Descrizione''' selezionati, insieme ai campi aggiuntivi '''Ecotax''' e '''ControlHistoryLink'''. Il codice QR codifica questi quattro valori concatenati.
Su un prodotto, il codice QR può codificare riferimento, etichetta, prezzi, codice a barre, peso e volume: pratico per l'etichettatura a scaffale o in magazzino.


== Magazzino ==
== Magazzino ==


[[File:Ultimateqrcode-stock-qrcode-fr.png|center|900px|Scheda codice QR di un magazzino]]
[[File:Ultimateqrcode-v25-stock-qrcode-it.png|center|900px|Scheda Codice QR di un magazzino]]


Utile per l'etichettatura fisica delle ubicazioni di magazzino. Il campo '''Nome breve dell'ubicazione''' consente di precisare la zona di stoccaggio.
Utile per identificare fisicamente le ubicazioni di stoccaggio. Il campo '''Nome breve dell'ubicazione''' precisa la zona (corsia, scaffale…).


== Utente ==
== Utente ==


[[File:Ultimateqrcode-user-qrcode-fr.png|center|900px|Scheda codice QR di un utente]]
Il codice QR dell'utente codifica i recapiti professionali (login, nome, cognome, telefoni, email, indirizzo…), e il codice QR vCard li aggiunge a una rubrica. Pratico per badge o biglietti da visita interni.


Il codice QR dell'utente codifica informazioni di contatto (login, nome, cognome, telefono, cellulare, e-mail, paese...). Pratico per badge o biglietti da visita interni.
: '''Nota:''' la scheda Codice QR di un utente è visibile solo all'utente stesso o a chi ha il permesso di leggere le schede utenti.
 
: '''Nota:''' La scheda codice QR dell'utente è visibile solo all'utente stesso o agli utenti con permesso di lettura sulle schede utente.


----
----


= Scheda QR-Url (solo Clienti/Fornitori) =
= Immagine di codice QR riutilizzabile (QR con logo) =


[[File:Ultimateqrcode-thirdparty-qrurl-fr.png|center|900px|Scheda QR-Url di un cliente/fornitore con logo]]
Per ottenere un''''immagine di codice QR con logo''' da riutilizzare altrove (sito web, brochure, firma e-mail), usare la scheda di configurazione '''QR con logo''':


Le schede Cliente/Fornitore dispongono di una '''seconda scheda QR''' chiamata '''QR-Url''', specializzata nella generazione di codici QR '''con logo incorporato''' che codificano l'URL della scheda.
# inserire l'URL della scheda o qualsiasi altro contenuto nella zona di immissione;
# scegliere la dimensione e il logo, poi fare clic su '''GENERA''';
# rivisualizzare il codice QR in qualsiasi momento con '''Selezionare un codice QR da visualizzare''', stamparlo o eliminarlo.


Funzionalità:
: '''Nota:''' la vecchia scheda «QR-Url» dei soggetti terzi, che il modulo non dichiarava più, è stata rimossa. Il codice QR dell'URL della scheda resta disponibile nella zona 4 di ogni scheda Codice QR.


{| class="wikitable"
----
! Elemento !! Funzione
|-
| '''Dimensione''' (1-10) || Risoluzione del codice QR generato
|-
| '''Seleziona file''' + '''CARICA LOGO''' || Caricare un logo PNG da incorporare al centro
|-
| '''Seleziona codice QR da visualizzare''' || Selezione tra i codici QR già generati per questo cliente/fornitore
|-
| Pulsante '''MOSTRA''' || Mostra il codice QR selezionato
|-
| Sezione '''Loghi caricati''' || Elenco dei loghi disponibili con opzioni di download ed eliminazione
|}
 
Il codice QR mostrato codifica l'URL della scheda cliente/fornitore, con il logo scelto al centro dell'immagine.


----
= Stampa delle etichette =


= Stampa etichette =
[[File:Ultimateqrcode-v25-label-print-it.png|center|466px|Etichetta di 120 × 57 mm]]


[[File:Ultimateqrcode-label-print-fr.png|center|700px|Finestra di stampa etichetta 120×57mm]]
Il pulsante '''STAMPA ETICHETTA''', o un clic su un codice QR, apre una '''finestra di stampa''' in formato '''120 × 57 mm''', adatto alle stampanti per etichette più comuni.


Cliccando su un codice QR in una qualsiasi scheda, si apre una '''finestra popup di stampa''', ottimizzata per etichette in formato '''120 × 57 mm''' (compatibile con le comuni stampanti di etichette).
L'etichetta di una scheda contiene:
* '''a sinistra''': il codice QR dei dati;
* '''al centro''': le informazioni chiave della scheda (riferimento, soggetto terzo, totale…, a seconda dell'oggetto);
* '''a destra''': il codice QR dell'URL della scheda.


L'etichetta include:
I generatori delle schede '''Codici QR''' e '''QR con logo''' stampano allo stesso modo il codice QR appena creato.
* '''A sinistra''': il codice QR con dati configurabili
* '''Al centro''': le principali informazioni testuali (riferimento, descrizione, nome, ecc. a seconda dell'oggetto)
* '''A destra''': il codice QR dell'URL della scheda


La finestra avvia automaticamente la finestra di dialogo di stampa del browser.
La finestra apre automaticamente la finestra di dialogo di stampa del browser.


: '''Nota:''' Per una stampa ottimale su etichette adesive, impostare la stampante sul formato 120×57mm e disattivare i margini nelle opzioni di stampa del browser.
: '''Nota:''' per una stampa ottimale su etichette adesive, impostare la stampante sul formato 120 × 57 mm ed eliminare i margini nelle opzioni di stampa del browser.


----
----


= Diritti e permessi =
= Autorizzazioni =


[[File:Ultimateqrcode-permissions-fr.png|center|700px|Permessi del modulo UltimateQRcode]]
[[File:Ultimateqrcode-v25-permissions-it.png|center|900px|Autorizzazioni del modulo UltimateQRcode]]


Il modulo definisce due livelli di permessi, assegnabili per gruppo di utenti da '''Configurazione → Utenti e gruppi''':
Il modulo definisce due autorizzazioni, da assegnare per utente o per gruppo in '''Utenti e gruppi''':


{| class="wikitable"
{| class="wikitable"
! Permesso !! Descrizione !! Effetto
! Autorizzazione !! Effetto
|-
|-
| '''Read qrcode outcomes''' || Lettura dei codici QR || Consente di visualizzare le schede codice QR e i codici QR generati
| '''Leggere i codici QR''' || Mostra le schede Codice QR e i codici QR generati
|-
|-
| '''Create/Modify qrcode outcomes''' || Creazione/Modifica || Consente di selezionare o deselezionare i campi e salvare la configurazione
| '''Creare / Modificare i codici QR''' || Permette di spuntare o togliere la spunta ai campi e di salvare la configurazione
|}
|}


: '''Nota:''' Senza il permesso '''Read''', le schede codice QR non sono visibili. Senza il permesso '''Write''', l'utente può vedere i codici QR ma non modificare la selezione dei campi.
: '''Nota:''' senza l'autorizzazione di lettura, le schede Codice QR non sono visibili. Senza l'autorizzazione di modifica, l'utente vede i codici QR ma non può cambiare la selezione dei campi. Caricamento, rinomina ed eliminazione dei loghi sono riservati agli amministratori.


----
----


= Novità e compatibilità con v24 =
= Novità e compatibilità v25 =


'''[Novità v24]''' La versione 24 del modulo UltimateQRcode introduce i seguenti miglioramenti:
La versione 25.0.0 allinea UltimateQRcode a Dolibarr 25.


== Nuove funzionalità ==
{| class="wikitable"
! Modifica !! Dettaglio
|-
| '''Versioni minime''' || Dolibarr 25.0.0 e PHP 8.2
|-
| '''PHP 8.4 e 8.5''' || Il modulo non genera alcun avviso di deprecazione: proprietà del descrittore allineate al core, pagina «Informazioni» senza avvisi
|-
| '''Schede dei pagamenti''' || Le schede «Codice QR» dei pagamenti clienti e fornitori, che puntavano a pagine inesistenti (errore 404), sono state rimosse
|-
| '''Scheda QR-Url''' || La pagina orfana della vecchia scheda QR-Url dei soggetti terzi è stata eliminata; la documentazione rimanda alla scheda '''QR con logo'''
|-
| '''Autorizzazioni tradotte''' || Le due autorizzazioni sono ora mostrate nella lingua dell'utente («Leggere i codici QR», «Creare / Modificare i codici QR»)
|-
| '''Visualizzazione vCard''' || Il contenuto vCard e gli indirizzi su più righe sono mostrati correttamente, senza «\n» visibile né sconfinamento della pagina
|-
| '''Campi aggiuntivi''' || L'etichetta «Campo aggiuntivo» è tradotta (prima compariva «ExtraField»)
|-
| '''Etichette IT''' || «Codice QR vCard» corretto in italiano
|-
| '''Guida utente''' || Nuova scheda di configurazione con la guida completa nelle 5 lingue
|-
| '''Integrazione continua''' || Ogni file PHP del modulo viene verificato con <code>php -l</code> con PHP 8.4 e 8.5
|}
 
== Cronologia v24 ==
 
=== Nuove funzionalità v24 ===


{| class="wikitable"
{| class="wikitable"
! Funzionalità !! Descrizione
! Funzionalità !! Descrizione
|-
|-
| '''Impostazioni per pagina''' || Dimensione, qualità ECC e logo configurabili direttamente su ogni pagina di codice QR della scheda
| '''Impostazioni per scheda''' || Dimensione, qualità e logo configurabili direttamente in ogni scheda Codice QR
|-
|-
| '''Logo incorporato''' || Possibilità di incorporare un logo PNG al centro di ogni codice QR, su tutte le pagine
| '''Logo integrato''' || Logo PNG al centro di ogni codice QR, su tutte le pagine
|-
|-
| '''Anteprima in tempo reale''' || Aggiornamento in tempo reale dei codici QR alla modifica di dimensione, ECC, logo o campi selezionati (AJAX, senza ricaricamento)
| '''Anteprima dinamica''' || Aggiornamento dei codici QR in tempo reale al cambio di dimensione, qualità, logo o campi spuntati
|-
|-
| '''Codice QR vCard''' || Codice QR vCard per contatti, utenti, clienti/fornitori e aderenti, per aggiungerli direttamente alla rubrica telefonica
| '''Codice QR vCard''' || Per soggetti terzi, contatti, utenti e membri
|-
|-
| '''Gestione dei loghi''' || Caricamento, anteprima, rinomina ed eliminazione dei loghi direttamente dall'interfaccia di ogni scheda
| '''Gestione dei loghi''' || Caricamento, anteprima, rinomina ed eliminazione dei loghi da ogni scheda
|}
|}


== Compatibilità con Dolibarr v24 ==
=== Compatibilità con Dolibarr v24 ===


{| class="wikitable"
{| class="wikitable"
! Correzione !! Dettaglio
! Correzione !! Dettaglio
|-
|-
| '''Icona del modulo''' || Aggiunta dell'estensione <code>.png</code> nella proprietà <code>$this->picto</code> del descrittore del modulo, in conformità con l'avviso di Dolibarr v23+.
| '''Picto del modulo''' || Estensione <code>.png</code> aggiunta alla proprietà <code>$this->picto</code> del descrittore
|-
|-
| '''Valuta''' || Sostituzione di <code>$conf->currency</code> (obsoleto) con <code>getDolCurrency()</code>.
| '''Valuta''' || <code>getDolCurrency()</code> al posto di <code>$conf->currency</code> (deprecato)
|-
|-
| '''Costanti''' || Sostituzione dell'assegnazione diretta <code>$conf->global->XXX = value</code> (obsoleta) con <code>dolibarr_set_const()</code>.
| '''Costanti''' || <code>dolibarr_set_const()</code> al posto della scrittura diretta in <code>$conf->global</code>
|}
|}


== Correzioni di bug ==
=== Correzioni v24 ===


{| class="wikitable"
{| class="wikitable"
! Bug !! Correzione
! Errore !! Correzione
|-
|-
| Scheda fattura non trovata || Correzione della distinzione tra maiuscole e minuscole della chiave della scheda nel descrittore del modulo.
| Scheda fattura non trovata || Maiuscole/minuscole della chiave della scheda corrette nel descrittore
|-
|-
| Parametro di amministrazione obsoleto || Rimozione del parametro «Dimensione di visualizzazione dei codici QR (in pixel)», diventato ridondante con l'impostazione della dimensione per pagina.
| Parametro di configurazione obsoleto || Rimosso «Dimensione di visualizzazione dei codici QR (in pixel)», sostituito dall'impostazione della dimensione di ogni scheda
|-
|-
| Overflow del logo || Aggiunta di un meccanismo try/catch per gestire l'overflow di capacità quando il logo è troppo grande: passaggio automatico alla modalità senza logo.
| Logo troppo grande || Passaggio automatico a «senza logo» invece di un errore
|}
|}


== Traduzioni ==
=== Traduzioni v24 ===


Aggiunta delle chiavi di traduzione mancanti nei '''5 file di lingua''' (FR, EN, DE, ES, IT) per le nuove funzionalità: selezione della qualità ECC, gestione dei loghi e tutti i tipi di oggetto.
Chiavi di traduzione mancanti aggiunte nelle 5 lingue (FR, EN, DE, ES, IT): qualità, gestione del logo e tutti i tipi di oggetto.


----
----
Line 402: Line 450:


; '''Il codice QR è vuoto o mostra «Nessun dato»'''
; '''Il codice QR è vuoto o mostra «Nessun dato»'''
: Nessun campo è selezionato, oppure tutti i campi selezionati hanno un valore vuoto nella scheda. Selezionare almeno un campo con un valore e cliccare su SALVA.
: Nessun campo è spuntato, oppure i campi spuntati sono vuoti nella scheda. Spuntare almeno un campo compilato e fare clic su SALVA.


; '''L'etichetta non viene stampata nella dimensione corretta'''
; '''L'etichetta non viene stampata nella dimensione corretta'''
: Verificare che il formato carta della stampante sia correttamente impostato su 120×57mm. Disattivare i margini nelle opzioni di stampa del browser.
: Verificare che il formato carta della stampante sia impostato su 120 × 57 mm ed eliminare i margini nelle opzioni di stampa del browser.


; '''I campi aggiuntivi non compaiono'''
; '''I campi aggiuntivi non compaiono'''
: Gli attributi complementari devono essere definiti in '''Configurazione → Attributi complementari''' per l'oggetto in questione.
: Vengono proposti solo i campi aggiuntivi '''compilati''' nella scheda. Si definiscono nella configurazione del modulo interessato (ad esempio '''Soggetti terzi → Attributi aggiuntivi''').


; '''Il codice QR con logo non è leggibile'''
; '''Il codice QR con logo non è leggibile'''
: Il logo occupa troppo spazio. Utilizzare un logo più piccolo (idealmente quadrato, inferiore a 100×100 pixel) o aumentare il livello ECC su '''H''' per migliorare la correzione degli errori. Con il modulo v24, la qualità ECC viene forzata automaticamente su '''H''' quando viene selezionato un logo.
: Il logo copre una superficie eccessiva. Usare un logo più piccolo, idealmente quadrato. La qualità è già forzata ad Alta (H) non appena si seleziona un logo.
 
; '''Il codice QR compare senza logo anche se ne ho selezionato uno'''
: Il logo è troppo grande per il contenuto codificato: il modulo genera allora il codice QR senza logo. Provare con un logo più piccolo o spuntare meno campi.


; '''Il codice QR viene mostrato senza logo anche se ne ho selezionato uno'''
; '''I codici QR non si aggiornano quando cambio le impostazioni'''
: Il logo è probabilmente troppo grande rispetto al contenuto codificato. Il modulo passa automaticamente alla modalità senza logo per evitare un errore. Provare con un logo più piccolo o ridurre il numero di campi selezionati.
: L'anteprima dinamica richiede JavaScript. Verificare che nessun blocco degli script sia attivo.


; '''I codici QR non si aggiornano quando modifico le impostazioni'''
; '''La scheda Codice QR non compare su alcune schede'''
: L'anteprima in tempo reale richiede che JavaScript sia attivato nel browser. Verificare che nessun blocco degli script sia attivo. I codici QR si aggiornano automaticamente 300 ms dopo ogni modifica.
: Verificare che il modulo sia attivato, che lo sia anche il modulo Dolibarr dell'oggetto e che l'utente abbia l'autorizzazione '''Leggere i codici QR'''. Dopo un aggiornamento, disattivare e riattivare UltimateQRcode.


; '''La scheda codice QR non compare su alcune schede'''
; '''Dov'è finita la scheda QR-Url dei soggetti terzi?'''
: Verificare che il modulo sia attivato e che l'utente disponga del permesso '''Read qrcode outcomes'''.
: È stata rimossa. Il codice QR dell'URL della scheda si trova nella scheda Codice QR (zona 4), e la scheda di configurazione '''QR con logo''' crea immagini riutilizzabili.


----
----


= Vedi anche =
= Vedere anche =


* [[Module_Ultimateqrcode_FR|Français]]
* [[Module_Ultimateqrcode_EN|English]]
* [[Module_Ultimateqrcode_EN|English]]
* [[Module_Ultimateqrcode_FR|Français]]
* [[Module_Ultimateqrcode_DE|Deutsch]]
* [[Module_Ultimateqrcode_DE|Deutsch]]
* [[Module_Ultimateqrcode_ES|Español]]
* [[Module_Ultimateqrcode_ES|Español]]
* [https://www.dolistore.com Dolistore]
* [https://www.dolistore.com/search.php?search_query=ultimateqrcode UltimateQRcode sul DoliStore]
* [https://www.atoo-net.com Atoo-Net]
* [https://www.atoo-net.com Atoo-Net]

Latest revision as of 19:44, 29 September 2026

Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

Informazioni


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 come minimo, estensione 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 Compatibile con Dolibarr v25 e PHP 8.5

UltimateQRcode aggiunge codici QR alle schede di Dolibarr (soggetti terzi, contatti, prodotti, documenti commerciali, progetti…). Ogni codice QR codifica i campi scelti, può portare un logo al centro e si stampa su un'etichetta di 120 × 57 mm. Le schede delle persone offrono inoltre un codice QR vCard che uno smartphone scansiona per aggiungere il contatto alla rubrica.

Requisiti

Elemento Versione
Dolibarr 25.0.0 o superiore
PHP 8.2 come minimo (testato fino a PHP 8.5)
Estensione PHP GD (generazione delle immagini PNG)
Moduli Dolibarr Nessun modulo obbligatorio. Le schede compaiono solo sugli oggetti il cui modulo è attivato (Fatture, Magazzino, Progetti…)

Le librerie chillerlan/php-qrcode e michelf/php-markdown sono fornite con il modulo: non serve alcuna installazione con Composer.

Installazione

  1. Scaricare l'archivio module_ultimateqrcode-25.0.x.zip dal DoliStore
  2. In Dolibarr: Home → Impostazioni → Moduli/Applicazioni, scheda Distribuisci/installa un modulo esterno, caricare l'archivio. In alternativa, decomprimere l'archivio in htdocs/custom/: si deve ottenere htdocs/custom/ultimateqrcode/
  3. Cercare il modulo UltimateQRcode nell'elenco e attivarlo
  4. Assegnare le autorizzazioni agli utenti o ai gruppi (vedere Autorizzazioni)
Aggiornamento da una versione precedente: sostituire la cartella ultimateqrcode, poi disattivare e riattivare il modulo affinché Dolibarr ricarichi le schede e le autorizzazioni.

Configurazione del modulo

Si accede alla configurazione da Home → Impostazioni → Moduli/Applicazioni → UltimateQRcode (icona a forma di ingranaggio).

La pagina di configurazione ha quattro schede: Codici QR, QR con logo, Guida utente e Informazioni.

Scheda «Codici QR» (generatore libero)

Generatore libero di codici QR

Questa scheda è un generatore di codici QR su richiesta: il codice QR creato qui non è collegato ad alcuna scheda Dolibarr e può codificare qualsiasi contenuto.

Campo Descrizione
Inserire qui i dati da codificare nel QR code Il contenuto da codificare: URL, indirizzo e-mail, numero di telefono, testo libero…
Qualità Livello di correzione degli errori:
• Bassa (L, ≈ 7 %): codice QR più compatto
• Media (M, ≈ 15 %): uso comune
• Intermedia (Q, ≈ 25 %): buona resistenza
• Alta (H, ≈ 30 %): molto resistente a sporco e graffi
Dimensione Da 1 a 10 pixel per modulo del codice QR
Pulsante GENERA Genera e visualizza il codice QR
Pulsante STAMPA ETICHETTA Apre il codice QR su un'etichetta di 120 × 57 mm (vedere Stampa delle etichette)

Scheda «QR con logo»

Generatore di codici QR con logo

Questa scheda crea un codice QR libero con un logo al centro. I codici QR generati sono conservati nella cartella temporanea del modulo e possono essere rivisualizzati, stampati o eliminati.

Elemento Descrizione
Inserire qui i dati da codificare nel QR code URL o contenuto da codificare
Dimensione Da 2 a 10, controlla la risoluzione dell'immagine
Tabella dei loghi Loghi disponibili in documents/mycompany/logos/, con dimensione, data, anteprima (lente), rinomina ed eliminazione. Il pulsante di opzione sceglie il logo da integrare
Pulsante GENERA Crea il codice QR con il logo scelto
UPLOAD Aggiunge un nuovo logo (PNG consigliato)
Selezionare un codice QR da visualizzare + VISUALIZZA Rivisualizza un codice QR già generato
Icona cestino Elimina il codice QR selezionato, previa conferma
Pulsante STAMPA ETICHETTA Stampa il codice QR visualizzato su un'etichetta di 120 × 57 mm
Nota: la correzione degli errori è forzata alla qualità Alta, perché il logo copre una parte della matrice.

Scheda «Guida utente»

Guida utente integrata

La guida utente completa è consultabile direttamente in Dolibarr, nella lingua dell'utente (francese, inglese, tedesco, spagnolo o italiano).

Scheda «Informazioni»

Mostra la versione del modulo, l'autore, la licenza e i collegamenti alla documentazione.

Uso nelle schede

Il modulo aggiunge una scheda Codice QR alle schede dei 16 oggetti seguenti:

Oggetto Scheda aggiunta Codice QR vCard
Soggetto terzo Codice QR Sì
Contatto / Indirizzo Codice QR Sì
Utente Codice QR Sì
Membro Codice QR Sì
Gruppo di utenti Codice QR
Prodotto / Servizio Codice QR
Lotto / Numero di serie Codice QR
Magazzino Codice QR
Preventivo Codice QR
Ordine cliente Codice QR
Ordine fornitore Codice QR
Fattura attiva Codice QR
Fattura passiva Codice QR
Contratto Codice QR
Intervento Codice QR
Progetto Codice QR

Struttura comune della scheda Codice QR

Ogni scheda Codice QR è organizzata in cinque zone.

Zona 1 — Barra delle impostazioni

In alto nella scheda, una barra delle impostazioni permette di scegliere:

Impostazione Descrizione
Dimensione Risoluzione del codice QR, da 2 a 10 pixel per modulo
Qualità Correzione degli errori: Bassa (L), Media (M), Intermedia (Q) o Alta (H)
Logo Logo integrato al centro del codice QR, scelto nella tabella della zona 2
Nota: non appena si seleziona un logo, la qualità è forzata ad Alta (H) e accanto al selettore compare la dicitura (Forzata ad Alta con logo).

Queste impostazioni sono salvate per tipo di oggetto (fatture, preventivi, ordini…) e si applicano a tutti i codici QR della scheda.

La tabella elenca i loghi della cartella documents/mycompany/logos/:

Colonna Descrizione
Pulsante di opzione Seleziona il logo, oppure «Nessun logo»
Logo Nome del file
Dimensione Dimensione del file in byte
Data Data di caricamento del file
Anteprima Lente per visualizzare il logo
Azioni Rinomina ed elimina

Un modulo in fondo alla pagina permette di caricare nuovi loghi.

Sicurezza: se il logo è troppo grande rispetto alla capacità del codice QR, il modulo genera il codice QR senza logo invece di provocare un errore, e registra l'incidente nel log di Dolibarr.

Zona 3 — Codice QR dei dati

Scheda Codice QR di un soggetto terzo: campi, codice QR dei dati, codice QR dell'URL e codice QR vCard

Si scelgono i campi da codificare spuntandoli:

  • la casella include o esclude il campo;
  • la colonna centrale mostra l'etichetta e il valore attuale del campo (in grigio se non spuntato);
  • il codice QR generato compare accanto alla tabella, con o senza logo, insieme al pulsante STAMPA ETICHETTA.

Campi disponibili per oggetto:

Oggetto Campi disponibili
Soggetto terzo Società, Indirizzo, CAP, Città, Paese, Telefono, Email, URL
Contatto Nome, Cognome, Telefono, Cellulare, Email, Indirizzo, CAP, Città, Paese, URL
Utente Login, Nome, Cognome, Telefono, Cellulare, Email, Indirizzo, CAP, Città, Paese, URL
Membro Nome, Cognome, Telefono, Telefono personale, Email, Indirizzo, CAP, Città, Paese, URL
Gruppo di utenti Nome del gruppo, Descrizione, URL
Prodotto / Servizio Rif., Etichetta, Descrizione, Prezzo netto, Prezzo lordo, Codice a barre, Peso, Volume, URL
Lotto / Numero di serie Lotto/Serie, Data di scadenza, Data limite di vendita, URL
Magazzino Etichetta, Nome breve dell'ubicazione, Descrizione, Indirizzo, CAP, Città, Paese, URL
Preventivo Rif., Rif. cliente, Società, Email, Telefono, Data, Data di fine validità, Totale netto, Totale lordo, Nota pubblica, URL
Ordine cliente Rif., Rif. cliente, Società, Email, Telefono, Data, Totale netto, Totale lordo, Nota pubblica, URL
Ordine fornitore Rif., Rif. fornitore, Società, Email, Telefono, Data, Totale netto, Totale lordo, Nota pubblica, URL
Fattura attiva Rif., Rif. cliente, Società, Email, Telefono, Data fattura, Scadenza pagamento, Totale netto, Totale lordo, Nota pubblica, URL
Fattura passiva Rif., Rif. fornitore, Società, Email, Telefono, Data fattura, Scadenza pagamento, Totale netto, Totale lordo, Nota pubblica, URL
Contratto Rif., Rif. cliente, Rif. fornitore, Società, Email, Telefono, Data del contratto, Nota pubblica, URL
Intervento Rif., Società, Email, Telefono, Data, Descrizione, URL
Progetto Rif., Etichetta del progetto, Società, Email, Telefono, Data di inizio, Data di fine, Nota pubblica, URL
Nota: i campi aggiuntivi compilati nella scheda vengono aggiunti automaticamente all'elenco, nella forma Campo aggiuntivo : etichetta. Quelli creati da altri moduli vengono ignorati.

Zona 4 — Codice QR dell'URL della scheda

A destra (o sotto la tabella a seconda della larghezza dello schermo), la scheda mostra:

  • l'etichetta URL della scheda seguita da un collegamento alla scheda;
  • un secondo codice QR che codifica l'URL diretto della scheda, anch'esso stampabile su etichetta;
  • in fondo alla pagina, i pulsanti SALVA e ANNULLA.

Zona 5 — Codice QR vCard (Soggetto terzo, Contatto, Utente, Membro)

Codice QR vCard su una scheda contatto

Le schede Soggetto terzo, Contatto, Utente e Membro mostrano inoltre un codice QR vCard. Scansionato con uno smartphone, propone di aggiungere il contatto direttamente alla rubrica. Il contenuto vCard 3.0 codificato è mostrato in chiaro accanto al codice QR.

Anteprima dinamica

I codici QR si aggiornano in tempo reale quando si modifica:

  • la dimensione;
  • la qualità;
  • il logo;
  • i campi spuntati.

Non serve ricaricare la pagina. L'anteprima usa una richiesta AJAX inviata 300 ms dopo l'ultima modifica. Funziona su tutte le 16 schede Codice QR.

Selezione automatica dei campi predefiniti

Alla prima visualizzazione, finché non è stata salvata alcuna configurazione, il modulo spunta i campi compilati nella scheda. Il codice QR è così pertinente fin dalla prima apertura.

Salvataggio della configurazione

Spuntare o togliere la spunta ai campi, poi fare clic su SALVA. La selezione si applica a tutti gli oggetti dello stesso tipo (una configurazione per tipo di oggetto).

Scheda Codice QR — Esempi per oggetto

Fattura attiva

Scheda Codice QR di una fattura con logo integrato

Esempio su una fattura attiva: Rif., Società, Email, Telefono, Data fattura, Scadenza pagamento, Totale netto, Totale lordo e URL sono spuntati. Il logo expert_dolibarr.png è integrato al centro di entrambi i codici QR e la qualità è forzata ad Alta (H).

Prodotto

Scheda Codice QR di un prodotto

Su un prodotto, il codice QR può codificare riferimento, etichetta, prezzi, codice a barre, peso e volume: pratico per l'etichettatura a scaffale o in magazzino.

Magazzino

Scheda Codice QR di un magazzino

Utile per identificare fisicamente le ubicazioni di stoccaggio. Il campo Nome breve dell'ubicazione precisa la zona (corsia, scaffale…).

Utente

Il codice QR dell'utente codifica i recapiti professionali (login, nome, cognome, telefoni, email, indirizzo…), e il codice QR vCard li aggiunge a una rubrica. Pratico per badge o biglietti da visita interni.

Nota: la scheda Codice QR di un utente è visibile solo all'utente stesso o a chi ha il permesso di leggere le schede utenti.

Immagine di codice QR riutilizzabile (QR con logo)

Per ottenere un'immagine di codice QR con logo da riutilizzare altrove (sito web, brochure, firma e-mail), usare la scheda di configurazione QR con logo:

  1. inserire l'URL della scheda o qualsiasi altro contenuto nella zona di immissione;
  2. scegliere la dimensione e il logo, poi fare clic su GENERA;
  3. rivisualizzare il codice QR in qualsiasi momento con Selezionare un codice QR da visualizzare, stamparlo o eliminarlo.
Nota: la vecchia scheda «QR-Url» dei soggetti terzi, che il modulo non dichiarava più, è stata rimossa. Il codice QR dell'URL della scheda resta disponibile nella zona 4 di ogni scheda Codice QR.

Stampa delle etichette

Etichetta di 120 × 57 mm

Il pulsante STAMPA ETICHETTA, o un clic su un codice QR, apre una finestra di stampa in formato 120 × 57 mm, adatto alle stampanti per etichette più comuni.

L'etichetta di una scheda contiene:

  • a sinistra: il codice QR dei dati;
  • al centro: le informazioni chiave della scheda (riferimento, soggetto terzo, totale…, a seconda dell'oggetto);
  • a destra: il codice QR dell'URL della scheda.

I generatori delle schede Codici QR e QR con logo stampano allo stesso modo il codice QR appena creato.

La finestra apre automaticamente la finestra di dialogo di stampa del browser.

Nota: per una stampa ottimale su etichette adesive, impostare la stampante sul formato 120 × 57 mm ed eliminare i margini nelle opzioni di stampa del browser.

Autorizzazioni

Autorizzazioni del modulo UltimateQRcode

Il modulo definisce due autorizzazioni, da assegnare per utente o per gruppo in Utenti e gruppi:

Autorizzazione Effetto
Leggere i codici QR Mostra le schede Codice QR e i codici QR generati
Creare / Modificare i codici QR Permette di spuntare o togliere la spunta ai campi e di salvare la configurazione
Nota: senza l'autorizzazione di lettura, le schede Codice QR non sono visibili. Senza l'autorizzazione di modifica, l'utente vede i codici QR ma non può cambiare la selezione dei campi. Caricamento, rinomina ed eliminazione dei loghi sono riservati agli amministratori.

Novità e compatibilità v25

La versione 25.0.0 allinea UltimateQRcode a Dolibarr 25.

Modifica Dettaglio
Versioni minime Dolibarr 25.0.0 e PHP 8.2
PHP 8.4 e 8.5 Il modulo non genera alcun avviso di deprecazione: proprietà del descrittore allineate al core, pagina «Informazioni» senza avvisi
Schede dei pagamenti Le schede «Codice QR» dei pagamenti clienti e fornitori, che puntavano a pagine inesistenti (errore 404), sono state rimosse
Scheda QR-Url La pagina orfana della vecchia scheda QR-Url dei soggetti terzi è stata eliminata; la documentazione rimanda alla scheda QR con logo
Autorizzazioni tradotte Le due autorizzazioni sono ora mostrate nella lingua dell'utente («Leggere i codici QR», «Creare / Modificare i codici QR»)
Visualizzazione vCard Il contenuto vCard e gli indirizzi su più righe sono mostrati correttamente, senza «\n» visibile né sconfinamento della pagina
Campi aggiuntivi L'etichetta «Campo aggiuntivo» è tradotta (prima compariva «ExtraField»)
Etichette IT «Codice QR vCard» corretto in italiano
Guida utente Nuova scheda di configurazione con la guida completa nelle 5 lingue
Integrazione continua Ogni file PHP del modulo viene verificato con php -l con PHP 8.4 e 8.5

Cronologia v24

Nuove funzionalità v24

Funzionalità Descrizione
Impostazioni per scheda Dimensione, qualità e logo configurabili direttamente in ogni scheda Codice QR
Logo integrato Logo PNG al centro di ogni codice QR, su tutte le pagine
Anteprima dinamica Aggiornamento dei codici QR in tempo reale al cambio di dimensione, qualità, logo o campi spuntati
Codice QR vCard Per soggetti terzi, contatti, utenti e membri
Gestione dei loghi Caricamento, anteprima, rinomina ed eliminazione dei loghi da ogni scheda

Compatibilità con Dolibarr v24

Correzione Dettaglio
Picto del modulo Estensione .png aggiunta alla proprietà $this->picto del descrittore
Valuta getDolCurrency() al posto di $conf->currency (deprecato)
Costanti dolibarr_set_const() al posto della scrittura diretta in $conf->global

Correzioni v24

Errore Correzione
Scheda fattura non trovata Maiuscole/minuscole della chiave della scheda corrette nel descrittore
Parametro di configurazione obsoleto Rimosso «Dimensione di visualizzazione dei codici QR (in pixel)», sostituito dall'impostazione della dimensione di ogni scheda
Logo troppo grande Passaggio automatico a «senza logo» invece di un errore

Traduzioni v24

Chiavi di traduzione mancanti aggiunte nelle 5 lingue (FR, EN, DE, ES, IT): qualità, gestione del logo e tutti i tipi di oggetto.

FAQ

Il codice QR è vuoto o mostra «Nessun dato»
Nessun campo è spuntato, oppure i campi spuntati sono vuoti nella scheda. Spuntare almeno un campo compilato e fare clic su SALVA.
L'etichetta non viene stampata nella dimensione corretta
Verificare che il formato carta della stampante sia impostato su 120 × 57 mm ed eliminare i margini nelle opzioni di stampa del browser.
I campi aggiuntivi non compaiono
Vengono proposti solo i campi aggiuntivi compilati nella scheda. Si definiscono nella configurazione del modulo interessato (ad esempio Soggetti terzi → Attributi aggiuntivi).
Il codice QR con logo non è leggibile
Il logo copre una superficie eccessiva. Usare un logo più piccolo, idealmente quadrato. La qualità è già forzata ad Alta (H) non appena si seleziona un logo.
Il codice QR compare senza logo anche se ne ho selezionato uno
Il logo è troppo grande per il contenuto codificato: il modulo genera allora il codice QR senza logo. Provare con un logo più piccolo o spuntare meno campi.
I codici QR non si aggiornano quando cambio le impostazioni
L'anteprima dinamica richiede JavaScript. Verificare che nessun blocco degli script sia attivo.
La scheda Codice QR non compare su alcune schede
Verificare che il modulo sia attivato, che lo sia anche il modulo Dolibarr dell'oggetto e che l'utente abbia l'autorizzazione Leggere i codici QR. Dopo un aggiornamento, disattivare e riattivare UltimateQRcode.
Dov'è finita la scheda QR-Url dei soggetti terzi?
È stata rimossa. Il codice QR dell'URL della scheda si trova nella scheda Codice QR (zona 4), e la scheda di configurazione QR con logo crea immagini riutilizzabili.

Vedere anche

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