saquetim announced a new visual index editor for the Doc Categories plugin, allowing admins to build sidebar indices directly in the admin UI without maintaining a separate index topic. This experimental feature is available as an upcoming change at /admin/config/upcoming-changes.
The editor introduces a Doc index tab with three modes:
Editor: Builds the index in place using sections and links (to topics or URLs), supporting custom icons and duplicate warnings.
Index topic: Retains the existing behavior where topic headings form the index.
Disabled: Turns off the sidebar index.
Key features include:
Auto-index: A section that automatically collects unlisted topics, resyncing on save.
Bulk actions: Admins can identify and add unlisted topics in bulk.
Accessibility and UX: Drag-and-drop reordering, keyboard navigation for all elements, and a batch mode for multi-select actions like deleting or moving multiple rows.
Martin noted that the initial PR is merged behind this experimental flag and refinements are expected before moving to Alpha. Hugh praised the smooth migration from existing index topics to the new UI. Martin further confirmed upcoming improvements, including support for three levels of nesting and establishing a proper Documentation category type, referencing recent PRs for nesting and category types.
Feedback is requested on usability compared to topic-based indices and missing features. Current images demonstrate the editor’s interface, including the mode selector, link management, auto-index section, and drag-and-drop reordering.
Doc categories can now build their sidebar index directly in the admin UI. The index editor is an upcoming change for the Doc Categories plugin, and it removes the need to maintain a separate index topic.
Two ways to source an index
Editing a category now has a Doc index tab with a mode selector:
Editor builds the index in place, as sections holding links.
Index topic is the existing behaviour, where a topic’s headings and lists become the index.
Disabled turns the sidebar index off for that category.
Categories already pointing at an index topic keep working exactly as they do today.
A section holds links, and a link points either at a topic or at any URL you type. Each link can carry its own icon, and the editor warns you when two links resolve to the same place or two sections share a title.
An Auto-index section fills itself from the category’s topics, so you can list the pages you care about by hand and let everything else collect in one place. It can resync on each save.
Sections and links reorder by dragging. Every drag handle is also an ordinary tab stop that opens a move menu, so the whole index can be rearranged from the keyboard. A batch mode handles multi-select, for deleting several rows at once or dragging a whole selection together.
The index editor is an experimental upcoming change. Enable Doc categories index editor at /admin/config/upcoming-changes. It affects doc categories only, and only what admins see while editing one.
Tell us how it holds up against a real index: whether building one here beats maintaining a topic, what is missing before you would move a category over, and anything that feels rough.
This is great! Migration is simple - the existing index topic populates the new UI and it all works smoothly. Love this update and very happy with the new UI here
Thanks Hugh! More improvements are coming, I’ve already merged a change to allow 3 levels deep of nesting and to make this into a proper Documentation category type, so stay tuned.