> 后台附件管理页打开后，页面上方光秃秃的，子菜单区域什么都没有。想在顶部加个"上传文件"的快捷入口，不想每次都得在编辑器里找上传按钮？Z-Blog 给附件管理页也留了子菜单接口，只是系统自己没往里塞东西，正好留给我们发挥。

## 一、接口在哪触发

附件管理页由系统函数 `Admin_UploadMng()` 渲染，位于 `zb_system/function/c_system_admin.php`：

```php
/**
 * 后台上传附件管理.
 */
function Admin_UploadMng()
{
    global $zbp;

    echo '<div class="divHeader">' . $zbp->lang['msg']['upload_manage'] . '</div>';
    echo '<div class="SubMenu">';
    foreach ($GLOBALS['hooks']['Filter_Plugin_Admin_UploadMng_SubMenu'] as $fpname => &$fpsignal) {
        $fpname();
    }
    echo '</div>';
    echo '<div id="divMain2">';

    echo '<form class="search" name="upload" id="upload" method="post" enctype="multipart/form-data" action="' . BuildSafeCmdURL('act=UploadPst') . '">';
    echo '<p>' . $zbp->lang['msg']['upload_file'] . ': </p>';
    echo '<p><input type="file" name="file" size="60" />&nbsp;&nbsp;';
    // ... 表单 ...
    echo '</form>';
    // ... 附件列表 ...
}
```

和用户管理页一样的模式：`<div class="SubMenu">` 之间遍历 `Filter_Plugin_Admin_UploadMng_SubMenu` 注册的回调，回调内 `echo` 的内容就是子菜单。

接口定义在 `zb_system/function/c_system_plugin.php`：

```php
'名称:Filter_Plugin_Admin_UploadMng_SubMenu
'参数:
'说明:
DefinePluginFilter('Filter_Plugin_Admin_UploadMng_SubMenu');
```

关键区别在于：**系统没有给附件管理页注册任何内置子菜单函数**。翻遍 `zblogphp.php` 的 `LoadManage()` 方法，你会看到它给 `MemberMng`、`TagMng`、`ModuleMng`、`SettingMng` 等管理页都注册了内置子菜单，唯独 `UploadMng` 没有：

```php
public function LoadManage()
{
    Add_Filter_Plugin('Filter_Plugin_Admin_PageMng_SubMenu', 'Include_Admin_Addpagesubmenu');
    Add_Filter_Plugin('Filter_Plugin_Admin_TagMng_SubMenu', 'Include_Admin_Addtagsubmenu');
    Add_Filter_Plugin('Filter_Plugin_Admin_CategoryMng_SubMenu', 'Include_Admin_Addcatesubmenu');
    Add_Filter_Plugin('Filter_Plugin_Admin_MemberMng_SubMenu', 'Include_Admin_Addmemsubmenu');
    Add_Filter_Plugin('Filter_Plugin_Admin_ModuleMng_SubMenu', 'Include_Admin_Addmodsubmenu');
    Add_Filter_Plugin('Filter_Plugin_Admin_CommentMng_SubMenu', 'Include_Admin_Addcmtsubmenu');
    Add_Filter_Plugin('Filter_Plugin_Admin_SettingMng_SubMenu', 'Include_Admin_Addsettingsubmenu');
    // 注意：没有 UploadMng 的注册
}
```

所以附件管理页的子菜单区域默认是空的。页面正文虽然有一个上传表单，但没有独立的"上传文件"页面入口。这正好是接口插件发挥作用的地方——填补系统未提供的快捷入口。

## 二、插件做了什么

插件代码极其精简：

```php
RegisterPlugin("zb_UploadMngMenu", "ActivePlugin_zb_UploadMngMenu");

function ActivePlugin_zb_UploadMngMenu()
{
    Add_Filter_Plugin('Filter_Plugin_Admin_UploadMng_SubMenu', 'zb_UploadMngMenu_SubMenu');
}

function zb_UploadMngMenu_SubMenu()
{
    global $zbp;
    echo MakeSubMenu('上传文件', $zbp->host . 'zb_system/cmd.php?act=UploadEdt', 'm-left', '');
}
```

