Italia Theme for Joomla 2.1.0

Correzioni e novità dal riesame delle 24 issue aperte: ogni punto è stato riprodotto e verificato in Docker su Joomla 6.2 (PHP 8.4) e Joomla 5.4 (PHP 8.3). Nessuna libreria nuova, nessun CDN. I siti esistenti non cambiano comportamento se non per le correzioni: le novità sono opzionali (parametri con il valore predefinito di prima, layout alternativi da scegliere nel modulo o nella voce di menu).

Corretto

• #89 Megamenu con voci di terzo livello: il menu perdeva le voci e lasciava visibile solo la prima.
• #88 Conflitti con jQuery e Bootstrap caricati da estensioni di terze parti: i componenti del core vengono disattivati anche per i moduli e resta una sola jQuery per pagina.
• #57 Titolo e sottotitolo dell'intestazione fuori dal riquadro sui telefoni.
• #45 Finestra "Stampa / Condividi" con lo sfondo nero pieno.

Aggiunto

• #60 Favicon personalizzata (scheda Avanzate dello stile).
• #47 user.css e user.js caricati se esistono, fuori dal pacchetto.
• #53 Pagina di errore e #54 pagina "sito offline" con la grafica del modello.
• #49 Layout italia per il modulo di accesso nativo.
• #38 Icona degli allegati in base al tipo di file.
• #86 Parametro "Licenza dei documenti" nelle Carte della scuola.
• #81 Data di pubblicazione nei layout del modulo elenco articoli, con "Mostra data".
• #61 Layout news-noveditutti e progetti-noveditutti.
• #98 Layout offerta-formativa-tutti con il pulsante verso tutti i percorsi di studio.
• #93 Sottocategorie dell'Elenco categoria come schede.
• #95 Override della voce "Lista di tutti i tag".
• #76 Parametro "Articoli per ogni sottocategoria" nelle voci di menu dei layout di sezione.

Verificato senza modifiche

• #41 e #37: comportamento del modello e filtro del campo, documentati in doc/custom-field-articoli.md.

Rimandato alla 2.2

#63, #20, #18, #12 e l'aggiornamento di Bootstrap Italia (#25).

Requisiti e aggiornamento

Joomla 5 o 6, PHP 8.1 o superiore. Dalla 2.0.x: Aggiornamenti estensioni nel pannello di Joomla, oppure caricando lo zip. Il plugin singleedit resta alla 1.0.1. Dettagli nel CHANGELOG.

SHA-256 di joomla-italia-theme-2.1.0.zip: 295366ac8b24072026bfe890ae9adea6541f59e549a4234f8d030e5362899287

Italia Theme for Joomla 2.0.3

Release di manutenzione: tre correzioni che erano state fatte direttamente sul sito dimostrativo e non erano mai entrate nel repository. Nessuna novità funzionale; il plugin singleedit resta alla 1.0.1.

Corretto

• #75 Ricerca impossibile con l'intestazione fissa (da 1200px in su): la finestra modale della ricerca restava intrappolata nell'intestazione position: fixed e si apriva invisibile, bloccando lo scorrimento. Ora index.php sposta le finestre modali dell'intestazione come figlie dirette del body al caricamento della pagina.
• #56 Collegamenti rapidi della ricerca tagliati sui telefoni: aggiunto flex-wrap in mod_menu/cerca.php, i pulsanti vanno a capo.
• Schede articolo con foto verticale più alte delle altre: il riquadro immagine delle card (.card-article-img) ha ora altezza fissa di 240px con object-fit: cover.

Quickstart

Il pacchetto quickstart del sito dimostrativo (Joomla 6, tema, contenuti di esempio e Albo Pretorio Online, da installare con Akeeba Kickstart) è allegato alla release 2.0.2 e installa il tema 2.0.2: Joomla propone poi l'aggiornamento alla 2.0.3 dal pannello. Guida: doc/quickstart.md.

Requisiti

Joomla 5 o 6, PHP 8.1 o superiore. Aggiornamento dalla 2.0.x: dal pannello di Joomla (Aggiornamenti estensioni) o caricando lo zip.

SHA-256 di joomla-italia-theme-2.0.3.zip: 6309f92b06496a09cc208baa66b19da3f56fb0e504879395d91372d494ac6530

Italia Theme for Joomla 2.0.2

