using-menu.md

Using Menu

Menu manager used for build hierarchical menu. This is automatically look of user role and permision then return menus that he has access.

use mdm\admin\components\MenuHelper;
use yii\bootstrap\Nav;

echo Nav::widget([
    'items' => MenuHelper::getAssignedMenu(Yii::$app->user->id)
]);

Return of mdm\admin\components\MenuHelper::getAssignedMenu() has default format like:

[
    [
        'label' => $menu['name'], 
        'url' => [$menu['route']],
        'items' => [
			[
				'label' => $menu['name'], 
				'url' => [$menu['route']]
            ],
            ....
        ]
    ],
    [
        'label' => $menu['name'], 
        'url' => [$menu['route']],
        'items' => [
			[
				'label' => $menu['name'], 
				'url' => [$menu['route']]
            ]
        ]
    ],
    ....
]

where $menu variable correspond with a record of table menu. You can customize return format of mdm\admin\components\MenuHelper::getAssignedMenu() by provide a callback to this method. The callback must have format function($menu){}. E.g:

You can add html options attribute to Your menu, for example "title". When You create a menu, in field data (textarea) fill this : return ['title'=>'Title of Your Link Here'];

and then in Your view:

$callback = function($menu){
    $data = eval($menu['data']);
    return [
        'label' => $menu['name'], 
        'url' => [$menu['route']],
        'options' => $data,
        'items' => $menu['children']
    ];
}

$items = MenuHelper::getAssignedMenu(Yii::$app->user->id, null, $callback);

Default result is get from cache. If you want to force regenerate, provide boolean true as forth parameter.

You can modify callback function for advanced usage.

Using Sparated Menu

Second parameter of mdm\admin\components\MenuHelper::getAssignedMenu() used to get menu on it's own hierarchy. E.g. Your menu structure:

• Side Menu
  • Menu 1
    • Menu 1.1
    • Menu 1.2
    • Menu 1.3
  • Menu 2
    • Menu 2.1
    • Menu 2.2
    • Menu 2.3
• Top Menu
  • Top Menu 1
    • Top Menu 1.1
    • Top Menu 1.2
    • Top Menu 1.3
  • Top Menu 2
  • Top Menu 3
  • Top Menu 4

You can get 'Side Menu' chldren by calling

$items = MenuHelper::getAssignedMenu(Yii::$app->user->id, $sideMenuId);

It will result in

• Menu 1
  • Menu 1.1
  • Menu 1.2
  • Menu 1.3
• Menu 2
  • Menu 2.1
  • Menu 2.2
  • Menu 2.3