插件配置
每个插件都暴露自己独有的设置项——具体字段因插件而异。本节讲通用规律和几个典型插件的配置示例。
后台入口：扩展市场 → 插件 → 任一插件卡片点 设置 按钮
待补充截图 左侧字段分组 + 右侧字段值编辑 + 顶部「保存 / 重置」按钮
配置面板的通用结构
Section titled “配置面板的通用结构”主流插件通常按以下分组：
- 基本设置 — 启用/关闭、显示位置等开关
- 内容设置 — 文字、图片、链接（多语言独立）
- 样式设置 — 颜色、尺寸、动画
- 行为设置 — 触发条件、显示频率、关闭行为
- 高级 — 自定义 CSS / JS、第三方对接
改了立即生效
Section titled “改了立即生效”插件配置保存即生效——前台硬刷新可见。
但有缓存的情况：
- SSR 缓存（视主题实现）— 1-5 分钟自动刷新
- CDN 缓存 — 需要让运维清缓存
- 浏览器缓存 — 让用户硬刷新（Cmd/Ctrl + Shift + R）
插件配置通常分两层：
全语言共享：
- 颜色、尺寸、动画
- 启用 / 关闭
- 显示频率
每种语言独立：
- 文字内容（标题、按钮文字、提示语）
- 链接 URL（如订阅插件可能链不同语言的隐私页）
- 媒体（图片、视频）
切换语言 Tab 编辑——同其他多语言模块。
典型示例 1：首页轮播图（hero carousel）
Section titled “典型示例 1：首页轮播图（hero carousel）”插件作用：在首页 Hero 区显示自动播放的多帧轮播。
典型配置：
| 字段 | 类型 | 说明 |
|---|---|---|
| 是否启用 | 开关 | 关闭 → 主题用默认 hero |
| 轮播帧 | 列表 | 每帧含：背景图 / 视频 / 标题 / 副标题 / CTA 按钮 |
| 自动播放 | 开关 | 是否自动切换 |
| 切换间隔 | 数字（秒） | 5-10 秒最常用 |
| 过渡动效 | 选项 | 淡入淡出 / 滑动 / 缩放 |
| 显示指示点 | 开关 | 底部小圆点 |
| 显示左右箭头 | 开关 | 鼠标 hover 显示 |
| 手机端布局 | 选项 | 跟桌面一致 / 简化为单图 |
每帧的内容（标题 / 副标题 / CTA 文字）多语言独立——中英文 hero 可以放完全不同的图和文案。
典型配置示例：
轮播帧 1： - 背景：hero-1.jpg（春节促销主视觉） - 标题：春节大促 直降 30% - 副标题：限时 7 天 仅此一次 - CTA：立即抢购 → /promotions/spring-2026
轮播帧 2： - 背景：hero-2.jpg（产品展示） - 标题：30 分钟搭好你的多语言企业站 - 副标题：B2B 出海一站式 - CTA：免费试用 → /trial
轮播帧 3： - 背景视频：hero-bg.mp4 - 标题：1000+ 客户的选择 - CTA：查看案例 → /cases典型示例 2：邮件订阅
Section titled “典型示例 2：邮件订阅”插件作用：在 Footer 上方放订阅表单，收集邮箱用于内容推送。
典型配置：
| 字段 | 说明 |
|---|---|
| 标题 | 如「订阅我们的行业洞察」 |
| 描述 | 「每月 2-3 封干货邮件 随时取消」 |
| 占位文字 | 「输入你的邮箱」 |
| 按钮文字 | 「订阅」 |
| 服务商对接 | Mailchimp / SendGrid / 自建 |
| API Key | 服务商提供 |
| 列表 ID | 订阅到哪个邮件列表 |
| 隐私同意 | 可选：复选框 + 隐私政策链接 |
| 成功提示 | 「订阅成功！请查收确认邮件」 |
| 失败提示 | 「订阅失败，请稍后再试」 |
典型示例 3：客服浮窗（live chat）
Section titled “典型示例 3：客服浮窗（live chat）”插件作用：在前台所有页面右下角显示客服图标，点击展开聊天窗。
典型配置：
| 字段 | 说明 |
|---|---|
| 服务商 | 智齿、Tidio、Crisp、Tawk.to |
| 嵌入代码 | 服务商提供的 JS 片段 |
| 按钮位置 | 右下 / 左下 / 自定义 |
| 图标 | 默认 / 自传 |
| 显示页面 | 全部 / 仅产品页 / 仅询盘页 / 排除某些页 |
| 延迟显示 | 进站后 N 秒才出现（避免打扰） |
| 手机端 | 显示 / 隐藏 |
显示页面”排除”的常见用法：
- 不在
/login显示（避免遮挡登录表单） - 不在
/checkout显示（避免分散注意力）
典型示例 4：Google Analytics / 百度统计
Section titled “典型示例 4：Google Analytics / 百度统计”插件作用：埋点追踪所有页面访问 + 转化事件。
典型配置：
| 字段 | 说明 |
|---|---|
| 追踪 ID | GA4: G-XXXXXXX / GA Universal: UA-XXXXXX / 百度: xxxxxxx |
| 是否启用 | 总开关 |
| 追踪登录后台 | 通常关闭——不污染数据 |
| 追踪事件 | 自动追踪：点击、滚动、表单提交 |
| 自定义事件 | 让开发者扩展（“加入购物车”、“询盘提交”） |
| 匿名化 IP | GDPR 合规要求开启 |
| 生命周期 | Cookie 保留 N 天 |
重置 / 恢复默认
Section titled “重置 / 恢复默认”多数插件设置面板有 重置默认 按钮——一键还原到出厂设置。
作用：
- 把所有字段恢复成插件默认值
- 不删除已挂载的位置（slot 关系还在）
- 多语言副本也会重置
慎用——重置后没法撤销，建议先截图保存当前配置作为备份。
何时改插件配置
Section titled “何时改插件配置”| 时机 | 改什么 |
|---|---|
| 新装插件 | 全量配置（必填项填好） |
| 节日活动 | 改轮播图、改 CTA 文案 |
| 数据复盘 | 调整客服显示规则、订阅文案 |
| A/B 测试 | 改 CTA 文字、改按钮颜色 |
| 合规审计 | 加 cookie 同意、改隐私链接 |
插件配置存哪
Section titled “插件配置存哪”插件配置存在数据库的 Extension.config 字段（JSON）——跟插件代码包分开存。
意味着：
- 升级插件保留配置（绝大多数情况）
- 卸载插件 → 配置在数据库里保留（直到再次安装同名插件）
- 重装插件 → 配置自动恢复
唯一例外：开发者在新版改了配置数据结构 → 旧配置可能不兼容。
我能批量配置多个插件吗？
Section titled “我能批量配置多个插件吗？”当前不支持——必须一个一个配。
如果你要在多个站点（多个 BangNiCMS 实例）部署相同的插件配置，让运维写脚本批量同步配置 JSON。
插件配置能导出 / 导入吗？
Section titled “插件配置能导出 / 导入吗？”当前不支持后台 UI 操作——但配置存在数据库，让运维可以：
- 用
pg_dump导出Extension表 - 复制到目标数据库的
Extension表
适合多站点同步。
我能给同一个插件挂在不同位置时用不同配置吗？
Section titled “我能给同一个插件挂在不同位置时用不同配置吗？”可以——详见 挂载到主题槽位 - 同一个插件挂在不同位置。每次挂载都是独立配置实例。
配置面板有的字段我看不懂？
Section titled “配置面板有的字段我看不懂？”| 怎么办 | |
|---|---|
| 字段旁边有 ? 图标 | hover 显示说明 |
| 看插件文档 | 通常开发者会附 README 或线上文档 |
| 联系开发者 | 大型插件通常有支持渠道 |
| 不要乱改 | 不知道含义就别动，免得误操作 |
改了配置但前台没变？
Section titled “改了配置但前台没变？”排查：
- 是否点了 保存（不是只关弹窗）？
- 浏览器有缓存？硬刷新
- SSR / CDN 缓存？等几分钟或让运维清缓存
- 改的是该 slot 的本地配置还是全局配置？