> 每个站长都有一堆"运维时必去"的网站：统计后台、图床、CDN 控制台、官方文档、备案查询……它们散落在浏览器书签栏的各个角落，每次找都要翻半天。zblogphp 后台侧栏明明是每天工作时长待的地方，却只有"文章管理""评论管理"这几个固定入口，一个自定义空间都不给。zb_SidebarBookmarks 这个插件把侧栏开放成了自定义书签栏——你在配置里写几行"名称|链接"，侧栏就多几个和系统菜单长得一模一样的入口。

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

## 一、接口在哪触发

zb_SidebarBookmarks 挂的是 `Filter_Plugin_Admin_LeftMenu` 接口。这个接口在zblogphp后台侧栏导航菜单组装时触发，具体位置是在全部系统内置菜单项（"文章管理""分类管理""评论管理""用户管理""主题设置"等）都加完之后。也就是说，插件追加的书签会出现在侧栏系统菜单区的末尾、和"文章管理"它们并列排队。

接口签名是 `Filter_Plugin_Admin_LeftMenu(arr &$leftmenus)`，只有一个引用传入的数组参数。数组里每个元素是一段完整的 `<li>` HTML 字符串，与顶栏菜单的 `MakeTopMenu` 对应，侧栏菜单也有官方构造函数：

```php
MakeLeftMenu($requireAction, $strName, $strUrl, $strLiId, $strAId, $strImgUrl, $strIconClass = '')
```

七个参数，比 `MakeTopMenu` 多了三个：

| 参数 | 说明 |
|---|---|
| `$requireAction` | 权限动作，内部经 `$zbp->CheckRights()` 校验，无权限时菜单项不显示 |
| `$strName` | 菜单显示名称 |
| `$strUrl` | 链接地址 |
| `$strLiId` | `<li>` 的 id |
| `$strAId` | `<a>` 的 id |
| `$strImgUrl` | 图片 URL，与图标类名二选一 |
| `$strIconClass` | 图标类名（`icon.css`），不传图片和图标时用默认图标 |

侧栏是纵向列表，每个菜单项是"图标 + 文字"的结构，所以它支持三种图标形态：传图片 URL 显示图片、传图标类名显示矢量图标、都不传显示系统默认图标。

还有一个和顶栏本质不同的点：`$leftmenus` 是带字符串键名的数组，系统内置菜单用 `nav_xxx` 形式的键名。插件往里加元素时最好也遵循这个键名规范，避免与其他插件的菜单项键名撞车——数组键名冲突时后者覆盖前者，你的书签会静默吞掉别人（或被吞）。

## 二、插件做了什么

书签数据不是写死在代码里的。插件把书签列表存进配置项 `items`，每行一条，格式是 `名称|链接`，管理页用一个 textarea 就能编辑。回调函数负责解析配置并逐条生成菜单：

```php
function zb_SidebarBookmarks_Add(&$leftmenus)
{
    global $zbp;
    $items = explode("\n", (string) $zbp->Config('zb_SidebarBookmarks')->items);
    foreach ($items as $line) {
        $line = trim($line);
        if (strpos($line, '|') === false) {
            continue;
        }
        list($name, $url) = array_map('trim', explode('|', $line, 2));
        if ($name === '' || $url === '') {
            continue;
        }
        // 参数：权限动作、名称、链接、li 的 id、a 的 id、图片 URL、图标类名
        $leftmenus['nav_bm_' . md5($name . $url)] = MakeLeftMenu(
            'root',
            $name,
            $url,
            '',
            '',
            '',
            'icon-link-45deg'
        );
    }
}
```

逐段拆解实现思路：

**配置解析：一行一个书签，容错先行。** `explode("\n", ...)` 把配置按换行拆成数组，然后每一行经历三道过滤：`trim` 去掉首尾空白（顺手处理掉 Windows 编辑器带来的 `\r`）；`strpos($line, '|') === false` 的行直接跳过（没写分隔符说明这行写废了）；名称或链接为空的行也跳过。这三道过滤合起来保证"一行写错不影响其他书签显示"——你在 textarea 里手滑写错了一行，其他书签照常出现在侧栏，不会整个插件罢工。

