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

[Moin]

A barra lateral oferece 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 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 os padrões das preferências do usuário relacionadas à barra lateral.

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

Seção 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 as seguintes alterações:

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

Compreendendo os links padrão

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

• Meus posts - Este link sempre é exibido como “Meus posts” por padrão. No entanto:
  • Se o usuário tiver um ou mais rascunhos, clicar no link o levará para seus rascunhos, não para 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 presentes.
• Minhas mensagens - Visível apenas para usuários em personal_message_enabled_groups.
  • Mostra um indicador de não lido 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 leva você à 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 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 de 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. Oculte o link original adicionado pelo plugin
2. Adicione um link personalizado com o comportamento e a 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 completamente um link adicionado por plugin
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 que esteja 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 estar 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 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:

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 pela configuração

A visibilidade da categoria respeita as permissões do usuário — os usuários verão apenas as categorias em sua barra lateral às quais têm permissão para acessar, mesmo que você inclua categorias restritas nos padrões. Se você configurar apenas categorias restritas como padrões:

• Visitantes verão uma lista vazia
• Usuários logados 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 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:

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 pela configuração

A visibilidade da tag respeita as permissões do usuário — tags em um grupo de tags oculto não aparecerão nas barras laterais dos usuários, mesmo que 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 no chat

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

Seção de Threads

A seção de threads aparece apenas para usuários que são membros de pelo menos um chat onde o threading está habilitado.

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 que possam ingressar com base nas permissões da categoria. A seção ficará vazia até que eles tenham ingressado em pelo menos um canal.

Você pode automatizar a associação ao canal nas configurações do canal:

1. Habilite 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 Mensagens Diretas (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 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ção:

1. Navegue para Admin > Aparência > Textos do site
2. Pesquise pelo 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 padrões de preferência do usuário

Os usuários podem personalizar suas preferências de 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 novos itens são exibidos na barra lateral:

Pontos/Máscaras	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 seções relacionadas ao chat (como Meus threads, 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 de fórum e chat claramente separadas.

Existe 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 do seu fórum usando componentes de tema. Para explorar as opções disponíveis, pesquise por tópicos na categoria #theme-component::category com a tag 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 funcionalidade à sua barra lateral. Alguns exemplos incluem:

• Alterar 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
• Alterar 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 recuam 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 categorias aninhadas aparecem 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!