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	Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-07-25
Note / Nota	Compatibile con Dolibarr v24

Installazione

Scaricare il modulo e depositarlo nella cartella htdocs/custom/ultimateqrcode/
In Dolibarr: Home → Configurazione → Moduli/Applicazioni
Cercare il modulo UltimateQRcode nella sezione Atoo-Net e attivarlo
I permessi devono essere configurati per gruppo di utenti (vedere Diritti e permessi)

Configurazione del modulo

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

La pagina di configurazione è composta da tre schede.

Scheda «Codici QR» (generatore libero)

Questa scheda offre un generatore di codice QR su richiesta:

Campo	Descrizione
Data	Il contenuto da codificare: URL, indirizzo e-mail, testo libero, vCard, ecc.
ECC	Livello di correzione degli errori: • L (≈7% — il più piccolo): dimensione minima • M (≈15%): uso comune • Q (≈25%): buona resistenza • H (≈30% — il migliore): molto resistente (consigliato con logo)
Size	Dimensione del punto (da 1 a 10 pixel per modulo del codice QR)
Pulsante GENERATE	Genera e visualizza immediatamente il codice QR

Cliccare su Like this nel testo di aiuto per vedere un esempio di generazione.

Scheda «QR con logo»

Questa scheda consente di creare un codice QR con un logo inserito al centro:

Campo	Descrizione
Data	URL o contenuto da codificare (predefinito: https://www.atoo-net.com/)
Dimensione	Da 1 a 10 — controlla la risoluzione dell'immagine generata
Seleziona file	Logo PNG da incorporare al centro del codice QR
Pulsante GENERATE	Genera il codice QR con il logo e lo salva
Seleziona codice QR da visualizzare	Selezione tra i codici QR già generati per visualizzarli
Pulsante MOSTRA	Mostra il codice QR selezionato
Icona Cestino	Elimina il file QR selezionato (con conferma)

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

Scheda «Informazioni sul modulo»

Mostra informazioni sulla versione del modulo, sull'autore e il link alla documentazione.

Utilizzo nelle schede

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

Oggetto	Scheda/e aggiunta/e
Cliente/Fornitore	Codice QR + QR-Url (schede separate)
Contatto	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 cliente	Codice QR
Fattura fornitore	Codice QR
Contratto	Codice QR
Intervento	Codice QR
Progetto	Codice QR
Aderente (associazione)	Codice QR
Gruppo di utenti	Codice QR
Utente	Codice QR

Struttura comune della scheda Codice QR

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

Zona 1 — Barra delle impostazioni

Pannello impostazioni: dimensione, qualità ECC e selezione del logo

Nella parte superiore di ogni scheda di codice QR, una barra delle impostazioni consente di configurare:

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.
Qualità (ECC)	Livello di correzione degli errori: Basso (L ≈ 7%), Medio (M ≈ 15%), Quartile (Q ≈ 25%), Alto (H ≈ 30%).
Logo	Logo PNG da incorporare al centro del codice QR, selezionabile tra i loghi caricati.

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.

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

Zona 2 — Tabella di selezione del logo

La tabella elenca i loghi disponibili nella cartella documents/mycompany/logos/:

Colonna	Descrizione
Radio	Pulsante di opzione per selezionare il logo (o «Nessun logo»)
Logo	Nome del file PNG con icona di anteprima
Dimensione	Dimensione del file in byte
Data	Data dell'ultimo caricamento
Anteprima	Icona a lente per l'anteprima del logo
Azioni	Icone per rinominare ed eliminare

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

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.

Zona 3 — Codice QR con dati configurabili

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

La colonna sinistra contiene la casella di controllo
La colonna centrale mostra l'etichetta del campo e il suo valore attuale (in grigio se non selezionato)
La colonna destra mostra il codice QR generato (con o senza logo, a seconda della selezione)

I campi disponibili dipendono dall'oggetto:

Oggetto	Campi disponibili
Cliente/Fornitore	Azienda, Indirizzo, CAP, Città, Paese, Telefono, E-mail, URL + campi aggiuntivi
Prodotto	Rif., Descrizione, Dettaglio, Prezzo netto, Prezzo lordo, Codice a barre, Peso, Volume, URL + campi aggiuntivi
Magazzino	Etichetta, Nome breve dell'ubicazione, Descrizione, Indirizzo, CAP, Città, Paese, URL + campi aggiuntivi
Utente	Login, Nome, Cognome, Telefono, Cellulare, E-mail, Indirizzo, CAP, Città, Paese, URL + campi aggiuntivi
Contatto	Titolo, Nome, Cognome, Azienda, Funzione, Telefono, Cellulare, E-mail, Indirizzo, ecc.
Fattura	Rif., Rif. cliente, Azienda, E-mail, Telefono, Data fattura, Scadenza, Totale netto, Totale lordo, Nota pubblica, URL
(altri)	Campi specifici dell'oggetto

Nota: I campi aggiuntivi (attributi complementari) definiti in Dolibarr vengono aggiunti automaticamente all'elenco dei campi disponibili.

Il codice QR mostrato è cliccabile: un clic apre la finestra di stampa etichette.

Zona 4 — Codice QR dell'URL della scheda

La zona inferiore mostra:

L'etichetta URL della scheda [Oggetto]
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)

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

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.

