1. 安装与启用插件
上传第三方插件 zip / 启用 / 停用 / 卸载
「插件」是给站点追加新功能的扩展模块——客服浮窗、邮件订阅、统计分析、轮播图、社交分享按钮……都是插件。
后台入口:扩展市场 → 插件 Tab
按用途分类:
| 类型 | 例子 |
|---|---|
| 首页 / 落地页扩展 | 轮播图、客户证言、数字成就墙、特性 3 列 |
| 转化工具 | 邮件订阅、聊天客服、退出意图弹窗、限时促销条 |
| 数据追踪 | Google Analytics、Facebook Pixel、百度统计、自建埋点 |
| 社交集成 | 微信分享、X / Twitter 卡片、LinkedIn 分享按钮 |
| 内容增强 | 阅读进度条、代码高亮主题、目录侧栏、相关推荐算法 |
| 后台增强 | 高级编辑器、批量导入、SEO 分析报告、AI 写作助手 |
| 集成对接 | Hubspot CRM、Mailchimp、企业微信通知、钉钉通知 |
| 维度 | 主题 | 插件 |
|---|---|---|
| 作用 | 整体视觉骨架(布局、配色) | 单一功能扩展(一个具体能力) |
| 范围 | 全站生效 | 通常只影响某个页面 / 区块 |
| 同时启用数量 | 1 个 | 多个 |
| 依赖关系 | 独立 | 需要主题预留 挂载点 |
| 影响前台外观 | 巨大(重构整站) | 局部(只改插件挂的地方) |
典型组合:1 个主题 + 5-15 个插件 = 你的完整站点。
跟主题类似:
| 维度 | 内置插件 | 第三方插件 |
|---|---|---|
| 来源 | 系统自带 | 你上传 zip 包 |
| 能否禁用 | ✅ 可以(内置插件不强制启用) | ✅ 可以 |
| 能否卸载 | ❌ 不能 | ✅ 可以(先停用 + 解除挂载) |
| 质量保证 | 官方保证 | 取决于开发者 |
内置插件(系统自带)通常包括:
第三方插件:从主题市场(建设中)下载或开发者打包给你。
一个站点可以同时启用 多个插件,互不冲突(前提是开发者写得好)。
举例:
当前启用的插件:✅ 首页轮播图(挂在 homepage-hero)✅ 邮件订阅(挂在 footer-extra)✅ 客服浮窗(自动注入到所有页面)✅ Google Analytics(追踪所有页面访问)✅ 阅读进度条(仅文章详情页生效)每个插件独立工作,独立配置。
详见 主题与插件协作。简要:
<head> 或浮层)取决于插件质量:
安全做法:在测试环境先装 → 验证 → 再上生产。
少数情况会——主要冲突场景:
<head> 标签(如两个统计插件抢 dataLayer)遇到冲突的处理:
会——每个插件都加载 JS / CSS,累计影响性能:
保守建议:只装真正需要的,定期清理不用的。
可以——同一个插件可以挂到多个 slot,每次挂载是独立配置。
通常不会——插件配置存数据库,跟插件代码包分开。
但少数情况会:
升级前截图保存当前配置 + 让运维做数据库备份。
接下来 4 篇带你走完插件相关全部能力:
1. 安装与启用插件
上传第三方插件 zip / 启用 / 停用 / 卸载
2. 插件配置
每个插件的设置项怎么调(通用规律 + 典型例子)
3. 挂载到主题槽位
把插件挂到首页 / Footer / 其他位置
4. 常见插件类型与用法
轮播图、订阅、客服、统计、社交分享——典型场景示例
可以——BangNiCMS 提供完整的插件开发文档。需要会 React / Astro 等前端技术。详见 开发者 章节(建设中)。
排查:
| 检查项 | 怎么看 |
|---|---|
| 插件是否启用 | 「扩展市场 → 插件」状态是 active |
| 是否还挂在 slot 上 | 「插件挂载」检查 |
| 主题升级是否破坏了 slot | 切到内置主题验证 |
| 浏览器缓存 | 硬刷新 |
| 错误日志 | 让运维看 server / web 日志 |
通常保留——插件配置和数据存数据库,卸载只删代码包。重新装回同名插件,数据还在。
但少数插件有”彻底删除”选项 → 卸载时清除所有数据。
详见 安装与启用插件 - 卸载。
取决于插件设计——多数插件是全语言生效。
少数插件支持”按语言过滤”(如某个促销插件只对中文用户显示)——查插件设置面板有没有这个选项。