Reordenar o menu lateral do Discourse

[Lilly]

	Resumo	Permite reordenar as seções padrão e personalizadas do menu da barra lateral
	Pré-visualização	https://discourse.theme-creator.io/theme/Lilly/discourse-sidebar-menu-reorder
	Repositório	https://github.com/Lillinator/discourse-sidebar-menu-reorder
	Guia de Instalação	Como instalar um tema ou componente de tema
	Novo nos Temas do Discourse?	Guia para iniciantes sobre o uso de Temas do Discourse

Instale este componente de tema

Introdução

Tenho visto várias solicitações de administradores do Discourse que desejam reordenar as seções do menu da barra lateral, incluindo seções personalizadas globais. Como atualmente não é muito intuitivo ou direto para a maioria das pessoas fazer isso com CSS, e gerenciá-lo pode ser difícil e trabalhoso, criei um componente de tema que torna muito mais fácil na interface administrativa.

Visão Geral

Este componente de tema do Discourse permite que administradores reordenem as seções do menu da barra lateral do fórum na interface de usuário administrativa, incluindo todas as seções padrão, bem como quaisquer seções personalizadas visíveis globalmente.

O componente funciona tanto para as visualizações da barra lateral em desktop quanto em dispositivos móveis, bem como no modo de menu suspenso no cabeçalho (embora, idealmente, seja feito para o modo de barra lateral).

---

Instalação & Configuração

• Instale este componente de tema conforme o Guia para iniciantes sobre o uso de Temas do Discourse.
• A seção community refere-se à seção superior padrão da barra lateral — o menu com o cabeçalho Tópicos e inclui o submenu suspenso Mais; recomenda-se que não mais do que uma ou duas seções (padrão ou personalizadas) sejam movidas acima da seção community.
• Não exclua nenhuma das seções padrão nas configurações, pois elas ficarão fora de ordem (você sempre poderá adicioná-las novamente ou redefinir a configuração).
• A melhor maneira de configurar este componente é ter a tela administrativa do componente com a configuração de lista de reordenação em uma janela do navegador e a visualização da barra lateral do fórum como um usuário de teste em outra janela ao lado; recarregue a página após cada alteração na ordem das seções do menu na lista.

---

Configurações

Configuração

Descrição

Sidebar menu order

Uma configuração de lista que contém as seções padrão do menu. (community é a seção superior padrão na barra lateral e inclui o submenu suspenso More. ) Reordene as seções do menu com as setas para cima e para baixo ao lado. Seções personalizadas visíveis globalmente também podem ser adicionadas — use o slug do nome do menu (por exemplo, para um menu personalizado chamado Test Menu, adicione test-menu na configuração).

O componente de tema inicialmente possui as configurações padrão. Os administradores precisam adicionar quaisquer seções de menu personalizadas globais que desejem misturar na lista de ordenação e, em seguida, reorganizá-las junto com as seções padrão.

screenshot of default component setttings

---

Capturas de Tela

As capturas de tela abaixo mostram a seção community e duas seções de menu personalizadas de exemplo chamadas “Dev Links” (dev-links) e “Toolbox” (toolbox) conforme aparecem no painel administrativo do componente à esquerda e para um usuário regular à direita. As setas para mover uma seção do menu para cima e para baixo na configuração administrativa do componente são mostradas na pequena caixa vermelha.

---

Aqui, a configuração está configurada para mostrar a seção padrão categories acima da seção community (modos colapsado e expandido):

Aqui está um exemplo usando duas seções personalizadas: uma chamada dev-links que está acima da seção padrão community e outra chamada toolbox que fica abaixo da seção padrão tags.

Além disso, observe a seção chamada inbox-section na captura de tela administrativa acima — esta é a seção Messages que o componente Seção de mensagens para barra lateral insere na barra lateral (sob o menu personalizado toolbox acima), mostrando que este componente pode ser usado para movê-lo também.

Além disso, este componente de tema pode ser usado juntamente com os componentes Menus de barra lateral de grupos e Subcategorias indentadas (veja na captura de tela acima).

