rah1595 / laravel-menu
类似于WordPress的Laravel 9拖放式菜单生成器
dev-main
2023-09-28 06:37 UTC
Requires
- php: >=8.0
- illuminate/support: ^8.0 || ^9.0 || ^10
This package is not auto-updated.
Last update: 2024-09-26 11:35:29 UTC
README
安装
- 运行
composer require rah1595/laravel-menu:dev-main
如果你使用laravel 9,步骤 2 和 3 是可选的
- 将以下类添加到 config/app.php 文件中的 "providers" 数组中(laravel 9中为可选)
Harimayco\Menu\MenuServiceProvider::class,
- 在 config/app.php 文件中添加 facade(laravel 9中为可选)
'Menu' => Harimayco\Menu\Facades\Menu::class,
- 运行发布命令
php artisan vendor:publish --provider="Harimayco\Menu\MenuServiceProvider"
- 在 config/menu.php 中进行配置(可选)
- 自定义中间件:你可以添加自己的中间件
- 表前缀:默认情况下,此包将创建两个新表,分别名为 "menus" 和 "menu_items",但你仍然可以添加自己的表前缀,以避免与现有表冲突
- 表名:如果你想使用特定的表名,你必须修改它以及迁移文件
- 自定义路由:如果你想编辑路由路径,你可以编辑该字段
- 角色访问:如果你想为菜单项启用角色(权限)
- 运行迁移
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, 9.x, 10.x兼容
已知问题
- 不与RTL网站一起工作 #21(欢迎提交pull requests)