Configurando a barra lateral padrão para seus usuários

[Moin]

A barra lateral fornece acesso rápido às seções importantes do seu site Discourse. Embora os usuários possam personalizar sua própria barra lateral de acordo com suas preferências, fornecer uma configuração padrão bem pensada ajuda especialmente os novos usuários e visitantes do seu fórum, facilitando a navegação.

Este guia explica como personalizar as seções existentes e criar seções adicionais na barra lateral. Você também aprenderá quais configurações podem ser ajustadas para definir padrões para as preferências dos usuários relacionadas à barra lateral.

Personalizando o conteúdo padrão de cada seção

Seção da Comunidade

A seção superior da sua barra lateral (sem um título visível) é chamada de seção “Comunidade”. Esta seção é visível para todos os usuários e contém links de navegação essenciais.

Para personalizar esta seção:

1. Clique em Mais na barra lateral
2. Selecione Personalizar esta seção na parte inferior do menu expandido

Você pode fazer essas alterações:

• Reordenar links arrastando o ícone
• Editar o ícone, nome e link de cada entrada
• Adicionar novas entradas à seção

Entendendo os links padrão

Alguns dos links padrão têm comportamentos especiais:

• Meus posts - Este link é exibido como “Meus posts” por padrão. No entanto:
  • Se o usuário tiver um ou mais rascunhos, clicar no link o levará aos seus rascunhos, não à sua atividade de postagem.
  • Se o usuário pertencer a um grupo selecionado na configuração do site experimental_new_new_groups, o texto do link também muda para “Meus rascunhos” quando há rascunhos.
• Minhas mensagens - Visível apenas para usuários em personal_message_enabled_groups.
  • Mostra um indicador de não lidas ou o número de mensagens não lidas para sua caixa de entrada pessoal e as caixas de entrada dos grupos dos quais você é membro.
  • Sempre o leva à sua caixa de entrada pessoal - mesmo que a única mensagem não lida esteja em uma caixa de entrada de grupo.
• Revisão - Visível apenas para a equipe e moderadores de categoria.
• Admin - Visível apenas para administradores e moderadores.
• Convidar - Visível apenas para usuários que podem convidar outros.

Trabalhando com traduções

Os links padrão são exibidos automaticamente no idioma da interface selecionado pelo usuário. No entanto:

• Personalizar o texto de um link padrão o substitui para todos os idiomas
• Para editar o texto para idiomas específicos ou elementos ocultos como “Meus rascunhos”, siga as instruções no guia sobre como personalizar texto no Discourse.

Lidando com links adicionados por plugins

Links adicionados por plugins não podem ser personalizados atualmente através do editor da barra lateral. No entanto, você pode substituí-los por suas próprias versões usando a seguinte abordagem:

1. Ocultar o link original adicionado pelo plugin
2. Adicionar um link personalizado com o comportamento e aparência desejados

Alguns links podem ser ocultados nas configurações do plugin. Por exemplo, o link de eventos futuros pode ser ocultado desativando a configuração sidebar_show_upcoming_events.
Se não houver tal configuração, você pode ocultar o link usando CSS personalizado.

Exemplo de CSS para ocultar ou mover links de plugins

Ocultar um link adicionado por plugin completamente
Este exemplo oculta o link adicionado pelo plugin ActivityPub:

.sidebar-section-link-wrapper[data-list-item-name="activity-pub-about"] {
         display: none;
      }

Ocultar um link apenas do menu “Mais”
Útil se você estiver movendo um link do menu “Mais” para ser sempre visível:

.sidebar-more-section-content
  .sidebar-section-link-wrapper.dropdown-menu__item[data-list-item-name="anniversaries"] {
  display: none;
}

Ocultar um link apenas da seção principal (não no menu “Mais”)
Útil se você quiser que o link apareça no menu “Mais” em vez de ser sempre visível:

.sidebar-section.sidebar-section-wrapper:not(.sidebar-more-section-content)
  .sidebar-section-link-wrapper[data-list-item-name="docs"] {
  display: none;
}

