 |
Resumo | Criar menus de barra lateral personalizados para grupos selecionados |
 |
Pré-visualização | Junte-se a este grupo de Criador de Temas e depois visualize aqui |
 |
Repositório | https://github.com/Lillinator/discourse-group-sidebar-menus |
 |
Guia de Instalação | Como instalar um tema ou componente de tema |
Instalar este componente de tema
Visão Geral
Este componente de tema do Discourse oferece aos administradores do fórum a capacidade de criar menus de barra lateral personalizados que são acessíveis apenas aos membros de grupos selecionados.
Principais Recursos:
- Visibilidade de menu baseada em grupo — Seções de menu são renderizadas na barra lateral apenas para usuários autorizados
- Configuração baseada em objeto — Interface de configuração fácil de usar para criar menus
- Múltiplas seções — Crie seções de menu ilimitadas para diferentes grupos (dentro do razoável)
- Link de edição rápida para administradores — O ícone de lápis nos cabeçalhos do menu leva os administradores diretamente às configurações do componente
Alguns Casos de Uso
- Recursos e links rápidos apenas para a equipe
- Atalhos para moderadores de categoria
- Portais personalizados para grupos (equipes de projeto, grupos de estudo, clubes de livro, membros VIP)
- Links para recursos de sites de parceiros ou filiais
Configurações
Seções de Menu (menu_sections)
Abre o editor de configurações de objeto para configurar seções de menu de grupo personalizadas.
Propriedades da Seção
| Propriedade | Descrição |
|---|---|
| Título do menu | Título exibido como o cabeçalho da seção na barra lateral |
| Grupos permitidos | Grupos autorizados a visualizar esta seção de menu (máx: 20 grupos por seção) |
| Links do menu | Coleção de links para exibir nesta seção (máx: 20 links por seção) |
Propriedades do Link
| Propriedade | Descrição |
|---|---|
| Ícone | Nome do ícone do FontAwesome (por exemplo, circle-info, star, user-group). Pode ser necessário adicioná-lo em Admin > Todas as configurações do site > subconjunto de ícones svg |
| Texto | Rótulo de exibição para o link |
| URL | Destino do link — suporta tanto caminhos relativos (/faq, /minhas/preferencias) quanto URLs absolutas (https://exemplo.com) |
Instalação e Configuração
- Instale o componente de tema conforme descrito em Installing a theme or theme component.
- Vá para o
Editor de configurações de objetos - Clique no botão
+ new_menu_sectionpara configurar a primeira seção de menu personalizada - Dê um título ao novo menu no campo
Título do menue, em seguida, selecione os grupos que devem ter acesso a ele. - Clique em
+ new_menu_sectionpara adicionar outra seção ou Salvar alterações.
Capturas de tela da configuração administrativa com exemplo
Instalação recente — vá para o Editor de configurações de objetos.
Cenário de exemplo com 2 menus personalizados e 3 usuários, sendo um deles administrador:
@Catraama gatos e é membro do grupopink, que terá acesso aoMenu de Gatos@HelloKittygosta de cachorros e é membro do grupopurple, que terá acesso aoMenu de Cães@Lillyé membro do grupopurpleporque ela tem um cachorro e cachorros são melhores. No entanto, ela também é administradora do fórum, e administradores terão acesso aoMenu de Gatosporque gatos precisam de mais supervisão
Crie um novo menu personalizado — para nosso exemplo, crie o Menu de Gatos e adicione os grupos autorizados a ter acesso a ele — pink e admins. Em seguida, clique no botão + menu_link para configurar os links do novo menu.
Adicione os links do menu — 1. Nome do ícone do FontAwesome, 2. texto para exibir no link e 3. a URL, relativa ou absoluta. Clique no botão + menu_link para adicionar outro link a este menu.
Crie outra seção de menu personalizada chamada Menu de Cães, conceda acesso apenas ao grupo purple e configure os links:
Capturas de tela do acesso resultante ao menu da barra lateral
O usuário @Catra tem o Menu de Gatos! 
O usuário @HelloKitty tem o Menu de Cães!
O usuário administrador @Lilly tem ambos os menus e pode editá-los! 
Exemplo de Configuração
Título do Menu: "Coisas de Gato"
Grupos Permitidos: team-cat
Links:
- Ícone: link
Texto: Vídeos e fotos de gatos
URL: /t/videos-e-fotos-de-gatos/123
- Ícone: magnifying-glass
Texto: Wiki de gatos
URL: https://pt.wikipedia.org/wiki/Gato
Notas Importantes
Acesso de Administrador
Os administradores devem adicionar-se aos grupos para ver os menus configurados para esses grupos. O status de administrador sozinho não concede acesso a todos os menus personalizados. Isso é intencional! Além disso, administradores que pertencem aos grupos permitidos de um menu verão um ícone de lápis no cabeçalho da seção que leva às configurações do componente.
Configuração de Grupos
- O grupo
everyonenão é suportado — Use a interface nativa do rodapé da barra lateral para criar menus personalizados globais para todos os usuários, incluindo visitantes anônimos. - Máximo de 20 grupos por seção de menu. Se precisar de mais, crie seções duplicadas com atribuições de grupo diferentes.
- Usuários em múltiplos grupos verão todas as seções de menu às quais têm acesso.
Testes e Organização
Use contas de teste para verificar o acesso correto para diferentes combinações de grupos. Mantenha um registro das suas configurações de menu para evitar confusão à medida que a complexidade aumenta; uma matriz de acesso ou documentação semelhante é recomendada para fóruns maiores com muitos grupos.
Considerações de Segurança
Este componente fornece controle de acesso apenas no nível da interface do usuário. Ele controla a visibilidade do menu, não o acesso aos recursos — este componente controla apenas o que é renderizado na barra lateral, não quem pode acessar os recursos reais.
Sempre confie no sistema de permissões integrado do Discourse para proteger os recursos reais:
- Configure corretamente as permissões de categoria
- Defina restrições de visibilidade de tópicos
- Use controles de acesso baseados em grupo para conteúdo
- Garanta que recursos privados exijam autenticação
Melhor prática para administradores:
Configure as permissões de segurança de categorias vinculadas e a associação de grupos separadamente — por exemplo: um link de menu para uma categoria privada deve ter as permissões dessa categoria configuradas corretamente. Os administradores são responsáveis por garantir que links para recursos externos estejam adequadamente autorizados para os grupos selecionados.
Este foi um projeto colaborativo com @Moin — sua contribuição, inspiração e feedback foram inestimáveis.
Confira meu outro conteúdo do Discourse
) Nas suas capturas de tela, seu Cat Menu e Dog Menu estão na navegação da barra lateral acima da seção Topics, mas meu menu de grupo personalizado está aparecendo na parte inferior da minha navegação da barra lateral. Como eu o movo para cima, acima de Topics?