Este componente analisa a descrição completa de uma categoria em busca de tags específicas e exibe links adicionais para outras categorias. Veja a captura de tela.
Captura de tela
Repositório
Sobre
Por que devo usá-lo e por que foi implementado dessa forma?
Você deseja exibir links adicionais, por exemplo, para outros recursos desse tipo de categoria. Pense em uma categoria para um clube de futebol onde você quer adicionar o link para o site do clube. Nesses casos, você pode usar o GitHub - naidihr/discourse-category-headers: Theme component providing custom settings for the discourse category header · GitHub
Se você tiver mais de um link e/ou não quiser que esse link apareça na página de visão geral das categorias e/ou não quiser aquele enorme banner, você pode usar este tema.
Ele foi implementado dessa forma para analisar a descrição completa de uma categoria, pois o Discourse utiliza apenas o primeiro fragmento do “primeiro tópico” para criar a descrição da categoria exibida na página de visão geral. O restante da postagem não é mostrado.
Caso você esteja usando muitas categorias, talvez criadas via API, esta adição é totalmente utilizável, pois a primeira postagem da categoria (= a descrição completa) também pode ser definida via API.
Instalação
Como instalar um Tema ou Componente de Tema?
Configurá-lo
Configure o componente do tema e defina as tags, como:
WIKI, blank
Altere a descrição de uma categoria para que fique assim:
Esta é a descrição exibida da categoria.
`
{AddCategoryLinks}
{WIKI#Wiki#Nosso wiki incrível#https://awesome-wiki-which-doesnt.exist}
{TAGNAME#Nome do Link#Título do Link#URL do Link}
`
Observe:
- É importante que
{AddCategoryLinks}exista na descrição. - É importante que esteja dentro de um bloco de código (dentro de
...). - Use # como separador.
Nota: Recomendo ocultar a postagem na qual a descrição da categoria é escrita, para que os usuários não vejam as adições como AddCategoryLinks, etc.
Agradecimentos
- discourse, uma ferramenta excelente
- GitHub - discourse/discourse-custom-header-links · GitHub
- https://github.com/discourse/discourse-category-headers.git
