QR code WordPress: redirect, pagine con allegati e statistiche di scansione

La sesta puntata di «Faccio cose, vedo gente»: il plugin per creare un QR code WordPress che si cambia dopo la stampa, con redirect, pagine con allegati, immagini SVG e PNG e statistiche di scansione giorno per giorno.

Copertina della sesta puntata di Faccio cose, vedo gente: il plugin per QR code WordPress con il riquadro del codice QR in wp-admin

Sesta puntata di Faccio cose, vedo gente, la serie sui plugin WordPress fatti su misura. Questa volta tocca a un plugin usato da diversi clienti, che ho rivisitato da poco aggiornando la libreria che disegna i codici e il sistema delle statistiche: serve a creare un QR code WordPress che si può cambiare dopo la stampa e di cui si contano le scansioni, giorno per giorno.

Ti racconto come funziona il plugin per QR code WordPress dal punto di vista di chi lo usa: come si crea un codice, le tre cose che può fare alla scansione, come si scaricano SVG e PNG, cosa mostrano le statistiche e cosa non contano di proposito e, come in ogni puntata, cosa manca ancora. Le schermate vengono da un sito di prova che ho preparato con Claud.ia usando wp-env, con codici, allegati e numeri tutti inventati.



QR code WordPress senza ristampare

Un QR code stampato su un menu, un volantino o un cartello non si cambia più. L’indirizzo a cui porta un QR code WordPress sì: il plugin codifica sempre un URL breve del tuo sito e decide poi cosa mostrare.

Il problema di ogni codice stampato è che l’indirizzo lo scrivi nel quadratino una sola volta. Se il PDF del menu cambia nome, se la promozione finisce, se la pagina viene spostata, i codici già appesi ai tavoli continuano a portare dove portavano. Il plugin risolve la cosa all’origine: il codice contiene sempre e solo un indirizzo breve del tuo sito, del tipo /qr/k7m2xp/, e la destinazione si imposta e si cambia in wp-admin quando vuoi, senza toccare i cartelloni.

Con un QR code WordPress fatto così sai anche quante persone lo hanno usato, puoi dirottarlo su una pagina nuova e ti accorgi che quello sul retro del volantino non lo inquadra nessuno. Il plugin richiede WordPress 6.4 e PHP 8.2 e non ha bisogno di estensioni PHP particolari.

Creare un codice in pochi clic

I codici sono un tipo di contenuto a parte, «Codici QR», con un titolo interno, un codice casuale di sei caratteri e un elenco con anteprima, indirizzo, modalità e conteggi.

In wp-admin il plugin per QR code WordPress aggiunge la voce Codici QR. Il titolo serve solo a te, per riconoscere il codice («Menu dei tavoli», «Stand in fiera»): al primo salvataggio il plugin assegna come slug un codice casuale di sei caratteri, ed è l’ultimo pezzo dell’indirizzo pubblico. L’alfabeto esclude i caratteri che si confondono, come lo zero e la o, l’uno, la l e la i, perché un codice può capitare di leggerlo o dettarlo a voce. Sei caratteri su trentuno simboli fanno quasi novecento milioni di combinazioni, abbastanza per non farsi indovinare con facilità.

L’elenco mostra l’anteprima del QR, l’indirizzo breve, la modalità e due colonne di numeri, Visite e Unici. Il codice funziona solo a contenuto pubblicato, e se cambi lo slug a mano cambia anche il disegno del quadratino: quello già stampato smetterebbe di funzionare, quindi conviene lasciarlo com’è.

Redirect, pagina del tema o minimale

Alla scansione il QR code WordPress può mandare altrove con un redirect, mostrare una pagina nel tema del sito o una pagina minimale con solo testo e allegati. La modalità si cambia in qualsiasi momento.

