Blocos da Barra Lateral Direita

||||\n-|-|-|\n:discourse2: | Resumo | Right Sidebar Blocks mostra uma barra lateral à direita das listas de tópicos com uma lista configurável de blocos. \n| :eyeglasses: | Prévia | Prévia no Discourse Theme Creator\n:hammer_and_wrench: | Link do Repositório | \u003chttps://github.com/discourse/discourse-right-sidebar-blocks\u003e\n:open_book:|Novo nos Temas do Discourse?| Guia para iniciantes sobre como usar Temas do Discourse\n\n[wrap=theme-install-button repoUrl="https://github.com/discourse/discourse-right-sidebar-blocks\" repoName="Right Sidebar Blocks"]\nInstalar este componente de tema\n[/wrap]\n\n[quote]\n\n:discourse2: Como este é um componente de tema #oficial mantido pela equipe do Discourse, solicitações de #suporte, Bug, UX e Feature podem ser feitas nas respectivas categorias aqui no Meta, e marcadas com a tag apropriada do componente de tema. Clique em um link abaixo para iniciar um. :+1: \n\n\u003ckbd\u003e [:question:\u0026nbsp;Suporte](Discourse Meta "Peça suporte sobre como configurar e usar o Right Sidebar Blocks") \u003c/kbd\u003e \u003ckbd\u003e [:bug:\u0026nbsp;Bug](Discourse Meta "Um relatório de bug significa que algo está quebrado, impedindo o uso normal/típico do componente de tema") \u003c/kbd\u003e \u003ckbd\u003e [:eyes:\u0026nbsp;UX](Discourse Meta "Discussão sobre a interface do usuário do Right Sidebar Blocks, e como os recursos são apresentados (incluindo idioma e elementos da interface do usuário)") \u003c/kbd\u003e \u003ckbd\u003e [:bulb:\u0026nbsp;Funcionalidade](Discourse Meta "Discussão sobre como os recursos existentes do Right Sidebar Blocks podem ser aprimorados ou aprimorados, e como os novos recursos propostos poderiam funcionar")\u003c/kbd\u003e\n\n[/quote]\n\n### Funcionalidades\n\nO componente inclui alguns blocos que você pode exibir na barra lateral:\n\n* popular-tags\n* top-contributors\n* recent-replies\n* category-topics\n* custom-html\n* category-list\n* subcategory-list\n* upcoming-events-list*\n* minimal-gamification-leaderboard** \n\n\u003e:information_source: O diretório de usuários deve estar ativado para que a lista de Principais Contribuidores seja preenchida. Se sua lista estiver em branco, pesquise enable user directory nas suas configurações de administrador para garantir que esteja ativado.\n\n\* Disponível apenas quando usado com o plugin Calendar.\n** Disponível apenas quando usado com o plugin Gamification.\n\nVocê também pode usar outros componentes Ember como blocos, você só precisa 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 da barra lateral. \n\nVocê pode controlar alguns recursos para os blocos fornecidos por meio de parâmetros.\n\n| nome | descrição | padrão | valor | disponível para |\n|—|—|—|—|—|\n| count | limita o número de resultados | varia | número | todos, exceto custom-html |\n| excerptLimit | limita o comprimento de cada trecho de resposta | 150 | número | recent-replies |\n| id | id da categoria | | id da categoria (category-list usa separado por vírgula) | category-topics, category-list |\n| content | conteúdo a ser exibido | | html | custom-html |\n| scopeToCategory | mostra apenas na categoria ou subcategoria X | | id da categoria | popular-tags |\n| excludedTags | lista de tags excluídas | | nomes de tags | popular-tags |\n| displayInSpecificCategories | lista de categorias para mostrar o widget | todas | números separados por vírgula | popular-tags |\n| id | id do placar | | número | minimal-gamification-leaderboard |\n| tag | qual tag exibir | | nome da tag | tag-topics |\n| period | período de tempo dos principais tópicos | weekly | all, yearly, quarterly, monthly, weekly, daily | top-topics |\n| title | título do bloco | varia | string | tag-topics, category-list, top-contributors |\n| excludedGroupNames | Exclui grupos especificados | | Nomes de grupos | top-contributors |\n| order | Ordena os contribuidores | | String (likes_received ou likes_given) | top-contributors |\n| period | Período de tempo para os principais contribuidores | yearly | all, yearly, quarterly, monthly, weekly, daily | top-contributors |\n| upcomingDays | Eventos iniciados antes do valor fornecido | 180 | número | upcoming-events-list |\n| timeFormat | Formato da data/hora do evento | LT | formato momentjs | upcoming-events-list |\n\n### Configurações\n\n| Nome | Descrição\n|-|-|\n| blocks | \n| show in routes | Apenas para usuários avançados: limite a barra lateral às rotas selecionadas.\u003cbr\u003eExemplos: discovery.latest, discovery.unread, discovery.new, discovery.top, tag.show, "c/category-slug" (para categorias), "tag/sample-tag" (para tags).\u003cbr\u003eQuando vazio, a barra lateral é mostrada em todas as rotas de lista.\n\nblocks: escolha os blocos a serem exibidos e ajuste sua ordenação\n\nshow_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 em /categories. \n\n| Tradução | Padrão\n|-|-|\n| top_contributors.heading | Principais contribuidores\n| top_contributors.view_all | Ver todos\n| popular_tags.heading | Tags populares\n| popular_tags.view_all | Ver todos\n| recent_replies.heading | Respostas recentes\n| subcategory_list.heading | Subcategorias\n| top_topics.heading | Tópicos principais\n| category_list.heading | Categorias\n\n### Capturas de Tela\n\n

