01Z-Blog 与 WordPress 的插件机制差异
123ONE 的文章下载插件做了双平台适配：一套后台配置逻辑，分别编译出 WordPress 与 Z-Blog 两个安装包。下载时注意选对平台，装错了会因为目录结构不匹配而无法启用。
| 对比项 | WordPress | Z-Blog PHP |
|---|---|---|
| 插件目录 | wp-content/plugins/ | zb_users/plugin/ |
| 钩子机制 | Filter / Action | 插件接口（Plugin Interface） |
| 安装方式 | 上传 zip 后台安装 | 应用中心安装 / 手动上传解压 |
| 配置文件 | 数据库 option 表 | 插件独立 include.php |
02方式一：通过应用中心安装
- 1登录 Z-Blog 后台，进入「应用中心」。
- 2搜索插件名称，点击安装。
- 3安装完成后进入插件管理，启用该插件。
- 4如果应用中心搜索不到（自研或未上架的插件），走下面的手动上传方式。
Z-Blog 的应用中心收录范围有限，站长为自研插件时基本都需要手动上传。这不是插件的问题，是分发渠道的差异。
03方式二：手动上传安装
- 1把插件 zip 包解压，得到插件目录（目录名通常是插件标识，不要重命名）。
- 2用宝塔文件管理器或 FTP，把整个目录上传到 `zb_users/plugin/` 下。
- 3确认目录结构正确：`zb_users/plugin/插件标识/include.php` 这一层必须存在。如果解压出来多了一层同名目录，要把它提上来。
- 4回到后台 → 插件管理，找到该插件并启用。
- 5按插件文档完成首次配置（下载按钮风格、网盘平台等）。
最常见的失败原因是「多了一层目录」。zip 解压后如果变成 `zb_users/plugin/xxx/xxx/include.php`，插件列表里就不会出现。把它调整成 `zb_users/plugin/xxx/include.php` 即可。
04常见报错与处理
插件列表里看不到刚上传的插件
三个原因按概率排序：目录多了一层；目录权限不对（Web 进程无法读取）；插件缺少 `include.php` 导致 Z-Blog 无法识别。逐一确认即可定位。
提示「无法写入」或配置保存失败
插件配置需要写入 `zb_users/plugin/插件标识/` 目录。把这个目录的所有者设置为 Web 进程用户（宝塔通常是 `www`），权限设为可读写。
启用后前台没有变化
检查两点：主题是否对文章内容做了自定义渲染（部分主题会绕过标准的内容过滤器）；是否开启了页面缓存，需要清一次缓存才能看到变化。
05在 Z-Blog 里配置网盘下载按钮
启用插件后，在文章编辑页会出现下载按钮的插入入口。配置逻辑与 WordPress 侧一致：填网盘平台、分享链接、提取码、按钮标题。
- 支持 QQ 群、微信公众号等平台 —— 这是面向国内 Z-Blog 用户补的
- 提取码与解压密码支持一键复制
- 移动端可配置自动跳转网盘 App，减少「打开 App」这一步的流失
- 按钮风格可切换，深色主题建议选带暗色适配的样式