Barras laterais da lista de tópicos

[Discourse]

Anteriormente chamado “Discourse Category Sidebars” — o nome deste componente de tema foi atualizado para Topic List Sidebars, já que agora ele suporta tanto categorias quanto tags.

	Resumo	O Topic List Sidebars pega um tópico e o aplica como uma barra lateral para a lista de tópicos de uma categoria ou tag.
	Pré-visualização	Pré-visualização no Discourse Theme Creator
	Link do Repositório	https://github.com/discourse/discourse-topic-list-sidebars
	Novo nos Temas do Discourse?	Guia para iniciantes sobre o uso de Temas do Discourse

Instale este componente de tema

Como este é um componente de tema #oficial mantido pela equipe do Discourse, solicitações de #suporte, Contribute > Bug, Contribute > UX e Contribute > Feature podem ser feitas nas categorias respectivas aqui no Meta, e marcadas com a tag apropriada do componente de tema. Clique em um dos links abaixo para iniciar uma.

 Suporte  Bug  UX  Recurso

Recursos

Este componente de tema pega um tópico e o aplica como uma barra lateral para a lista de tópicos de uma categoria ou tag. Essas barras laterais são visíveis apenas quando o navegador tem 767px ou mais de largura (na maioria dos tablets e monitores).

O que posso fazer com este componente de tema?

• Escolha um tópico e exiba seu conteúdo como uma barra lateral para uma categoria ou tag.

• Defina uma barra lateral para ser exibida nas páginas /latest, /new, /unread e /top usando all como o nome da categoria nas suas configurações.

• Escolha se as barras laterais devem aparecer à esquerda ou à direita da lista de tópicos.

• Por padrão, a barra lateral de uma categoria também será exibida para todas as suas subcategorias, a menos que uma subcategoria tenha sua própria barra lateral definida (você pode desativar isso desmarcando a configuração inherit parent sidebar).

Como configurá-lo?

Escolha suas categorias e tags, e adicione o ID do tópico (por exemplo, example.com/t/example-topic/57) que você deseja usar para popular o conteúdo da barra lateral.

Recomendo criar os tópicos das barras laterais em suas respectivas categorias/tags, fechar o tópico para que não haja respostas e deslistá-lo (para que ele não apareça na lista de tópicos).

Observe que você não pode usar um tópico de uma categoria privada como uma barra lateral em uma categoria pública (tecnicamente você pode, mas os usuários sem acesso a esse tópico privado verão apenas uma barra lateral vazia!).

Configurações

Nome	Descrição
sidebars	Adicionar e remover barras laterais
sidebar side	Escolha entre Esquerda ou Direita
inherit parent sidebar	Se marcado, as subcategorias herdarão a barra lateral da categoria pai (a menos que a subcategoria tenha sua própria barra lateral atribuída). Se desmarcado, as subcategorias exibirão uma barra lateral apenas se uma for especificada.
stick on scroll	Se marcado, a barra lateral terá uma posição fixa ao rolar

Notas para Desenvolvedores

Cada barra lateral de categoria é envolvida por uma classe que contém o slug da categoria, portanto, para a categoria staff, seria .category-sidebar-staff. Você pode usar essas classes para estilizar as barras laterais individuais.

A tag body nas páginas com barras laterais também tem uma classe adicionada, para que você possa usar body.custom-sidebar para aplicar estilos em todas as páginas que possuem uma barra lateral.

Créditos

Agradecimentos especiais ao @xrav3nz por ter lançado as bases para tornar este componente possível!

Hospedado por nós? Componentes de tema estão disponíveis para uso em nossos planos Standard, Business e Enterprise.

[emilio]

Trying to figure out how to make this work with tags as well. (we use tags heavily rather than having tons of categories.)

It looks like it may be about replacing controller:navigation/category with whatever the equivalent for tags is but not sure.

[awesomerobot (Kris)]

Acabei de dar uma olhada rápida e é possível fazer isso para tags…

Provavelmente vou trabalhar mais nisso amanhã e separar em um repositório próprio.

@emilio

Parece que pode ser sobre substituir controller:navigation/category pelo equivalente para tags, mas não tenho certeza.

Sim, esse é o cerne da questão — isso parece funcionar para tags:

const controller = container.lookup("controller:tags-show");
const tag = controller.get("tag");

Atualização: Tenho um componente de tema disponível, Discourse Tag Sidebars

[jrgong]