**键名生成：md5 摘要天然防撞。** `$leftmenus['nav_bm_' . md5($name . $url)]` 这行是插件的键名策略。前缀 `nav_` 跟随系统键名规范；`bm_` 是 bookmark 的缩写，标识这是书签插件的项；`md5($name . $url)` 用书签内容做摘要。好处有两个：一是同一书签不会重复插入（键名相同覆盖自身），二是不同书签几乎不可能撞键。比起 `nav_bm_0`、`nav_bm_1` 这种顺序键名，md5 方案对"用户在配置里复制粘贴出重复行"的场景天然免疫。

**权限统一 root：** 全部书签都按管理员可见处理。个人导航站的定位决定了这些链接基本是管理性质的资源，没必要给投稿作者看到。

**图标统一 `icon-link-45deg`：** 一条 45 度角斜放的链条图标，语义是"链接"，所有书签共用同一图标。这让插件加的书签在侧栏视觉上自成一组，用户扫一眼就知道"下面这几条是我自己加的"，不会和系统菜单混淆。

安装函数给了两条默认书签，避免用户启用插件后侧栏空空如也不知道东西去哪了：

```php
function InstallPlugin_zb_SidebarBookmarks()
{
    global $zbp;
    $cfg = $zbp->Config('zb_SidebarBookmarks');
    if ($cfg->items === null) {
        $cfg->items = "Z-Blog 文档|https://docs.zblogcn.com/\n应用中心|https://app.zblogcn.com/";
        $zbp->SaveConfig('zb_SidebarBookmarks');
    }
}
```

启用插件马上就能在侧栏看到"Z-Blog 文档"和"应用中心"两个入口，演示了配置格式，用户照葫芦画瓢改成自己的书签即可。

## 三、实际怎么用

### 场景 1：把日常运维系统钉进侧栏

在插件管理页的 textarea 里写上常用的运维入口：

```
统计后台|https://tongji.example.com/
图床管理|https://pic.example.com/admin
CDN 控制台|https://cdn.example.com/
```

保存后侧栏底部多出四个链式图标入口，点击即跳转。从此浏览器书签栏里那一坨"网站运维"文件夹可以退役了——所有工作入口都在 Z-Blog 后台这一亩三分地里。

### 场景 2：给不同角色准备不同的书签集

配置项是全局的，但生成菜单的循环里权限动作写死成了 `'root'`。稍微改造一下，让书签行支持三段式语法 `名称|链接|权限动作`：

```php
foreach ($items as $line) {
    $line = trim($line);
    if ($line === '') continue;
    $parts = array_map('trim', explode('|', $line, 3));
    if (count($parts) < 2 || $parts[0] === '' || $parts[1] === '') continue;
    $action = isset($parts[2]) && $parts[2] !== '' ? $parts[2] : 'root';
    $leftmenus['nav_bm_' . md5($parts[0] . $parts[1])] = MakeLeftMenu(
        $action, $parts[0], $parts[1], '', '', '', 'icon-link-45deg'
    );
}
```

配置改成这样：

```
投稿指南|https://example.com/guide|ArticleAll
内部规范|https://example.com/spec|ArticleAll
运维面板|https://ops.example.com/|root
```

前两行权限动作是 `ArticleAll`（有文章管理权限即可见），编辑作者登录后台也能看到投稿指南；第三行是 `root`，只有管理员可见。一套配置服务多角色，全靠 `MakeLeftMenu` 内置的 `CheckRights` 过滤。

### 场景 3：用自定义图片图标做品牌化侧栏

`MakeLeftMenu` 支持 `$strImgUrl` 参数，想给某个书签配专属图片图标（比如各平台的 logo），把图标类名换成图片地址即可：

```php
$leftmenus['nav_bm_analytics'] = MakeLeftMenu(
    'root',
    '统计后台',
    'https://tongji.example.com/',
    '',
    '',
    $zbp->host . 'zb_users/plugin/myplugin/icons/analytics.png',
    ''
);
```

图片 URL 建议放插件目录下用 `$zbp->host` 拼接，避免写死域名。图片会被系统按侧栏图标规格渲染，尺寸建议和后台默认图标一致（16px 或 32px 方图），过大图片会把侧栏行高撑变形。这个能力还可以用来做"带平台 logo 的服务入口面板"，让侧栏书签的辨识度更上一个台阶。

## 四、注意点

**1. MakeLeftMenu 不支持 target，侧栏外链是当前窗口跳转**

