Idéalement, lors de la personnalisation de Discourse via des thèmes/plugins, vous devriez utiliser CSS, l’API de plugin JavaScript, ou les points de sortie de plugin. Si aucun de ces éléments ne convient à votre cas d’utilisation, n’hésitez pas à ouvrir une PR à Discourse core ou à démarrer un sujet Dev ici sur Meta. Nous sommes toujours heureux de discuter de l’ajout de nouveaux points de sortie/API pour faciliter la personnalisation.
Si vous avez épuisé toutes les autres options, vous devrez peut-être recourir à des remplacements de modèles. Cette technique vous permet de remplacer l’intégralité du modèle de n’importe quel composant Ember ou route à partir de votre thème/plugin.
Ce n’est pas une façon recommandée de personnaliser Discourse. Les changements quotidiens dans le cœur de Discourse entreront inévitablement en conflit avec votre remplacement de modèle, causant potentiellement des erreurs catastrophiques lors du rendu du forum.
Si vous décidez d’adopter cette approche, assurez-vous d’avoir des processus de test automatisés et d’assurance qualité suffisants pour détecter les régressions. Si vous distribuez un thème/plugin avec des remplacements de modèles, veuillez vous assurer que les administrateurs du forum sont conscients des risques de stabilité que votre thème/plugin comporte.
.gjsd’Ember. Les modèles de ces composants sont définis en ligne et ne peuvent pas être remplacés par des thèmes/plugins.À l’avenir, toutes les personnalisations de modèles doivent être effectuées à l’aide de Points de sortie de plugin
Je comprends que cela va casser dans un avenir proche, montrez-moi quand même la documentation
Remplacement des modèles de composants
Pour remplacer un modèle de composant Ember (c’est-à-dire tout ce qui se trouve sous components/* dans le cœur de Discourse), vous devez créer un fichier .hbs portant le même nom dans votre thème/plugin. Par exemple, pour remplacer le modèle du composant badge-button dans le cœur de Discourse, vous créeriez un fichier de modèle dans votre thème/plugin à cet emplacement :
{theme}/javascripts/discourse/templates/components/badge-button.hbs
{plugin}/assets/javascripts/discourse/templates/components/badge-button.hbs
Le remplacement doit toujours être imbriqué dans le répertoire /templates, même si le composant principal a un modèle « colocated ».
Remplacement des modèles de routes
Le remplacement des modèles de routes (c’est-à-dire tous les modèles non-composants sous templates/*) fonctionne de la même manière que pour les composants. Créez un modèle portant le même nom dans votre thème/plugin. Par exemple, pour remplacer discovery.hbs dans le cœur, vous créeriez un fichier comme
{theme}/javascripts/discourse/templates/discovery.hbs
{plugin}/assets/javascripts/discourse/templates/discovery.hbs
Remplacement des modèles « bruts » (.hbr)
Le système de modèles « bruts » de Discourse sera bientôt remplacé par des composants Ember classiques. Mais en attendant, le remplacement des modèles bruts fonctionne de la même manière que les modèles Ember. Par exemple, pour remplacer topic-list-item.hbr dans le cœur, vous pourriez créer un fichier comme :
{theme}/javascripts/discourse/templates/list/topic-list-item.hbr
{plugin}/assets/javascripts/discourse/templates/list/topic-list-item.hbr
Interaction entre plusieurs thèmes / plugins
Si plusieurs thèmes/plugins installés remplacent le même modèle, le « gagnant » est celui qui a le classement le plus bas dans cette liste :
- Remplacements de thèmes (l’ID de thème le plus élevé l’emporte)
- Remplacements de plugins (le nom de plugin alphabétiquement le plus récent l’emporte)
- Cœur
Cette précédence signifie également que vous pouvez remplacer les modèles de plugins à partir de thèmes. Techniquement, vous pouvez également remplacer les modèles de thèmes à partir d’autres thèmes, et les modèles de plugins à partir d’autres plugins, mais le comportement peut être surprenant en raison de la dépendance au nom du plugin et à l’ID du thème.
Comment cela fonctionne-t-il ?
Discourse assemble et priorise les modèles dans la classe DiscourseTemplateMap. Pour les modèles de composants colocated, ces informations sont utilisées lors de l’initialisation de l’application pour remplacer les associations de modèles principales. Pour tous les autres modèles, la carte est utilisée par le résolveur au moment de l’exécution pour récupérer le bon modèle.
Ce document est contrôlé par version - suggérez des modifications sur github.
).