Z-Blog 官方文档

后台侧栏菜单扩展 ​

通过 Filter_Plugin_Admin_LeftMenu 接口，可以向 Z-BlogPHP 后台左侧导航栏添加自定义菜单项，例如把插件的管理页面放入侧栏，与「文章管理」「插件管理」等系统入口并列。

接口信息 ​

接口参数说明
Filter_Plugin_Admin_LeftMenuarr &$leftmenus左侧导航菜单项数组，引用传入

完整案例 ​

php
<?php

RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");

function ActivePlugin_demoAPP()
{
    Add_Filter_Plugin('Filter_Plugin_Admin_LeftMenu', 'demoAPP_Admin_LeftMenu');
}

function demoAPP_Admin_LeftMenu(&$leftmenus)
{
    global $zbp;
    // 参数依次为：权限动作、菜单名称、链接、li 标签 id、a 标签 id、图片 URL、图标类名
    $leftmenus['nav_demoapp'] = MakeLeftMenu(
        'root',
        'demoAPP 管理',
        $zbp->host . 'zb_users/plugin/demoAPP/main.php',
        'nav_demoapp',
        'aDemoAPP',
        '',
        'icon-gear-fill'
    );
}

MakeLeftMenu 参数 ​

php
MakeLeftMenu($requireAction, $strName, $strUrl, $strLiId, $strAId, $strImgUrl, $strIconClass = '')
参数说明
$requireAction要求的权限动作，函数内部通过 $zbp->CheckRights() 校验，无权限时返回空字符串，菜单项不显示
$strName菜单显示名称
$strUrl菜单链接
$strLiId<li> 标签的 id
$strAId<a> 标签的 id
$strImgUrl菜单图片 URL，与图标类名二选一，留空即可
$strIconClass可选，系统图标字体的类名（来自 icon.css）；不传图片和图标时使用默认图标

注意事项 ​

  • $leftmenus 以引用方式传入，每个元素是 MakeLeftMenu() 返回的 <li> HTML 字符串，直接向数组追加元素即可，无需返回值；
  • 系统内置菜单使用 nav_xxx 形式的字符串键名，插件自定义菜单建议遵循同样的命名方式，避免键名冲突；
  • 接口在全部系统内置菜单项组装完成之后执行，插件菜单显示在侧栏最后；
  • 第一个参数权限动作按实际需要填写（如 'root' 表示仅管理员），系统会自动处理无权限用户的显示问题。