这是 `MakeLeftMenu` 和 `MakeTopMenu` 最实质的差异：顶栏菜单支持 `_blank` 新窗口，侧栏菜单没有 target 参数，点击一律当前窗口跳转。跳去外站后想回后台只能靠浏览器返回键。这对"看完即走的查询型网站"（备案查询、天气接口状态页）影响不大，但对"工作流型网站"（编辑器、面板）体验欠佳。缓解办法有两个：一是只把"查完就回来"的书签放侧栏，重工作流入口放顶栏（配 `_blank`）；二是改造 `MakeLeftMenu` 返回的 HTML 字符串，追加插入前用 `str_replace` 给 `<a` 加 target 属性——可行，但改变了系统统一行为，升级后要留意侧栏菜单渲染逻辑是否变化。

**2. 键名规范不是洁癖，是防吞**

`$leftmenus` 是关联数组，PHP 数组同名键赋值会直接覆盖。如果你用数字下标追加（`$leftmenus[] = ...`），恰好系统内置菜单也是数字键名时可能发生意外覆盖；如果你用自己发明的键名前缀，别的插件用了相同前缀也会互相吞菜单。`nav_bm_` 前缀 + 内容 md5 的方案虽然长，但"前缀标识来源、摘要保证唯一"这个组合能避免 99% 的键名事故。开发侧栏类插件时建议照抄这个思路，前缀换成你自己插件名的缩写。

**3. 配置是全局共享的，多管理员场景注意隐私边界**

所有书签的权限动作都是 `'root'`，意味着全体管理员看到完全相同的书签列表。单站长博客这无所谓；但一个站有多个管理员时，A 管理员把带账号密码的内部系统入口加进来，B、C 管理员也都会看到。侧栏书签本质上是"站点级配置"而非"用户级配置"。如果确实需要"每个管理员各看各的书签"，要把配置键名加上当前用户 ID（如 `items_{$zbp->user->ID}`），并在管理页按登录用户隔离读写——这就从三十行插件膨胀成一个小系统了，动手前先想清楚需求是共享还是私有。

## 五、代码仓库

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

---

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

每个站长都有一堆"运维时必去"的网站：统计后台、图床、CDN 控制台、官方文档、备案查询……它们散落在浏览器书签栏的各个角落，每次找都要翻半天。zblogphp 后台侧栏明明是每天工作时长待的地方，却只有"文章管理""评论管理"这几个固定入口，一个自定义空间都不给。zb_SidebarBookmarks 这个插件把侧栏开放成了自定义书签栏——你在配置里写几行"名称|链接"，侧栏就多几个和系统菜单长得一模一样的入口。

Z-Blog PHP后台侧栏变成个人导航站，把统计后台、图床、文档全部钉到眼皮底下

每个站长都有一堆"运维时必去"的网站：统计后台、图床、CDN 控制台、官方文档、备案查询……它们散落在浏览器书签栏的各个角落，每次找都要翻半天。zblogphp 后台侧栏明明是每天工作时长待的地方，却只有"文章管理""评论管理"这几个固定入口，一个自定义空间都不给。zb_SidebarBookmarks 这个插件把侧栏开放成了自定义书签栏——你在配置里写几行"名称|链接"，侧栏就多几个和系统菜单长

开发工具

后端

新闻资讯

zb_SidebarBookmarks插件为Z-Blog后台侧栏增加自定义书签功能，支持按“名称|链接”格式批量添加常用运维入口，菜单项与系统菜单并列显示。插件基于Filter_Plugin_Admin_LeftMenu接口开发，提供md5键名防冲突、多角色权限控制及自定义图标支持，帮助站长将统计后台、CDN控制台等分散资源集中管理，提升后台操作效率。

代码解释

Windows

CDN免费试用


2026上云采购 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

zb_SidebarBookmarks插件为Z-Blog后台侧栏增加自定义书签功能，支持按“名称|链接”格式批量添加常用运维入口，菜单项与系统菜单并列显示。插件基于Filter_Plugin_Admin_LeftMenu接口开发，提供md5键名防冲突、多角色权限控制及自定义图标支持，帮助站长将统计后台、CDN控制台等分...

Z-Blog PHP后台侧栏变成个人导航站，把统计后台、图床、文档全部钉到眼皮底下-腾讯云开发者社区-腾讯云

Z-Blog PHP后台侧栏变成个人导航站，把统计后台、图床、文档全部钉到眼皮底下

Z-Blog PHP后台侧栏变成个人导航站，把统计后台、图床、文档全部钉到眼皮底下

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