\n\n\n\n\n\nNote que o componente vem com apenas um estilo muito básico, a suposição é que os administradores que usam o componente adicionarão seu próprio estilo em seu próprio tema.\n\n### Interações\n\nQuando 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 ).\n\n\n\n\n\n\n\u003cbr\u003e\n\n\n\u003e:discourse2: Hospedado por nós? Componentes de tema estão disponíveis para uso em nossos planos Standard, Business e Enterprise."

61 curtidas
Discourse Gamification
Sidebar for Subcategories
Add User leaderboard in sidebar
FKB Pro - Social theme
Setup Continuous Integration using GitHub Actions
Blogroll (feature request)
Topic List Previews (TLP)
How to include a YouTube video or video widget on the community home page?
How to extend the Discourse sidebar?
Discourse Bars :beers: :cocktail: (a sidebar framework)
Homepage Blocks
Topic List Excerpts
🏷️ Bars Tag List Component
Discourse Bars :beers: :cocktail: (a sidebar framework)
When to switch themes/plugins to `.gjs`?
FKB Pro - Social theme
Recent replies takes 2 seconds to display
Leaderboard in homepage
Discourse Gamification Plugin in the Header
Discourse Calendar updated to use fullcalendar 6
I'm getting errors when I switch categories too quickly
目前我感觉看到的最好看的Discourse主题,有没有谁能爱心奉献一个
Adding ‘hot topics’ to the Sidebar
Tag Icons + Tag Banners + Right Sidebar Blocks
Discourse Sidebar Blocks
Custom Components -- add button or text at any plugin outlet
Top Posters Widget?
Creating a Top 20 leaderboard for a specific date range
Connectors not rendering
Sidebar for Subcategories
Displaying tags along with categories
FKB Pro - Social theme
Customizing your site with existing theme components
Creating and installing plugins?
FKB Pro - Social theme
Adding a recent comments widget
Add social media handles on home page
Alternate presentation of sub-categories which puts the _top_ category first?
FKB Pro - Social theme
Looking for the perfect theme
Discourse Bars :beers: :cocktail: (a sidebar framework)
Discourse Bars :beers: :cocktail: (a sidebar framework)
Add right sidebar gamification mini-leaderboard
Add right sidebar gamification mini-leaderboard
Pyx's Modern Theme

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

1 curtida

Ó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.

1 curtida

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

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.

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).

3 curtidas

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

4 curtidas

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).

2 curtidas

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).

4 curtidas

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?

2 curtidas

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

2 curtidas

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.)

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.

3 curtidas

@pmusaraj você pode adicionar

padding: 3px 4px 3px 4px

para as popular-tags?

Obrigado.

1 curtida

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

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

4 curtidas

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.

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).

3 curtidas

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)

Seria ótimo ter isso em todos os blocos!

2 curtidas

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

1 curtida

Olá! Não tenho certeza se este componente está causando erros. Mas, uma vez desativado, não há mais erros. :thinking: 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
1 curtida

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

3 curtidas

Obrigado! Funciona perfeitamente agora.

3 curtidas

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 :slight_smile:

Muito obrigado!

3 curtidas

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é.

2 curtidas