| Résumé | Bannières de catégorie utilise les détails existants des catégories pour créer des bannières pour vos pages de catégories (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 sur les thèmes Discourse ? | Guide pour débutants sur l’utilisation des thèmes Discourse |
Installer ce composant de thème
Fonctionnalités
Bannières de catégorie utilise les détails existants des catégories pour créer des bannières pour vos pages de catégories. Il utilise le nom de la catégorie, sa description et sa 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 du sujet « Définition de la catégorie pour … » de chaque catégorie. Les couleurs de l’arrière-plan et du texte de la bannière sont définies par vos paramètres de badge de catégorie.
Par défaut, cela s’affichera sur les versions bureau et mobile de toutes les pages de catégorie et de sous-catégorie, mais ne s’affichera pas si vous n’avez pas attribué de description à votre catégorie.
Paramètres
Ce composant propose des options pour remplacer les paramètres par défaut :
| Nom | Description |
|---|---|
| show description | Afficher la description du message « À 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 | Aligner le texte |
| 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’émoji de la catégorie définis dans 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 maintenant référence à l’icône ou à l’émoji de catégorie défini dans les paramètres de catégorie, et non au composant de thème Category Icons (qui est obsolète au profit de la fonctionnalité principale).
Notes sur la personnalisation
Si vous souhaitez les personnaliser avec du CSS supplémentaire, vous pouvez cibler des en-têtes de catégorie spécifiques en utilisant cette structure (exemple-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 Entreprise.
