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