La barre latérale offre un accès rapide aux sections importantes de votre site Discourse. Bien que les utilisateurs puissent personnaliser leur propre barre latérale selon leurs préférences, proposer une configuration par défaut réfléchie aide particulièrement les nouveaux utilisateurs et les visiteurs de votre forum en facilitant leur navigation.
Ce guide explique comment personnaliser les sections existantes et créer des sections supplémentaires dans la barre latérale. Vous apprendrez également quels paramètres ajuster pour configurer les valeurs par défaut des préférences utilisateur relatives à la barre latérale.
Personnaliser le contenu par défaut de chaque section
Section Communauté
La section supérieure de votre barre latérale (sans titre visible) est appelée la section « Communauté ». Cette section est visible par tous les utilisateurs et contient des liens de navigation essentiels.
Pour personnaliser cette section :
- Cliquez sur Plus dans la barre latérale
- Sélectionnez Personnaliser cette section en bas du menu étendu
Vous pouvez apporter les modifications suivantes :
- Réorganiser les liens en faisant glisser l’icône
- Modifier l’icône, le nom et le lien pour chaque entrée
- Ajouter de nouvelles entrées à la section
Comprendre les liens par défaut
Certains liens par défaut ont des comportements spéciaux :
- Mes publications – Ce lien s’affiche toujours par défaut sous le nom « Mes publications ». Cependant :
- Si l’utilisateur a un ou plusieurs brouillons, cliquer sur le lien l’emmène vers ses brouillons, et non vers son activité de publication.
- Si l’utilisateur appartient à un groupe sélectionné dans le paramètre du site
experimental_new_new_groups, le texte du lien change également en « Mes brouillons » lorsque des brouillons sont présents.
- Mes messages – Visible uniquement pour les utilisateurs appartenant à
personal_message_enabled_groups.- Il affiche un indicateur de non-lu ou le nombre de messages non lus pour votre boîte de réception personnelle et les boîtes de réception des groupes dont vous êtes membre.
- Il vous emmène toujours vers votre boîte de réception personnelle – même si le seul message non lu se trouve dans une boîte de réception de groupe.
- Examen – Visible uniquement pour le personnel et les modérateurs de catégorie.
- Admin – Visible uniquement pour les administrateurs et les modérateurs.
- Inviter – Visible uniquement pour les utilisateurs autorisés à inviter d’autres personnes.
Travailler avec les traductions
Les liens par défaut s’affichent automatiquement dans la langue de l’interface choisie par l’utilisateur. Cependant :
- Personnaliser le texte d’un lien par défaut le remplace pour toutes les langues
- Pour modifier le texte de langues spécifiques ou d’éléments cachés comme « Mes brouillons », suivez les instructions du guide sur la façon de personnaliser le texte dans Discourse.
Gérer les liens ajoutés par des plugins
Les liens ajoutés par des plugins ne peuvent pas actuellement être personnalisés via l’éditeur de barre latérale. Cependant, vous pouvez les remplacer par vos propres versions en utilisant la méthode suivante :
- Masquez le lien original ajouté par le plugin
- Ajoutez un lien personnalisé avec le comportement et l’apparence souhaités
Certains liens peuvent être masqués dans les paramètres du plugin. Par exemple, le lien vers les événements à venir peut être masqué en désactivant le paramètre sidebar_show_upcoming_events.
S’il n’existe pas de tel paramètre, vous pouvez masquer le lien à l’aide de CSS personnalisé.
Exemple de CSS pour masquer ou déplacer des liens de plugins
Masquer complètement un lien ajouté par un plugin
Cet exemple masque le lien ajouté par le plugin ActivityPub :
.sidebar-section-link-wrapper[data-list-item-name="activity-pub-about"] {
display: none;
}
Masquer un lien uniquement du menu « Plus »
Utile si vous déplacez un lien du menu « Plus » pour qu’il soit toujours visible :
.sidebar-more-section-content
.sidebar-section-link-wrapper.dropdown-menu__item[data-list-item-name="anniversaries"] {
display: none;
}
Masquer un lien uniquement de la section principale (pas dans le menu « Plus »)
Utile si vous souhaitez que le lien apparaisse dans le menu « Plus » plutôt que d’être toujours visible :
.sidebar-section.sidebar-section-wrapper:not(.sidebar-more-section-content)
.sidebar-section-link-wrapper[data-list-item-name="docs"] {
display: none;
}
Pour plus de détails sur la modification du CSS de votre site, consultez le guide sur la modification du CSS.
Section Catégories
Vous pouvez configurer les catégories qui apparaissent par défaut dans les barres latérales des utilisateurs dans le paramètre du site default_navigation_menu_categories. Vous pouvez y accéder en :
- Cliquez sur « Configurer les valeurs par défaut » en bas de la section Catégories (visible uniquement tant qu’aucune valeur par défaut n’est configurée)
- Accédez à ce paramètre via Admin > Tous les paramètres du site et recherchez le paramètre
La visibilité des catégories respecte les permissions des utilisateurs : les utilisateurs ne verront dans leur barre latérale que les catégories auxquelles ils ont accès, même si vous incluez des catégories restreintes dans les valeurs par défaut. Si vous configurez uniquement des catégories restreintes comme valeurs par défaut :
- Les visiteurs verront une liste vide
- Les utilisateurs connectés verront les catégories les plus populaires (comme s’ils avaient désélectionné toutes les catégories)
L’option « Modifier les catégories de la barre latérale » dans le menu à côté de « Catégories » personnalise uniquement votre vue personnelle, et non la valeur par défaut pour tous les utilisateurs.
Section Tags
Vous pouvez configurer les tags qui apparaissent par défaut dans les barres latérales des utilisateurs dans le paramètre du site default_navigation_menu_tags. Vous pouvez y accéder en :
- Cliquez sur « Configurer les valeurs par défaut » en bas de la section Tags (visible uniquement tant qu’aucune valeur par défaut n’est configurée)
- Accédez à ce paramètre via Admin > Tous les paramètres du site et recherchez le paramètre
La visibilité des tags respecte les permissions des utilisateurs : les tags d’un groupe de tags masqué n’apparaîtront pas dans les barres latérales des utilisateurs, même s’ils sont inclus dans les valeurs par défaut. Si vous configurez uniquement des tags restreints comme valeurs par défaut :
- Tous les utilisateurs (y compris les visiteurs) verront les tags les plus populaires (comme s’ils avaient désélectionné tous les tags)
Sections Chat
Toutes les sections de chat ne sont disponibles que lorsque le chat est activé[1], que l’utilisateur a l’autorisation d’utiliser le chat[2] et qu’il n’a pas désactivé le chat dans ses préférences.
Section Recherche de chat
La recherche de chat est contrôlée par le paramètre du site chat_search_enabled.
Section Discussions
La section Discussions n’apparaît que pour les utilisateurs qui sont membres d’au moins un chat où la fonction de discussion en fils est activée.
Section Canaux
La section Canaux affiche les canaux de chat auxquels l’utilisateur a rejoint. Les utilisateurs verront cette section s’il existe au moins un canal auquel ils pourraient rejoindre en fonction des permissions de catégorie. La section sera vide jusqu’à ce qu’ils aient rejoint au moins un canal.
Vous pouvez automatiser l’appartenance aux canaux via les paramètres du canal :
- Activez l’ajout automatique de membres dans les paramètres du canal
- Les nouveaux utilisateurs répondant aux critères verront automatiquement le canal dans leur barre latérale
Section Messages directs
La section Messages directs affiche les conversations de chat en un-à-un et en groupe. Pour voir cette section, les utilisateurs doivent appartenir à l’un des groupes direct_message_enabled_groups.
Vous ne pouvez pas configurer de conversations par défaut pour cette section. Mais au lieu d’une section vide, les utilisateurs verront un bouton « Démarrer un nouveau MD » remplaçant cette section.
Ajouter une section personnalisée
Vous pouvez créer des sections supplémentaires dans la barre latérale contenant des liens personnalisés. Elles apparaîtront sous la première section et au-dessus de la section Catégories. Pour ajouter une nouvelle section :
- Cliquez sur le bouton + en bas de la barre latérale
- Entrez un titre pour votre section
- Pour chaque lien que vous souhaitez ajouter :
- Sélectionnez une icône
- Entrez un nom pour le lien
- Spécifiez l’URL de destination
- Cliquez sur « Ajouter un autre lien » pour ajouter plus de liens
- Cochez « Visible pour tout le monde » pour que cette section apparaisse pour tous les utilisateurs
- Cliquez sur « Enregistrer » pour créer la section
La petite icône à côté du titre d’une section personnalisée n’est visible que par les administrateurs et indique que la section est visible pour tout le monde.
Personnaliser les étiquettes de texte
Vous pouvez personnaliser toutes les étiquettes de texte dans la barre latérale, y compris les titres de section :
- Accédez à Admin > Apparence > Textes du site
- Recherchez le texte que vous souhaitez personnaliser
Puisque de nombreuses étiquettes de barre latérale utilisent des mots courants, trouver la clé de texte spécifique peut être difficile. Pour vous aider :
- Utilisez la fonctionnalité de localisation détaillée pour identifier la clé de texte correcte
Personnaliser les valeurs par défaut des préférences utilisateur
Les utilisateurs peuvent personnaliser leurs préférences de barre latérale à l’adresse /my/preferences/navigation-menu. Vous pouvez définir les valeurs par défaut de ces préférences en utilisant les paramètres du site suivants :
default_sidebar_link_to_filtered_list
Ce paramètre contrôle si les liens de la barre latérale vers les listes de sujets (y compris « Tous les sujets » et les liens dans les sections Catégories et Tags) mènent à :
- Lorsqu’il est activé : Des listes filtrées pour afficher uniquement les sujets non lus ou nouveaux
- Lorsqu’il est désactivé : Des listes incluant tous les sujets
default_sidebar_show_count_of_new_items
Ce paramètre contrôle comment les nouveaux éléments sont affichés dans la barre latérale :
chat_separate_sidebar_mode
Lorsqu’il est activé, un bouton de chat ou de forum est ajouté au menu de navigation. Cela permet aux utilisateurs de basculer plus efficacement entre une expérience de chat plein écran et la vue du forum. En mode chat plein écran, seules les sections liées au chat (telles que Mes discussions, Canaux et MD) sont affichées dans la barre latérale. Si défini sur « toujours », les sections liées au chat dans la barre latérale sont masquées lors de la navigation sur le forum. Ce paramètre aide à maintenir une séparation claire entre les expériences de forum et de chat.
Il existe un paramètre du site default_sidebar_switch_panel_position qui vous permet de décider si le bouton bascule doit être affiché en haut ou en bas de la barre latérale. Les utilisateurs ne peuvent pas changer la position dans leurs préférences.
Personnalisation supplémentaire
Vous pouvez améliorer davantage la barre latérale de votre forum en utilisant des composants de thème. Pour explorer les options disponibles, recherchez des sujets dans la catégorie #theme-component::tag avec le tag sidebar (lien). Cependant, tous les composants n’ont pas de sujet sur Meta. Certains ont également été liés dans d’autres sujets.
Les composants de thème peuvent ajouter des fonctionnalités à votre barre latérale. Voici quelques exemples :
- Changer la visibilité par défaut de la barre latérale :
- Fermer la barre latérale par défaut : GitHub - VaperinaDEV/closed-sidebar-by-default
- Réduire les sections par défaut : GitHub - Arkshine/discourse-collapsed-sidebar- sections-by-default
- Changer les icônes de la barre latérale et les rendre dynamiques : Discourse Dynamic Sidebar Icon
- Changer l’ordre des sections de la barre latérale :
- Sections de barre latérale supplémentaires :
- Sections personnalisées visibles uniquement pour des groupes sélectionnés : Discourse Group Sidebar Menus
- Section pour les messages personnels pour afficher des liens directs vers les boîtes de réception de groupe : Section Messages pour la barre latérale
- Composants permettant d’afficher ou de masquer des sections spécifiques pour différents groupes d’utilisateurs, tels que les visiteurs ou le personnel :
- Composants qui indentent les sous-catégories, tels que :
Ressources connexes
- Creating quick access links to Discourse preference pages
- Customize text in Discourse
- Find a translation key with verbose localization