henrypenny/silverstripe-custommenus

A Silverstripe module allowing you to create custom menus that can be gernated in the front end of your site.

1.0.1 2015-11-23 02:56 UTC

Requires

• silverstripe/cms: >=3.1
• silverstripe/framework: >=3.1

BSD-3-Clause

• Morven Lewis-Everley

• navigation
• silverstripe
• nav
• menus

README

Developer

Developed and maintained by i-lateral

Requirements

SilverStripe 3.1 or greater.

Installation Instructions

Downloading the module:

1. Download and add the module to the "custommenus" folder in your SilverStripe root folder

2. Run dev/build?flush=all

3. Visit admin/menus/ to setup your custom menus

4. In you template, use: <% loop CustomMenu(slug) %><% end_loop %>

You can also download and install this module using composer and packagist

Usage

Once the module is downloaded and installed, you can create menus and add pages to them using the "Menus" page in the admin interfacve.

To render these menus in your templates, you can either:

Add $RenderCustomMenu(menu-slug) to your template code. This will make use of the CustomMenu.ss include to render a UL (with a unique class name).

Alternativley you can generate your own template by adding the following code:

<% if $CustomMenu(main-menu) %><ul class="menu">
    <% loop $CustomMenu(main-menu) %>
        <li class="$LinkingMode $FirstLast">
            <a href="$Link">$MenuTitle</a>
        </li>
    <% end_loop %>
</ul><% end_if %>