Rilascio di manutenzione: correzioni dei bug confermati nel codice dal riesame
delle issue di GitHub del 7 novembre 2026. Nessuna novità funzionale; il plugin
singleedit resta alla 1.0.1.

Corretto

• #64 Date di pubblicazione e revisione — i layout articolo (novità, circolari,
  eventi, servizio, documenti della scuola, strutture, progetti, schede didattiche)
  sovrascrivevano publish_up e modified con la data del giorno: ogni articolo
  risultava pubblicato e revisionato "oggi". Ora "Pubblicato" mostra la data di
  pubblicazione reale (publish_up, in mancanza created) nel fuso orario del sito
  e "Revisione" compare solo quando la data di modifica è successiva; il calcolo è
  in article/_condiviso/date_articolo.php. Formato d.m.Y e markup invariati.
• #78 Undefined variable $item_active — mod_menu/_condiviso/url.php usava la
  variabile senza inizializzarla (warning PHP con la segnalazione errori attiva);
  ora è inizializzata come in component.php, senza cambiare il markup.
• #74 Intro delle card del modulo news in minuscolo — la regola
  .mod-news .scheda-item p { text-transform: lowercase } trasformava in minuscolo
  sigle e nomi propri; rimossa (resta la maiuscola sulla prima lettera).
• #15 Descrizione della categoria "La scuola" senza formattazione —
  category/scuola.php la stampava con strip_tags dentro l'h1: grassetti e
  paragrafi sparivano. Ora l'h1 è il titolo della categoria (o l'intestazione della
  voce di menu) e la descrizione è stampata sotto come HTML, con lo stesso markup
  degli altri layout di categoria.
• #44 Note legali senza "Stampa / Condividi" — article/note-legali.php non aveva
  il blocco presente negli altri layout articolo; aggiunto nella stessa posizione
  (colonna laterale), con la pagina divisa nelle due colonne di default.php.
• #82 Timeline: "Anno Evento" non stampato — layouts/com_fields/field/timeline.php
  stampava solo i primi tre sottocampi dell'elenco "Storia della Scuola". Ora stampa i
  quattro sottocampi documentati (Anno, Mese Anno, Titolo, Descrizione), riconosciuti
  dal nome del campo e non più dalla posizione; se i nomi non corrispondono vale
  l'ordine di inserimento come prima.
• #3 "Dati Copyright" senza formattazione — il campo è di tipo editor, ma il
  manifesto lo filtrava come testo semplice (filter="string", che toglie ogni tag al
  salvataggio) e index.php lo stampava con htmlspecialchars. Ora il filtro è
  safehtml (script ed eventi rimossi) e il footer lo stampa come HTML. Per vedere
  la formattazione va salvato di nuovo lo stile del template.
• #79 Carosello in homepage con una sola slide — loop: true clonava l'unica slide
  e mostrava le frecce; ora il loop è attivo solo con più di una slide.

Verificato senza modifiche

• #80 Colore della sezione Novità — il layout "Blog per le categorie della sezione
  Novità" (category/novita.php → _condiviso/layout_eventi_novita.php) usa già il
  verde bg-greendark, lo stesso delle schede notizia; il viola bg-purplelight resta
  solo nel "Blog di categoria" standard (category/blog.php), pensato per i Servizi.
  Se la voce di menu Novità appare viola, usa il layout sbagliato: vedi doc/menu.md.

Quickstart del sito dimostrativo

• Nuovo allegato quickstart-italia-theme-for-joomla-2.0.2.zip (47 MB): il sito demo completo da installare sul proprio hosting.
• Contiene Joomla 6.1.3 in italiano, Italia Theme for Joomla 2.0.2, il plugin singleedit 1.0.1 e l'Albo Pretorio Online 1.2.1.
• Contenuti di esempio di un istituto immaginario, "Istituto Battaglia 1815": menu, articoli, categorie, campi, moduli e atti dell'albo.
• Si installa con Akeeba Kickstart Core 9.2.0 e la procedura di ripristino di Akeeba Backup Core 10.5.0, già inclusi.
• Durante il ripristino scegli il tuo database e imposti email e password del super utente admin.
• Richiede PHP 8.3 o superiore (minimo di Joomla 6) e MySQL 8 o MariaDB 10.4 o superiori.
• Utente di prova admin / demo-battaglia-2026: password pubblica, da cambiare se non la sostituisci durante il ripristino.
• A fine installazione cancella kickstart.php, kickstart.json.php, l'archivio .jpa, configuration.bak.php e LEGGIMI.txt.
• Istruzioni complete nel LEGGIMI.txt dello zip e in doc/quickstart.md. SHA-256: 12a4f3b1539af72484343880a9589a9da5a0593088bbf53fabfbcf7b2251ab0b

