Anciennement « Barres latérales de catégories Discourse » — le nom de ce composant de thème a été mis à jour en Barres latérales de liste de sujets maintenant qu’il prend en charge à la fois les catégories et les étiquettes.
 |
Résumé | Barres latérales de liste de sujets prend un sujet et l’applique comme barre latérale pour la liste des sujets d’une catégorie ou d’une étiquette. |
 |
Aperçu | Aperçu sur Discourse Theme Creator |
 |
Lien vers le dépôt | https://github.com/discourse/discourse-topic-list-sidebars |
 |
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
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’une étiquette. Ces barres latérales ne sont visibles que lorsque le navigateur a une largeur d’au moins 767 px (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 une étiquette.
-
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 d’afficher les barres latérales à gauche ou à droite de la liste des sujets.
-
Par défaut, la barre latérale d’une catégorie s’affiche é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 cette option en décochant le paramètre
hériter de la barre latérale parente).
Comment le configurer ?
Choisissez vos catégories et étiquettes, puis ajoutez l’identifiant du sujet (par exemple, example.com/t/exemple-sujet/57) que vous souhaitez utiliser pour remplir le contenu de la barre latérale.
Je recommande de créer des sujets de barre latérale dans leurs catégories/étiquettes respectives, de fermer le sujet pour qu’il n’y ait aucune réponse, et de le rendre non listé (pour 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 |
| côté de la barre latérale | Choisir entre Gauche ou Droite |
| hériter de la barre latérale parente | Si coché, les sous-catégories hériteront de la barre latérale de leur catégorie parente (sauf si la sous-catégorie a sa propre barre latérale assignée). Lorsqu’il est décoché, les sous-catégories n’afficheront une barre latérale que si elle est spécifiée. |
| coller au défilement | Lorsqu’il est coché, 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, vous pouvez donc utiliser body.custom-sidebar pour appliquer des styles sur toutes les pages qui ont une barre latérale.
Crédits
Un merci spécial à @xrav3nz pour avoir posé les bases permettant de rendre ce composant possible !
Hébergé par nous ? Les composants de thème sont disponibles pour une utilisation sur nos plans Standard, Business et Entreprise.