Joomla Italia Theme è il tema Joomla che permette di aderire al modello di sito istituzionale delle scuole di Designers Italia. Esempio demo:https://jit.protocollicreativi.it/
Sviluppato da Protocolli Creativi, con l'ausilio di strumenti di intelligenza artificiale.
| Versione | 2.0.0 |
| Joomla | 5.x e 6.x — verificato su 5.4.7 e 6.1.2 |
| PHP | 8.1 o superiore — verificato su 8.4 |
| Licenza | GNU AGPL v3 o successiva |
Questa versione (2.0.0) richiede Joomla 5 o Joomla 6. Non è compatibile con Joomla 4: non installarla su un sito Joomla 4, non funzionerebbe.
Se il tuo sito è ancora su Joomla 4, usa la versione 1.2.1, disponibile nella pagina Releases di questo repository insieme a tutte le versioni precedenti. Restano scaricabili e continueranno a funzionare.
Per capire quale Joomla hai: pannello ▸ Sistema ▸ Informazioni di sistema.
- Cos'è
- Cosa fa
- Da dove iniziare
- Installazione
- Configurazione del template
- Accessibilità
- La community di riferimento
- F.A.Q.
- Licenze software dei componenti di terze parti
- Segnalazione bug
- Documentazione
Il modello di sito istituzionale delle scuole nasce nel progetto Designers Italia per dare agli istituti un sito coerente, accessibile e riconoscibile, senza che ogni scuola debba riprogettare tutto da capo.
Il modello è stato pubblicato come tema WordPress. Joomla Italia Theme porta lo stesso modello su Joomla: stessa struttura di contenuti, stessa impostazione grafica, stessi componenti di Bootstrap Italia.
È la libreria che implementa le linee guida di design per i servizi web della Pubblica Amministrazione italiana. Basata su Bootstrap 5, fornisce componenti già conformi: colori, tipografia, moduli, schede, menu.
Il tema non aggiunge componenti a Joomla: usa esclusivamente ciò che Joomla già offre — articoli, categorie, menu, moduli, campi personalizzati — e ne cambia la presentazione.
Questo significa tre cose:
- niente da imparare oltre a Joomla: chi sa usare il pannello sa usare il tema;
- nessun blocco tecnologico: disinstallando il tema i contenuti restano al loro posto, intatti;
- aggiornamenti di Joomla senza sorprese: il tema non sostituisce parti del core.
Il tema fornisce le pagine previste dal modello — schede servizio, luoghi, strutture organizzative, documenti, notizie, circolari, eventi, schede didattiche, progetti — insieme ai campi che le compongono, già configurati.
Un sito dimostrativo è disponibile su jit.protocollicreativi.it: è il punto di partenza consigliato per capire come organizzare i contenuti prima di scriverli.
Se stai partendo da zero, l'ordine di lavoro consigliato è in doc/doc.md.
I file di questo repository stanno nella posizione che occupano dentro un sito
Joomla già installato. L'installatore di Joomla si aspetta invece un pacchetto in
cui la cartella media sta dentro il template: build.sh riorganizza i file e
produce i due pacchetti pronti.
bash build.sh
# dist/joomla-italia-theme-2.0.0.zip
# dist/plg_system_singleedit-1.0.0.zipIl secondo pacchetto è facoltativo: il template funziona da solo. Il plugin
singleedit impedisce a due persone di modificare lo stesso contenuto nello stesso
momento — utile dove più redattori lavorano insieme, inutile se il sito lo aggiorna
una persona sola.
Poi dal pannello: Sistema ▸ Installa ▸ Carica file di pacchetto, e infine Sistema ▸ Stili del sito per impostare Joomla Italia Theme come predefinito.
La procedura completa, con i requisiti e le verifiche successive, è in doc/installazione.md.
Errore frequente: se il template risulta installato ma il sito appare senza grafica, controlla che lo stile abbia
inheritable = 1. Con0Joomla non carica gli asset del template, e non viene mostrato nessun messaggio d'errore.
Sistema ▸ Stili del sito ▸ Joomla Italia Theme
I parametri sono divisi in sei gruppi:
| Gruppo | Cosa configura |
|---|---|
| Topbar | la barra in cima, con messaggio e pulsanti (es. Area Riservata) |
| Logo | logo dell'istituto e testi affiancati |
| Social | collegamenti ai profili social |
| Banner | il carosello della homepage |
| Logo footer | logo nel piè di pagina e logo dell'Unione Europea |
| Copyright | il testo di copyright |
I campi si mostrano e si nascondono a seconda delle scelte fatte: non serve conoscere il codice per configurare il sito.
Il tema mette a disposizione 27 posizioni modulo e otto tipi di voce di menu dedicati alle sezioni del modello. Dettagli in doc/moduli.md e doc/menu.md.
L'accessibilità è un requisito di legge per i siti scolastici, non un miglioramento facoltativo.
Su 36 pagine misurate sull'HTML generato non risulta alcun errore fra quelli
verificabili staticamente: nessuna immagine priva di testo alternativo (su 165),
nessuna pagina senza <h1> o con più di uno, nessun salto di livello nelle
intestazioni, nessun identificativo HTML non valido o duplicato, nessun controllo
che cambi pagina alla semplice selezione. Skip link, landmark ARIA, etichette dei
moduli e viewport risultano corretti su tutte le pagine.
Restano da verificare con un browser i criteri che un'analisi statica non può misurare: contrasto dei colori, focus visibile, navigazione da tastiera, zoom al 200% e reflow a 320 px.
Il quadro completo, con i criteri verificati e quelli ancora aperti, è in doc/accessibilita.md. Leggilo prima di pubblicare la dichiarazione di accessibilità: la conformità è autodichiarata e la responsabilità resta di chi la firma.
- Forum Italia — sezione dedicata ai servizi di design
- Canale Slack
#design-siti-scuole - Tema WordPress del modello scuole
- Pagine statiche del modello scuole
- Porte Aperte sul Web
- Team per la Trasformazione Digitale
Il personale della scuola, dal pannello di Joomla. Il tema è pensato perché le operazioni quotidiane — pubblicare una circolare, aggiungere un evento, aggiornare una scheda — si facciano senza toccare codice.
Il modello per le scuole è stato pubblicato come tema WordPress, ma molte scuole italiane usano Joomla. Questo tema permette di aderire allo stesso modello senza dover migrare la piattaforma, il che significa non rifare da zero contenuti e formazione del personale.
Un sito conforme al modello nazionale, con una struttura dei contenuti già progettata e verificata: la scuola non deve decidere come organizzare le informazioni, né progettare le pagine. In più, l'accessibilità è considerata fin dall'impostazione, non aggiunta dopo.
Sì. Contenuti, menu, moduli, colori dei parametri e struttura delle categorie sono completamente nelle tue mani: sono funzioni standard di Joomla.
No, se puoi evitarlo. Modificare i file sovrascritti (html/) o i fogli di
stile rende più difficili gli aggiornamenti futuri: le modifiche verrebbero
sovrascritte, o andrebbero riapplicate a mano ogni volta.
Se una personalizzazione ti serve davvero, leggi prima
doc/manutenzione.md: documenta le convenzioni del tema — in
particolare le cartelle _condiviso/, dove un solo file governa il
comportamento di più pagine, e le trappole già incontrate da chi ci ha lavorato.
Il tema usa esclusivamente il core di Joomla! e distribuisce le librerie seguenti, tutte con licenze open source:
| Componente | Licenza |
|---|---|
| Bootstrap Italia (bundle, include Bootstrap 5 e Popper.js) | BSD-3-Clause |
| jQuery 3.6.2 | MIT |
| Owl Carousel 2 | MIT |
| Leaflet 1.9.4 | BSD-2-Clause |
| Font Titillium Web | SIL Open Font License 1.1 |
| Font Lora | SIL Open Font License 1.1 |
| Font Roboto Mono | Apache License 2.0 |
I font sono distribuiti localmente insieme al tema, nei formati woff2 e
woff: nessuna richiesta viene inviata a servizi esterni per caricarli.
Apri una issue su questo repository indicando:
- versione di Joomla e di PHP (Sistema ▸ Informazioni di sistema)
- versione del tema (Sistema ▸ Gestione estensioni)
- l'indirizzo della pagina in cui si verifica il problema
- cosa ti aspettavi e cosa è successo
Se il problema riguarda l'aspetto allega uno screenshot; se riguarda un errore, allega il testo esatto del messaggio.
La documentazione completa è in doc/doc.md.
Per chi gestisce il sito dal pannello:
| Guida | Contenuto |
|---|---|
| configurazione-joomla.md | impostazioni di Joomla, multilingua, permessi |
| alberatura-categorie.md | la struttura delle categorie e perché viene prima di tutto |
| inserimento-articoli.md | scrivere e pubblicare un contenuto, passo passo |
| custom-field-articoli.md | i campi aggiuntivi, categoria per categoria |
| custom-field-categoria.md | i campi delle categorie: timeline, strutture |
| menu.md | menu, voci di navigazione, tipi di pagina |
| moduli.md | i blocchi che compongono le pagine |
| topbar.md · header.md · footer.md | le tre zone fisse del sito |
Per chi lavora sul codice:
| Guida | Contenuto |
|---|---|
| installazione.md | installazione, requisiti, pacchetti |
| struttura.md | come è organizzato il codice del tema |
| manutenzione.md | convenzioni e trappole note |
| accessibilita.md | stato WCAG 2.1 AA e verifiche mancanti |
La cronologia delle modifiche è in CHANGELOG.md.
GNU Affero General Public License v3.0 o successiva — vedi LICENSE.
Attribuzioni in AUTHORS.
Questo programma è software libero: puoi redistribuirlo e modificarlo secondo i termini della GNU AGPL pubblicata dalla Free Software Foundation. È distribuito nella speranza che sia utile, ma SENZA ALCUNA GARANZIA. Vedi http://www.gnu.org/licenses/.