A volte, potresti voler personalizzare un tema Discourse ma scoprire che non è disponibile una sezione “Codice personalizzato” con un pulsante “Modifica codice”. Questo accade spesso con i temi remoti (temi installati da una fonte esterna) e i temi preinstallati (Horizon e Foundation). Ecco come puoi comunque aggiungere le tue personalizzazioni:
Comprensione della limitazione
Per i temi preinstallati, vedrai un banner che ti dice
Questo tema è preinstallato e non può essere eliminato o personalizzato
Per i temi remoti, vedrai tipicamente un messaggio come:
Se desideri modificare questo tema, devi inviare una modifica al suo repository
Ospitato da Discourse? Allora potresti vedere: “La modifica dei temi remoti è disabilitata in Discourse. Ti preghiamo di contattarci se hai bisogno di assistenza per la transizione di temi remoti personalizzati a un tema locale.”
Ospitato da Discourse? Allora potresti vedere: “La modifica dei temi remoti è disabilitata in Discourse. Ti preghiamo di Opzioni per la personalizzazione
- Inviare modifiche al repository principale: Se le tue modifiche potrebbero essere utili ad altri, considera di proporle ai creatori originali del tema. Questo richiede familiarità con git e GitHub.
- Creare una copia (fork) del repository: Crea la tua versione del repository del codice del tema, aggiungi le tue personalizzazioni e utilizza la tua versione copiata. Questo metodo richiede conoscenze tecniche e significa che dovrai gestire gli aggiornamenti da solo.
- Creare un componente personalizzato: Questo metodo ti consente di aggiungere personalizzazioni senza modificare il tema originale. È l’approccio consigliato per la maggior parte degli amministratori e sarà il focus di questa guida.
Creazione di un componente personalizzato
Segui questi passaggi per creare un componente personalizzato per le tue personalizzazioni del tema:
-
Vai al pannello di amministrazione del tuo sito e naviga su
/admin/config/customize/components -
Fai clic sul pulsante “Installa” in alto a destra
-
Seleziona “+ Crea nuovo”, inserisci un nome per il tuo componente (ad es. “Il mio componente personalizzato”), scegli “Componente” come tipo e fai clic su “Crea”
-
Trova il componente appena creato nell’elenco dei componenti e fai clic sul pulsante “Modifica”
-
Aggiungi il componente ai temi che desideri personalizzare
Non dimenticare di salvare facendo clic sul segno di spunta verde -
Fai clic su “Modifica codice”
-
Aggiungi le tue personalizzazioni nelle sezioni appropriate (CSS,
<head>, ecc.)
-
Fai clic su “Salva” per applicare le modifiche
Note importanti
- Le tue personalizzazioni verranno applicate sopra il tema esistente.
- Se il tema di base viene aggiornato, il tuo componente personalizzato continuerà ad applicare le sue modifiche, il che a volte potrebbe portare a risultati inaspettati.
- Testa sempre attentamente le tue personalizzazioni dopo gli aggiornamenti del tema.
Seguendo questi passaggi, puoi aggiungere CSS, HTML o altre modifiche personalizzate al tuo tema Discourse senza modificare direttamente i file del tema remoto. Questo metodo è adatto alla maggior parte degli amministratori che desiderano apportare piccole personalizzazioni all’aspetto o alla funzionalità del proprio sito.