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