Discourse Doc Categories

Plugin
,
132

Just did this - it gave a slightly odd error but seemed to run okay:

root@spokes-web-only:/var/www/discourse# bundle exec rake doc_categories:build_sidebar
fatal: detected dubious ownership in repository at ‘/var/www/discourse’
To add an exception for this directory, call:

    git config --global --add safe.directory /var/www/discourse

Processing category #21 - Ask the Candidates
⮑ Created 3 sections and 55 links

Processing category #21 - Ask the Candidates
⮑ Created 3 sections and 55 links

Is that as it should be?

And do we have to change how we interact with the index topic, or is that all unchanged?

4 Likes
133

Yes, that is correct and there is nothing else that needs to be done :ok_hand:t2:

Yes again.

In the near future (:crossed_fingers:t2:) we would be working on improving features such as easy sorting, rearranging, updating with perhaps a dedicated UI. I do not expect there to be any more manual tasks that self-hosters will have to do.

3 Likes
134

Can you please clarify to which plugin version and/or commit this applies?

I’m running Discourse 3.6.0.beta1-dev and not showing any plugin updates available for Documentation Categories, the plugin being version 0.0.1 with commit ba90a37.

1 Like
135

The changes are about 7 commits newer.

The changes come in the same version of Discourse 3.6.0.beta1-dev. Ideally the next time you update Discourse itself, you should get those changes as well.

Generally, I do not recommend just updating the plugin only, but rather use the typical upgrade methods through the UI or ./launcher rebuild app.

2 Likes
136

Doc Menu (on the left) can not display at the latest version of discourse (3.6.0.beta2)

Could you check this again?

137

For me it still works here on Meta.

Did you rebuild the index as described here?

2 Likes
138

Thank you, it is ok with this:

sudo -E -u discourse bundle exec rake doc_categories:build_sidebar

1 Like
139

A post was split to a new topic: Various suggestions to improve the doc categories plugin

140

Hi everyone,

I tried to install it now, but it seems that this plugin is not compatible with the version of Discourse we are using, 3.5.2.

Can you confirm compatibility? I am getting this error:

November 5, 2025, 06:55
/var/www/discourse/plugins/discourse-doc-categories/lib/doc_categories/initializers/add_category_extensions.rb:19:in `apply': undefined method `register_category_update_param_with_callback' for an instance of Plugin::Instance (NoMethodError)
discourse
November 5, 2025, 06:55
** INCOMPATIBLE PLUGIN **
discourse
November 5, 2025, 06:55
You are unable to start Discourse due to errors in the plugin at
discourse
November 5, 2025, 06:55
/var/www/discourse/plugins/discourse-doc-categories
discourse
November 5, 2025, 06:55
Please try removing this plugin and rebuilding again!
141

Hey, you’ll need to update your Discourse instance first as the method indicated is only on a more recent version.

142

Does the image discourse/discourse:3.5.2 have this updated code? Because I am using it and I see that it was updated 10 hours ago

143

3.5.2 will not have compatibility, you’ll see security updates, but not new features. You’ll need 3.6.0.beta1 minimally.

1 Like