 |
Résumé | Créer des menus de barre latérale personnalisés pour des groupes sélectionnés |
 |
Aperçu | Rejoignez ce groupe de créateurs de thèmes puis prévisualisez ici |
 |
Dépôt | https://github.com/Lillinator/discourse-group-sidebar-menus |
 |
Guide d’installation | Comment installer un thème ou un composant de thème |
 |
Nouveau sur les thèmes Discourse ? | Guide de démarrage pour l’utilisation des thèmes Discourse |
Installer ce composant de thème
Aperçu
Ce composant de thème Discourse permet aux administrateurs de forum de créer des menus de barre latérale personnalisés accessibles uniquement aux membres de groupes sélectionnés.
Fonctionnalités clés :
- Visibilité du menu basée sur les groupes : les sections de menu ne sont affichées dans la barre latérale que pour les utilisateurs autorisés
- Configuration basée sur les objets : interface de paramètres facile à utiliser pour créer des menus
- Sections multiples : créez des sections de menu illimitées pour différents groupes (dans la mesure du raisonnable)
- Lien d’édition rapide pour les administrateurs : l’icône de crayon dans les en-têtes de menu redirige directement les administrateurs vers les paramètres du composant
Quelques cas d’utilisation
- Ressources et liens rapides réservés au personnel
- Raccourcis pour les modérateurs de catégories
- Portails personnalisés pour groupes (équipes de projet, groupes d’étude, clubs de lecture, membres VIP)
- Liens vers des ressources de sites web parents ou partenaires
Paramètres
Sections de menu (menu_sections)
Ouvre l’éditeur de paramètres d’objet pour configurer des sections de menu de groupe personnalisées.
Propriétés de la section
| Propriété | Description |
|---|---|
| Titre du menu | Titre affiché comme en-tête de section dans la barre latérale |
| Groupes autorisés | Groupes autorisés à voir cette section de menu (max : 20 groupes par section) |
| Liens du menu | Collection de liens à afficher dans cette section (max : 20 liens par section) |
Propriétés du lien
| Propriété | Description |
|---|---|
| Icône | Nom de l’icône FontAwesome (par exemple, circle-info, star, user-group). Peut nécessiter d’être ajouté à Admin > Tous les paramètres du site > sous-ensemble d'icônes svg |
| Texte | Libellé d’affichage pour le lien |
| URL | Destination du lien - prend en charge à la fois les chemins relatifs (/faq, /my/preferences) et les URL absolues (https://example.com) |
Installation et configuration
- Installez le composant de thème conformément à Installing a theme or theme component.
- Accédez à l’
éditeur de paramètres d'objet. - Cliquez sur le bouton
+ new_menu_sectionpour configurer la première section de menu personnalisée. - Donnez un titre au nouveau menu dans le champ
Menu title, puis sélectionnez les groupes qui doivent y avoir accès. - Cliquez sur
+ new_menu_sectionpour ajouter une autre section, ou enregistrez les modifications.
Captures d'écran de configuration par l'administrateur avec un exemple de mise en place
Installation fraîche - accédez à l’éditeur de paramètres d'objet.
Scénario exemple avec 2 menus personnalisés et 3 utilisateurs, dont un administrateur :
@Catraadore les chats et fait partie du groupepink, qui aura accès auCat Menu@HelloKittyaime les chiens et fait partie du groupepurple, qui aura accès auDog Menu@Lillyfait partie du groupepurplecar elle possède un chien et les chiens sont meilleurs. Cependant, elle est aussi administratrice du forum, et les administrateurs auront accès auCat Menucar les chats ont besoin de plus de surveillance
Créez un nouveau menu personnalisé - pour notre exemple, créez Cat menu et ajoutez les groupes autorisés à y accéder : pink et admins. Ensuite, cliquez sur le bouton + menu_link pour configurer les liens du nouveau menu.
Ajoutez les liens du menu - 1. Nom de l’icône Fontawesome, 2. texte à afficher pour le lien, et 3. l’URL, relative ou absolue. Cliquez sur le bouton + menu_link pour ajouter un autre lien à ce menu.
Créez une autre section de menu personnalisée appelée Dog menu, donnez uniquement au groupe purple l’accès et configurez les liens :
Captures d'écran de l'accès résultant au menu de la barre latérale
L’utilisateur @Catra a le menu Chat ! 
L’utilisateur @HelloKitty a le menu Chien !
L’utilisateur administrateur @Lilly a les deux menus et peut les modifier ! 
Exemple de configuration
Menu Title: "Cat Stuff"
Allowed Groups: team-cat
Links:
- Icon: link
Text: Cat videos & photos
URL: /t/cat-videos-and-photos/123
- Icon: magnifying-glass
Text: Cat wiki
URL: https://en.wikipedia.org/wiki/Cat
Remarques importantes
Accès administrateur
Les administrateurs doivent s’ajouter eux-mêmes aux groupes pour voir les menus configurés pour ces groupes. Le statut d’administrateur seul ne donne pas accès à tous les menus personnalisés. C’est intentionnel ! De plus, les administrateurs appartenant aux groupes autorisés d’un menu verront une icône de crayon dans l’en-tête de la section, qui redirige vers les paramètres du composant.
Configuration des groupes
- Le groupe
everyonen’est pas pris en charge - Utilisez l’interface utilisateur native du pied de page de la barre latérale pour créer des menus personnalisés globaux pour tous les utilisateurs, y compris les visiteurs anonymes. - Maximum de 20 groupes par section de menu. Si vous en avez besoin de plus, créez des sections dupliquées avec des affectations de groupes différentes.
- Les utilisateurs appartenant à plusieurs groupes verront toutes les sections de menu auxquelles ils ont accès.
Tests et organisation
Utilisez des comptes de test pour vérifier l’accès correct pour différentes combinaisons de groupes. Gardez une trace de vos configurations de menu pour éviter toute confusion à mesure que la complexité augmente ; une matrice d’accès ou une documentation similaire est recommandée pour les forums plus grands avec de nombreux groupes.
Considérations de sécurité
Ce composant fournit uniquement un contrôle d’accès au niveau de l’interface utilisateur. Il contrôle la visibilité du menu, pas l’accès aux ressources : ce composant contrôle uniquement ce qui est affiché dans la barre latérale, pas qui peut accéder aux ressources réelles.
Toujours se fier au système de permissions intégré de Discourse pour sécuriser les ressources réelles :
- Configurez correctement les permissions des catégories
- Définissez des restrictions de visibilité des sujets
- Utilisez des contrôles d’accès basés sur les groupes pour le contenu
- Assurez-vous que les ressources privées nécessitent une authentification
Meilleure pratique pour les administrateurs :
Configurez séparément les permissions de sécurité des catégories liées et l’appartenance aux groupes - par exemple : un lien de menu vers une catégorie privée doit avoir les permissions de cette catégorie correctement configurées. Les administrateurs sont responsables de s’assurer que les liens vers des ressources externes sont correctement autorisés pour les groupes sélectionnés.
Il s’agit d’un projet collaboratif avec @Moin - ses contributions, son inspiration et ses retours ont été inestimables.
Découvrez mes autres créations Discourse
) Dans vos captures d’écran, votre Cat Menu et Dog Menu se trouvent dans la navigation de la barre latérale au-dessus de la section Topics, mais mon menu de groupe personnalisé apparaît tout en bas de ma navigation de barre latérale. Comment puis-je le déplacer au-dessus de Topics ?