A front-end utility menu featuring administration and development tools.
Back in the era of SilverStripe 2 the default template BlackCandy included SilverStripeNavigator - a handy menu utility shown to CMS users when browsing the front-end site that let them quickly edit a page, logout, and switch between viewing the draft and published version of a page.
Fast forward to the modern era of SilverStripe 3 and this useful utility is sadly missing from Simple, SilverStripe’s slick new default theme - meaning it’s existence may be unknown to developers who are new to SilverStripe. It lives on in the SilverStripe core though, and you can easily include it in a site by adding $SilverStripeNavigator somewhere in your page template. Give it a try!
The built-in SilverStripeNavigator is pretty cool but it has remained pretty much unchanged since SilverStripe 2, so while it still works, I thought it could use a few improvements. BetterNavigator expands upon the functionality provided by SilverStripeNavigator in a number of ways:
Improvements for Content Authors
- Redesigned user interface
- Click to toggle menu open/close (state saved between page loads)
- Clearer draft/published status
Improvements for Developers
- Developer tools included (debug/build/flush etc. - shown only to developers)
- Customise menu by overriding templates (add buttons/change look)
- No jQuery dependency (just a sprinkling of plain javascript)
Give it a try
To quickly install BetterNavigator with Composer use the following command:
composer require jonom/silverstripe-betternavigator dev-masterThen just include $BetterNavigator somewhere in your page template, and run a dev/build?flush=1.
Composer is the recommended way to install SilverStripe modules (read about Composer and SilverStripe here). If you prefer to manually install modules, you can find downloads and instructions on the module’s GitHub page.
BetterNavigator requires SilverStripe 3.1 or newer.
Find out more
Detailed documentation is available on the BetterNavigator Addons listing.
I hope you find BetterNavigator useful.
