README

**此包是从之前废弃的包中分叉出来的：修复对laravel 9+和其余问题的支持需要一些时间。如果您正在寻找菜单生成器的工作版本，请耐心等待。谢谢！

分叉自 https://github.com/lordmacu/wmenu

安装

先决条件

0.1. jQuery

0.2. jQueryUI（包含插件）

0.3. Bootstrap

0.4. Fontawesome

要使用npm安装依赖项，请运行

npm i jquery@3.6
npm i jquery-ui@1.13
npm i bootstrap@4.6

您需要负责您自己的Fontawesome副本。

然后，在您的laravel Mix配置（resources/js/app.js）中

// resources/js/app.js
//
// jQuery
window.$=window.jQuery=require('jquery');
require('jquery-ui/ui/widget.js');
require('jquery-ui/ui/widgets/mouse.js');
require('jquery-ui/ui/widgets/sortable.js');
require('jquery-ui/ui/widgets/draggable.js');
require('jquery-ui/ui/widgets/droppable.js');
// Bootstrap
require('bootstrap');

然后，要编译您的mix，请运行

npm run dev

运行

composer require ggets/laravel-menu-builder

步骤2和3在您使用laravel 5.5时是可选的

在文件config/app.php中的“providers”数组中添加以下类，在laravel 5.5中是可选的

ggets\MenuBuilder\MenuServiceProvider::class,

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

'Menu' => ggets\MenuBuilder\Facades\Menu::class,

运行发布

php artisan vendor:publish --provider="ggets\MenuBuilder\MenuServiceProvider"

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

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

运行迁移

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 ggets\MenuBuilder\Models\Menus;
use ggets\MenuBuilder\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 ggets\MenuBuilder\Facades\Menu;
...
/*
Parameter: Menu ID
Return: Array
*/
$menuList = Menu::get(1);

通过菜单名称获取菜单项

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

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

自定义

您可以在 resources/views/vendor/ggets-menu-builder/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，8.x，9.x

已知问题

不适用于RTL网站 #21（欢迎拉取请求）

ggets / laravel-menu-builder

维护者

详细信息