Blocos da barra lateral direita

[Discourse]

	Resumo	Blocos da Barra Lateral Direita exibe uma barra lateral à direita das listas de tópicos com uma lista configurável de blocos.
	Visualização	Visualização no Discourse Theme Creator
	Link do Repositório	https://github.com/discourse/discourse-right-sidebar-blocks
	Novo em 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, #contribuir:bug, #contribuir:ux e #contribuir:feature podem ser feitas nas respectivas categorias 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

O componente inclui alguns blocos que você pode exibir na barra lateral:

• tags-populares
• principais-contribuidores
• respostas-recentes
• topicos-da-categoria
• html-personalizado
• lista-de-categorias
• lista-de-subcategorias
• lista-de-eventos-futuros*
• placar-de-gamificacao-minimalista**

O diretório de usuários deve estar habilitado para que a lista de Principais Contribuidores seja preenchida. Se sua lista estiver em branco, pesquise enable user directory (habilitar diretório de usuários) nas configurações de administrador para garantir que esteja habilitado.

* Disponível apenas quando usado com o plugin Calendário.
** Disponível apenas quando usado com o plugin Gamificação.

Você também pode usar outros componentes Ember como blocos, basta usar o nome correto. Por exemplo, o núcleo inclui um componente Ember signup-cta, e você pode usá-lo na barra lateral como está. Observe que você não pode usar componentes que esperam um conjunto de parâmetros, mas você pode criar seu próprio componente Ember em um tema separado e referenciá-lo apenas pelo seu nome na configuração blocks (blocos) da barra lateral.

Você pode controlar alguns recursos para os blocos fornecidos por meio de parâmetros.

nome	descrição	padrão	valor	disponível para
count	limita o número de resultados	varia	número	todos exceto html-personalizado
excerptLimit	limita o comprimento de cada trecho de resposta	150	número	respostas-recentes
id	id da categoria		id da categoria (lista-de-categorias usa separados por vírgula)	topicos-da-categoria, lista-de-categorias
content	conteúdo a ser exibido		html	html-personalizado
scopeToCategory	mostra apenas na categoria ou subcategoria X		id da categoria	tags-populares
excludedTags	lista de tags excluídas		nomes das tags	tags-populares
displayInSpecificCategories	lista de categorias para exibir o widget	todas	números separados por vírgula	tags-populares
id	id do placar		número	placar-de-gamificacao-minimalista
tag	qual tag exibir		nome da tag	topicos-da-tag
period	período de tempo dos principais tópicos	semanal	todos, anual, trimestral, mensal, semanal, diário	topicos-principais
title	título do bloco	varia	string	topicos-da-tag, lista-de-categorias, principais-contribuidores
excludedGroupNames	exclui grupos especificados		Nomes dos grupos	principais-contribuidores
order	ordena os contribuidores		String (likes_received ou likes_given)	principais-contribuidores
period	período de tempo para os principais contribuidores	anual	todos, anual, trimestral, mensal, semanal, diário	principais-contribuidores
includeSubcategories	inclui eventos de subcategorias	false	false, true	lista-de-eventos-futuros
upcomingDays	eventos iniciados antes do valor fornecido	180	número	lista-de-eventos-futuros
timeFormat	formato da data/hora do evento	LT	formato momentjs	lista-de-eventos-futuros

Configurações

Nome	Descrição
blocks
show in routes	Apenas para usuários avançados: limita a barra lateral às rotas selecionadas. Exemplos: discovery.latest, discovery.unread, discovery.new, discovery.top, tag.show, “c/categoria-slug” (para categorias), “tag/tag-amostra” (para tags). Quando vazio, a barra lateral é exibida em todas as rotas de lista.

blocks: escolha os blocos a serem exibidos e ajuste sua ordem

show_in_routes: decida em quais rotas de lista de tópicos exibir a barra lateral. Por padrão, ela será exibida em todas as rotas de descoberta, exceto para /categories.

Tradução	Padrão
top_contributors.heading	Principais contribuidores
top_contributors.view_all	Ver todos
popular_tags.heading	Tags populares
popular_tags.view_all	Ver todos
recent_replies.heading	Respostas recentes
subcategory_list.heading	Subcategorias
top_topics.heading	Principais tópicos
category_list.heading	Categorias

Capturas de Tela

Observe que o componente vem com um estilo muito básico, a premissa é que os administradores que usam o componente adicionarão seu próprio estilo em seu próprio tema.

Interações