注册回调 -> `echo` 一个 `MakeSubMenu` 链接，就这么简单。

`MakeSubMenu` 是 Z-Blog 的子菜单构造函数（`zb_system/function/c_system_admin_function.php`）：

```php
function MakeSubMenu($strName, $strUrl, $strClass = 'm-left', $strTarget = '', $strId = '', $strTitle = '', $strIconClass = '')
{
    $s = '<a href="' . $strUrl . '" ';
    if ($strTarget) { $s .= 'target="' . $strTarget . '"'; }
    if ($strId) { $s .= 'id="' . $strId . '"'; }
    if ($strTitle) { $s .= 'title="' . $strTitle . '" alt="' . $strTitle . '" '; }
    $s .= '>';
    $strIconElem = $strIconClass !== "" ? "<i class=\"" . $strIconClass . "\" style=\"line-height: 1em;\"></i> " : "";
    $s .= '<span class="' . $strClass . '">' . $strIconElem . $strName . '</span></a>';
    return $s;
}
```

插件传了 4 个参数：

- `'上传文件'`：菜单显示文字
- `$zbp->host . 'zb_system/cmd.php?act=UploadEdt'`：链接到系统的独立上传页面
- `'m-left'`：靠左排列
- `''`：当前窗口打开（不新开标签页）

`cmd.php?act=UploadEdt` 是系统的独立上传文件页面入口。虽然附件管理页正文已经有一个上传表单，但 `UploadEdt` 页面提供的是更完整的上传界面，支持更多选项。子菜单入口的意义在于：不用翻到页面中间找表单，顶部一点就进。

## 三、实际怎么用

### 场景 1：基本用法——补一个上传入口

