Knowledge Base

[justin (Justin DiRose)]

Thanks for the feedback @tobiaseigen! I have some other work on my plate this week, but I’ll be sure to dig into a few of these items next week.

[tobiaseigen]

Another item - this theme component makes no sense alongside the popular tags theme component, and for some reason the exclude category setting for that theme component does not seem to work for me despite multiple browser refreshes. I don’t know if you can accommodate this issue in this theme component… so we can still use the popular tags in other views and not show them here.

I’m not too proud to expose how I am using discourse as my personal knowledge base - in the screenshot below you can see how the tags appear on both sides, even with the howto category set to be excluded in the popular tags theme component.

[justin (Justin DiRose)]

@tobiaseigen

I’m not too proud to expose how I am using discourse as my personal knowledge base

First of all, you should be proud. That’s some expert Discourse use there! Discourse is perfect for that kind of stuff!

@tobiaseigen

I don’t know if you can accommodate this issue in this theme component… so we can still use the popular tags in other views and not show them here.

I’ll take a look with the other items next week sometime.

[tobiaseigen]

Thanks, Justin!

I just installed this on the global legal empowerment network forum. We have a kb category, and sub-categories within kb. Each sub-category has its own individual group access permissions.

It’s pretty cool to see that enabling this theme component in the kb category and subcategories works! In fact it works very well.

Two additional things I noticed:

• the tags menu does not appear to work correctly in the kb category. Items appearing in the list of topics from subcategory clearly have tags but the tags menu is empty, because there are no topics in the kb category.
• it would be very helpful to see a sub-categories list on the menu. I don’t know if this is technically feasible. If so, perhaps it could be listed directly above the tags menu?

[EGreg (Greg Magarshak)]

This is exciting. Can someone please create a post with a link to a theme with KB installed, showing exactly what KB offers versus just regular categories and topics?

[justin (Justin DiRose)]

You can see it in action on our theme creator site: https://theme-creator.discourse.org/theme/justindirose/knowledge-base

[justin (Justin DiRose)]

@Sean_R

It happens every time. I can just click “KB” or refresh fixes it but not when I go to the category from the drop-down.

This has been fixed in this commit:

https://github.com/discourse/discourse-knowledge-base-theme/commit/4b49d6f01880f4da22f5f9150eda0a14091fd9d9

---

@TowerBR did you end up figuring out what was wrong by chance? If not, send me a PM and maybe we can take a look.

[justin (Justin DiRose)]

@tobiaseigen

This theme component does seem to conflict with Knowledge Base Plugin by @angus. I can confirm that the plugin has to be uninstalled prior to enabling this theme component, otherwise the below happens when you look at a knowledge base category. Note the weird horizontal line next to the menu and spinning circle.

This was a component naming conflict which I’ve resolved.

@tobiaseigen

bug? when you select a tag from the left menu to filter by that tag, and then click to another category or latest etc… then when you next click on kb to return to the knowledge base you will find you are still filtering by that tag.

I wasn’t able to reproduce this with the steps. Try updating and let me know if you still have this behavior.

@tobiaseigen

when you click on the tag under a title, it takes you to the tag page for that tag, not to a filtered kb view as it does when you click the tag on the left menu.

This is expected for now as in the theme version we’re just appending the KB UI to the existing topic list.

@tobiaseigen

click on the tag category title on the left menu, and you are taken to the latest view for the category. I’d suggest this not link to anywhere. The category title also should probably not have # which is a distraction.

I think this is a fair suggestion and I’ve removed both the link and the hash.

@tobiaseigen

• it would be handy to see the number of topics with each tag on the left menu
• it would be handy to be able to sort kb topics alphabetically or even in custom order

This is eventually going to be in the advanced version that’s a plugin.

@tobiaseigen

Another item - this theme component makes no sense alongside the popular tags theme component, and for some reason the exclude category setting for that theme component does not seem to work for me despite multiple browser refreshes. I don’t know if you can accommodate this issue in this theme component… so we can still use the popular tags in other views and not show them here.

The popular tags hid properly for me when I added an exception.

@tobiaseigen

• the tags menu does not appear to work correctly in the kb category. Items appearing in the list of topics from subcategory clearly have tags but the tags menu is empty, because there are no topics in the kb category.
• it would be very helpful to see a sub-categories list on the menu. I don’t know if this is technically feasible. If so, perhaps it could be listed directly above the tags menu?

I’m not quite following exactly what the issue is here. Does the kb category have subcategories, but no actual topics in the kb parent category?

If that’s the case, that’s semi-out of the scope of the theme component - we really just wanted to make a particular category filterable. Same with the subcategory filter. Some of these items will be possible in the advanced release.

[TowerBR (Tower)]

@justin

@TowerBR did you end up figuring out what was wrong by chance? If not, send me a PM and maybe we can take a look.

Unfortunately no, the behavior persists. The KB button seems to do nothing. I’ll send you a PM.

