Ce composant de thème offre plusieurs améliorations pour l’en-tête de catégorie de Discourse.
L’en-tête de catégorie « standard » de Discourse s’affiche en haut de chaque page de catégorie, au-dessus des liens de navigation et de la liste des sujets. Il n’est normalement visible que si une image de logo de catégorie a été téléchargée dans les paramètres de la catégorie. L’en-tête affiche le logo et une brève description de la catégorie, tirée du premier paragraphe du sujet « À propos de la catégorie… ».
Ce composant de thème offre les améliorations suivantes
L’en-tête de catégorie est désormais affiché par défaut pour toutes les catégories. Il inclut maintenant le nom de la catégorie, en plus du logo (s’il est défini) et de la description de la catégorie. Il peut également inclure une image de fond de logo et peut être stylisé pour s’afficher soit sous forme de « boîte », soit sous forme de « bannière », en utilisant les paramètres de couleur de la catégorie. De nombreuses options configurables sont disponibles dans les paramètres du thème.
Paramètres du thème
- afficher le nom de la catégorie : Afficher le nom de la catégorie dans l’en-tête
- afficher la description de la catégorie : Afficher le texte de description de la catégorie (le premier paragraphe du sujet « À propos de cette catégorie »)
- taille du texte de description : Taille du texte dans la description de la catégorie
- alignement du texte : Alignement du texte dans l’en-tête de la catégorie
- afficher l’en-tête des sous-catégories : Afficher l’en-tête pour les sous-catégories
- afficher le nom de la catégorie parente : Préfixer le nom de la catégorie parente sur les en-têtes des sous-catégories (cela agit comme un lien de fil d’Ariane vers la page de la catégorie parente)
- afficher l’icône de verrou : Afficher l’icône de verrou sur les catégories protégées par des permissions
- afficher le logo de la catégorie : Afficher l’image du logo de la catégorie dans l’en-tête
- afficher le logo de la catégorie parente : Afficher le logo de la catégorie parente lorsqu’aucun logo de sous-catégorie n’est défini
- afficher le logo du site : Afficher le petit logo du site si aucun logo de catégorie n’est défini
- position du logo : Position du logo dans la boîte
– « gauche » et « droite » affichent le logo en ligne avec le texte.
– « haut » affiche le logo au-dessus, aligné avec le texte. - taille du logo : Taille du logo dans l’en-tête.
– Petite : 50 px de hauteur, similaire à un logo de boîte de sous-catégorie.
– Standard : 150 px de hauteur.
– Original : la taille de l’image téléchargée. - style de l’en-tête : Définir le style de l’en-tête sur l’une des options suivantes :
– Boîte : l’en-tête de la catégorie s’affiche dans le même style que les boîtes standard de Discourse.
– Bannière : définir l’arrière-plan de l’en-tête sur la couleur d’arrière-plan de la catégorie et le texte sur la couleur de premier plan.
– Aucun : aucune bordure ni aucun style d’arrière-plan. - image d’arrière-plan de l’en-tête : S’applique si vous avez téléchargé une image d’arrière-plan de catégorie.
– « contain », « cover » et « resize » affichent l’arrière-plan dans l’en-tête.
– « outside » est la valeur par défaut de Discourse, affichant l’image en dehors de l’en-tête, sur toute la page. - afficher sur mobile : Afficher l’en-tête de la catégorie sur les appareils mobiles.
- forcer l’alignement mobile : Forcer l’alignement mobile du logo et du texte vers le centre supérieur de l’en-tête.
- masquer si aucune description de catégorie : Masquer l’en-tête si aucune description de catégorie n’est définie.
- exceptions de catégories masquées : Les en-têtes ne s’afficheront pas pour ces catégories.
Installer le composant de thème
Dépôt Git : https://github.com/naidihr/discourse-category-headers
Comment installer un thème ou un composant de thème ?
Crédits
Merci à @Johani pour son excellent Guide du développeur sur les thèmes Discourse
Ce composant de thème s’inspire d’autres thèmes, notamment le thème Discourse Category Banners par @awesomerobot.
Exemples
Style boîte : L’en-tête de la catégorie s’affiche dans le même style que les boîtes des sous-catégories.
Sous-catégorie : notez que la sous-catégorie n’a pas de logo, mais est configurée pour hériter du logo de la catégorie parente. Le nom de la catégorie parente est également configuré pour s’afficher sous forme de lien de fil d’Ariane.
Si la sous-catégorie possède son propre logo, celui-ci sera affiché à la place.
Vue mobile montrant un alignement différent du texte et de l’icône.
Paramètres de taille du texte.
Exemple d’options d’alignement : texte centré, logo à droite.
Style bannière : Utilise les couleurs d’arrière-plan et de premier plan de la catégorie.
Image d’arrière-plan : Utilise l’image d’arrière-plan de la catégorie.
Il me manquait l’élément suivant sous Paramètres :
. Merci d’avoir également posté la réponse — je pense qu’elle sera utile pour d’autres aussi. J’espère que le composant de thème fonctionnera bien pour toi.
