README

从https://github.com/lordmacu/wmenu fork而来

安装

1. 运行

composer require harimayco/laravel-menu

如果你使用laravel 5.5，步骤2和3是可选的

1. 在config/app.php文件中的"providers"数组中添加以下类（在laravel 5.5中是可选的）

Harimayco\Menu\MenuServiceProvider::class,

1. 在config/app.php文件中添加facade（在laravel 5.5中是可选的）

'Menu' => Harimayco\Menu\Facades\Menu::class,

1. 运行发布

php artisan vendor:publish --provider="Harimayco\Menu\MenuServiceProvider"

1. 在config/menu.php中配置（可选）

• 自定义中间件: 你可以添加自己的中间件
• 表前缀: 默认情况下，此包将创建两个新表，名为"menus"和"menu_items"，但你仍然可以添加自己的表前缀以避免与现有表冲突
• 表名称: 如果你想要使用特定的表名，你必须修改它以及迁移文件
• 自定义路由: 如果你想要编辑路由路径，你可以编辑该字段
• 角色访问: 如果你想要在菜单项上启用角色（权限）

1. 运行迁移

php artisan migrate

完成

菜单构建器使用示例 - 显示构建器

在你的视图blade文件中

@extends('app')

@section('contents')
    {!! Menu::render() !!}
@endsection

//YOU MUST HAVE JQUERY LOADED BEFORE menu scripts
@push('scripts')
    {!! Menu::scripts() !!}
@endpush

使用模型

调用模型类

use Harimayco\Menu\Models\Menus;
use Harimayco\Menu\Models\MenuItems;

菜单使用示例（a）

一个基本的二级菜单可以在你的blade模板中显示

使用模型类

/* get menu by id*/
$menu = Menus::find(1);
/* or by name */
$menu = Menus::where('name','Test Menu')->first();

/* or get menu by name and the items with EAGER LOADING (RECOMENDED for better performance and less query call)*/
$menu = Menus::where('name','Test Menu')->with('items')->first();
/*or by id */
$menu = Menus::where('id', 1)->with('items')->first();

//you can access by model result
$public_menu = $menu->items;

//or you can convert it to array
$public_menu = $menu->items->toArray();

或使用辅助函数

// Using Helper 
$public_menu = Menu::getByName('Public'); //return array

菜单使用示例（b）

现在在你的blade模板文件中放置菜单，使用这个简单的示例

<div class="nav-wrap">
    <div class="btn-menu">
        <span></span>
    </div><!-- //mobile menu button -->
    <nav id="mainnav" class="mainnav">

        @if($public_menu)
        <ul class="menu">
            @foreach($public_menu as $menu)
            <li class="">
                <a href="{{ $menu['link'] }}" title="">{{ $menu['label'] }}</a>
                @if( $menu['child'] )
                <ul class="sub-menu">
                    @foreach( $menu['child'] as $child )
                        <li class=""><a href="{{ $child['link'] }}" title="">{{ $child['label'] }}</a></li>
                    @endforeach
                </ul><!-- /.sub-menu -->
                @endif
            </li>
            @endforeach
        @endif

        </ul><!-- /.menu -->
    </nav><!-- /#mainnav -->
 </div><!-- /.nav-wrap -->

辅助函数

通过菜单ID获取菜单项

use Harimayco\Menu\Facades\Menu;
...
/*
Parameter: Menu ID
Return: Array
*/
$menuList = Menu::get(1);

通过菜单名称获取菜单项

在这个示例中，你必须有一个名为Admin的菜单

use Harimayco\Menu\Facades\Menu;
...
/*
Parameter: Menu ID
Return: Array
*/
$menuList = Menu::getByName('Admin');

自定义

你可以在resources/views/vendor/wmenu/menu-html.blade.php中编辑菜单界面

鸣谢

• wmenu laravel包，类似于wordpress的菜单

兼容性

• 与laravel 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 6.x, 7.x进行了测试

已知问题

• 与RTL网站不兼容 #21（欢迎提交pull requests）