Since I am using the header submenu plugin, A part of the text is covered by my header bar. It would be great if it was possible to add extra margin/offset or whatever it’s called for the case when additional elements before the header are covering the sidebar’s content.

Also: is there any way to keep the category drop down menu above the sticky sidebar’s content? that would make it easy for users to jump between categories quickly.

altogether I think the category sidebar is a great plugin and has huge potential to add useful information to the forum structure!

[AstonJ]

Outro ótimo plug-in, Kris, obrigado!

Tenho algumas perguntas/sugestões que espero que você possa me ajudar…

1 - É possível fazer com que, quando um usuário navega pelo fórum, passando de página para página, a barra lateral sempre verifique a versão mais recente da postagem que ela contém? No momento, acho que o conteúdo da barra lateral só é atualizado ao atualizar a página? Infelizmente, conteúdo que raramente muda começa a parecer desatualizado para os usuários (especialmente usuários ativos), então gostaria de atualizar o tópico associado à barra lateral com frequência, se possível. (Da mesma forma, se o ID do tópico nas opções dessa página for alterado, ele deve ser detectado na próxima visualização da página). Estou muito disposto a aceitar a carga adicional por página/visualização, mas, se você estiver preocupado que outros usuários não estejam, talvez você possa adicionar uma opção “armazenar em cache o conteúdo da postagem”, que faria com que funcionasse como funciona agora.

2 - É possível associar/coletar conteúdo de mais de um tópico por barra lateral, por favor? Por exemplo, na página “Mais Recentes”, você pode querer o conteúdo dos tópicos 33 e 55 (e nessa ordem). Isso seria ótimo para permitir conteúdo diferente por página, ao mesmo tempo em que inclui informações/links comuns que você deseja que apareçam na parte inferior de todas as barras laterais.

3 - É possível expandir o plug-in para que ele possa ser usado em todo o site, por favor? No momento, acho que ele só pode ser usado em determinadas páginas? Idealmente, gostaria de usá-lo em todo o fórum, em todas as seções/páginas principais. (Talvez seu plug-in de barra lateral de tags possa ser usado em conjunto com este para um controle mais fino - por exemplo, para tags individuais e/ou tópicos - acho que a combinação de ambos poderia se tornar um pacote de barra lateral muito poderoso!!)

4 - É possível adicionar uma opção de largura da barra lateral, além de um ponto de corte/“display-none” configurável, por favor? Isso não é algo crítico, pois pode ser feito por meio de alterações no CSS, mas acho que seria bom ter nas opções.

5 - Por último, mas não menos importante… você poderia fazer com que as enquetes funcionem, por favor? Acho que permitir que os usuários votem em enquetes diretamente da barra lateral seria incrível!!! Encontrar conteúdo dinâmico como esse nas barras laterais pode torná-las interessantes para os usuários, tornando menos provável que eles as ignorem automaticamente.

Acho que com tudo isso, este plug-in seria um excelente candidato para ser incluído no núcleo ou como um plug-in oficial do DC - na minha opinião, ele poderia ajudar as pessoas a deixar sua marca individual em seus fóruns, e tenho certeza de que as pessoas o usariam de formas divertidas e interessantes!

[marielavd10 (Mariela)]

Olá,

Ótimo componente. É possível ter uma barra lateral assim para cada tópico dentro de uma categoria específica?

Obrigado.

[Ralf_Stockmann]

Qual é a sintaxe para endereçar uma subcategoria? As opções que tentei até agora:

category/subcategory,123
subcategory,123
category-subcategory,123

Nenhuma delas parece funcionar. As categorias principais são exibidas, no entanto.

[Ralf_Stockmann]

@Ralf_Stockmann

Qual é a sintaxe para endereçar uma subcategoria?

Hm, alguém, por favor? Não deveria ser tão difícil dar uma resposta…

[awesomerobot (Kris)]

Parece que houve uma regressão e as subcategorias não estavam funcionando em alguns casos. A sintaxe deve ser a mesma das categorias: subcategory, 123

Refatorei o tema, então, se você atualizá-lo, as subcategorias devem funcionar conforme o esperado!

[Ralf_Stockmann]

@awesomerobot

Refatorei o tema, então, se você atualizá-lo, as subcategorias devem funcionar conforme o esperado!

Isso resolveu: perfeito!
Muito obrigado, exatamente na hora da nossa grande inauguração.

[hyphalos]

Plugin incrível!

Por acaso isso também é possível para grupos? Ter uma barra lateral para grupos seria ótimo para fornecer informações sobre o grupo.

