 |
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 |
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 principales :
- Visibilité des menus 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 un nombre illimité de sections de menu 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 les administrateurs directement 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é en tant qu’en-tête de section dans la barre latérale |
| Groupes autorisés | Groupes autorisés à voir cette section de menu (maximum : 20 groupes par section) |
| Liens du menu | Collection de liens à afficher dans cette section (maximum : 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é dans 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
Titre du menu, puis sélectionnez les groupes que vous souhaitez autoriser à y accéder. - Cliquez sur
+ new_menu_sectionpour ajouter une autre section, ou enregistrez les modifications.
Captures d'écran de la configuration administrateur avec 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 auMenu Chat@HelloKittyaime les chiens et fait partie du groupepurple, qui aura accès auMenu Chien@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 auMenu Chatcar les chats ont besoin de plus de surveillance
Créez un nouveau menu personnalisé - pour notre exemple, créez Menu Chat 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 Menu Chien, accordez uniquement au groupe purple l’accès et configurez les liens :
Captures d'écran de l'accès résultant au menu de 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
Titre du menu : « Choses de chat »
Groupes autorisés : team-cat
Liens :
- Icône : link
Texte : Vidéos et photos de chats
URL : /t/cat-videos-and-photos/123
- Icône : magnifying-glass
Texte : Wiki sur les chats
URL : https://en.wikipedia.org/wiki/Cat
Notes 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 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 la 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 rendu dans la barre latérale, pas qui peut accéder aux ressources réelles.
Toujours s’appuyer sur le 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 autorisés de manière appropriée pour les groupes sélectionnés.
Ceci était 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 ?