Italia Theme for Joomla 2.0.1

[2.0.1] — 2026-11-07

Correzioni emerse dall'App di valutazione dei modelli (pa-website-validator-ng
1.1.40, modello scuole) eseguita sul sito demo, più preparazione alla
distribuzione: nome, update server, catalogo Developers Italia.

Corretto — App di valutazione dei modelli

• Le schede servizio non venivano trovate dal validatore. L'App apre le
  pagine delle tipologie di servizio (data-element="service-type") e lì cerca i
  link alle schede (data-element="service-link"). Le card delle categorie
  servizi avevano solo itemprop="url": il validatore non trovava nessun servizio
  e segnava come falliti font (C.SC.1.1), Bootstrap Italia (C.SC.1.2) e cookie
  (C.SC.2.3), anche se tutte le pagine analizzate li rispettavano. Ora blog_item.php
  passa service-link al layout del titolo, che lo stampa solo quando il chiamante
  lo richiede (lo stesso layout è usato anche da notizie, eventi, luoghi, documenti).
• Note legali: = al posto di ===. In article/note-legali.php la
  condizione sul titolo "Licenza dei contenuti" era un'assegnazione: risultava
  sempre vera e sovrascriveva il titolo dell'articolo.

Nome

• Il tema si chiama ora "Italia Theme for Joomla" (prima "Joomla Italia Theme").
  La policy del marchio Joomla non ammette nomi di prodotto che iniziano con
  "Joomla"; la forma indicata è "… for Joomla". Cambia solo il nome visibile
  (README, documentazione, crediti nel footer, update server, publiccode.yml).
  Il nome tecnico resta joomla-italia-theme — cartella, elemento, percorso dei
  media — così l'aggiornamento dalla 2.0.0 conserva stili e impostazioni.
  Aggiunta nel README la nota sui marchi.

Privacy

• Leaflet non viene più caricato da unpkg.com. La mappa delle sedi usava
  la CDN esterna: ogni visita a una scheda luogo inviava l'indirizzo IP del
  visitatore a un servizio terzo. Ora usa le copie di Leaflet 1.9.4 già incluse
  nel tema, registrate in joomla.asset.json (template.css.leaflet,
  template.js.leaflet). Aggiunte in css/images/ le icone del segnaposto e
  dei livelli, che il CSS locale cerca lì e che prima mancavano.
  Le tessere della mappa restano servite da OpenStreetMap.

Aggiornamenti

• Update server per il template e per il plugin singleedit
  (updateserver/template.xml, updateserver/plugin-singleedit.xml, pubblicati
  via GitHub raw). Da questa versione Joomla segnala da solo le nuove release in
  Sistema ▸ Aggiornamenti. Il targetplatform limita gli aggiornamenti a
  Joomla 5 e 6.

Catalogo Developers Italia

• Aggiunto publiccode.yml in radice, validato con publiccode-parser-go 5.4.3,
  per l'inserimento nel catalogo del software open source per la PA. Da
  aggiornare a ogni release (softwareVersion, releaseDate).

Plugin singleedit 1.0.1

• Namespace da Joomla\Plugin\System\Singleedit a Pcrt\Plugin\System\Singleedit.
  Il prefisso Joomla\ è riservato al core: un'estensione di terze parti non
  deve usarlo. Nessun effetto sul funzionamento.

---

2.0.0 — per Joomla 5 e 6

⚠️ Questa versione richiede Joomla 5 o Joomla 6

Non è compatibile con Joomla 4. Installarla su un sito Joomla 4 non funzionerebbe.

Se il tuo sito è ancora su Joomla 4, usa la versione
v.1.2.1:
resta scaricabile, insieme a tutte le versioni precedenti, e continua a funzionare.

Per sapere quale Joomla hai: pannello ▸ Sistema ▸ Informazioni di sistema.

---

Installazione

