安装与启用插件
插件的安装与切换全部在后台「扩展市场」操作。
后台入口：扩展市场 → 插件 Tab
| 状态 | 含义 |
|---|---|
| 可用 | 已上传但未启用 |
| 已启用（active） | 当前生效 |
| 已停用 | 装了但没启用 |
| 内置 | 系统自带 |
跟主题不同的是：多个插件可以同时启用——所以”已启用”不是互斥状态。
上传第三方插件
Section titled “上传第三方插件”-
从可信渠道获取
.zip包：- BangNiCMS 官方 / 主题市场
- 你雇的开发者
- 公司内部团队
-
进「扩展市场 → 插件」 → 点 上传插件
-
拖拽 / 选择
.zip待补充截图 拖拽区域 + 文件选择按钮 + 上传后实时校验进度上传插件弹窗 -
系统自动校验：
- 文件结构（必须有
manifest.json） - 必填字段
- 类型必须是
plugin（不是theme） - 唯一键格式
- 文件结构（必须有
-
校验通过 → 状态自动设为「已停用」
-
启用：在插件卡片点 启用 → 立即生效
启用 / 停用
Section titled “启用 / 停用” 待补充截图 每张卡片右上角有 toggle 开关，点击切换状态
启用：
- 直接点开关 / 状态按钮
- 立即生效——前台页面立刻加载该插件
- 如果该插件需要挂载到 slot，还要去「插件挂载」配置挂载位置——否则启用了但前台看不到
停用：
- 点开关关闭
- 立即生效——前台立刻不再加载
- 配置数据保留——下次启用时配置还在
- 挂载关系也保留——下次启用直接恢复
卸载第三方插件
Section titled “卸载第三方插件”| 报错提示 | 怎么解决 |
|---|---|
| 该插件已挂载到 N 个槽位 | 先到「插件挂载」解除所有挂载 |
| 系统内置扩展不可卸载 | 内置插件不能卸载（设计上的保护） |
-
把要卸载的插件先停用
-
进「插件挂载」解除所有挂载
-
回到插件卡片 → 出现 卸载 按钮
-
点 卸载 → 弹窗确认 → 确认
-
插件文件从服务器删除
升级插件（新版本）
Section titled “升级插件（新版本）”跟主题升级流程类似：
-
拿到新版
.zip -
「扩展市场 → 插件」 → 点 上传插件
-
上传同
extensionKey的新版 → 系统检测到已有同名 → 弹窗确认升级 -
确认升级：
- 旧版本被覆盖
- 状态保持不变
- 配置数据：通常保留，但可能需要按新版手册调整
-
升级后立刻验证——前台是否还正常工作
启用插件后的检查清单
Section titled “启用插件后的检查清单”启用一个新插件后，立刻检查：
| 检查 | 怎么看 |
|---|---|
| 前台插件渲染了 | 进对应页面验证 |
| 没有 JS 错误 | 浏览器 F12 → Console 看是否有红字 |
| 没有 CSS 错乱 | 视觉检查页面布局 |
| 性能没明显下降 | 用 Lighthouse 测分数 |
| 移动端正常 | 手机上看一下 |
| 跟其他插件不冲突 | 检查所有相关页面 |
一些边界情况
Section titled “一些边界情况”装的 zip 校验失败
Section titled “装的 zip 校验失败”| 报错 | 解决 |
|---|---|
| 不是合法 zip | 让开发者重新打包 |
| 缺少 manifest.json | 让开发者按规范打包 |
| manifest.json 缺字段 | 让开发者补 |
| extensionType 必须是 plugin | 错装成主题入口了 |
| 唯一键格式不合法 | 让开发者改成英文小写 + 连字符 |
启用插件后前台报错
Section titled “启用插件后前台报错”最快恢复：立刻停用该插件 → 前台恢复正常 → 联系开发者。
如果后台也进不去（极少见），让运维：
UPDATE extension SET status = 'disabled'WHERE extension_type = 'plugin' AND extension_key = 'xxx';内置插件能”删”吗
Section titled “内置插件能”删”吗”不能卸载，但可以停用——前台不再加载该插件。再启用时一切恢复。
启用了插件但前台没看到
Section titled “启用了插件但前台没看到”最常见原因：还没挂到 slot 上。
详见 挂载到主题槽位。
一次能装多少插件？
Section titled “一次能装多少插件？”技术上没硬上限，但建议不超过 15 个——超过会明显拖慢前台加载。
插件能像主题那样有市场可以浏览吗？
Section titled “插件能像主题那样有市场可以浏览吗？”当前没有官方插件市场。你可以：
- 联系 BangNiCMS 官方
- 找开发者按需开发
- 等未来插件市场上线
我装错了插件怎么办？
Section titled “我装错了插件怎么办？”立刻停用 + 解除挂载 + 卸载。整个过程 1 分钟。
启用插件需要什么权限？
Section titled “启用插件需要什么权限？”需要管理员权限。普通运营不能装 / 启用 / 卸载插件——这是为了防止误操作或恶意行为。详见 用户与权限（建设中）。
升级插件后我之前的配置丢了？
Section titled “升级插件后我之前的配置丢了？”少数情况会——开发者在新版改了配置数据结构、或删了某些字段。
预防：
- 升级前截图保存配置
- 看新版本的 changelog
- 在测试环境先升级验证
一个插件能给所有页面追加 JS 吗（如统计代码）？
Section titled “一个插件能给所有页面追加 JS 吗（如统计代码）？”可以——插件设计为”全局注入”时会给所有页面追加。这种插件不需要挂到 slot——启用即生效。
详见 常见插件类型与用法。