Admin Menu Groups
What it helps you do
Find things in wp-admin faster. The left menu is ordered under five labels, so Plugins, Users and Settings always sit in the same place, however many plugins a site has:
- Content: Posts, Pages, Media, Comments, every post type (Events, People and so on) and Forms.
- Store: Products, orders and the rest of WooCommerce, on a site with a store.
- Site: Contact & Social, Tracking & Privacy, Site Sheet and anything else a site's plugins add.
- Design: Customize, Appearance, Fonts, Menus, Footer and Mega Menus.
- Admin: the Dirigible menu first, then Plugins, Users, Tools, Settings, Optimize and AI.
Things to know
- Dashboard and Analytics stay at the very top, above the labels.
- A new plugin lands under Site, A to Z, with nothing to set up.
- A group only shows when the person signed in can see something in it.
- Click a group's label to close or open it. Groups start open, and each person's choice follows them from page to page. The group holding the page you're on always opens with it, so you can see where you are, but you can still close it to reach the groups below. Closed that way, it stays closed on pages in other groups. A closed group shows the total of its rows' counts, such as comments waiting or plugin updates, beside its label, so nothing waiting is hidden.
- Comments leaves the menu when Allow people to submit comments on new posts is off in Settings > Discussion and no comment is waiting for moderation. It comes back while one waits, and the page still opens by its URL.
- Menus has its own row under Design instead of sitting inside Appearance. The Fonts row is Dirigible's font settings; WordPress's own Fonts page, which the theme doesn't use, is left out of the menu.
- AI holds the Dirigible AI pages and the OpenRouter key. On a site without Dirigible AI, it goes straight to its Settings page.
- In a narrow window the menu shrinks to icons on its own. Hover or tab to an icon to open its section. Every icon shows there, even from a group you closed.
- The sun and moon button beside Help in the top bar switches the menu and top bar between dark and light. It's dark until you change it, and your choice follows you from page to page without changing what anyone else sees.
- On the light look, a plugin's picture icon sits on a small dark square so a white one stays visible.
For developers
The ds_admin_menu_groups filter maps a top-level menu slug to top, content, store, site, design or admin. Any other slug goes in Site. The ds_admin_menu_icons filter maps a slug to one of the theme's line icons, listed in bin/ds-line-icons.mjs; any other slug keeps the icon its plugin set.
Closed groups are stored in WordPress's own per-user settings, as dsrail.
The light look stores dirigible-light in WordPress's own admin_color user setting, which puts admin-color-dirigible-light on body. It changes the --menu-* color variables, and a plugin that draws in the menu or top bar should use those instead of fixed colors.