---

Observações

• Após adicionar novas seções personalizadas globais à configuração sidebar_menu_order, os usuários do fórum verão a nova ordem correta do menu quando recarregarem o navegador ou colapsarem/expandirem a barra lateral.
• Criar novas seções de menu personalizadas globais enquanto este componente está habilitado pode resultar em seções duplicadas temporárias para o administrador até que a barra lateral seja renderizada novamente, seja com uma atualização da página ou colapsando e expandindo.
• Seções de menu personalizadas criadas por usuários sempre aparecerão na parte inferior da barra lateral para aquele usuário, mas não são afetadas de outra forma.
• Se a configuração Admin -> Todas as Configurações do Site -> Modo de Barra Lateral Separado do Chat estiver definida como Sempre, o botão de chat aparecerá como usual na parte inferior e o componente ignorará as seções padrão do menu de chat (chat-dms, chat-channels e chat-search).

---

Confira meu outro material do Discourse

[David_Ghost]

É muito legal. Eu realmente gosto de usar a configuração de categorias (1) e depois bate-papo (2). Muito obrigado pelo seu ótimo trabalho, Lilly

[R23D_Printing]

Isto ainda é suportado? Tentei instalar e recebi o seguinte erro. Tentei a partir daqui e também usando as instruções manuais.

[Moin]

Sim, é. O link no botão “install this theme component” está desatualizado, mas o link no topo ainda está correto e você pode usá-lo para instalar o componente manualmente

Ou você tenta este botão

Instalar este componente de tema

[nathank (Nathan Kershaw)]

Acabei de corrigir o link no botão de instalação no OP, então está tudo certo agora.

[nathank (Nathan Kershaw)]

Encontrei um pequeno bug, onde a ordem especificada não está funcionando quando tenho uma tela de ‘desktop’ incomumente estreita - como no meu telefone dobrável.

É assim que eu quero que fique:

   

Quando tenho uma tela de tamanho estranho (parece ser uma largura de 640-820 ou algo assim), eu perco a ordem:

[Lilly]

ai meu Deus, o retorno da barra lateral de 2 colunas. Pensei que aquilo tinha sumido? Vou dar uma olhada…

[nathank (Nathan Kershaw)]

Fui eu mesmo sendo um pouco tolo! Eu estava usando o componente antigo e nem percebi.

No entanto, notei uma coisa: o que era chamado de community agora é chamado de the-forum. Aqui está um PR para arrumar isso nos padrões:

Update settings.yml (#3)

[Moin]

@nathank

o que era chamado de community agora é chamado de the-forum

No meu fórum ainda é chamado de community e aqui na Meta também.

Eu me pergunto como você mudou isso.

[nathank (Nathan Kershaw)]

Isso é realmente estranho! Lembro-me de ter alterado o texto em algum momento, agora que penso nisso. Mas não sei como isso foi parar no HTML!

Vou retirar aquele PR e pensar um pouco mais. Pode ser que tenha que permanecer uma ‘esquisitice’ do meu site!

[Lilly]

você deve ser capaz de executar alguns comandos do rails para renomeá-lo de volta. se sua seção for realmente chamada de the-forum, então eu acho que isso deve funcionar a partir do console do rails:

cd /var/discourse
./launcher enter app
rails c

section = SidebarSection.find_by(title: 'the-forum', public: true)
if section
  section.update!(title: 'community')
  puts "Concluído: renomeado para 'community'."
else
  puts "Seção não encontrada."
end

definitivamente faça um backup primeiro.

[nathank (Nathan Kershaw)]

Finalmente (por fim) tentei isso. Mas não encontrou a seção:

Acho que isso pode apenas permanecer como uma peculiaridade do site, né?

[Lilly]

(postagem excluída pelo autor)

[Lilly]

Nota: acabei de aplicar algumas correções móveis para este componente — ele começou a renderizar as linhas horizontais entre as seções da barra lateral, que devem aparecer apenas em visualizações de desktop ou tablet.