nodebb-plugin-unread-category-priority
v1.0.1
Published
Boosts topics from a chosen category to the top of the Unread list
Maintainers
Readme
nodebb-plugin-unread-category-priority
Pins unread topics from one or more chosen categories to the top of the Unread list, while preserving the normal recency order within each group.
No category is prioritized until you configure one in the ACP — the plugin is a no-op until then.
How it works
NodeBB exposes the filter:topics.getUnreadTids hook, which fires after the
unread tids have been gathered and sorted by recency. This plugin hooks in,
looks up the cid of each unread topic via topics.getTopicsFields, and
reorders the list so topics in the priority categories appear first. The same
reordering is applied to every filter bucket ('', new, watched,
unreplied) so the order stays consistent across the Unread tabs.
No topics are added or removed — only reordered.
Configuration
Go to ACP → Plugins → Unread Category Priority and enter a comma-separated
list of category IDs (e.g. 5 or 5,3,8). Leave it empty to disable. Settings
are cached in memory and refreshed automatically when you save.
Install
npm install nodebb-plugin-unread-category-priorityThen activate it in ACP → Extend → Plugins and rebuild/restart.
License
MIT
