Discourse Docs Card Filter Component

This theme component is to be used with the Discourse Docs Plugin.

It will allow you to place “Cards” that act as a clickable filter for quicker filter results upon entering the /docs page by your users.

The above would be rendered with these settings in the docs plugin:

Component Settings

You can select custom icons for each category or tag card filter. You can also allow category descriptions to be rendered in the category card filters.

15 Likes

Thanks for building this! Is it the case that if a user doesn’t have view permissions on a (private) category, the card for that private category won’t appear above the search box? (Or I suppose on the sidebar, but just want to confirm the behavior is consistent.)

1 Like

This should be the case as we are getting the category info from

@discourseComputed("category")
  categoryInfo(category) {
    return this.site.categories.findBy("id", category.id);
  },

To my knowledge, this.site.categories will only return those the current user can view.

1 Like

Excellent. That will make it a real easy-to-use tool for people in our multiple workgroups who want quick access to their group(s) reference materials, and quickly filter our Group A from Group B, etc. Thanks!

1 Like