[TowerBR (Tower)]

With a little help from @justin, now everything is working.

I had not enabled tagging_enabled and show_filter_by_tag on the instance I use to test.

Thanks!

[tobiaseigen]

Cool! Lots of great stuff here. Thanks for your hard work on getting this theme component working so well. You mention an advanced version that is a plugin - Is there a roadmap somewhere for all this so I can set my expectations and give feedback? We also have https://meta.discourse.org/t/knowledge-base-plugin/115288 by @angus which has some overlapping functionality and it will be good to know which horse I should be betting on. I like aspects of both.

I will do some testing and get back to you.

[justin (Justin DiRose)]

@tobiaseigen

Is there a roadmap somewhere for all this so I can set my expectations and give feedback?

No unfortunately not. But I can tell you the plugin I’m working on is in a much different vein – think the theme component on steroids. I think both the plugin and @angus’ knowledge base plugin will have helpful use cases.

[justin (Justin DiRose)]

I’ve made a neat change – the kb categories setting now autopopulates with categories. This was available in our theme API the whole time, but I didn’t know about it! @tshenry cued me in.

One caveat – if you’ve set this up already, you’ll need to add your categories again once you update.

https://github.com/discourse/discourse-knowledge-base-theme/commit/4694d4a8ad788f8884e3341c852d3f77b2c1d103

[tobiaseigen]

Nice! That works well.. you will get fewer support requests now.

A niggle, but I noticed the kb categories setting searches for names of categories, but not the short name (slug).

[justin (Justin DiRose)]

@tobiaseigen

A niggle, but I noticed the kb categories setting searches for names of categories, but not the short name (slug).

Ah yes - you won’t have to worry about the slug. The theme component handles that now. I may have forgotten to change some text though…

Edit: yeah I did. Committed a change to fix that.

[tobiaseigen]

I’m enjoying this theme component alot! Thanks again for creating it. I am really looking forward to the plugin because this is such a valuable bit of functionality that will get my team using discourse more. I can’t be positive, but I think as long as wiki topics look like forum posts people are intimidated and less likely to edit to improve it as a shared resource.

A few things I am grappling with:

1. tags menu shows up on one of my sites, but not on another. Have been unable to pinpoint the conflict. Likely an unofficial plugin. Any suggestions where to look?
2. there is no + NEW TOPIC button at the top of kb category view as there is for Latest. It would be helpful to have one to add a new wiki topic in the category. Right now you have to click across to Latest to start a topic in the category.
3. not a big problem but feels buggy - replicable on both of my sites and at theme creator:
   • go to kb view
   • select tag to filter by it
   • switch to TOP on top menu
   • switch back to KB on top menu
   • tag filter is still in place
4. on the same site where tags menu doesn’t show up, I have another weird problem I can’t replicate on my other site or on theme creator. When I go to a kb category via the categories pulldown, I am taken to Latest even though it should be defaulting to kb. Selecting kb on the menu has no effect.. but when I hard refresh in the web browser I am taken to kb.

[tpetrov (Toni Petrov)]

조스틴, 감사합니다. 정말 유용한 컴포넌트네요. KB 카테고리를 훨씬 더 체계적으로 정리해 줍니다.

어제 새로 설치한 환경에 추가했는데, 두 가지 문제가 있습니다:

1. 사이드바에 태그가 표시되지 않습니다.
2. 카테고리를 선택해도 기본적으로 KB 뷰가 표시되지 않습니다. (선택된 카테고리에 대해 기본적으로 KB 뷰 자동 표시 옵션은 활성화되어 있습니다.)

다른 모든 컴포넌트를 비활성화하고 tagging_enabled과 show_filter_by_tag를 모두 활성화해 두었지만, 여전히 같은 문제가 발생합니다.

[justin (Justin DiRose)]

브라우저 콘솔에서 어떤 오류가 표시되고 있나요? 그리고 두 가지 설정을 활성화한 후 새로고침을 했나요?

[tpetrov (Toni Petrov)]

페이지를 새로고침하라는 뜻인가요? 네, 그렇게 했습니다.

오류는 보이지 않고, 다음 경고만 표시됩니다:

[justin (Justin DiRose)]

이게 공개 포럼인가요? 몇 가지 의심이 드는데, 직접 확인할 수 있는 방법이 있으면 좋겠습니다.

수정: 2번 문제는 최근 카테고리 라우팅 변경으로 인해 발생한 것으로 확실합니다. 수정 작업을 진행 중이지만, 아직 해결해야 할 복잡한 부분이 있습니다.

1번 문제는 재현이 되지 않습니다. 아마도 목록에서 하위 카테고리의 주제를 보고 계시기 때문일 가능성이 높습니다. 해당 주제들이 현재 선택한 카테고리에 속해 있지 않기 때문에 사이드바에 태그가 표시되지 않습니다.