| Résumé | Category Banners utilise les détails existants de la catégorie pour créer des bannières pour vos pages de catégorie (pour les balises, consultez Discourse Tag Banners). | |
| Aperçu | Aperçu sur Discourse Theme Creator | |
| Lien du dépôt | https://github.com/discourse/discourse-category-banners | |
| Nouveau dans les thèmes Discourse ? | Guide de démarrage pour l’utilisation des thèmes Discourse |
Installer ce composant de thème
Fonctionnalités
Category Banners utilise les détails existants de la catégorie pour créer des bannières pour vos pages de catégorie. Il utilise le nom de la catégorie, la description et la couleur pour générer une bannière en haut des pages de catégorie concernées (pour les balises, consultez Discourse Tag Banners).
La description de la catégorie est définie par le premier paragraphe dans le sujet « Définition de la catégorie pour… » de chaque catégorie. Les couleurs de fond/texte de la bannière sont définies par les paramètres de badge de votre catégorie.
Par défaut, cela s’affichera sur ordinateur et mobile sur toutes les pages de Catégorie et Sous-catégorie, mais ne s’affichera pas si vous n’avez pas donné de description à votre catégorie.
Paramètres
Ce composant propose des options pour remplacer les valeurs par défaut :
| Nom | Description |
|---|---|
| show description | Afficher la description du poste « À propos de cette catégorie » |
| show mobile | Afficher les bannières sur mobile |
| show subcategory | Afficher les bannières pour les sous-catégories |
| hide if no description | Masquer les bannières si la description de la catégorie n’est pas définie |
| show category logo | Afficher le logo de la catégorie |
| align text | |
| exceptions | La bannière ne s’affichera pas pour ces NOMS DE CATÉGORIE |
| categories | Catégories pour lesquelles afficher une bannière |
| plugin outlet | Modifie la position de la bannière sur la page |
| show category icon | Afficher l’icône ou l’emoji de la catégorie depuis les paramètres de catégorie * |
| override category icon color | Lorsque les icônes de catégorie sont utilisées, activer cette option fera correspondre l’icône à la couleur du texte de la bannière |
* Notez que ce paramètre fait désormais référence à l’icône ou l’emoji de catégorie défini dans les paramètres de catégorie, et non au composant de thème Category Icons (qui est déprécié au profit de la fonctionnalité intégrée).
Notes de personnalisation
Si vous souhaitez personnaliser ces éléments avec du CSS supplémentaire, vous pouvez cibler des en-têtes de catégorie spécifiques en utilisant cette structure (example-category est le nom de votre catégorie) :
.category-title-header {
&.category-banner-example-category {
background: url(example.jpg);
}
}
Ce composant ajoute également la classe category-header à la balise body comme cible CSS supplémentaire.
Hébergé par nous ? Les composants de thème sont disponibles pour une utilisation sur nos plans Standard, Business et Enterprise.