![image.png](https://developer.qcloudimg.com/http-save/yehe-12010127/37efbc822aed272f8c1f34752bba2c85.png)

这就是插件本身做的事情。激活插件后，附件管理页顶部子菜单区域出现"上传文件"链接，点击跳转到 `cmd.php?act=UploadEdt`：

```php
function zb_UploadMngMenu_SubMenu()
{
    global $zbp;
    echo MakeSubMenu('上传文件', $zbp->host . 'zb_system/cmd.php?act=UploadEdt', 'm-left', '');
}
```

这是最基础的用法。如果你只是想给空荡荡的子菜单区域加一个入口，这三行代码就够了。

### 场景 2：加上附件大小统计入口

假设你做了一个附件统计插件，想在附件管理页加一个"查看统计"入口，显示各类型附件的占用空间：

```php
function zb_UploadMngMenu_SubMenu()
{
    global $zbp;
    
    // 基本的上传入口
    echo MakeSubMenu('上传文件', 
        $zbp->host . 'zb_system/cmd.php?act=UploadEdt', 
        'm-left', ''
    );
    
    // 附件统计入口（只有有权限的用户可见）
    if ($zbp->CheckRights('UploadAll')) {
        echo MakeSubMenu(
            '空间统计',
            $zbp->host . 'zb_users/plugin/myUploadStats/stats.php',
            'm-left',
            '',
            '',
            '查看各类型附件的空间占用',
            'icon-pie-chart-fill'
        );
    }
}
```

`UploadAll` 权限表示"管理所有用户的附件"，管理员才有。普通用户只能看到"上传文件"入口，看不到"空间统计"。

### 场景 3：批量上传入口

如果你的插件提供了批量上传功能（比如一次选择多个文件），可以在子菜单加入口：

```php
function zb_UploadMngMenu_SubMenu()
{
    global $zbp;
    
    // 单文件上传
    echo MakeSubMenu('上传文件', 
        $zbp->host . 'zb_system/cmd.php?act=UploadEdt', 
        'm-left', ''
    );
    
    // 批量上传（新窗口打开）
    echo MakeSubMenu(
        '批量上传',
        $zbp->host . 'zb_users/plugin/myBatchUpload/index.php',
        'm-left',
        '_blank',
        '',
        '一次选择多个文件批量上传',
        'icon-cloud-upload-fill'
    );
    
    // 从URL远程拉取
    echo MakeSubMenu(
        '远程拉取',
        $zbp->host . 'zb_users/plugin/myBatchUpload/fetch.php',
        'm-left',
        '',
        '',
        '输入远程图片地址，自动下载到本地',
        'icon-cloud-download-fill'
    );
}
```

这里用了 `_blank` 让批量上传在新窗口打开，因为批量上传页面通常有自己的交互逻辑，用户可能想同时操作附件管理列表和批量上传页面。

## 四、注意点

**1. 附件管理页正文已有上传表单，子菜单入口是补充**

`Admin_UploadMng()` 的页面正文里已经渲染了一个 `<form>` 上传表单，带文件选择框和提交按钮。所以子菜单的"上传文件"入口不是必须的——它链接到的 `UploadEdt` 页面提供的是独立的上传界面。如果你只是想让用户更快地上传，页面正文的表单已经够用。子菜单入口的价值在于提供一个到独立上传页面的快捷方式，或者放你插件自己的上传相关功能入口。

**2. 上传权限的区分**

Z-Blog 的上传权限分两种：`UploadAll`（管理所有用户的附件）和普通的只能管理自己附件的权限。`Admin_UploadMng()` 函数里有判断：

```php
if (!$zbp->CheckRights('UploadAll')) {
    $w[] = array('=', 'ul_AuthorID', $zbp->user->ID);
}
```

没有 `UploadAll` 权限的用户只能看到自己的附件。你在子菜单加的入口也要考虑这个权限区分——如果入口指向的是"管理所有附件"的功能，记得用 `$zbp->CheckRights('UploadAll')` 做检查。

**3. UploadEdt 和 UploadPst 的区别**

`cmd.php?act=UploadEdt` 是上传文件的页面（显示表单），`cmd.php?act=UploadPst` 是处理上传提交的 action（接收 POST 数据）。子菜单链接应该指向 `UploadEdt`（展示页面），不要直接链到 `UploadPst`（处理页面），否则用户一点击就会触发上传操作而不是看到上传表单。页面正文里的 `<form>` 的 `action` 才是指向 `UploadPst` 的。

## 五、代码仓库

**仓库地址**：https://cnb.cool/ytecn/zblog-interfaces
**插件目录**：`zb_UploadMngMenu/`

---

「Z-Blog 接口插件集」系列第 12 个插件。

后台附件管理页打开后，页面上方光秃秃的，子菜单区域什么都没有。想在顶部加个"上传文件"的快捷入口，不想每次都得在编辑器里找上传按钮？Z-Blog 给附件管理页也留了子菜单接口，只是系统自己没往里塞东西，正好留给我们发挥。

附件管理页缺一个上传入口？一个接口补上

数据库

Z-Blog附件管理页子菜单默认空白，开发者可借助Filter_Plugin_Admin_UploadMng_SubMenu接口添加自定义快捷入口。通过RegisterPlugin注册钩子，调用MakeSubMenu函数输出链接，实现上传文件、批量上传、远程拉取等菜单项。此插件方案支持权限控制，提升后台操作效率，代码精简易用。

代码解释

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Z-Blog附件管理页子菜单默认空白，开发者可借助Filter_Plugin_Admin_UploadMng_SubMenu接口添加自定义快捷入口。通过RegisterPlugin注册钩子，调用MakeSubMenu函数输出链接，实现上传文件、批量上传、远程拉取等菜单项。此插件方案支持权限控制，提升后台操作效率，代码精...

附件管理页缺一个上传入口？一个接口补上-腾讯云开发者社区-腾讯云

附件管理页缺一个上传入口？一个接口补上

附件管理页缺一个上传入口？一个接口补上

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