Anteprima in tempo reale

[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

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.

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

Scheda Codice QR — Esempi per oggetto

Fattura cliente

[Novità v24]

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

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.

Magazzino

Utile per l'etichettatura fisica delle ubicazioni di magazzino. Il campo Nome breve dell'ubicazione consente di precisare la zona di stoccaggio.

Utente

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 dell'utente è visibile solo all'utente stesso o agli utenti con permesso di lettura sulle schede utente.

Scheda QR-Url (solo Clienti/Fornitori)

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.

Funzionalità:

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 etichette

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 include:

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.

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.

Diritti e permessi

Il modulo definisce due livelli di permessi, assegnabili per gruppo di utenti da Configurazione → Utenti e gruppi:

Permesso	Descrizione	Effetto
Read qrcode outcomes	Lettura dei codici QR	Consente di visualizzare 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

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.

Novità e compatibilità con v24

[Novità v24] La versione 24 del modulo UltimateQRcode introduce i seguenti miglioramenti:

Nuove funzionalità

Funzionalità	Descrizione
Impostazioni per pagina	Dimensione, qualità ECC e logo configurabili direttamente su ogni pagina di codice QR della scheda
Logo incorporato	Possibilità di incorporare un 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)
Codice QR vCard	Codice QR vCard per contatti, utenti, clienti/fornitori e aderenti, per aggiungerli direttamente alla rubrica telefonica
Gestione dei loghi	Caricamento, anteprima, rinomina ed eliminazione dei loghi direttamente dall'interfaccia di ogni scheda

Compatibilità con Dolibarr v24

Correzione	Dettaglio
Icona del modulo	Aggiunta dell'estensione `.png` nella proprietà `$this->picto` del descrittore del modulo, in conformità con l'avviso di Dolibarr v23+.
Valuta	Sostituzione di `$conf->currency` (obsoleto) con `getDolCurrency()`.
Costanti	Sostituzione dell'assegnazione diretta `$conf->global->XXX = value` (obsoleta) con `dolibarr_set_const()`.

Correzioni di bug

Bug	Correzione
Scheda fattura non trovata	Correzione della distinzione tra maiuscole e minuscole della chiave della scheda nel descrittore del modulo.
Parametro di amministrazione obsoleto	Rimozione del parametro «Dimensione di visualizzazione dei codici QR (in pixel)», diventato ridondante con l'impostazione della dimensione per pagina.
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.

Traduzioni

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.

FAQ

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.

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.

I campi aggiuntivi non compaiono: Gli attributi complementari devono essere definiti in Configurazione → Attributi complementari per l'oggetto in questione.

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 codice QR viene mostrato senza logo anche se ne ho selezionato uno: 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.

I codici QR non si aggiornano quando modifico le impostazioni: 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.

La scheda codice QR non compare su alcune schede: Verificare che il modulo sia attivato e che l'utente disponga del permesso Read qrcode outcomes.