Organizador de Categorias da Barra Lateral

[Drew-ART (Drew)]

Eu criei um organizador de barra lateral. Houve muitas discussões sobre isso há algum tempo e outros sentiram que não era necessário, mas eu sempre senti que meus usuários não são muito técnicos ou não sabem como o fórum funciona bem o suficiente no início, então criei este organizador suspenso para ajudar.

Há um pequeno botão de alternância no topo para que os usuários possam alternar e escolher o que preferirem.

Organizador de Categorias da Barra Lateral

Um componente de tema Discourse que organiza as categorias da barra lateral em seções personalizáveis, recolhíveis e com código de cores, com recursos avançados.

Funcionalidades

• 10 Seções Recolhíveis: Agrupe categorias em até 10 seções personalizadas
• Personalização de Cores: Defina cores de fundo e de texto para o cabeçalho de cada seção
• Fundos em Gradiente: Efeito de desvanecimento em gradiente opcional, como nas fotos
• Emblemas de Categoria: Emblemas coloridos padrão do Discourse ao lado das categorias podem ser ativados ou desativados
• Suporte a Subcategorias: Alternância por seção para mostrar/ocultar subcategorias (exibição recuada)
• Ocultar Categorias: Oculte categorias específicas de todas as visualizações
• Alternância Bidirecional: Alterne entre as seções personalizadas e a visualização padrão do Discourse (botão de alternância aparece em ambas as visualizações)
• Estado Persistente: Lembra quais seções estão abertas/fechadas e a preferência de visualização do usuário
• Consciência de Permissão: Mostra apenas as categorias às quais os usuários têm acesso
• Categorias Não Agrupadas: Exibe automaticamente quaisquer categorias não categorizadas em uma seção separada
• Responsivo para Dispositivos Móveis: Funciona em todos os tamanhos de tela

Instalação

1. Vá para Admin → Personalizar → Temas em sua instância do Discourse
2. Clique em Instalar → De um repositório Git
3. Insira: https://github.com/focallocal/sidebar-categories-organizer
4. Clique em Instalar
5. Adicione o componente ao seu tema ativo

Configuração

Configurações Globais

• Ativar Organizador da Barra Lateral: Ativa/desativa a visualização personalizada
• Mostrar Botão de Alternância: Exibe o ícone para alternar entre as visualizações (aparece nos cabeçalhos das visualizações personalizada e padrão)
• Mostrar Emblemas de Categoria: Exibe quadrados coloridos ao lado dos nomes das categorias
• Usar Desvanecimento em Gradiente: Ativa o efeito de fundo em gradiente nos cabeçalhos das seções (50% cor sólida, 50% desvanecimento para transparente)
• Categorias a Ocultar: Slugs de categorias separadas por vírgula para ocultar de todas as visualizações (ex: staff,private)
• Visualização Padrão: Escolha qual visualização carrega por padrão (personalizada ou padrão)

Configurações de Seção (1-10)

Cada seção possui:

• Ativado: Alterna a seção para ligar/desligar
• Título: Texto do cabeçalho da seção
• Cor de Fundo: Seletor de cores para o fundo do cabeçalho da seção
• Cor do Texto: Seletor de cores para o texto do cabeçalho
• Categorias: Slugs de categorias separadas por vírgula (ex: general,support,feedback)
• Mostrar Subcategorias: Alterna para mostrar/ocultar subcategorias para esta seção
• Padrão Aberto: Se a seção começa expandida ou recolhida

Encontrando Slugs de Categoria

Slugs de categoria estão no URL:

• seusite.com/c/general/5 → o slug é general
• seusite.com/c/feature-requests/12 → o slug é feature-requests

Uso

Após a instalação e configuração:

1. Visualização Personalizada: As categorias são agrupadas em suas seções configuradas com cabeçalhos coloridos
2. Expandir/Recolher: Clique nos cabeçalhos das seções para alternar a visibilidade do conteúdo
3. Alternar Visualizações: Clique no ícone no cabeçalho para alternar entre as visualizações personalizada e padrão
   • Na visualização personalizada: O botão de alternância aparece no cabeçalho da visualização personalizada
   • Na visualização padrão: O botão de alternância aparece no cabeçalho “Categorias” padrão
4. Subcategorias: Quando ativadas por seção, as subcategorias aparecem recuadas abaixo das categorias principais
5. Emblemas de Categoria: Pequenos quadrados coloridos (se ativados) mostram a cor de cada categoria
6. Categorias Não Agrupadas: Quaisquer categorias não atribuídas a seções aparecem em “Outras Categorias”
7. Preferências: Sua escolha de visualização e estado aberto/fechado são salvos por navegador

Funcionalidades Avançadas

Fundos em Gradiente

Quando ativado, os cabeçalhos das seções usam um gradiente suave:

• 50% cor sólida (sua cor de fundo escolhida)
• 50% desvanecimento para transparente
• Cria uma aparência moderna e elegante

Ocultar Categorias

Especifique slugs de categoria para ocultar completamente da barra lateral:

• Útil para categorias apenas para a equipe ou descontinuadas
• Aplica-se a ambas as visualizações, personalizada e padrão
• Lista separada por vírgulas (ex: staff,private,archived)

Subcategorias

• Alternância por seção (não global)
• Exibição recuada com fonte ligeiramente menor
• Opacidade reduzida para hierarquia visual
• Mantém as cores dos emblemas das categorias

Versão

• Atual: 1.0.1
• Discourse Mínimo: 3.3.0
• Autor: Andy@Focallocal

Licença

Licença MIT - Consulte o arquivo LICENSE

Suporte

Relate problemas: GitHub · Where software is built

[Lilly (Lillian Louis)]

Ótimo trabalho

Dica de configuração de categoria

Em vez de fazer com que os administradores insiram slugs de categoria, você pode usar isto no seu arquivo settings.yml, por exemplo:

categories_to_hide:
  type: list
  list_type: category
  default: ""
  description:
    en: "Categories to hide from sidebar completely."

o que lhe dará uma configuração como esta:

Você também pode fazer a mesma coisa com grupos, se alguma vez quiser um menu suspenso de grupo:

groups_this_setting_applies_to:
  type: list
  list_type: group
  default: ""
  description:
    en: "Groups this setting will apply to."

o que dará algo como isto: