Anciennement « Discourse Category Sidebars » — le nom de ce composant de thème a été mis à jour en Topic List Sidebars car il prend désormais en charge les catégories et les tags.
 |
Résumé | Topic List Sidebars prend un sujet et l’applique comme barre latérale pour la liste des sujets d’une catégorie ou d’un tag. |
 |
Aperçu | Aperçu sur Discourse Theme Creator |
 |
Lien du dépôt | https://github.com/discourse/discourse-topic-list-sidebars |
 |
Nouveau avec les thèmes Discourse ? | Guide du débutant pour utiliser les thèmes Discourse |
Installer ce composant de thème
Fonctionnalités
Ce composant de thème prend un sujet et l’applique comme barre latérale pour la liste des sujets d’une catégorie ou d’un tag. Ces barres latérales ne sont visibles que lorsque la largeur du navigateur est de 767 pixels ou plus (la plupart des tablettes et moniteurs).
Que puis-je faire avec ce composant de thème ?
-
Choisir un sujet et afficher son contenu comme barre latérale pour une catégorie ou un tag.
-
Définir une barre latérale à afficher sur les pages /latest, /new, /unread et /top en utilisant
allcomme nom de catégorie dans vos paramètres. -
Choisir si les barres latérales apparaissent à gauche ou à droite de la liste des sujets.
-
Par défaut, la barre latérale d’une catégorie s’affichera également pour toutes ses sous-catégories, sauf si une sous-catégorie a sa propre barre latérale définie (vous pouvez désactiver cela en décochant le paramètre
inherit parent sidebar).
Comment le configurer ?
Choisissez vos catégories et tags, et ajoutez l’identifiant du sujet (par exemple example.com/t/example-topic/57) que vous souhaitez utiliser pour remplir le contenu de la barre latérale.
Je recommande de créer les sujets de la barre latérale dans leurs catégories/tags respectifs, de fermer le sujet pour qu’il n’y ait pas de réponses, et de le rendre non répertorié (afin qu’il n’apparaisse pas dans la liste des sujets).
Notez que vous ne pouvez pas utiliser un sujet d’une catégorie privée comme barre latérale dans une catégorie publique (vous pouvez techniquement le faire, mais les utilisateurs n’ayant pas accès à ce sujet privé verront simplement une barre latérale vide !).
Paramètres
| Nom | Description |
|---|---|
| sidebars | Ajouter et supprimer des barres latérales |
| sidebar side | Choisir entre Gauche ou Droite |
| inherit parent sidebar | Si cochée, les sous-catégories hériteront de la barre latérale de leur catégorie parent (sauf si la sous-catégorie a sa propre barre latérale assignée). Si décochée, les sous-catégories n’afficheront une barre latérale que si l’une est spécifiée. |
| stick on scroll | Si cochée, la barre latérale a une position fixe lors du défilement |
Notes pour les développeurs
Chaque barre latérale de catégorie est enveloppée dans une classe contenant le slug de la catégorie, donc pour la catégorie staff, ce serait .category-sidebar-staff. Vous pouvez utiliser ces classes pour styliser les barres latérales individuelles.
La balise body sur les pages avec des barres latérales a également une classe ajoutée afin que vous puissiez utiliser body.custom-sidebar pour appliquer des styles sur toutes les pages qui ont une barre latérale.
Crédits
Un grand merci à @xrav3nz pour avoir jeté les bases qui ont rendu ce composant possible !
Hébergé par nous ? Les composants de thème sont disponibles à l’utilisation sur nos plans Standard, Business et Enterprise.