efectn / laravel-menu-builder
此包的最新版本(v1.5.3)没有提供许可证信息。
Laravel 9.x、10.x和11.x的类似Wordpress的拖放菜单构建器
v1.5.3
2023-09-12 11:27 UTC
Requires
- php: >=8.0
- illuminate/translation: ~9 || ~10
README
最初从harimayco/wmenu-builder分叉,但现在仍在积极维护。
安装
- 运行
composer require efectn/laravel-menu-builder
- 在config/app.php中添加门面(可选)
'Menu' => Efectn\Menu\Facades\Menu::class,
- 运行发布以获取配置、视图、资源和迁移。
php artisan vendor:publish --provider="Efectn\Menu\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 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。