Alguém pode me direcionar para obter os parâmetros do grupo (informar ao componente que você está dentro de um grupo) para que eu possa tentar e criar um PR eu mesmo?

[keegan (Keegan George)]

@hyphalos Criei um Groups Widget que pode ser adicionado às barras laterais do Layouts Plugin.

Talvez o código que eu tinha para isso possa te ajudar a escrever seu PR:

GitHub - paviliondev/layouts-groups-widget: The Groups Widget allows each user to see what...

Alternativamente, você também poderia usar o plugin Layouts e o próprio widget.

[Ralf_Stockmann]

Pode ser um pouco ousado pedir, já que se chama sidebar (barra lateral), mas: seria possível adicionar uma opção para colocar o conteúdo não ao lado, mas sempre acima da lista de tópicos?

Usamos o Discourse como uma intranet social e, para algumas categorias, temos a necessidade de uma área de fácil manutenção para links, listas de pessoas, etc. - esse mecanismo seria ótimo para isso, mas há muito pouco espaço na barra lateral.
Hacks de CSS também são bem-vindos.

Já tentei os banners de categoria, mas eles são limitados ao primeiro parágrafo, então essa não é uma opção.

Atenciosamente,
Ralf
(Biblioteca Estadual de Berlim)

[nathank (Nathan Kershaw)]

E quanto a este TC?

Discourse Category Headers theme component

This theme component provides a number of enhancements for the Discourse category header. The ‘standard’ Discourse category header is displayed at the top of each category page, above the navigation links and list of topics. It is normally only visible if a category logo image has been uploaded in the category settings. The header displays the logo and a short description of the category, taken from the first paragraph of the ‘About the… category’ topic. This theme component provides the foll…

Acho que você ainda ficará preso ao primeiro parágrafo. Mas isso poderia ser potencialmente alterado.

[Heliosurge (Dan DeMontmorency)]

Olá Kris, isso é muito bom.

Eu estava imaginando se isso poderia ser modificado ou ter uma opção para movê-lo de uma barra lateral para a barra superior abaixo do cabeçalho do site ou talvez apenas abaixo de um logotipo de categoria?

Ou se eu poderia receber orientação sobre como adicionar CSS personalizado para movê-lo e também fazê-lo exibir para dispositivos móveis como uma barra superior, é uma barra fixa? ancorada logo abaixo da barra principal do site?

[bdfl (Bryan)]

Posso estar a entender mal como este componente de tema funciona, mas seria possível utilizá-lo para mostrar a lista de tópicos à esquerda, clicar num tópico na lista e ter as publicações mostradas à direita (e manter a lista de tópicos fixada à esquerda)? Não preciso de ver categorias. Pareceria o Flarum.

[awesomerobot (Kris)]

Não, o que este componente faz é pegar o conteúdo de um tópico e usá-lo para preencher uma barra lateral para a lista de tópicos de uma categoria específica. Ele não é visível ao navegar para um tópico.

[bdfl (Bryan)]

Ok, obrigado!

[awesomerobot (Kris)]

Olá a todos! Acabei de mesclar uma grande atualização neste componente que faz algumas coisas: FEATURE: include tag sidebars, migrate to objects setting by awesomerobot · Pull Request #22 · discourse/discourse-topic-list-sidebars · GitHub

• Migra a configuração de estilo da lista para uma configuração de objetos. Isso significa:
• Cada barra lateral pode ser configurada para várias categorias ao mesmo tempo
• Agora você pode selecionar categorias do menu suspenso em vez de adicionar slugs manualmente
• Inclui também uma opção de tag! isso significa que você não precisará mais de um componente separado (Discourse Tag Sidebars)

As configurações existentes devem migrar automaticamente na atualização… a menos que seu slug seja diferente do nome da categoria, então você precisará atualizar manualmente as configurações.

Por exemplo, site-feedback migrará corretamente para Site Feedback, mas não há um método para migrar slugs que não se alinham com os nomes (por exemplo, seu slug para Site Feedback é hamburgers em vez de site-feedback).

Provavelmente mudarei o nome deste componente de tema e desativarei as barras laterais de tags para refletir a nova situação.

[mattdm (Matthew Miller)]

@awesomerobot

As configurações existentes devem migrar automaticamente na atualização… a menos que seu slug seja diferente do nome da categoria, então você precisará atualizar as configurações manualmente.

Isso migrará automaticamente as configurações de tags?

Com a nova configuração, pode haver barras laterais diferentes para a mesma tag em categorias diferentes? Como os conflitos são resolvidos?