> zblogphp后台标签管理页打开后，顶上子菜单区有系统自带的"新建标签"入口，但你想加个自己的？比如"标签合并"、"标签导入"之类的批量操作入口。或者你做了个多类型文章系统，不同类型的标签想分开展示入口。子菜单接口可以叠加多个回调，你加的和系统自带的会同时出现。

## 一、接口在哪触发

标签管理页由系统函数 `Admin_TagMng()` 渲染，位于 `zb_system/function/c_system_admin.php`：

```php
/**
 * 后台标签管理.
 */
function Admin_TagMng()
{
    global $zbp;

    $posttype = (int) GetVars('type');
    $typetitle = $posttype > 0 ? (ucfirst($zbp->GetPostType($posttype, 'name')) . '-') : '';

    echo '<div class="divHeader">' . $typetitle . $zbp->lang['msg']['tag_manage'] . '</div>';
    echo '<div class="SubMenu">';
    foreach ($GLOBALS['hooks']['Filter_Plugin_Admin_TagMng_SubMenu'] as $fpname => &$fpsignal) {
        $fpname();
    }
    echo '</div>';
    // ... 标签列表 ...
}
```

注意第三行 `$posttype = (int) GetVars('type')`——标签管理页支持按文章类型筛选。URL 带 `?type=1` 时，标题会变成"Article-标签管理"。这个 `type` 参数也会传给系统内置的子菜单函数。

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

```php
'名称:Filter_Plugin_Admin_TagMng_SubMenu
'参数:
'说明:标签管理
DefinePluginFilter('Filter_Plugin_Admin_TagMng_SubMenu');
```

和用户管理页一样，**系统自己也注册了内置子菜单**。在 `LoadManage()` 里：

```php
Add_Filter_Plugin('Filter_Plugin_Admin_TagMng_SubMenu', 'Include_Admin_Addtagsubmenu');
```

内置函数 `Include_Admin_Addtagsubmenu()` 位于 `c_system_admin_function.php`：

```php
function Include_Admin_Addtagsubmenu()
{
    global $zbp;
    $type = (int) GetVars('type');
    $typeurl = $type > 0 ? ('&type=' . $type) : '';
    echo MakeSubMenu($GLOBALS['lang']['msg']['new_tag'], $zbp->cmdurl . '?act=TagEdt' . $typeurl, 'm-left', null, null, null, 'icon-tag-fill');
}
```

系统自带了"新建标签"入口，而且会自动带上当前页面的 `type` 参数——如果用户在查看某个文章类型的标签，点击"新建标签"时 URL 会带上 `&type=x`，确保新建的标签归属正确的文章类型。这个细节很重要，后面会展开。

## 二、插件做了什么

```php
RegisterPlugin("zb_TagMngMenu", "ActivePlugin_zb_TagMngMenu");

function ActivePlugin_zb_TagMngMenu()
{
    Add_Filter_Plugin('Filter_Plugin_Admin_TagMng_SubMenu', 'zb_TagMngMenu_SubMenu');
}

function zb_TagMngMenu_SubMenu()
{
    global $zbp;
    echo MakeSubMenu('新建标签', $zbp->host . 'zb_system/cmd.php?act=TagEdt', 'm-left', '');
}
```

和上一个插件结构完全一样——注册回调，`echo` 一个 `MakeSubMenu` 链接。链接指向 `cmd.php?act=TagEdt`，这是系统新建/编辑标签的页面入口。

`MakeSubMenu` 生成的是一个 `<a>` 标签，最终 HTML 大致是：

```html
<a href="https://example.com/zb_system/cmd.php?act=TagEdt">
    <span class="m-left">新建标签</span>
</a>
```

由于系统内置的 `Include_Admin_Addtagsubmenu` 也会被调用，最终子菜单区域会出现两个"新建标签"——一个来自系统（带图标、带 type 参数），一个来自插件（无图标、不带 type 参数）。在实际使用中建议改个名字或加上不同的参数来区分。

## 三、实际怎么用

### 场景 1：带 type 参数的新建标签入口

