Idealmente, quando si personalizza Discourse tramite temi/plugin, si dovrebbe usare CSS, l’API JavaScript per plugin o plugin outlets. Se nessuno di questi funziona per il tuo caso d’uso, sentiti libero di aprire una PR a Discourse core o avviare un argomento Dev qui su Meta. Siamo sempre felici di discutere l’aggiunta di nuovi outlet/API per semplificare la personalizzazione.
Se hai esaurito tutte le altre opzioni, potresti dover ricorrere all’override dei template. Questa tecnica ti consente di sovrascrivere l’intero template di qualsiasi componente Ember o Route dal tuo tema/plugin.
Questo non è un modo consigliato per personalizzare Discourse. Le modifiche quotidiane a Discourse core entreranno in conflitto con il tuo override del template, causando potenzialmente errori catastrofici durante il rendering del forum.
Se decidi di adottare questo approccio, assicurati di disporre di test automatici e processi di QA sufficienti per rilevare regressioni. Se distribuisci un tema/plugin con override di template, assicurati che gli amministratori del forum siano consapevoli dei rischi di stabilità che il tuo tema/plugin comporta.
.gjsdi Ember. I template per questi componenti sono definiti inline e non possono essere sovrascritti da temi/plugin.In futuro, tutte le personalizzazioni dei template dovrebbero essere eseguite utilizzando Plugin Outlets
Capisco che questo si romperà nel prossimo futuro, mostrami comunque la documentazione
Override dei Template dei Componenti
Per sovrascrivere un template di componente Ember (cioè qualsiasi cosa sotto components/* in Discourse core), dovresti creare un file .hbs con lo stesso nome nel tuo tema/plugin. Ad esempio, per sovrascrivere il template per il componente badge-button in Discourse core, creeresti un file template nel tuo tema/plugin in questa posizione:
{theme}/javascripts/discourse/templates/components/badge-button.hbs
{plugin}/assets/javascripts/discourse/templates/components/badge-button.hbs
L’override deve essere sempre annidato nella directory /templates, anche se il componente core ha un template ‘collocato’.
Override dei Template delle Route
L’override dei template delle route (cioè tutti i template non-componente sotto templates/*) funziona allo stesso modo dei componenti. Crea un template con lo stesso nome nel tuo tema/plugin. Ad esempio, per sovrascrivere discovery.hbs in core, creeresti un file come
{theme}/javascripts/discourse/templates/discovery.hbs
{plugin}/assets/javascripts/discourse/templates/discovery.hbs
Override dei Template ‘Raw’ (.hbr)
Il sistema di template “raw” di Discourse sarà presto sostituito da normali componenti Ember. Ma nel frattempo, l’override dei template raw funziona allo stesso modo dei template Ember. Ad esempio, per sovrascrivere topic-list-item.hbr in core, potresti creare un file come:
{theme}/javascripts/discourse/templates/list/topic-list-item.hbr
{plugin}/assets/javascripts/discourse/templates/list/topic-list-item.hbr
Interazione tra più temi / plugin
Se più temi/plugin installati sovrascrivono lo stesso template, il “vincitore” è quello con il ranking più basso in questo elenco:
- Override dei temi (vince l’ID del tema più alto)
- Override dei plugin (vince il nome del plugin alfabetico più recente)
- Core
Questa precedenza significa anche che puoi sovrascrivere i template dei plugin dai temi. Tecnicamente puoi anche sovrascrivere i template dei temi da altri temi e i template dei plugin da altri plugin, ma il comportamento può essere sorprendente a causa della dipendenza dal nome del plugin e dall’ID del tema.
Come funziona?
Discourse assembla e prioritizza i template nella classe DiscourseTemplateMap. Per i template di componenti collocati, tali informazioni vengono utilizzate durante l’inizializzazione dell’app per sostituire le associazioni dei template core. Per tutti gli altri template, la mappa viene utilizzata dal resolver al runtime per recuperare il template corretto.
Questo documento è controllato in versione - suggerisci modifiche su github.
).