Base de Conhecimento

Obrigado pelo feedback, @tobiaseigen! Tenho outras coisas para fazer esta semana, mas com certeza vou analisar alguns desses itens na próxima semana.

7 curtidas

Outro ponto: este componente do tema não faz sentido ao lado do componente do tema ‘tags populares’, e, por algum motivo, a configuração de exclusão de categoria para esse componente do tema não parece funcionar para mim, apesar de várias atualizações do navegador. Não sei se é possível resolver essa questão neste componente do tema… para que ainda possamos usar as tags populares em outras visualizações e não mostrá-las aqui.

Não tenho vergonha de mostrar como estou usando o Discourse como minha base de conhecimento pessoal: na captura de tela abaixo, você pode ver como as tags aparecem em ambos os lados, mesmo com a categoria ‘howto’ configurada para ser excluída no componente do tema ‘tags populares’.

3 curtidas

Em primeiro lugar, você deveria se sentir orgulhoso. Isso é um uso especializado do Discourse! O Discourse é perfeito para esse tipo de coisa! :smiley:

Vou dar uma olhada nisso junto com os outros itens em algum momento da próxima semana.

5 curtidas

Obrigado, Justin!

Acabei de instalar isso no fórum da Rede Global de Empoderamento Jurídico. Temos uma categoria de base de conhecimento (KB) e subcategorias dentro dela. Cada subcategoria possui suas próprias permissões de acesso individual para grupos.

É muito legal ver que ativar esse componente do tema na categoria KB e nas subcategorias funciona! Na verdade, funciona muito bem. :rocket:

Duas coisas adicionais que notei:

  • o menu de tags não parece funcionar corretamente na categoria KB. Os itens que aparecem na lista de tópicos das subcategorias claramente possuem tags, mas o menu de tags está vazio, porque não há tópicos na categoria KB.
  • seria muito útil ver uma lista de subcategorias no menu. Não sei se isso é tecnicamente viável. Se for, talvez pudesse ser listado logo acima do menu de tags?
4 curtidas

Isso é emocionante. Alguém poderia, por favor, criar uma postagem com um link para um tema com KB instalado, mostrando exatamente o que o KB oferece em comparação com apenas categorias e tópicos regulares?

3 curtidas

Você pode vê-lo em ação no nosso site de criador de temas: https://theme-creator.discourse.org/theme/justindirose/knowledge-base

5 curtidas

Isso foi corrigido neste commit:


@TowerBR, você acabou descobrindo por acaso o que estava errado? Se não, me envie uma MP e talvez possamos dar uma olhada.

3 curtidas

Isso era um conflito de nomenclatura de componentes, que já resolvi.

Não consegui reproduzir isso com os passos descritos. Tente atualizar e me avise se o comportamento persistir.

Isso é esperado por enquanto, pois na versão do tema que estamos usando, apenas estamos anexando a interface do KB à lista de tópicos existente.

Acho que essa é uma sugestão justa e removi tanto o link quanto o hash.

Isso eventualmente fará parte da versão avançada, que será um plugin.

As tags populares foram ocultadas corretamente para mim quando adicionei uma exceção.

Não entendi exatamente qual é o problema aqui. A categoria KB tem subcategorias, mas nenhum tópico real na categoria pai do KB?

Se for esse o caso, isso está parcialmente fora do escopo do componente do tema — realmente queríamos apenas tornar uma categoria específica filtrável. O mesmo vale para o filtro de subcategoria. Alguns desses itens serão possíveis na versão avançada.

6 curtidas

Infelizmente não, o comportamento persiste. O botão KB parece não fazer nada. Vou te enviar uma MP.

Com uma pequena ajuda do @justin, agora tudo está funcionando.

Eu não havia habilitado tagging_enabled e show_filter_by_tag na instância que uso para testar.

Obrigado!

2 curtidas

Legal! Tem muita coisa boa aqui. Obrigado pelo seu esforço para fazer este componente de tema funcionar tão bem. Você menciona uma versão avançada que é um plugin — existe algum roteiro por aí para tudo isso, para que eu possa ajustar minhas expectativas e dar feedback? Também temos https://meta.discourse.org/t/knowledge-base-plugin/115288 do @angus, que tem algumas funcionalidades sobrepostas, e será bom saber em qual cavalo devo apostar. Gosto de aspectos de ambos.