![zb_TagMngMenu 插件效果](https://developer.qcloudimg.com/http-save/yehe-12010127/2f994f7cf342a6a88bb01e3204a02834.png)

Z-Blog 支持多种文章类型（文章、页面、自定义类型），标签也按类型区分。系统内置函数会自动带上 `type` 参数，你的插件也可以这样做：

```php
function zb_TagMngMenu_SubMenu()
{
    global $zbp;
    // 获取当前页面的文章类型
    $type = (int) GetVars('type');
    $typeurl = $type > 0 ? ('&type=' . $type) : '';
    
    echo MakeSubMenu(
        '新建标签', 
        $zbp->host . 'zb_system/cmd.php?act=TagEdt' . $typeurl, 
        'm-left', ''
    );
}
```

`GetVars('type')` 从 GET 参数里取 `type` 值。如果用户在 `?type=2` 的标签管理页，点击"新建标签"会跳转到 `cmd.php?act=TagEdt&type=2`，新建的标签自动归属类型 2。如果不带 `type`，新建的标签默认归属类型 0（普通文章）。

### 场景 2：添加标签合并入口

标签管理常见的痛点是重复标签。你可以通过子菜单加一个"标签合并"入口，跳转到你自己的插件页面：

```php
function zb_TagMngMenu_SubMenu()
{
    global $zbp;
    
    // 新建标签（带type参数）
    $type = (int) GetVars('type');
    $typeurl = $type > 0 ? ('&type=' . $type) : '';
    echo MakeSubMenu('新建标签', 
        $zbp->host . 'zb_system/cmd.php?act=TagEdt' . $typeurl, 
        'm-left', ''
    );
    
    // 标签合并工具
    echo MakeSubMenu(
        '标签合并',
        $zbp->host . 'zb_users/plugin/myTagMerge/merge.php',
        'm-left',
        '',
        '',
        '将多个相似标签合并为一个',
        'icon-git-merge-fill'
    );
    
    // 标签导入导出
    echo MakeSubMenu(
        '导入导出',
        $zbp->host . 'zb_users/plugin/myTagMerge/io.php',
        'm-left',
        '',
        '',
        '批量导入或导出标签',
        'icon-arrow-left-right-fill'
    );
}
```

这三个入口并排显示在子菜单区域，"新建标签"靠左，"标签合并"和"导入导出"紧随其后。用户不用在侧栏菜单里找你的插件页面，直接在标签管理页就能访问。

### 场景 3：根据标签数量显示清理入口

如果你想在标签数量超过一定阈值时显示"清理空标签"入口：

```php
function zb_TagMngMenu_SubMenu()
{
    global $zbp;
    
    // 基本入口
    $type = (int) GetVars('type');
    $typeurl = $type > 0 ? ('&type=' . $type) : '';
    echo MakeSubMenu('新建标签', 
        $zbp->host . 'zb_system/cmd.php?act=TagEdt' . $typeurl, 
        'm-left', ''
    );
    
    // 查询空标签数量
    $emptyTags = $zbp->GetTagList(null, null, null, null, array('count' => 1));
    // 或者用 SQL 查询没有文章关联的标签
    $sql = 'SELECT COUNT(*) FROM ' . $GLOBALS['table']['Tag'] . ' AS t LEFT JOIN ' . $GLOBALS['table']['PostTag'] . ' AS pt ON t.tag_ID = pt.tag_ID WHERE pt.tag_ID IS NULL';
    $count = (int) $zbp->db->Query($sql);
    
    if ($count > 0) {
        echo MakeSubMenu(
            '清理空标签（' . $count . '）',
            $zbp->host . 'zb_users/plugin/myTagClean/clean.php',
            'm-left',
            '',
            '',
            '删除' . $count . '个没有文章关联的标签',
            'icon-trash-fill'
        );
    }
}
```

子菜单文字里带上数字（如"清理空标签（3）"），让用户一眼看到需要处理的数量。这种动态子菜单在每次页面加载时查询，所以不要做太重的查询——上面这个 SQL 查询很轻量，不会有性能问题。

## 四、注意点

**1. type 参数不能丢**

Z-Blog 的标签管理页支持 `?type=x` 按文章类型筛选。系统内置的 `Include_Admin_Addtagsubmenu` 会自动把 `type` 参数拼到链接里。你的插件如果不带 `type` 参数，用户在某个类型的标签管理页点你的"新建标签"，会跳到默认类型的标签编辑页，创建错误类型的标签。正确做法是用 `GetVars('type')` 获取当前类型再拼接。这也是为什么系统内置函数里有一行 `$typeurl = $type > 0 ? ('&type=' . $type) : ''`。

**2. 和系统内置入口会重复**

系统在 `LoadManage()` 里已经注册了 `Include_Admin_Addtagsubmenu`，它添加的"新建标签"入口会和你插件的入口同时出现。如果不想重复，可以：改个名字（比如"快速新建标签"）、指向不同的页面、或者干脆不添加"新建标签"而是添加其他功能入口（合并、导入、清理等）。

**3. 标签编辑页和标签管理页是两个不同的接口**

标签管理页（`Admin_TagMng`）用的是 `Filter_Plugin_Admin_TagMng_SubMenu`。标签编辑页（`tag_edit.php`）用的是 `Filter_Plugin_Tag_Edit_SubMenu`。两个接口名字很像但完全不同——前者在管理列表页触发，后者在编辑表单页触发。本插件用的是前者。如果你的需求是在标签编辑页加入口（比如"查看前台"），应该用 `Filter_Plugin_Tag_Edit_SubMenu`，对应系列中的 zb_TagEditMenu 插件。

## 五、代码仓库

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

---

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

zblogphp后台标签管理页打开后，顶上子菜单区有系统自带的"新建标签"入口，但你想加个自己的？比如"标签合并"、"标签导入"之类的批量操作入口。或者你做了个多类型文章系统，不同类型的标签想分开展示入口。子菜单接口可以叠加多个回调，你加的和系统自带的会同时出现。

标签管理页没有新建按钮 三行代码补上快捷入口

编程语言

Z-Blog标签管理页子菜单扩展教程，详解Filter_Plugin_Admin_TagMng_SubMenu接口用法，支持添加新建标签、标签合并、导入导出及空标签清理等自定义入口，保留type参数实现多文章类型筛选，附完整代码示例与注意事项。

代码解释

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

标签管理页没有新建按钮 三行代码补上快捷入口-腾讯云开发者社区-腾讯云

标签管理页没有新建按钮三行代码补上快捷入口

标签管理页没有新建按钮三行代码补上快捷入口

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

标签管理页没有新建按钮 三行代码补上快捷入口

标签管理页没有新建按钮 三行代码补上快捷入口

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

标签管理页没有新建按钮三行代码补上快捷入口

标签管理页没有新建按钮三行代码补上快捷入口