Reordenar menu lateral do Discourse

[Lilly (Lillian)]

| | |
|— | — | —|
| | 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|

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 fazê-lo pode ser difícil de gerenciar e modificar, 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 os administradores reordenem as seções do menu da barra lateral do fórum na interface administrativa do usuário, 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 para o 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 pode adicioná-las de volta ou redefinir a configuração).
• A melhor maneira de configurar este componente é ter a tela de administração 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 Mais.) 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 intitulado 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 desejam misturar na lista de ordenação e, em seguida, reorganizá-las junto com as seções padrão.

captura de tela das configurações padrão do componente

---

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) como 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 recolhido 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 (abaixo do menu personalizado toolbox acima), mostrando que este componente pode ser usado para movê-la também.

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

---

Notas

• 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 recolherem/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 recolhendo e expandindo.
• Seções de menu personalizadas criadas pelo usuário sempre aparecerão na parte inferior da barra lateral para aquele usuário, mas, de outra forma, não serão afetadas.
• 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 (Lillian)]

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 (Lillian)]

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 (Lillian)]

(postagem excluída pelo autor)

[Lilly (Lillian)]

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.