View source for Module Ultimateqrcode IT

<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
[[fr:Module_Ultimateqrcode_FR]]
[[en:Module_Ultimateqrcode_EN]]
[[de:Module_Ultimateqrcode_DE]]
[[es:Module_Ultimateqrcode_ES]]
<!-- END interlang links -->

[[Category:Moduli aggiuntivi]]
[[Category:Ultimateqrcode]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informazioni=
{{TemplateModuleInfo
|modulename=Ultimateqrcode
|editor=Atoo.Net
|web=https://www.atoo-net.com
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|status=stable
|prerequisites=PHP 8.2 come minimo, estensione PHP GD
|minversion=25.0.0
|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 =

# Scaricare l'archivio <code>module_ultimateqrcode-25.0.x.zip</code> dal [https://www.dolistore.com DoliStore]
# 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''' nell'elenco e attivarlo
# 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.

----

= 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) ==

[[File:Ultimateqrcode-v25-admin-qrcodes-it.png|center|900px|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.

{| class="wikitable"
! 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:<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
|-
| '''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|Stampa delle etichette]])
|}

== Scheda «QR con logo» ==

[[File:Ultimateqrcode-v25-admin-qrwithlogo-it.png|center|900px|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.

{| class="wikitable"
! 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 <code>documents/mycompany/logos/</code>, 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» ==

[[File:Ultimateqrcode-v25-admin-guide-it.png|center|900px|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:

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

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

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

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

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

[[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]]

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:

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

[[File:Ultimateqrcode-v25-contact-vcard-it.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.

=== 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 ==

[[File:Ultimateqrcode-v25-invoice-qrcode-it.png|center|900px|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 ==

[[File:Ultimateqrcode-v25-product-qrcode-it.png|center|900px|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 ==

[[File:Ultimateqrcode-v25-stock-qrcode-it.png|center|900px|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''':

# 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.

: '''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 =

[[File:Ultimateqrcode-v25-label-print-it.png|center|466px|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 =

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

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

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

{| 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"
! 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 ===

{| class="wikitable"
! Correzione !! Dettaglio
|-
| '''Picto del modulo''' || Estensione <code>.png</code> aggiunta alla proprietà <code>$this->picto</code> del descrittore
|-
| '''Valuta''' || <code>getDolCurrency()</code> al posto di <code>$conf->currency</code> (deprecato)
|-
| '''Costanti''' || <code>dolibarr_set_const()</code> al posto della scrittura diretta in <code>$conf->global</code>
|}

=== Correzioni v24 ===

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

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