efectn/laravel-menu-builder

此包的最新版本(v1.5.3)没有提供许可证信息。

Laravel 9.x、10.x和11.x的类似Wordpress的拖放菜单构建器

v1.5.3 2023-09-12 11:27 UTC

README

Latest Stable Version Latest Unstable Version Total Downloads Monthly Downloads

最初从harimayco/wmenu-builder分叉,但现在仍在积极维护。

Laravel drag and drop menu

安装

  1. 运行
composer require efectn/laravel-menu-builder
  1. 在config/app.php中添加门面(可选)
'Menu' => Efectn\Menu\Facades\Menu::class,
  1. 运行发布以获取配置、视图、资源和迁移。
php artisan vendor:publish --provider="Efectn\Menu\MenuServiceProvider"
  1. config/menu.php 中配置(可选)
  • 自定义中间件: 您可以添加自己的中间件
  • 表前缀: 默认情况下,此包将创建名为 "menus" 和 "menu_items" 的2个新表,但您仍然可以添加自己的表前缀,以避免与现有表冲突
  • 表名: 如果您想使用特定的表名,则必须修改该表名和迁移
  • 自定义路由: 如果您想编辑路由路径,可以编辑该字段
  • 角色访问: 如果您想在菜单项上启用角色(权限)
  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 Efectn\Menu\Models\Menus;
use Efectn\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 Efectn\Menu\Facades\Menu;
...
/*
Parameter: Menu ID
Return: Array
*/
$menuList = Menu::get(1);

通过菜单名称获取菜单项

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

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

定制

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

致谢

  • wmenu - 类似于Wordpress的laravel包菜单
  • wmenu-builder - Laravel拖放动态菜单生成器(类似于Wordpress)

兼容性

  • 在Laravel 9.x上测试过。

已知问题

注意: 请参阅 #1