1. Scarica joomla-italia-theme-2.0.0.zip qui sotto
2. Pannello ▸ Sistema ▸ Installa ▸ Carica file di pacchetto
3. Pannello ▸ Sistema ▸ Stili del sito ▸ imposta Joomla Italia Theme come predefinito

Se il sito appare senza grafica dopo l'installazione, controlla che lo stile
del template abbia inheritable = 1. È l'errore più frequente e non produce
nessun messaggio.

Il secondo pacchetto, plg_system_singleedit-1.0.0.zip, è facoltativo: il
template funziona benissimo da solo. Il plugin impedisce a due persone di
modificare lo stesso contenuto nello stesso momento — utile dove più redattori
lavorano insieme.

Guida completa: doc/installazione.md

---

Cosa cambia rispetto alla 1.2.1

Compatibilità

• Verificato su Joomla 5.4.7 e Joomla 6.1.2, con PHP 8.4
• I pacchetti sono stati installati davvero con l'installatore di Joomla su
  entrambe le versioni, partendo da template assente: i file finiscono nelle
  posizioni corrette e tutte le pagine funzionano
• Rimosse le chiamate deprecate in vista di Joomla 7

Accessibilità

• Il filtro "Tipologia" delle pagine di categoria era inutilizzabile da
  tastiera. Erano pulsanti radio con onchange che cambiava pagina: spostandosi
  con le frecce si navigava via a ogni tasto, quindi la seconda e la terza opzione
  erano irraggiungibili. Sostituiti con collegamenti, che è il controllo corretto
  per una scelta che porta a un'altra pagina. Risolti insieme anche gli id non
  validi e l'assenza di escaping sui titoli.
• Corretti gli <h1> multipli in homepage e le pagine che non ne avevano nessuno
• Corretti i <title> non descrittivi delle sottocategorie

Su 36 pagine misurate: 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.

Restano da verificare con un browser i criteri che l'analisi statica non può
misurare: contrasto, focus visibile, navigazione da tastiera, zoom e reflow.
Dettagli in doc/accessibilita.md.

Traduzioni

• Le traduzioni inglesi non venivano caricate. La cartella era en-EN e il
  file aveva un nome non corrispondente al template: nel sito inglese comparivano
  le sigle grezze al posto dei testi. Le 40 stringhe già tradotte ora funzionano.

Pulizia e manutenibilità

• Rimossi 44 file che erano copie identiche di file del core Joomla: un
  override identico "congela" il file e gli aggiornamenti di sicurezza non lo
  raggiungono più
• Unificati gli override duplicati: lo stesso codice esisteva in 7 o 10 copie, ora
  vive in un solo file richiamato da tutti. Da 2426 a 972 righe negli override
  interessati
• Rimossi font in formati obsoleti, file di sviluppo e asset non utilizzati

Documentazione

15 guide in italiano nella cartella doc/,
rivolte a chi gestisce il sito dal pannello: configurazione di Joomla, alberatura
delle categorie, topbar, header, footer, menu, moduli, campi aggiuntivi di articoli
e categorie, inserimento articoli, più le guide tecniche su installazione,
struttura del codice, manutenzione e accessibilità.

Licenza

Dichiarazione allineata a GNU AGPL v3.0 o successiva in tutti i manifesti: il
template dichiarava una licenza non valida.

---

Cronologia completa: CHANGELOG.md

Release 1.2.1

• Fix installazione templete in sottocartella
• Spostamento immagini su cartella media
• Unificazione cartella immagini
• Fix traduzione mancante Tab Copyright
• Aggiunta traduzioni lingua Inglese

Release 1.2

• Aggiornata la gestione degli asset
• fix preview immagine anteprima template nel pannello di joomla
• fix aggiornamento del template (ora è possibile installarlo anche se il template è già installato)
• fix modali negli editor nel front end (vengono caricate le risorse all'interno del tag head dell'iframe)

Release 1.1

New features:

• Layout singolo articolo (per tutte quelle pagine che non ricadono nella struttura del modello scuole)
• Lista di singola categoria
• Login, registrati, logout, reset password, reminder
• Modifica dal frontend
• Menu secondario creato un nuovo layout chiamato "menualternativo" (che non infastidisce la validazione)

1.0

Primo rilascio template Joomla 4 per le scuole che permette di aderire al modello di sito istituzionale delle scuole.