Pboot插件菜单动态添加教程

在PbootCMS中创建CustomMenu插件目录及info.json和Plugin.php文件；2. 编辑info.json填写插件信息；3. Plugin.php中定义命名空间并继承ControllerPlugin类；4. 实现beforeController方法，向$_SESSION'user_menu'添加菜单项；5. 创建CustomMenuController.php控制器与custom_menu.html视图；6. 后台启用插件后验证“插件中心”菜单是否正常显示并可访问。

如果您希望在PbootCMS中通过插件实现自定义菜单并动态添加菜单链接，以便更灵活地管理后台导航结构，则可以通过编写插件并调用系统钩子完成。以下是具体操作步骤：

本文运行环境：ThinkPad E14，Windows 11

一、创建插件基础文件结构

该步骤的目的是初始化一个符合PbootCMS规范的插件目录和必要文件，确保系统能正确识别并加载插件。

1、进入网站根目录下的 /apps/plugin/ 文件夹，在此目录下新建一个名为 CustomMenu 的文件夹。

2、在 CustomMenu 目录中创建两个必需文件：Plugin.php 和 info.json。

3、编辑 info.json 文件，填入以下内容以声明插件信息：
{"name": "CustomMenu", "title": "自定义菜单插件", "description": "用于动态添加后台菜单项", "author": "开发者", "version": "1.0"}

二、注册插件并绑定钩子函数

此步骤用于让插件在系统启动时自动执行特定逻辑，从而注入自定义菜单项到后台界面。

1、打开 Plugin.php 文件，输入命名空间并继承Pboot插件基类：
namespace app\plugin\CustomMenu;
use pboot\plugins\ControllerPlugin;
class Plugin extends ControllerPlugin { }

2、在类中添加方法 beforeController，该方法会在控制器执行前被调用：
public function beforeController($controller) {
// 添加菜单逻辑将在此处实现
}

三、定义动态菜单数据

为了实现菜单的动态性，需在插件中构造菜单数组结构，包含标题、图标、链接等信息，并准备插入到系统菜单中。

1、在 beforeController 方法内部定义一个菜单数组：
$menuData = [
'title' => '插件中心',
'icon' => 'fa fa-plug',
'url' => 'plugin/CustomMenu/index'
];

2、将该菜单项追加至全局变量 $_SESSION['user_menu'] 中，此变量存储当前用户的菜单权限结构：
if (isset($_SESSION['user_menu']['content'])) {
$_SESSION['user_menu']['content'][] = $menuData;
}

四、创建插件响应控制器与视图

为了让新添加的菜单链接可访问，必须创建对应的控制器方法和展示页面，否则点击时会报错。

1、在 /apps/home/controller/ 目录下创建 CustomMenuController.php 文件。

2、在文件中定义控制器类并编写 index 方法：
namespace app\home\controller;
use pboot\components\Controller;
class CustomMenuController extends Controller {
public function index() {
$this->display('custom_menu.html');
}
}

3、在 /apps/home/view/default/ 路径下创建 custom_menu.html 模板文件，用于显示页面内容。

五、启用插件并验证菜单显示

完成开发后需要在系统中启用插件，并登录后台检查是否成功加载了新的菜单项。

1、登录PbootCMS后台管理系统，进入“扩展” -> “插件管理”页面。

2、找到“自定义菜单插件”，点击“启用”按钮激活插件功能。

3、刷新后台页面，查看左侧导航菜单是否出现“插件中心”选项，若显示且可正常跳转，则说明动态菜单添加成功。