Para mais detalhes sobre como fazer alterações de CSS no seu site, consulte o guia sobre como fazer alterações de CSS.

Seção de Categorias

Você pode configurar quais categorias aparecem por padrão nas barras laterais dos usuários na configuração do site default_navigation_menu_categories. Você pode acessá-la por:

1. Clicando em “Configurar padrões” na parte inferior da seção de categorias (visível apenas enquanto nenhum padrão estiver configurado)
2. Acessando esta configuração através de Admin > Todas as configurações do site e pesquisando a configuração

A visibilidade das categorias respeita as permissões dos usuários - os usuários verão apenas as categorias em sua barra lateral às quais têm permissão de acesso, mesmo que você inclua categorias restritas nos padrões. Se você configurar apenas categorias restritas como padrões:

• Os visitantes verão uma lista vazia
• Os usuários conectados verão as categorias mais populares (o mesmo que se tivessem desmarcado todas as categorias)

A opção ‘editar categorias da barra lateral’ no menu ao lado de “Categorias” personaliza apenas sua visualização pessoal, não o padrão para todos os usuários.

Seção de Tags

Você pode configurar quais tags aparecem por padrão nas barras laterais dos usuários na configuração do site default_navigation_menu_tags. Você pode acessá-la por:

1. Clicando em “Configurar padrões” na parte inferior da seção de tags (visível apenas enquanto nenhum padrão estiver configurado)
2. Acessando esta configuração através de Admin > Todas as configurações do site e pesquisando a configuração

A visibilidade das tags respeita as permissões dos usuários - as tags em um grupo de tags oculto não aparecerão nas barras laterais dos usuários, mesmo que estejam incluídas nos padrões. Se você configurar apenas tags restritas como padrões:

• Todos os usuários (incluindo visitantes) verão as tags mais populares (o mesmo que se tivessem desmarcado todas as tags)

O ícone de lápis ao lado de “Tags” personaliza apenas sua visualização pessoal, não o padrão para todos os usuários.

Seções de Chat

Todas as seções de chat estão disponíveis apenas quando o chat está habilitado^[1], o usuário tem permissão para usar o chat^[2] e não desativou o chat em suas preferências.

Seção de pesquisa de chat

A pesquisa de chat é controlada pela configuração do site chat_search_enabled.

Seção de Tópicos

A seção de tópicos aparece apenas para usuários que são membros de pelo menos um chat onde a thread é habilitada.

Seção de Canais

A seção de canais exibe os canais de chat aos quais o usuário se juntou. Os usuários verão esta seção se houver pelo menos um canal ao qual possam se juntar com base nas permissões da categoria. A seção estará vazia até que eles se juntem a pelo menos um canal.

Você pode automatizar a adesão aos canais através das configurações do canal:

1. Ativar a adição automática de membros nas configurações do canal
2. Novos usuários que atendem aos critérios verão o canal em sua barra lateral automaticamente

Seção de DMs

A seção de mensagens diretas exibe conversas de chat um-para-um e em grupo. Para ver esta seção, os usuários devem pertencer a qualquer um dos direct_message_enabled_groups.

Você não pode configurar conversas padrão para esta seção. Mas, em vez de uma seção vazia, os usuários verão um botão “Iniciar nova DM” substituindo esta seção.

Adicionando uma seção personalizada

Você pode criar seções adicionais na barra lateral que contenham links personalizados. Elas aparecerão abaixo da primeira seção e acima da seção de categorias. Para adicionar uma nova seção:

1. Clique no botão + na parte inferior da barra lateral
2. Insira um título para sua seção
3. Para cada link que você deseja adicionar:
   • Selecione um ícone
   • Insira um nome para o link
   • Especifique a URL de destino
   • Clique em “Adicionar outro link” para adicionar mais links
4. Marque “Visível para todos” para fazer esta seção aparecer para todos os usuários
5. Clique em “Salvar” para criar a seção

O pequeno ícone ao lado do título de uma seção personalizada é visível apenas para administradores e indica que a seção é visível para todos.

Personalizando rótulos de texto

Você pode personalizar todos os rótulos de texto na barra lateral, incluindo títulos de seções:

