Ce composant analyse la description complète d’une catégorie pour détecter des balises spécifiques et affiche des liens supplémentaires vers d’autres catégories. Voir la capture d’écran.
Capture d’écran
Dépôt
À propos
Pourquoi l’utiliser et pourquoi est-il implémenté de cette manière ?
Vous souhaitez afficher des liens supplémentaires, par exemple vers d’autres ressources du même type de catégorie. Imaginez une catégorie pour un club de football et vous voulez ajouter un lien vers le site web du club. Dans de tels cas, vous pouvez utiliser GitHub - naidihr/discourse-category-headers: Theme component providing custom settings for the discourse category header · GitHub.
Si vous avez plus d’un lien, et/ou si vous ne souhaitez pas que ce lien apparaisse sur la page de vue d’ensemble des catégories, et/ou si vous ne voulez pas cette énorme bannière, vous pouvez utiliser ce thème.
Il est implémenté de cette manière pour analyser la description complète d’une catégorie, car Discourse n’utilise que le premier fragment du « premier message du sujet » pour créer la description de la catégorie affichée sur la page de vue d’ensemble des catégories. Le reste du message n’est pas affiché.
Si vous utilisez un grand nombre de catégories, peut-être créées via une API, cette fonctionnalité est entièrement utilisable car le premier message de la catégorie (= la description complète) peut également être défini via l’API.
Installation
Comment installer un thème ou un composant de thème ?
Configuration
Configurez le composant de thème et définissez les balises, par exemple :
WIKI, blank
Modifiez la description d’une catégorie pour qu’elle ressemble à ceci :
Ceci est la description affichée de la catégorie.
`
{AddCategoryLinks}
{WIKI#Wiki#Notre wiki génial#https://awesome-wiki-which-doesnt.exist}
{TAGNAME#Nom du lien#Titre du lien#URL du lien}
`
Veuillez noter :
- Il est important que
{AddCategoryLinks}existe dans la description. - Il est important qu’il soit placé dans un bloc de code (à l’intérieur de
...). - Utilisez # comme séparateur.
Remarque : Je recommande de masquer le message dans lequel la description d’une catégorie est écrite afin que les utilisateurs ne voient pas les ajouts tels que AddCategoryLinks, etc.
Remerciements
- Discourse, un excellent outil
- GitHub - discourse/discourse-custom-header-links · GitHub
- https://github.com/discourse/discourse-category-headers.git
