Template Joomla 3 non responsive o rotto: diagnosi e soluzioni
- Joomla
- 6 settembre 2025
Indice dei contenuti
Un template Joomla 3 rotto richiede una diagnosi prima di un restyling. Se la pagina appare senza formattazione, parti dalle richieste CSS. Se il menu non si apre, controlla JavaScript. Se il difetto riguarda soltanto il telefono, verifica larghezze e regole responsive. Una pagina bianca o un errore del server richiede invece l’analisi dei log PHP.
Il problema può dipendere dal template, dal suo framework, da un’estensione o dall’hosting. Individuare il livello coinvolto permette di ripristinare la funzione interessata e valutare se il progetto grafico rimane mantenibile.
Questa guida riguarda installazioni esistenti: Joomla indica il 17 agosto 2023 come termine del supporto comunitario a Joomla 3 e il 17 febbraio 2025 come termine del supporto esteso LTS. Sistemare la grafica non riporta il CMS sotto supporto: l’intervento va affiancato alla pianificazione della migrazione. Requisiti ufficiali e versioni non più supportate.
Template non responsive o interfaccia che non risponde?
Sono due problemi diversi. Un layout non responsive non si adatta allo schermo: colonne troppo larghe, testo difficile da leggere, pulsanti fuori dall’area visibile. Un’interfaccia che non risponde presenta invece controlli inattivi, come il menu mobile che rimane chiuso dopo il tocco.
| Sintomo | Primo controllo |
|---|---|
| Testo senza colori o colonne impilate | Richieste e risposte dei fogli di stile |
| Menu o slider inattivi con grafica corretta | JavaScript e Console del browser |
| Scorrimento orizzontale sul telefono | Elemento più largo dello schermo |
| Modulo assente soltanto in alcune pagine | Assegnazioni del modulo e dello stile |
| Un componente appare diverso dopo un aggiornamento | Override e risorse dell’estensione |
| Pagina bianca, HTTP 500 o output interrotto | Log degli errori PHP |
La tabella orienta l’indagine, non certifica una causa. Un CSS mancante e un elemento a larghezza fissa possono entrambi far debordare la pagina, ma richiedono interventi differenti.
Documentare il difetto prima di modificare il template
Annota URL, browser, larghezza dello schermo e azione che non funziona. Verifica se il difetto coinvolge homepage, pagine interne, amministrazione o soltanto un componente.
Raccogli le versioni di Joomla, PHP, template e relativo framework, insieme alle modifiche recenti a hosting, estensioni e ottimizzazioni. La comparsa del problema dopo un aggiornamento è un indizio da verificare, non una prova sufficiente.
Prima di intervenire, conserva file e database e verifica la possibilità di ripristino. Riproduci il difetto su una copia di prova ad accesso limitato, con configurazione pertinente equivalente. Impedisci che moduli e integrazioni di test inviino notifiche reali o elaborino ordini.
Cambia una variabile alla volta e registra l’esito: aggiornare contemporaneamente PHP, template e plugin rende difficile capire quale modifica abbia risolto o introdotto il guasto.
Come diagnosticare CSS mancanti e JavaScript bloccato
Apri gli strumenti sviluppatore prima di ricaricare la pagina. Nella scheda Network, disabilita la cache del browser durante la prova, filtra CSS e JavaScript e controlla codice HTTP e corpo delle risposte. Anche un HTTP 200 può contenere una pagina HTML di errore anziché il file atteso. La documentazione Network di Chrome DevTools descrive gli strumenti disponibili.
Interpreta la richiesta prima di modificare il design:
- 404: controlla percorso richiesto ed esistenza del file.
- 403: indaga restrizioni di accesso e filtri; il codice non identifica da solo la regola responsabile.
- Redirect o risposta HTML inattesa: verifica come server e routing trattano quell’URL.
Conserva l’indirizzo completo, inclusa la query string. Nel caso documentato di CSS e JavaScript Joomla in 403, una regola di sicurezza intercettava parte del token di versioning. Modificare il contenuto del CSS non avrebbe eliminato il blocco.
Se le risorse arrivano ma i controlli restano inattivi, ripeti l’azione con la Console aperta. Parti dal primo errore pertinente: una libreria non caricata può provocare errori a cascata negli script dipendenti. Registra file e riga segnalati. Documentazione della Console di Chrome.
Sulla copia di prova verifica separatamente aggregazione, minificazione e caricamento differito, se attivi. Se disabilitare una funzione risolve il problema, controlla ordine degli script ed esclusioni prima di ripristinarla. Non aggiungere un’altra copia di una libreria senza verificare cosa carica già il template.
Perché il layout Joomla 3 si rompe soltanto sul mobile
Il comportamento responsive dipende dall’HTML e dal CSS effettivamente prodotti. Larghezze fluide, immagini adattabili e regole basate sullo schermo devono funzionare anche con i contenuti reali. La guida MDN al responsive design ne spiega i principi.
Confronta una visualizzazione larga corretta con quella stretta difettosa. Ispeziona l’elemento che supera il bordo: tabella, immagine, mappa incorporata, stringa lunga o modulo personalizzato a larghezza fissa. Controlla anche la configurazione del viewport e le regole personalizzate che potrebbero prevalere su quelle responsive.
Esempio illustrativo: le colonne si adattano al telefono, ma un modulo contiene una tabella a larghezza fissa. L’intervento riguarda quella tabella o il suo contenitore. Nascondere lo scorrimento orizzontale dell’intera pagina potrebbe soltanto rendere invisibili alcuni dati.
Usa la modalità responsive del browser per le larghezze intermedie, poi prova navigazione e moduli su un telefono reale. Se il layout entra nello schermo ma il pulsante del menu non reagisce, torna alla diagnosi JavaScript.
Verificare posizioni dei moduli e assegnazioni degli stili
Un modulo scomparso dopo il cambio di template potrebbe essere ancora pubblicato. Controlla posizione, assegnazione alle voci di menu, livello di accesso, lingua e date di pubblicazione. Verifica poi che il template attivo mostri quella posizione nella pagina interessata.
Distingui inoltre template e stile del template: gli stili conservano configurazioni e possono essere assegnati a specifiche voci di menu. In Joomla 3, nella gestione template sotto Estensioni, controlla stile predefinito e assegnazioni particolari. La guida Joomla 3 al cambio di template descrive questo comportamento.
Se homepage e pagina servizio usano stili diversi, cambiare quello predefinito potrebbe lasciare invariata la seconda. Verifica le assegnazioni prima di duplicare moduli o ricostruire la pagina.
I framework possono aggiungere controlli propri: consulta la documentazione della versione installata, perché impostazioni e nomi delle posizioni non sono intercambiabili fra template.
Controllare gli override dopo un aggiornamento
Un override modifica l’output di un’estensione senza cambiarne il file originale. In Joomla questi file si trovano comunemente nella directory html del template attivo. Conservano personalizzazioni, ma possono diventare incompatibili con il layout dell’estensione aggiornata. Documentazione Joomla sugli override.
Se il difetto riguarda un componente, confronta l’override pertinente con il layout fornito dalla versione effettivamente installata. Sulla copia di prova escludi temporaneamente soltanto quell’override e ripeti il test, conservando la personalizzazione e ripristinando poi lo stato iniziale della prova.
Se l’output standard funziona, hai ristretto l’indagine: non hai dimostrato che occorra eliminare tutti gli override. Riporta la personalizzazione sul layout compatibile e verifica le funzioni coinvolte, come filtri, paginazione e invio dei moduli.
Se il template si rompe dopo un cambio PHP
Pagina bianca, HTTP 500 e output incompleto richiedono i log del server. Cerca l’errore registrato all’orario della richiesta e identifica file, estensione o framework indicati nella traccia. Un errore PHP può interrompere la costruzione della pagina e sembrare un difetto grafico.
La compatibilità riguarda l’intera installazione: core, framework, estensioni e override possono avere requisiti differenti. Una tabella storica dei requisiti del core non garantisce tutte le estensioni e non raccomanda di mantenere PHP fuori supporto.
Non mostrare dettagli diagnostici sul sito pubblico: usa log riservati o staging. Un downgrade permanente di PHP non costituisce un piano di manutenzione. Per approfondire, consulta la guida alle incompatibilità PHP e database in Joomla 3.
Quando riparare il template e quando migrare
Una riparazione mirata ha senso quando il difetto è circoscritto e la modifica necessaria è compresa. Dipendenze abbandonate e continui interventi di compatibilità spostano la priorità sulla migrazione. Le attività possono procedere insieme: recuperare una funzione mentre si prepara la piattaforma supportata.
| Situazione | Intervento da valutare |
|---|---|
| Singola risorsa mancante o assegnazione errata | Correggere la causa e ripetere i test |
| Difetto mobile localizzato | Sistemare il layout e controllare pagine correlate |
| Override vecchio, estensione mantenuta | Adattare la personalizzazione al nuovo output |
| Framework abbandonato | Valutare sostituzione e dipendenze |
| Più estensioni bloccano l’aggiornamento | Inventariarne l’uso prima di scegliere il percorso |
Migrare non implica necessariamente abbandonare il design. Nel caso di migrazione Joomla 3–6 con T3 e Purity III, il template è stato conservato intervenendo sulle dipendenze. È il risultato di quell’installazione, non una garanzia applicabile a ogni template storico.
Il mantenimento degli URL va previsto nel progetto: un cambiamento grafico non richiede da solo nuovi indirizzi. Controlla percorsi di menu, canonical e pagine di ingresso importanti; prepara redirect soltanto dove l’indirizzo deve effettivamente cambiare.
Verifiche prima di applicare la correzione al sito pubblico
Un foglio di stile o un override condiviso può modificare pagine diverse da quella usata nella diagnosi.
- Controlla homepage, articolo, categoria e pagine servizio o prodotto pertinenti.
- Prova menu mobile, sottomenu e moduli, inclusi validazione e invio riuscito.
- Confronta desktop e mobile, con contenuti lunghi e tabelle larghe.
- Riattiva cache e ottimizzazioni previste e ripeti le prove come visitatore non autenticato.
- Verifica richieste degli asset e risoluzione degli errori pertinenti nel browser o nei log PHP.
- Controlla gli URL esistenti e documenta file, impostazioni e procedura di ripristino.
Il risultato utile è una correzione riproducibile, con causa spiegata e necessità di manutenzione residue. Una schermata della homepage funzionante è soltanto una parte della verifica.
Se il tuo template Joomla 3 presenta questi problemi, posso analizzare le pagine coinvolte e valutare una riparazione mirata o una migrazione. Per una richiesta di assistenza Joomla, indicami URL, sintomi e modifiche recenti: potrò inquadrare il guasto nel contesto del sito.
