Module Ultimateqrcode IT
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
- Scaricare l'archivio
module_ultimateqrcode-25.0.x.zipdal DoliStore - 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 ottenerehtdocs/custom/ultimateqrcode/ - Cercare il modulo UltimateQRcode nell'elenco e attivarlo
- 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)
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»
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»
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.
Zona 2 — Tabella di selezione del logo
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
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)
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
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
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
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
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
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.