Grupos de categorias

:discourse2: Summary Category Groups allows you to assign categories to groups, which are then used to sort and collapse categories on the categories page.
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-category-groups-component
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

Features

:information_source: Important things to note:

  • This theme component only works with the site setting desktop category page style set to boxes with subcategories (as it replaces that category page template).

  • The category collapsing works using your browser’s local storage, so the collapsed state will not be remembered between different devices.

Settings

Name Description
category groups This is how the groups are configured. Format as: Group name: category-slug, extra-link-id, category-slug-2 (The category slug is the name of the category as it’s seen in URLs. Usually all lowercase with no spaces)
extra links Extra links that can be mixed into category list. Add link ID in category_groups setting to render
show on mobile Show the collapsible category box groups on mobile
show ungrouped Display a group of categories that aren’t assigned to another group
fancy styling Turn on additional styling (These are some custom styles added. They stray from our defaults, so if you’re working on your own theme you may want to disable this)
hide muted subcategories When enabled, a non-muted parent category will not appear under the muted section if it has a muted subcategory
Theme Translations Default
ungrouped_categories_title Other

:discourse2: Hosted by us? Theme components are available to use on our Pro, Business and Enterprise plans.

Last edited by @tobiaseigen 2025-06-24T03:16:42Z

Check documentPerform check on document:
53 curtidas

Acabei de mesclar um refatoramento deste componente. A funcionalidade deve permanecer a mesma no geral, com algumas correçÔes de bugs.

Nos bastidores, isso usa um Ember modernizado e elimina substituiçÔes de template, que podem ser um pouco frågeis em relação às personalizaçÔes do Discourse.

Isso deve estar corrigido agora

Isso estĂĄ corrigido agora, os grupos nĂŁo se aplicarĂŁo mais aos layouts de subcategorias

Atualizei isso, entĂŁo os logotipos das categorias agora devem ter um tamanho muito mais normal

6 curtidas

É possível não exibir subcategorias para uma categoria específica? Temos uma categoria organizada de uma maneira particular com subcategorias aninhadas e isso está fazendo com que a caixa fique bem grande.

2 curtidas

Talvez tente o Category Hider em Theme component

2 curtidas

VocĂȘ pode me dizer se Ă© possĂ­vel aplicar os agrupamentos de categorias Ă  barra lateral? Se nĂŁo, eu gostaria de registrar isso como uma solicitação de recurso. Obrigado!

1 curtida


HĂĄ um problema no meu site, as subcategorias nĂŁo tĂȘm espaço entre elas.

2 curtidas

Obrigado por relatar, uma atualização deve corrigir isso agora (corrigido em UX: include gap for subcategories by awesomerobot · Pull Request #19 · discourse/discourse-category-groups-component · GitHub).

2 curtidas

Não é possível, a barra lateral precisaria de uma alteração maior no Discourse para permitir isso (solicitação anotada!)

2 curtidas

Seria Ăłtimo se esse agrupamento pudesse ser personalizado pelo usuĂĄrio, algumas pessoas em nossa comunidade queriam isso.

Sim, isso precisa de um plugin, mas Ă© uma boa ideia, eu acho

Alguma ideia do porquĂȘ a largura da categoria estĂĄ tĂŁo estreita? HĂĄ alguma maneira de corrigir isso?

2 curtidas

isso está no tema Mint? Acabei de fazer uma pequena atualização que deve corrigir isso — houve um pequeno conflito entre o CSS desse tema e este componente

3 curtidas

Sim, foi a menta, obrigado

2 curtidas

Como faço para evitar que as caixas sejam delineadas com a cor da categoria? Tentei fazer um fork, adicionar CSS e também alterar o style <li> em categories-groups.hbs

(Note que sou um diletante, nĂŁo um desenvolvedor treinado)

3 curtidas

VocĂȘ pode adicionar um pouco de CSS ao seu tema para remover as bordas coloridas:

.category-boxes .category-box {
  border-left: 2px solid var(--primary-low) !important;
}

ou se vocĂȘ tiver a configuração “fancy styling” ativada:

.custom-categories-groups .category-box {
    border: 2px solid var(--primary-low) !important;
}

1 curtida

Obrigado, Kris,

Parece que estou tendo um problema maior. Por algum motivo, sempre que tento atualizar o componente Theme, ele não capta as alteraçÔes. Então meu CSS estava bom, ele apenas não estava sendo carregado. Não é algo para este tópico, vou pesquisar para ver se estou fazendo algo idiota.

1 curtida

Seria possĂ­vel ter as caixas de estilo sofisticadas com uma seção de “Ășltimos” abaixo das categorias? Essencialmente, quero fazer a mesma coisa que o componente “Categorias Modernas + Caixas de Grupo” faz no Tema Air. VocĂȘ pode selecionar Categorias com Últimos para a visualização desktop e os Ășltimos sĂŁo exibidos abaixo das categorias.

Estou tentando editar minha prĂłpria versĂŁo do CSS, mas nĂŁo sou um especialista. Seria algo fĂĄcil de fazer ou pode estar fora do meu conjunto de habilidades?

1 curtida

Tenho este caso de uso, onde temos muitas categorias e subcategorias habilitadas, e elas tornam a pågina de destino muito lotada, dificultando a localização do que interessa ao usuårio.

Por causa disso, queremos personalizar a pågina de destino dos Grupos de Categorias de forma que ela seja mais direcionada para os usuårios em åreas de interesse específicas (através dos grupos de usuårios).

Portanto, proponho adicionar uma opção de visibilidade para cada grupo de categorias. Se alguma for definida, o grupo de categorias só serå visível para os grupos de usuårios habilitados em suas configuraçÔes.

Eu criei um pull-request para demonstrar o que quero dizer com tudo isso. Por favor, me diga o que vocĂȘ acha desta opção. VocĂȘ a usaria? Ela se aplica ao seu site Discourse?

p.s. Esta nova opção proposta não deve ser considerada como controle de acesso alternativo. Ela simplesmente controla quais grupos de categorias serão visíveis para o usuårio logado com base em suas associaçÔes de grupo. As permissÔes existentes ainda estarão em vigor.

1 curtida

Parece que nĂŁo estĂĄ aparecendo apĂłs as Ășltimas atualizaçÔes do Discourse, pode ser necessĂĄrio uma atualização para que este TC funcione.

Gostaria de saber por que não habilitar este estilo no celular com a opção de categorias padrão?

Eles ficam maravilhosos com o componente!