Quando usado em conjunto com o plugin Discourse Calendar, você pode adicionar um bloco de barra lateral para seus eventos futuros. O nome do bloco é upcoming-events-list, e o formato da data pode ser personalizado seguindo esta sintaxe (por exemplo, MMMM D, YYYY ). Você também pode configurar o quão longe no futuro procurar e se os eventos de subcategorias estão incluídos (veja a tabela acima)

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

[Alaa]

O que devo adicionar no parâmetro “name” se eu usar custom-html?

[nathank (Nathan Kershaw)]

Ótimo ver isso como um Componente de Tema #oficial! Certamente abre um novo mundo de customizações.

Tenho 2 perguntas:

1. Na barra lateral, quero exibir a lista de tópicos /latest de forma semelhante à maneira como category-topics os exibe. Isso é possível? recent-replies quase chega lá (especialmente se o trecho estiver oculto), mas eu realmente quero incluir tópicos sem respostas.

2. É possível exibir os blocos laterais apenas em certas categorias? O que quero dizer é que a única rota exibida é a Lista de Tópicos da Categoria, e apenas para as categorias que eu especificar.

[pmusaraj (Penar Musaraj)]

Desculpe, a documentação para isso está incompleta (vou atualizá-la agora). O nome do parâmetro para custom-html é content.

@nathankershaw

Quero exibir a lista de tópicos /latest

Não temos nada pronto para a lista completa de /latest, mas você pode criar a sua e adicioná-la à configuração usando o nome dela. Deve ser muito semelhante às listas de categorias/tags, apenas sem um filtro.

@nathankershaw

É possível exibir apenas os blocos laterais em certas categorias?

Atualmente, não, você não pode exibi-lo apenas em categorias específicas. No entanto, você pode usar discovery.category na configuração show in routes, que exibirá a barra lateral apenas nas rotas de categoria (mas em todas elas, não em um subconjunto).

[Alaa]

Obrigado, é possível incluir a barra lateral em cada tópico também?

[albert_vu (Albert Vũ)]

Apenas observei uma limitação do componente, especialmente quando se trata dos blocos category-topics e subcategory-list, e é que adicionar vários blocos de qualquer um desses tipos com IDs diferentes sempre resultou em eles exibirem tópicos/subcategorias do bloco mais acima no editor de lançamento (presumo).

Um bug que estou tendo agora é que, depois de brincar com o bloco subcategory-list por cerca de 10 a 12 vezes, ele parou de aparecer completamente em nosso site de staging (veja o vídeo abaixo).

[pmusaraj (Penar Musaraj)]

O bloco subcategory-list não aceita nenhum parâmetro. Quando usado, ele exibirá as subcategorias da categoria atual com base em qual categoria atual você navegou… portanto, não faz sentido usar esse bloco mais de uma vez.

É também por isso que o subcategory-list não está aparecendo no seu vídeo. Se você estiver em uma rota que não seja de categoria, esse bloco não será exibido.

Para category-topics, no seu vídeo, vejo o mesmo ID usado duas vezes: 7. Fiz um teste local e, com IDs diferentes, obtive tópicos diferentes exibidos (ou seja, não consigo reproduzir o bug relatado).

[Helga_Razinkova (Helga)]

Olá, muito obrigado por este plugin incrível!

Tenho uma pergunta sobre a barra lateral subcategory-list: existe uma opção para exibi-la apenas para uma categoria específica?

Nossos desenvolvedores deram uma olhada e parece que não há suporte para o parâmetro id no subcategory-list, você poderia adicionar isso, por favor?

[Helga_Razinkova (Helga)]

E em relação ao bloco top-contributors: há alguma forma de buscar os resultados para um período de uma semana?

[pmusaraj (Penar Musaraj)]

@Helga_Razinkova

sobre a barra lateral subcategory-list: existe uma opção para exibi-la apenas para uma categoria específica?

Atualmente, não, essa opção não existe. Faz sentido adicioná-la, embora eu imagine que ela deva suportar vários IDs para que você possa mostrar o bloco para uma lista de categorias (A, B e C, por exemplo). Ficarei feliz em revisar PRs no repositório, se seus desenvolvedores acharem que podem adicionar isso, seria ótimo. (Caso contrário, posso adicioná-lo a uma lista de “nice-to-haves” no componente do tema.)

@Helga_Razinkova

existe uma maneira de buscar os resultados por um período de uma semana?

Você quer dizer a) buscar os resultados e armazená-los em cache por uma semana ou b) buscar os principais contribuidores da última semana a cada carregamento? O segundo deve ser fácil de adicionar, o cache é um pouco mais complicado.

[miss]

