README

Yii2 菜单模块

用于创建和管理菜单的模块。它有自己的组件来在前端显示菜单项。

此模块是 Butterfly.СMS 内容管理系统的一个组成部分，但也可以作为一个独立的扩展使用。

版权所有 (c) 2019-2023 W.D.M.Group, 乌克兰

需求

• PHP 5.6 或更高版本
• Yii2 v.2.0.40 和最新版
• Yii2 Base 模块（必需）

安装

要安装模块，请在控制台中运行以下命令

$ composer require "wdmg/yii2-menu"

配置数据库连接后，在控制台中运行以下命令

$ php yii menu/init

然后选择您要执行的操作

1. 应用所有模块迁移
2. 撤销所有模块迁移

迁移

无论如何，您都可以通过在控制台中运行以下命令来执行迁移并创建初始数据

$ php yii migrate --migrationPath=@vendor/wdmg/yii2-menu/migrations

配置

要将模块添加到项目中，请在您的配置文件中添加以下数据

'modules' => [
    ...
    'menu' => [
        'class' => 'wdmg\menu\Module',
        'routePrefix' => 'admin'
    ],
    ...
],

使用示例

要构建导航菜单，您可以使用带有菜单的 id 或 alias 的组件方法 Yii::$app->menu->getItems()，第二个参数确定菜单项列表是否以树的形式呈现。

前端视图

<?php
    use yii\bootstrap\Nav;
    ...
?>
    
<?php
    if ($menuItems = Yii::$app->menu->getItems(1, true)) {
        echo Nav::widget([
            'options' => ['class' => 'navbar-nav'],
            'items' => $menuItems,
        ]);
    }
?>

// or get items by menu alias
    
<?php
    if ($menuItems = Yii::$app->menu->getItems('glavnoye-menyu', true)) {
        echo Nav::widget([
            'options' => ['class' => 'navbar-nav'],
            'items' => $menuItems,
        ]);
    }
?>
...

路由

要为 NavBar 生成导航项列表，请使用模块的 Module::dashboardNavItems() 方法，如下所示

<?php
    echo Nav::widget([
    'options' => ['class' => 'navbar-nav navbar-right'],
        'label' => 'Modules',
        'items' => [
            Yii::$app->getModule('menu')->dashboardNavItems(),
            ...
        ]
    ]);
?>

状态和版本 [可用]

• v.1.2.1 - 修复导航菜单
• v.1.2.0 - 修复 node sass，更新依赖关系和版权
• v.1.1.1 - 修复迁移错误
• v.1.1.0 - 多语言实现