Versione: 1.2.0 · Autore: Davide Bertolino · Licenza: GPL v2 · Richiede: WordPress 5.8+, PHP 7.4+

Un plugin WordPress che genera QR code in formato PNG con correzione errori alta e la possibilità di inserire un logo centrale. Si usa da pannello admin o da shortcode in qualsiasi pagina. I QR code vengono cachati per 24 ore e ripuliti automaticamente dopo 30 giorni. Niente cloud, niente API esterne, niente limiti nascosti.

---

Cosa fa

? Generazione QR Code

Il cuore del plugin. Genera QR code PNG a partire da qualsiasi URL o testo.

• Correzione errori alta (livello H) — il QR resta leggibile anche con un logo sovrapposto
• Dimensione configurabile da 100 a 1000 pixel
• Output PNG ottimizzato, servito dalla cartella uploads di WordPress
• Caching automatico via transient — stesso URL + dimensione = stesso file, nessuna rigenerazione

? Logo Centrale

Inserisci il tuo logo al centro del QR code. Il plugin lo ridimensiona, aggiunge uno sfondo bianco arrotondato e lo sovrappone al codice.

• Formati accettati: PNG, JPG, GIF, WebP
• Limite: 2 MB
• Validazione MIME reale con finfo — non ci fidiamo dell’estensione dichiarata dal browser
• Sfondo bianco con bordi arrotondati attorno al logo

?️ Sicurezza

Ogni punto di ingresso è protetto. Non è un “genera e spera”.

• Nonce WordPress dedicati per admin e frontend (separati)
• Capability check manage_options per le azioni admin
• Rate limiting: max 10 richieste per IP ogni 60 secondi sulle chiamate pubbliche
• Directory listing disabilitato via .htaccess generato automaticamente
• Sanitizzazione input e output escaping su tutti i dati

⚙️ Shortcode

Due shortcode per due usi diversi.

• [dbqr_generator] — form interattivo AJAX con upload logo, anteprima, download
• [dbqr_code url="..."] — QR code statico inline, cachato 24h
• Retrocompatibilità con i vecchi shortcode [qrcode_generator] e [qrcode]

? ♿ Accessibilità

Dalla v1.2.0 il plugin segue le linee guida WCAG 2.1 AA.

• aria-required, aria-describedby su tutti i campi form
• role="alert" e aria-live per i messaggi dinamici (errori e successo)
• Focus management dopo generazione o errore
• Touch target minimo 44×44px per bottoni e link
• focus-visible con outline ad alto contrasto
• Supporto prefers-reduced-motion

? Manutenzione automatica

I file QR generati si accumulano. Il plugin ci pensa da solo.

• Cron WordPress giornaliero: elimina i file PNG più vecchi di 30 giorni
• Il cron viene registrato all’attivazione e rimosso alla disattivazione
• Caching transient 24h evita rigenerazioni inutili

---

Quanto costa?

Funzionalità	Inclusa
Generazione QR code con logo	✅ Gratis
Shortcode frontend interattivo	✅ Gratis
Pannello admin	✅ Gratis
Rate limiting e sicurezza	✅ Gratis
Caching e pulizia automatica	✅ Gratis
Accessibilità WCAG 2.1 AA	✅ Gratis
Versione “Pro”	❌ Non esiste

---

Installazione

1. Scarica lo ZIP dalla sezione in alto o dalla pagina GitHub Releases
2. Vai su Plugin → Aggiungi nuovo → Carica plugin nel pannello WordPress
3. Seleziona lo ZIP e clicca Installa ora
4. Attiva il plugin

Il plugin compare come QR Code nel menu laterale di WordPress. Da lì puoi generare QR code manualmente. Per il frontend, inserisci lo shortcode [dbqr_generator] in qualsiasi pagina.

---

Utilizzo shortcode

Generatore interattivo

[dbqr_generator]
[dbqr_generator title="Crea il tuo QR" show_logo="no"]

Attributo	Default	Descrizione
title	Genera il tuo QR Code	Titolo sopra il form
show_logo	yes	Mostra/nasconde il campo logo

QR code statico

[dbqr_code url="https://example.com"]
[dbqr_code url="https://example.com" size="400"]

Attributo	Default	Note
url	(obbligatorio)	URL o testo da codificare
size	300	Dimensione in pixel (100–1000)

---

Struttura del progetto

qrcode-generator-plugin/
├── .github/workflows/release.yml
├── assets/
│   ├── css/frontend.css
│   └── js/
│       ├── admin.js
│       └── frontend.js
├── qrcode-generator.php
├── composer.json
├── LICENSE
├── vendor/
├── .gitignore
└── README.md

---

Changelog

1.2.0

• Refactoring completo — prefisso dbqr_ applicato a costanti, classi, hook, AJAX, transient, CSS, JS
• Header plugin — Author, Author URI, Plugin URI, Text Domain corretti
• CSS/JS estratti — stili e script in file separati, caricati solo dove servono
• ? Accessibilità WCAG 2.1 AA — ARIA, focus management, touch target, reduced motion
• Localizzazione — stringhe utente con __() e text domain
• Retrocompatibilità — shortcode [qrcode] e [qrcode_generator] mantenuti

1.1.0

• Fix critico — nonce AJAX, logoPath, validazione MIME
• Aggiunto — rate limiting, caching, pulizia cron, protezione directory

1.0.0

Release iniziale.

---

Licenza

GPL v2 o successiva. Sei libero di utilizzare, modificare e distribuire questo plugin.

---

Autore

Davide Bertolino — davidebertolino.it — info@davidebertolino.it

---

Hai suggerimenti o hai trovato un bug? Contattami!