@pmusaraj você pode adicionar

padding: 3px 4px 3px 4px

para as popular-tags?

Obrigado.

[Helga_Razinkova (Helga)]

Olá @pmusaraj, muito obrigado pela sua resposta!

Nosso desenvolvedor compartilhou os PRs aqui, por favor, dê uma olhada: Implement the `displayInCategories` parameter which allows to specify a list of categories where the `subcategories-list` block is displayed by d521bb85 · Pull Request #10 · discourse/discourse-right-sidebar-blocks · GitHub

@pmusaraj

Você quer dizer a) buscar os resultados e armazená-los em cache por uma semana ou b) buscar os principais contribuidores da última semana a cada carregamento? O último deve ser fácil de adicionar, o cache é um pouco mais complicado.

A segunda variante seria perfeita! Precisamos exibir a lista dos principais contribuidores da última semana, de fato. Muito obrigado!

[pmusaraj (Penar Musaraj)]

@miss

você pode adicionar

padding: 3px 4px 3px 4px

para as tags populares?

O componente intencionalmente tem muito pouco estilo para que os consumidores possam adicionar seus próprios estilos em seus próprios temas/componentes de tema.

@Helga_Razinkova

Nosso desenvolvedor compartilhou os PRs aqui, por favor, dê uma olhada: Implement the displayInCategories parameter which allows to specify a list of categories where the subcategories-list block is displayed by d521bb85 · Pull Request #10 · discourse/discourse-right-sidebar-blocks · GitHub

Obrigado, esse PR é ótimo e agora foi mesclado!

Também trabalharei em breve para adicionar configurabilidade ao bloco de principais contribuidores (ou se alguém for mais rápido, ficarei feliz em revisar um PR).

[nathank (Nathan Kershaw)]

@pmusaraj

Não temos nada pronto para a lista completa de /latest, mas você pode criar a sua e adicioná-la à configuração usando o nome dela. Deve ser muito semelhante às listas de categorias/tags, apenas sem um filtro.

Não tenho certeza de onde encontrar o código para isso - você se importaria de me direcionar? Gostaria de olhar para modificar os category-topics para que não ter um ID lhe dê todas as categorias (e, portanto, efetivamente a lista /latest)

@pmusaraj

Em breve também trabalharei para adicionar configurabilidade ao bloco de principais contribuidores (ou se alguém for mais rápido, ficarei feliz em revisar um PR).

Seria ótimo ter isso em todos os blocos!

[Helga_Razinkova (Helga)]

@pmusaraj Incrível! Muito obrigado pela sua ajuda, estou ansioso para usar o bloco de principais contribuidores

[Kuro22]

Olá! Não tenho certeza se este componente está causando erros. Mas, uma vez desativado, não há mais erros. Alguém poderia dar uma olhada nisso para me ajudar a descobrir o problema? Agradeceria muito.

Com ele ativado, ao visitar um determinado tópico no desktop, clicar no logotipo do site na barra superior na tentativa de retornar à página inicial me levava a uma tela de carregamento que nunca desaparecia e gerava erros no console do navegador (como abaixo). Nenhum log de erro relacionado foi visto no caminho mysite/logs.

d6ca234baf8d2d5e65f414f31e198fe956d9a939.js?__ws=www.bfsu.cafe:98 Uncaught (in promise) TypeError: Cannot read properties of undefined (reading 'findFiltered')
    at new CategoryTopics (d6ca234baf8d2d5e65f414f31e198fe956d9a939.js?__ws=www.bfsu.cafe:98:18)
    at h.createComponent (base-component-manager.js

[pmusaraj (Penar Musaraj)]

Ah, sim, desculpe por isso. Deve estar corrigido agora, você só precisa baixar a versão mais recente do componente de tema.

[Kuro22]

Obrigado! Funciona perfeitamente agora.

[Helga_Razinkova (Helga)]

@pmusaraj

Eu também trabalharei em breve para adicionar configurabilidade ao bloco de principais contribuidores (ou se alguém for mais rápido, ficarei feliz em revisar um PR).

Olá @pmusaraj, desculpe se estou sendo insistente - apenas queria saber se há alguma previsão de quando essa implementação será feita.

Seria uma adição incrível

Muito obrigado!

[carson]

Obrigado por este componente incrível!

Notei que todo o meu cabeçalho e rodapé desaparecem globalmente quando isso está ativado (tudo no meu header.html e footer.html). Isso foi intencional? Mas para contornar isso, tenho que usar o PluginAPI para adicionar manualmente um cabeçalho/rodapé.