Nel riquadro Cosa succede alla scansione si sceglie tra tre modalità. Con il redirect chi inquadra il QR code WordPress viene mandato a un altro indirizzo, esterno (https://…) oppure interno, scrivendo solo il percorso, come /fiera-di-primavera. La risposta è un 302, perché la destinazione si può modificare e il browser non deve ricordarsela: un 301 resterebbe in cache e il codice porterebbe per sempre alla vecchia pagina.

Se l’indirizzo manca o non è valido, il plugin ripiega sulla pagina del tema, e gli schemi diversi da http e https vengono scartati al salvataggio. Con la pagina del tema il QR apre una pagina nel design del sito, con il testo scritto nell’editor e l’elenco degli allegati: è la scelta giusta quando il codice deve sembrare parte del sito. Il tema può personalizzarla con un file single-qr_code.php, altrimenti usa il normale single.php.

Per provare il redirect senza telefono basta un curl -I sull’indirizzo breve: risponde con il 302, la destinazione nell’header Location, il noindex e gli header che vietano la cache. Curl è tra i client che il plugin non conta, quindi la prova non sporca le statistiche.

curl -I https://sito.example/qr/k7m2xp/

HTTP/1.1 302 Found
Cache-Control: no-cache, must-revalidate, max-age=0, no-store, private
X-Robots-Tag: noindex, nofollow
Location: https://sito.example/fiera-di-primavera

Allegati e pagina minimale da telefono

La pagina minimale mostra solo titolo, testo e allegati, senza header e footer del tema: è pensata per chi inquadra il codice dal telefono e vuole il PDF, non il sito.

Pensa al menu sul tavolo di un ristorante, o al manuale di un prodotto: chi inquadra un QR code WordPress vuole il file, subito. Nel riquadro scegli gli allegati dalla libreria media e il plugin li elenca come link, ciascuno con il tipo e il peso del file («PDF · 77,5 KB»), sotto il testo scritto nell’editor. La pagina minimale salta header e footer del tema ma carica comunque gli stili dei blocchi, quindi il testo si impagina come nel resto del sito.

Se il tema ha esigenze sue, basta copiare templates/minimal.php in wpqr/minimal.php dentro il tema per sostituirla. Nelle schermate trovi il menu d’autunno e la lista degli allergeni di un ristorante inventato: il testo, due PDF e nient’altro, leggibili su uno schermo da 390 pixel.

SVG e PNG senza GD né Imagick

Il QR code WordPress si scarica in SVG per la stampa e in PNG per tutto il resto, da un indirizzo pubblico che puoi usare anche per incorporare il codice in un’altra pagina.

Dal riquadro Codice QR copi l’URL e scarichi SVG o PNG a 1024 pixel. Dietro c’è un endpoint, /qr-image/codice.svg oppure .png, con due parametri: size, il lato in pixel da 64 a 4096, e download=1, che forza il salvataggio. Il PNG prende il multiplo intero di moduli più vicino per difetto, così i quadratini restano nitidi invece di sfocarsi per un ridimensionamento a metà pixel. La correzione degli errori è di livello M (il codice si legge anche con circa il 15 per cento rovinato) e attorno c’è il margine bianco di quattro moduli che i lettori richiedono.

La libreria è chillerlan/php-qrcode alla versione 6, solo PHP: calcola la matrice e disegna l’SVG. Il PNG lo scrive il plugin a partire dalla matrice, come immagine a un bit compressa con zlib, quindi non servono né GD né Imagick. Ho riletto un PNG generato così con un lettore di QR esterno e restituisce l’indirizzo giusto.

Il QR di un contenuto ancora in bozza si vede solo a chi può modificarlo, per tutti gli altri è un 404. Per incorporare il QR in un’altra pagina, o in una newsletter, basta un’immagine che punti all’indirizzo /qr-image/codice.svg: la risposta ha una cache pubblica di un giorno, quindi non pesa sul sito.

Statistiche giorno per giorno

Ogni scansione di un QR code WordPress viene registrata prima del redirect o della pagina. Nel riquadro Statistiche trovi i totali, il grafico degli ultimi trenta giorni e la tabella giornaliera.

Le statistiche del QR code WordPress stanno in due tabelle: una con una riga per codice e giorno, con visite e visitatori unici del giorno, e una con i visitatori già visti per codice e giorno, che serve a capire se una visita è di una persona nuova. Le scritture sono atomiche, un INSERT IGNORE e un ON DUPLICATE KEY UPDATE, quindi due scansioni quasi simultanee non si pestano i piedi e nessuna si perde.

Il riquadro Statistiche mostra cinque numeri (visite totali, visitatori unici, oggi, ultimi sette e ultimi trenta giorni), il grafico a barre degli ultimi trenta giorni e la tabella giorno per giorno, con i soli giorni che hanno avuto visite, fino a un anno indietro. Per il cambio di giorno vale il fuso orario impostato nel sito. Nella schermata il picco di qualche settimana fa è il codice dello stand in fiera, che nel resto dell’anno fa pochissime visite.

Nel totale gli unici sono indirizzi IP distinti, mentre nelle righe giornaliere sono quelli del giorno. La somma delle righe può quindi superare il totale, perché chi torna in un altro giorno viene contato di nuovo. Nei dati di prova sono 190 visitatori unici su 375 visite.

Chi non viene contato, e perché

Le statistiche del QR code WordPress non contano bot, anteprime dei link, richieste HEAD e le visite di chi può modificare il codice. L’indirizzo IP non si salva mai: resta solo un hash.

Un contatore di scansioni per un QR code WordPress serve solo se i numeri sono puliti. Il plugin salta le richieste HEAD, quelle senza user agent, i bot e i crawler, le anteprime che WhatsApp, Telegram e Facebook generano quando incolli un link, e le visite di chi può modificare quel codice, perché altrimenti ogni prova in wp-admin finirebbe nelle statistiche. Per cambiare queste regole c’è il filtro wpqr_should_track.

Il visitatore unico si riconosce da un hash dell’indirizzo IP: un HMAC-SHA256 con il salt del sito, troncato a 32 caratteri. L’IP non viene mai salvato e dall’hash non si risale all’IP. L’hash però è stabile, quindi lo stesso visitatore resta riconoscibile anche in giorni diversi e per questo resta un dato personale pseudonimizzato: va citato nell’informativa privacy del sito. Il plugin legge solo REMOTE_ADDR, perché gli header come X-Forwarded-For si falsificano; dietro a un proxy fidato si usa il filtro wpqr_client_ip.

Le pagine dei codici sono noindex ed escluse dalle cache di pagina, con DONOTCACHEPAGE, gli header no-cache e l’hook di LiteSpeed Cache: una pagina servita dalla cache non passerebbe dal plugin e la scansione non verrebbe contata.

Cosa manca ancora

Al plugin per QR code WordPress mancano una pagina di opzioni, una pulizia dei dati vecchi e una suite di test, e nell’editor a blocchi le impostazioni del QR stanno in un pannello che si apre solo se lo cerchi.

Rileggendo il codice per questo articolo e aprendo il plugin con un utente nuovo, ho segnato quello che sistemerei. La prima cosa si nota subito: nell’editor a blocchi i riquadri «Cosa succede alla scansione» e «Statistiche» stanno nel pannello Meta Box in fondo alla pagina, che per chi non l’ha mai aperto è chiuso. Per gli screenshot l’ho dovuto aprire a mano, e un cliente che cerca dove scegliere il redirect si trova davanti una pagina con un titolo e «Digita / per scegliere un blocco». Il riquadro principale va spostato nella barra laterale.

La seconda riguarda i dati: la tabella dei visitatori cresce di una riga per codice, giorno e visitatore, e per ora nessuno la ripulisce, quindi serve una pulizia periodica con WP-Cron oltre una certa soglia. Poi gli unici si contano per IP: a una fiera, con il Wi-Fi dello stand da cui escono tutti dallo stesso indirizzo, dieci persone possono diventare un solo visitatore.

Mancano la pagina di opzioni (titolo e testi della pagina minimale, titolo degli allegati, colori, modalità predefinita), i test automatici con PHPUnit, un uninstall.php che alla rimozione elimini tabelle e codici, e le personalizzazioni del QR: colori, logo e altre destinazioni oltre all’indirizzo, come telefono, vCard e Wi-Fi. Quello che rifarei uguale è il quadratino che porta sempre a un indirizzo breve del sito, il 302 e le statistiche che non salvano l’IP.

Un quadratino con tante cose da dire

Un indirizzo breve nel quadratino, la destinazione in wp-admin e i numeri delle scansioni al loro posto: un QR code WordPress che si governa senza ristampare nulla.

In un QR code WordPress fatto così la parte stampata e la parte che cambia sono separate: il quadratino resta com’è, tutto il resto si decide dopo, con i numeri davanti. Se hai cartelli, menu, volantini o prodotti con un codice sopra e non sai se qualcuno li inquadra, o dove portano da quando la pagina è stata spostata, prenota una call: lo guardiamo insieme.

Le altre puntate sono raccolte nel tag Faccio cose, vedo gente: le prenotazioni al posto di Calendly, i listini prezzi per cliente, il passaggio da WPBakery a Gutenberg, il multi magazzino e le aree riservate.

E tu, dove metteresti il primo codice: sul menu, sul biglietto da visita o sul furgone? Raccontamelo nei commenti, e se hai un amico che ristampa i cartelli ogni volta che cambia una pagina, mandagli questo articolo prima che ordini altri cento volantini.

Domande frequenti

Come si crea un QR code WordPress con questo plugin?

In wp-admin si apre la voce Codici QR, si dà un titolo interno, si sceglie cosa succede alla scansione (redirect, pagina del tema o pagina minimale) e si pubblica. Il plugin assegna un codice casuale di sei caratteri e mostra il QR da scaricare in SVG o PNG.

Un QR code WordPress si può cambiare dopo averlo stampato?

Sì: il disegno contiene sempre l’indirizzo breve del sito, del tipo /qr/codice/, e la destinazione si modifica in qualsiasi momento. Basta non cambiare lo slug del codice, perché cambierebbe anche il disegno.

Il plugin conta le scansioni di un QR code WordPress?

Sì: registra visite e visitatori unici giorno per giorno e li mostra con totali, grafico degli ultimi trenta giorni e tabella. Non conta bot, anteprime dei link, richieste HEAD e le visite di chi può modificare il codice.

Le statistiche dei QR code richiedono l’informativa privacy?

Conviene citarle. L’indirizzo IP non viene salvato, ma l’hash che lo sostituisce è stabile nel tempo e riconosce lo stesso visitatore in giorni diversi, quindi resta un dato personale pseudonimizzato da indicare nell’informativa del sito.

Servono GD o Imagick per generare un QR code WordPress?

No: la matrice e l’SVG li calcola la libreria PHP chillerlan/php-qrcode e il PNG lo scrive il plugin a partire dalla matrice. Servono solo PHP 8.2 e WordPress 6.4.

Cosa vedono le persone se il redirect non ha un indirizzo valido?

Si apre la pagina del tema, con il testo scritto nell’editor e gli eventuali allegati.

Posso cambiare l’aspetto della pagina minimale?

Sì: si copia il file templates/minimal.php del plugin in wpqr/minimal.php dentro il tema e lo si modifica a piacere. La pagina carica comunque gli stili dei blocchi di WordPress.

Maurizio Pelizzone

Scritto da

Maurizio Pelizzone

Sono Maurizio Pelizzone, sviluppatore WordPress da oltre vent'anni e consulente di intelligenza artificiale a Torino, co-fondatore di Mavida. Realizzo plugin e integrazioni su misura per WordPress e WooCommerce, automazioni dei processi con n8n e agenti AI, e tengo corsi e workshop su Claude Code, prompt engineering e vibe coding, in presenza a Torino o da remoto. Sono speaker ai WordCamp e autore della guida gratuita in italiano a Claude Code; se vuoi parlarmi di un progetto puoi prenotare una call conoscitiva.

Scopri chi sono

Nessun commento

Scrivi il primo.

Scrivi un commento

Nessun commento

Scrivi un commento

I commenti sono moderati: il tuo comparirà dopo la lettura. L'email non viene pubblicata. I campi con * sono obbligatori.