anlutro/menu

Dynamic menu builder.

Menu Builder

Simple dynamic menu building system., _(*1)

PHP framework agnostic. The default renderer uses Bootstrap 3 class names and markup., _(*2)

Installation

composer require anlutro/menu - pick the latest tag visible in the github tag list or on packagist., _(*3)

Laravel 4

Add anlutro\Menu\ServiceProvider to the list of providers in app/config/app.php. Optionally, add an alias for 'Menu' => 'anlutro\Menu\Facade' as well. The menu builder instance can be accessed via the facade or via automatic dependency injection by type hinting., _(*4)

Do artisan config:publish anlutro/menu to change the default Bootstrap 3-specific settings., _(*5)

Usage

Set up a shared instance of Menu\Builder. Create the menus you need., _(*6)

$builder = new anlutro\Menu\Builder;
$menu = $builder->createMenu('left');

If you're using Laravel 4, you can use Menu:: instead of $builder-> provided you set up an alias as shown in the installation instructions above., _(*7)

From here, you can add items to your menus from anywhere., _(*8)

$menu->addItem('Item 1', '/my-uri');

// you can add custom html attributes to your items
$menu->addItem('Item 2', '/my-uri', ['class' => 'custom-class']);

// use priorities to push items to the top or bottom of your menu
// items have priority 0 by default.
$menu->addItem('First item', '/my-uri', [], -50);
$menu->addItem('Last item', '/my-uri', [], 50);

Adding submenus works similarly., _(*9)

$submenu = $menu->addSubmenu('Sub Menu');
$submenu->addItem('Sub item 1', '/my-uri');

When you want to render a menu, call render($menu) and echo it., _(*10)

echo $builder->render('left');

By default, Bootstrap 3-specific classes are used. If you want to use something else, you need to create your own class implementation of anlutro\Menu\Renderers\RendererInterface and either do $builder->setDefaultRenderer('MyRenderer') or $builder->render('name_of_menu', $myRenderer)., _(*11)

Contact

Open an issue on GitHub if you have any problems or suggestions., _(*12)

License

The contents of this repository is released under the MIT license., _(*13)