Front-end utility menu for SilverStripe websites featuring administration and development tools
Go to file
Jono Menz 8329322693 Simplified transform css 2014-10-26 12:09:46 +10:30
_config Clean up 2014-08-25 20:37:26 +09:30
code Check if dataRecord is a SiteTree to prevent errors 2014-10-06 15:19:56 +13:00
css Simplified transform css 2014-10-26 12:09:46 +10:30
images Initial commit 2014-08-13 10:11:18 +09:30
javascript Fixed cookie path for menu state 2014-10-03 13:01:32 -06:00
scss Simplified transform css 2014-10-26 12:09:46 +10:30
templates FIX: Make links relative 2014-09-08 13:55:49 +12:00
README.md Added heading 2014-08-13 11:26:47 +09:30
composer.json Initial commit 2014-08-13 10:11:18 +09:30

README.md

#BetterNavigator for SilverStripe

Diagram of module

This module is intended to replicate and expand upon the functionality provided by SilverStripe's built-in SilverStripeNavigator class. It provides a handy front-end menu for CMS users which offers these features:

For Content Authors

  • Indicates to a user that they are logged in
  • Indicates whether they are viewing draft or live content
  • Quickly edit the page you're viewing

For Developers

  • When in Dev Mode links are included for accessing most of SilverStripe's URL Variable Tools
  • Developers can access these tools on a live website by nominating themselves as a developer in the site config

##Requirements

SilverStripe 3.1

##Installation

Composer / Packagist (best practice)
Add "jonom/silverstripe-betternavigator" to your requirements.

Manually
Download, place the folder in your project root, rename it to 'betternavigator' (if applicable) and run a dev/build?flush=1.

##How to use

Just place $BetterNavigator somewhere in your template(s). If your website uses caching, make sure BetterNavigator's output is excluded.

Access developer tools on a live website
You can mark certain CMS users as developers in your site's config, so they can acess developer tools when logged in. Example YAML:

  BetterNavigator:
    developers:
      - 'dev@yoursite.com'
      - 'otherdev@yoursite.com'

##Customisation

Scripts and CSS are included via the BetterNavigator.ss template, so you can completely customise the front-end code and included links by copying or creating your own BetterNavigator.ss template.

The BetterNavigator.ss template's scope is set to the page that is being viewed, so any methods available in your page controller will be available in the BetterNavigator.ss template. This should allow you to add custom links by page type if you wish.

##Known issues

  • Probably won't work in IE8 or lower.