1. Navegue até Admin > Aparência > Textos do site
2. Pesquise o texto que deseja personalizar

Como muitos rótulos da barra lateral usam palavras comuns, encontrar a chave de texto específica pode ser desafiador. Para ajudar com isso:

• Use o recurso de localização detalhada para identificar a chave de texto correta

Personalizando os padrões das preferências dos usuários

Os usuários podem personalizar suas preferências da barra lateral em /my/preferences/navigation-menu. Você pode definir os padrões para essas preferências usando as seguintes configurações do site:

default_sidebar_link_to_filtered_list

Esta configuração controla se os links da barra lateral para listas de tópicos (incluindo “Todos os Tópicos” e links nas seções de Categorias e Tags) levam a:

• Quando habilitado: Listas filtradas para mostrar apenas tópicos não lidos ou novos
• Quando desabilitado: Listas incluindo todos os tópicos

default_sidebar_show_count_of_new_items

A configuração controla como os novos itens são exibidos na barra lateral:

Pontos/Badges	Contagens


chat_separate_sidebar_mode

Quando habilitado, um botão de chat ou fórum é adicionado ao menu de navegação. Isso permite que os usuários alternem entre uma experiência de chat em tela cheia e a visualização do fórum de forma mais eficiente. No modo de chat em tela cheia, apenas as seções relacionadas ao chat (como Meus tópicos, Canais e DMs) são exibidas na barra lateral. Se definido como “sempre”, as seções relacionadas ao chat na barra lateral são ocultadas enquanto navega no fórum. Esta configuração ajuda a manter as experiências do fórum e do chat claramente separadas.

Há uma configuração do site default_sidebar_switch_panel_position que permite decidir se o botão de alternância deve ser exibido no topo ou na parte inferior da barra lateral. Os usuários não podem alterar a posição em suas preferências.

Personalização adicional

Você pode aprimorar ainda mais a barra lateral em seu fórum usando componentes de tema. Para explorar as opções disponíveis, pesquise tópicos na categoria Customization > Theme component marcados com sidebar (link). No entanto, nem todo componente tem um tópico no Meta. Alguns também foram vinculados em outros tópicos.

Componentes de tema podem adicionar funcionalidades à sua barra lateral. Alguns exemplos incluem:

• Alterando a visibilidade padrão da barra lateral:
  • Fechar a barra lateral por padrão: GitHub - VaperinaDEV/closed-sidebar-by-default
  • Colapsar as seções por padrão: GitHub - Arkshine/discourse-collapsed-sidebar-sections-by-default
  • Alterar os ícones da barra lateral e torná-los dinâmicos: Discourse Dynamic Sidebar Icon
• Alterando a ordem das seções da barra lateral:
  • Discourse Sidebar Menu Reorder
• Seções adicionais da barra lateral:
  • Seções personalizadas visíveis apenas para grupos selecionados: Discourse Group Sidebar Menus
  • Seção para mensagens pessoais para mostrar links diretos para caixas de entrada de grupo: Seção de Mensagens para barra lateral
• Componentes que permitem mostrar ou ocultar seções específicas para diferentes grupos de usuários, como visitantes ou equipe:
  • Controle de exibição do menu de navegação (barra lateral)
• Componentes que indentam subcategorias, como:
  • Discourse Indented Subcategories
  • GitHub: discourse-sidebar-nested-categories

Ao implementar recursos avançados, lembre-se de que os usuários podem personalizar sua barra lateral. Teste como suas personalizações aparecem com diferentes seleções de usuários. Por exemplo, como as subcategorias aninhadas parecem quando os usuários adicionam uma subcategoria, mas não sua categoria pai.

Recursos relacionados

• Creating quick access links to Discourse preference pages
• Customize text in Discourse
• Find a translation key with verbose localization

---

1. chat_enabled ↩︎

2. chat_allowed_groups ↩︎

[NateDhaliwal]

Sempre procurei por tópicos de #documentação para personalização de barra lateral baseada em admin, quando tais perguntas surgem. Agora finalmente há uma!