Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

SpiffyNavigation Module for Zend Framework 2

SpiffyNavigation is a navigation module for ZF2 intended to be a replacement for Zend\Navigation when ZF3 is able to break BC.

Project Status

Master Branch Build Status Coverage Status



Installation of SpiffyNavigation uses composer. For composer documentation, please refer to

Installation steps

  1. cd my/project/directory

  2. create a composer.json file with following contents:

        "require": {
            "spiffy/spiffy-navigation": "dev-master"
  3. install composer via curl -s | php (on windows, download and execute it with PHP)

  4. run php composer.phar install

  5. open my/project/directory/configs/application.config.php and add the following key to your modules:



Providers let you create your navigation containers from various sources. The following providers are included out of the box:

  • array: builds a container from an array.
  • config: builds a container from a file using Zend\Config.
  • json: builds a container from a json string.

Creating containers

Creating navigation containers is done via the module configuration using the spiffy_navigation key. The containers array can take two types of values: a string and an array. If you pass a string the container will be created from a provider matching the name if it exists, pulled from the service manager or instantiated directly. If you pass an array the container is built using the ContainerFactory::create() method.


// module.config.php
return array(
    'spiffy_navigation' => array(
        'containers' => array(
            'default' => array(
                    'options' => array(
                        'uri' => '',
                    'attributes' => array(
                        'class'  => 'foo',
                        'target' => '_blank',
                        'name'   => 'github'
                    'options' => array(
                        'label' => 'Home',
                        'route' => 'home',
                    'attributes' => array(
                        'name' => 'Home'
                    'pages' => array(
                        // ...

            'serviceManager' => 'My\ServiceManager\Alias',

            'class' => 'My\Class\Instantiation',

            'json_provider' => 'mynav',

        'providers' => array(
            'mynav' => array(
                'type' => 'json',
                'options' => array(
                    'json' => file_get_contents(__DIR__ . '/navigation/mynav.json')

Page options

  • label: The label for the element in view helpers.
  • anchor: An optional anchor to append to the uri.
  • route: The route to use for assembling the uri.
  • uri: The direct uri to use (use instead of route).
  • params: Optional params to include during route assembly.
  • query_params: Optional params to include in the query string during assembly.

Rbac specific options

  • role: required The role to use to determine if access is granted.
  • permission: required The permission to use to determine if access is granted.
  • assertion: The assertion to use to determine if access is granted.

Using the view helpers

Once you have created a container using a view helper is as simple as putting:


echo $this->helperName('containerName');


Quick Start


// in view script
echo $this->navigationMenu('containerName');

// or

echo $this->navigationMenu()->renderMenu('containerName', $options);

// or

echo $this->navigationMenu()->renderPartial('containerName', 'partialName');


  • ulClass: The class to use when generating the ul.
  • minDepth: Minimum render depth.
  • maxDepth: Maximum render depth.
  • activeClass: Active class to use for the active element.


A ZF2 module designed as a replacement for Zend\Navigation.






No packages published