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, fournir 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 vous pouvez ajuster pour configurer les valeurs par défaut des préférences utilisateur liées à la barre latérale.
Personnalisation du 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 pour 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 auxquels vous appartenez.
- Il vous emmène toujours à 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.
- Administration - 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 :
- La personnalisation du texte d’un lien par défaut l’écrase pour toutes les langues
- Pour modifier le texte pour des langues spécifiques ou des éléments masqués comme « Mes brouillons », suivez les instructions du guide sur la façon de personnaliser le texte dans Discourse.
Gestion des 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 l’approche 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 des é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 les 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 » au lieu 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 cliquant 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)
- En accédant à ce paramètre via Admin > Tous les paramètres du site et en recherchant le paramètre
La visibilité des catégories respecte les permissions utilisateur : 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 cliquant 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)
- En accédant à ce paramètre via Admin > Tous les paramètres du site et en recherchant le paramètre
La visibilité des tags respecte les permissions utilisateur : 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ù les fils de discussion sont activés.
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 un à un et de groupe. Pour voir cette section, les utilisateurs doivent appartenir à l’un des 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.
Ajout d’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 tous » 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 pour les administrateurs et indique que la section est visible pour tous.
Personnalisation des libellés de texte
Vous pouvez personnaliser tous les libellés 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 nombreux libellés 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
Personnalisation des valeurs par défaut des préférences utilisateur
Les utilisateurs peuvent personnaliser leurs préférences de barre latérale à /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 :
Lien de barre latérale par défaut vers une liste filtrée
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
Afficher par défaut le nombre d’éléments nouveaux dans la barre latérale
Ce paramètre contrôle comment les éléments nouveaux sont affichés dans la barre latérale :
Mode de barre latérale séparée pour le chat
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 supplémentaires de la barre latérale :
- 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