ItaliaWP3
Tema WordPress per la Pubblica Amministrazione
Guarda la demo | Scarica il tema | Pagina del tema
ItaliaWP3 è un tema basato su Bootstrap Italia utilizzabile per i siti della Pubblica Amministrazione, sviluppato per WordPress (CMS open-source).
ItaliaWP3 utilizza i componenti del Prototipo per siti PA di AgID delle linee guida di design dell'Agenzia per l'Italia digitale rilasciate dal Team per la trasformazione digitale e su Bootstrap Italia.
ItaliaWP3 è una soluzione open-source e gratuita, ideale per comuni, istituti e piccoli enti pubblici in genere che hanno scelto di utilizzare WordPress per il proprio sito internet.
È la riscrittura completa di ItaliaWP2, da cui eredita l'impianto e le convenzioni, a sua volta evoluzione di ItaliaWP (versione 1). Rispetto alla versione 2 cambiano il framework — Bootstrap Italia 2.x su Bootstrap 5 — e l'impostazione dell'accessibilità, che qui è uno strumento di lavoro e non una dichiarazione.
Installare ItaliaWP3:
- Scaricare il file .zip in locale
- Aggiungere un nuovo tema nella sezione "Aspetto" > "Temi"
- Selezionare "Aggiungi nuovo" e successivamente "Carica tema"
- Scegliere il file .zip scaricato in precedenza, senza decomprimerlo e cliccare "Installa ora"
- Selezionare "Attiva" per poter utilizzare il tema
Requisiti
| WordPress | 6.0 o superiore |
| PHP | 8.0 o superiore (testato su 8.3) |
| Bootstrap Italia | 2.18.3, incluso nel tema |
Il tema è compatibile con l'editor a blocchi Gutenberg. Chi preferisce l'editor classico può installare il plugin Classic Editor.
In caso di utilizzo del Tema Child:
Ripetere la procedura precedente ma con il file .zip del Tema Child, successivamente configurare il Tema Child lasciando italiawp3 con la configurazione iniziale.
Configurare ItaliaWP3:
- Creare 2 pagine per "Home" e "Articoli"
- In "Impostazioni" > "Lettura" selezionare "Una pagina statica"
- Assegnare le pagine appena create rispettivamente ad "Homepage" e "Pagina articoli"
- Impostare i dati di contatto e i dettagli nella sezione "Dettagli" (qui si imposta anche, facoltativamente, il Measurement ID di Google Analytics 4)
- Attivare le sezioni della "Home" in "Aspetto" > "Personalizza" > "Sito & Homepage"
- In "Aspetto" > "Menu" creare un nuovo Menu ed inserirlo nella posizione "Menu Principale"
- [Facoltativo] Installare (e poi attivare) i plugin consigliati in "Aspetto" > "Installa plugin" (la voce compare finché i plugin consigliati non sono installati)
Principali caratteristiche di ItaliaWP3:
- WordPress: è realizzato per l'ultima versione di WordPress disponibile in Italiano
- Responsive: si adatta ad ogni tipo di dispositivo (desktop, tablet e mobile) mantenendo le funzionalità
- Pagina "ACCESSIBILITÀ" nel backend: controlla il markup delle pagine pubbliche, misura i contrasti reali sul sito renderizzato, scandisce contenuti, immagini e PDF, e tiene il registro delle verifiche manuali con esito e data — il materiale su cui si fonda la dichiarazione di accessibilità da pubblicare su form.agid.gov.it
- I controlli automatici coprono circa un terzo dei criteri: navigazione da tastiera e screen reader non sono automatizzabili da nessuno strumento e restano una verifica umana. Il pannello lo dichiara e non mostra mai "tutto verde"
- Pagina "DETTAGLI" nel backend: è possibile inserire e modificare facilmente le informazioni di contatto, i link dei profili social (Facebook, Twitter, YouTube, Instagram, LinkedIn, Telegram e WhatsApp), il numero di ultimi articoli in homepage, gli ID delle pagine Privacy, Note legali e Contatti, il link alla dichiarazione di accessibilità e il Measurement ID di Google Analytics 4
- Il campo Analytics è facoltativo: se lasciato vuoto non viene caricato alcuno script di tracciamento e non parte alcuna richiesta verso terze parti
- Se mancano i riferimenti obbligatori per un sito della PA (dichiarazione di accessibilità, informativa privacy, note legali), un avviso in bacheca li elenca finché non vengono compilati
- 11 posizioni del menu: menu principale, menu in alto e 9 per i box servizi (divisi in 3 tipologie)
- Nei menu Box Servizi è possibile inserire delle immagini utilizzando i Link personalizzati e inserendo direttamente il tag html < img src="URL" > nel Testo del link
- 5 aree widget: Footer Colonne, Sidebar Pagine (disattivabile scegliendo l'apposito Template), Sidebar Articoli, Sezione Notifica e Sezione Credits
- Logo, titolo e descrizione: personalizzazione del logo, del titolo, della denominazione e dell'icona del sito direttamente dalla personalizzazione del tema
- Immagini e Gallerie Fotografiche: ritaglio e sistemazione automatica delle immagini principali degli articoli, gestione grafica secondo le linee guida delle singole immagini (disattivabile) e gallerie caricate negli articoli o nelle pagine. Gestione di Gallerie Fotografiche esterne tramite Custom Post Type
- Liste Allegati: gestione degli allegati (e relative liste) tramite Plugin esterno di cui si richiede l'installazione al momento dell'attivazione del tema
- Integrazione con il Customizer (Personalizza) di WordPress:
- Sezione "Sito & Homepage" consente di fissare o no il menu principale e di attivare o disattivare le varie sezioni in home page
- Sezione "Preferenze Pagine & Articoli" consente di attivare l'immagine in evidenza di default (per gli articoli che non ne hanno una), consente di disattivare le cornici grafiche per le immagini "singole"
- Sezione "Colori" consente di impostare il colore principale del sito: le varianti, i colori secondari e ogni coppia testo/sfondo sono generati dinamicamente, con il contrasto verificato sul fondo su cui il testo viene davvero stampato
- Sezione "Immagine dell'header" consente di impostare l'immagine di copertina dell'homepage
- Sezione "Menu" consente di creare, gestire e posizionare i menu personalizzati nelle posizioni previste
- Sezione "Widget" consente di creare, gestire e posizionare i widget nelle colonne del footer
Aggiornamenti:
Gli aggiornamenti sono notificati in "Aspetto" > "Temi" oppure nella pagina degli aggiornamenti del backend di WordPress.
Sviluppo:
Il tema è autosufficiente: niente build step, niente SCSS, niente bundler, niente
Node. Tutto ciò che il browser riceve è già compilato e versionato dentro static/, e la
personalizzazione grafica avviene tramite i fogli di stile del tema, caricati dopo quelli
di Bootstrap Italia. Si scarica, si attiva, si lavora.
I due controlli di manutenzione sono script PHP senza dipendenze:
php bin/check-css.php # sintassi dei CSS del tema
php bin/check-bi-version.php # allineamento delle versioni di Bootstrap Italia
Il primo va eseguito dopo ogni modifica ai CSS: un commento malformato disattiva silenziosamente tutto il resto del foglio, senza che il browser segnali nulla.
La procedura per aggiornare Bootstrap Italia e quella di rilascio sono in
CONTRIBUTING.md.
Traduzioni
La traduzione italiana è in languages/it_IT.po (sorgente) e languages/it_IT.mo
(compilato, quello che WordPress legge). Il text domain è italiawp3.
Chi aggiorna le traduzioni con Poedit ("Aggiorna dal sorgente") deve verificare che
in Catalogo > Proprietà > Parole chiave sorgenti ci siano tutte le funzioni di
traduzione di WordPress, non solo __ e _e:
__ · _e · _n:1,2 · _x:1,2c · _ex:1,2c · _nx:4c,1,2
esc_attr__ · esc_attr_e · esc_attr_x:1,2c
esc_html__ · esc_html_e · esc_html_x:1,2c
_n_noop:1,2 · _nx_noop:3c,1,2
Il file .po del tema le dichiara già. Se però ne manca una, Poedit non trova le stringhe
scritte con quella funzione, le marca come obsolete (#~) e sul sito ricompaiono in
inglese. Prima della 1.0.1 era successo con il form dei commenti, il breadcrumb della
pagina 404 e i testi per screen reader. Dopo ogni aggiornamento conviene controllare che
nessuna voce obsoleta sia ancora usata nel codice.
In alternativa il catalogo si può rigenerare con WP-CLI, che riconosce già tutte le funzioni:
wp i18n make-pot . languages/italiawp3.pot --domain=italiawp3 --exclude="__*,inc/tgm-plugin-activation,bin,docs,static"
Plugin WordPress:
I seguenti plugin WordPress sono già gestiti graficamente nel tema.
Per la Pubblica Amministrazione:
- Gestione Circolari pubblica le circolari dell'ente: il tema ne gestisce l'archivio, la pagina della singola circolare e la sezione "Ultime circolari" in homepage (da attivare in "Aspetto" > "Personalizza" > "Sito & Homepage")
- Amministrazione Trasparente organizza la sezione obbligatoria Amministrazione Trasparente
- Albo Pretorio On line pubblica gli atti dell'Albo Pretorio
- Polylang rende il sito multilingua; con la traduzione dei media attiva, le cornici delle immagini mostrano titolo e didascalia nella lingua della pagina
Consigliati:
- Attachments consente il caricamento di allegati in Pagine e Articoli (proposto all'attivazione del tema)
Facoltativi:
- Classic Editor ripristina l'Editor Classico di WordPress, per chi preferisce non usare l'editor a blocchi
Changelog:
1.0.1 — 21 ottobre 2026
Sicurezza
- I link dei profili social e i dati della pagina "Dettagli" stampati in intestazione e footer vengono ora sempre filtrati (
esc_url(),esc_attr(),esc_html()): un valore malevolo salvato in un campo non può più eseguire codice nelle pagine del sito
Correzioni
- Ricerca per data: cercando ad esempio "Settembre 2018" o "12 Settembre 2018" si apre l'archivio di quel mese o giorno. Sui siti in italiano non aveva mai funzionato
- Traduzioni: tornano in italiano le etichette del form commenti, il breadcrumb della pagina 404, l'istruzione della mappa e i testi letti dagli screen reader
- WhatsApp: il link apre la chat WhatsApp (
https://wa.me/…) e non più il telefono - I profili social compaiono anche quando sono impostati solo Telegram o WhatsApp
- Le cornici delle immagini mostrano titolo e didascalia corretti anche con due file omonimi caricati in mesi diversi e, con Polylang, nelle pagine in altra lingua (prima compariva il titolo dell'articolo)
- La colonna "Anteprima" nell'elenco delle Pagine in bacheca mostra l'immagine in evidenza
- Eliminati warning e avvisi PHP nelle sezioni delle circolari e nel menu (su PHP 8.1 e successivi)
Prestazioni
- Le immagini dei contenuti non eseguono più una scansione completa della tabella
wp_postmetaper ciascuna immagine - Ricerca per data con una sola query invece di due
- Le query delle sezioni in homepage e della navigazione fra articoli non calcolano più totali inutilizzati
Requisiti
- PHP minimo portato a 8.0
Per chi usa un tema child
- Rimosse le funzioni
my_date_search()(sostituita daitaliawp3_date_search()),italiawp3_sanitize_file()ebrb_add_editor_styles(): un tema child che le richiama va aggiornato - Rimossi i fogli vuoti
inc/admin.csseinc/editor.csse il filestatic/js/i18n/datepicker-it.min.js, non più usato
1.0.0
- Prima versione di ItaliaWP3
Licenza:
Copyright (c) 2018-2026 & moral rights Boris Amico.
Il testo integrale della licenza è nel file LICENSE.md.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
Altre licenze:
- Bootstrap Italia clicca qui
- jQuery clicca qui — il tema utilizza la copia inclusa in WordPress, non ne distribuisce una propria
- Plugin jQuery Magnific Popup clicca qui
- Plugin jQuery Owl Carousel 2 clicca qui
- Leaflet clicca qui
- Theme Update Checker clicca qui
- TGM Plugin Activation clicca qui
- Plugin WordPress Attachments clicca qui