Vou fazer alguns testes e retorno para você.

Não, infelizmente não. Mas posso dizer que o plugin em que estou trabalhando é de uma natureza bem diferente — pense no componente de tema com esteroides. Acredito que tanto o plugin quanto o plugin de base de conhecimento do @angus terão casos de uso úteis.

5 curtidas

Fiz uma mudança legal — a configuração kb categories agora é preenchida automaticamente com as categorias. Isso já estava disponível na nossa API de temas o tempo todo, mas eu não sabia! @tshenry me alertou.

Uma ressalva — se você já configurou isso, precisará adicionar suas categorias novamente após a atualização.

7 curtidas

Ótimo! Isso funciona bem. Agora você receberá menos solicitações de suporte. :slight_smile:

Um detalhe, mas notei que a configuração kb categories busca pelos nomes das categorias, mas não pelo nome curto (slug).

Ah, sim — você não precisará se preocupar com o slug. O componente do tema já lida com isso agora. Talvez eu tenha esquecido de alterar algum texto…

Edição: sim, eu esqueci. Fiz um commit com uma alteração para corrigir isso.

2 curtidas

Estou adorando muito este componente de tema! Obrigado novamente por criá-lo. Estou realmente ansioso pelo plugin, pois essa é uma funcionalidade tão valiosa que vai fazer minha equipe usar mais o Discourse. Não tenho certeza, mas acho que, enquanto os tópicos de wiki parecerem postagens de fórum, as pessoas ficarão intimidadas e menos propensas a editá-los para melhorar como um recurso compartilhado.

Algumas coisas com as quais estou lidando:

  1. O menu de tags aparece em um dos meus sites, mas não no outro. Não consegui identificar o conflito. Provavelmente é um plugin não oficial. Alguma sugestão de onde procurar?
  2. Não há botão + NOVO TÓPICO no topo da visualização da categoria do KB, como há para Últimos. Seria útil ter um para adicionar um novo tópico de wiki na categoria. No momento, você precisa clicar em Últimos para iniciar um tópico na categoria.
  3. Não é um grande problema, mas parece um bug — replicável em ambos os meus sites e no criador de temas:
    • Vá para a visualização do KB
    • Selecione uma tag para filtrar por ela
    • Mude para TOP no menu superior
    • Volte para KB no menu superior
    • O filtro de tag ainda está ativo
  4. No mesmo site onde o menu de tags não aparece, tenho outro problema estranho que não consigo replicar no meu outro site ou no criador de temas. Quando vou a uma categoria do KB pelo menu suspenso de categorias, sou levado para Últimos, mesmo que o padrão deva ser KB. Selecionar KB no menu não tem efeito… mas quando faço uma atualização forçada no navegador, sou levado para KB.
4 curtidas

Obrigado, Justin. Esse é um componente super útil — deixa as categorias do KB muito mais organizadas.

Eu o adicionei a uma instalação nova ontem, mas tenho dois problemas:

  1. As tags não aparecem na barra lateral.
  2. Quando seleciono a categoria, a visualização do KB não aparece por padrão (embora eu tenha marcado Categorias selecionadas mostram a visualização do KB por padrão automaticamente).

Desativei todos os outros componentes e tenho tanto tagging_enabled quanto show_filter_by_tag habilitados, mas ainda tenho esses problemas.

Você está vendo algum erro no console do navegador? E também, você atualizou a página após ativar essas duas configurações?

3 curtidas

Você quer dizer atualizar a página? Com certeza, fiz isso.

Não vejo nenhum erro, apenas esses alertas:

Isso está em um fórum público? Tenho algumas suspeitas, mas seria melhor se houvesse uma maneira de dar uma olhada.

EDIT: Com certeza, o número 2 é causado pelas nossas recentes alterações no roteamento de categorias. Estou trabalhando em uma correção, mas ainda preciso contornar algumas complexidades.

Quanto ao número 1, não consigo reproduzir. Muito provavelmente, isso ocorre porque você está vendo tópicos de subcategorias na lista. Como esses tópicos não estão na categoria que você selecionou, as tags não aparecerão na barra lateral.

1 curtida