README

安装

1. 运行

composer require bdacademy/laravel-menu

1. 运行发布

php artisan vendor:publish --provider="Bdacademy\LaravelMenu\LaravelMenuServiceProvider"

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

• 自定义中间件: 您可以添加自己的中间件
• 表前缀: 默认情况下，此包将创建名为 "menus" 和 "menu_items" 的2个新表，但您仍可以添加自己的表前缀，以避免与现有表冲突
• 表名: 如果您想使用特定的表名，您必须修改它以及迁移
• 自定义路由: 如果您想编辑路由路径，您可以编辑该字段
• 角色访问: 如果您想在菜单项上启用角色（权限）
• 文章模型: 您可以添加自己的文章模型。默认是 Post
• 分类模型: 您可以添加自己的分类模型。默认是 Category
• 文章标题列: 您可以添加自己的文章模型标题列。默认是 title
• 分类标题列: 您可以添加自己的分类模型标题列。默认是 name

1. 运行迁移

php artisan migrate

完成

Laravel Menu 使用示例 - 显示UI

在您的视图blade文件中

@extends('app')

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

// Recommended to Add Font Awesome CDN In Your Backend Header

//maxcdn.bootstrap.ac.cn/font-awesome/6.1.1/css/font-awesome.min.css

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

使用模型

调用模型类

use Bdacademy\LaravelMenu\Models\Menus;
use Bdacademy\LaravelMenu\Models\MenuItems;

菜单使用示例（a）

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

使用模型类

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

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

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

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

或使用助手

// Using Helper
$primary_menu = LaravelMenu::getByName('Primary'); //return array

菜单使用示例（b）

现在在您的blade模板文件中放置菜单，使用以下简单示例

<nav class="" id="navbar">
    <div class="navbar__menu container">
        <ul>
            @if ($primary_menu)
                @foreach ($primary_menu as $menu)
                    <li>
                        <a href="{{ $menu['link'] }}" title="{{ $menu['label'] }}">{{ $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
    </div>
</nav>

助手

通过菜单ID获取菜单项

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

通过菜单名称获取菜单项

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

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

自定义

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

致谢

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

兼容性

• 在laravel 11.x上测试
• 仅适用于laravel 11.x