A Flarum extension that gives admins full control over the sidebar navigation on the forum index page — reorder items, add custom links, customize icons, highlight items for users, and more.
Use the arrow buttons to reorder all sidebar nav items (All Discussions, Tags, Following, User Directory, third-party extension links, etc.). The order updates immediately after saving.
Add your own links to the sidebar nav. Each custom link has a label, URL, and icon. External links (starting with http:// or https://) open in a new tab automatically. Internal links (paths or your forum's URL) open in the same tab via Mithril's router.
Moves tag links to the top of the sidebar and nav items (All Discussions, Following, etc.) to the bottom. Applies on all screen sizes.
Keeps the sidebar fixed at the top of the viewport as the user scrolls. The Start a Discussion button stays visible at all times. Desktop only.
Each nav item has a text input for overriding its Font Awesome icon class (e.g. fas fa-bolt). Leave it empty to use the extension's default icon.
Mark any nav item with the star button to apply a highlight treatment: colored background at reduced opacity, solid border, and a pulsing glow animation. Desktop only.
A color picker controls the background, border, and glow color for highlighted items.
Any item can be permanently removed from the admin list using the × button. Useful for items discovered by the PHP scanner that don't actually appear in your forum's nav (e.g. fof/polls items when global polls is disabled).
Install via Flarum's built-in Extension Manager, or via Composer:
composer require resofire/menu-control
php flarum extension:enable resofire-menu-controlAfter enabling the extension:
- Visit the forum index page while logged in as an admin. This automatically detects all active nav items and saves the current display order.
- Go to Admin → Extensions → Menu Control to configure.
If you install or uninstall extensions that add nav items, visit the forum index page again as admin to refresh the list.
| Control | Description |
|---|---|
| Flip navigation | Toggle — tags above nav items |
| Sticky sidebar | Toggle — fixed sidebar on desktop |
| Highlight color | Color picker for highlighted item styling |
| Add Custom Link | Add a custom nav link with label, URL, and icon |
| Icon input | Override the Font Awesome icon (e.g. fas fa-fire) |
| ★ star button | Toggle highlight on/off for an item |
| × button | Remove item from the admin list permanently |
| ↑ / ↓ buttons | Reorder nav items |
| Save Order | Persist all changes |
Ordering, custom icons, flip, and highlight all apply to the blog page's Forum Nav sidebar automatically.
If fof/polls is installed, items like fof-polls-showcase may appear in the admin list even when global polls is disabled. Use the × button to remove them permanently.
| Key | Content |
|---|---|
resofire-menu-control.order |
JSON array of nav keys in saved order |
resofire-menu-control.known-keys |
JSON array of all discovered nav keys |
resofire-menu-control.labels |
JSON object of key → display label (auto-discovered) |
resofire-menu-control.icons |
JSON object of key → FA icon class (auto-discovered) |
resofire-menu-control.custom-icons |
JSON object of key → admin-overridden FA icon class |
resofire-menu-control.custom-links |
JSON array of custom link objects |
resofire-menu-control.flip |
"1" or "0" |
resofire-menu-control.sticky |
"1" or "0" |
resofire-menu-control.highlighted |
JSON array of highlighted nav keys |
resofire-menu-control.highlight-color |
Hex color string |
resofire-menu-control.removed-keys |
JSON array of keys removed from the admin list |
Flarum 1.8+ (flarum/core: ^1.8).
MIT — see LICENSE.