devitek/extensible-menu

An extensible library to manage menus

2.0.0 2016-08-20 19:36 UTC

Requires

• php: >=5.4.0

MIT

• Thomas SIEFFERT

README

Installing

Add "devitek/menu": "^2.0.0" to your composer.json by running :

composer require devitek/menu

And select version : 2.*

How to use

You can use it like this :

<?php

$html = (new Devitek\Menu\Renderer\TwitterBootstrap\Navbar())
    ->translateWith(new Devitek\Menu\Translator\LaravelTranslator())
    ->resolveUrlWith(new Devitek\Menu\Resolver\LaravelResolver())
    ->isFluid()
    ->handleResponsive()
    ->isFixedTop()
    ->withBrand('My super project', '/')
    ->onTheLeft((new Menu())->with([
        (new IconLink('pages.home.link'))->withDestination('home')->withIcon('glyphicon glyphicon-home'),
    ]))
    ->onTheRight((new Menu())->with([
        (new Devitek\Menu\Items\IconGroup('pages.account.link'))->withIcon('glyphicon glyphicon-user')->need([
            function () { return ! Auth::guest(); }
        ]) ->withUnder([
            (new Devitek\Menu\Items\IconLink('pages.administration.utilisateurs.lien'))->withDestination('administration.utilisateurs')->withIcon('glyphicon glyphicon-cog'),
        ]),
    ]))
    ->render();

In this case, I use the translator provider and route resolver for laravel.

What's included

Items

Base :

• Item

Classes :

• Link
• IconLink
• Group
• IconGroup
• Separator

Trait :

• WithIcon

Renderer

Base :

• Renderer

Twitter Bootstrap :

• Navbar

ResolverInterface

Interface :

• ResolverInterface

Laravel :

• LaravelResolver

TranslatorInterface

Interface :

• TranslatorInterface

Laravel :

• LaravelTranslator

TODO

• More integrations (Zf2, Symfony2...)
• More doc
• More examples

Enjoy it ! Feel free to fork :) !