挂载到主题槽位
启用了一个插件还不够——还要把它挂到主题预留的位置,前台才能看到。
后台入口:扩展市场 → 插件挂载 Tab
主题预留的 slot 是哪些
Section titled “主题预留的 slot 是哪些”每个主题暴露的 slot 不同。详见 主题与插件协作 - 主题里的”挂载点”。
典型 B2B 主题的 slot:
| Slot 名 | 在前台位置 | 适合挂什么插件 |
|---|---|---|
homepage-hero | 首页顶部 | 轮播图、视频背景、动态 hero |
homepage-features | 首页 hero 下方 | 价值主张、特性 3 列、客户证言 |
homepage-cta | 首页 footer 之前 | 订阅表单、CTA 按钮、促销条 |
header-utility | Header 右上角 | 语言切换、搜索、登录、购物车 |
footer-extra | Footer 底部追加 | 订阅、社交图标、CTA |
inquiry-form-extra | 询盘表单上方 | ”为什么选我们”短文、信任背书 |
product-detail-after | 产品详情页正文之后 | 相关产品、客户案例、CTA |
article-after-content | 文章正文之后 | 相关推荐、订阅、评论 |
-
确保插件已启用(扩展市场 → 插件)
-
进「扩展市场 → 插件挂载」
-
左侧 slot 列表找到目标位置(如
homepage-features) -
右侧”可用插件” 拖拽到左侧的 slot 挂载列表
待补充截图 左侧 slot 列表展开 + 右侧插件库可拖拽 + 拖入后弹出该插件的配置面板拖拽挂载插件 -
配置该插件在此 slot 下的设置——这次配置是该挂载实例独有的,不影响插件本身的全局配置
-
保存 → 前台立即生效
一个 slot 挂多个插件
Section titled “一个 slot 挂多个插件”支持——多个插件按列表顺序在前台依次渲染:
homepage-features 槽位├─ 第一项:插件「特性 3 列」(展示我们的优势)├─ 第二项:插件「客户 logo 墙」└─ 第三项:插件「数字成就」前台从上到下显示这三个插件。
调整顺序:左侧挂载列表里拖拽插件项重新排序,保存即生效。
同一个插件挂在不同位置
Section titled “同一个插件挂在不同位置”支持——而且每次挂载是独立配置实例:
插件「特性 3 列」├─ 挂在 homepage-features:│ - 标题:「为什么选我们」│ - 项 1:极速搭建 / 项 2:多语言 / 项 3:AI 辅助└─ 挂在 about-us-features: - 标题:「公司核心价值」 - 项 1:诚信 / 项 2:专业 / 项 3:创新同一个插件代码包,但两次挂载用了完全不同的配置。
-
进「插件挂载」
-
找到要解除的 slot
-
点该插件项右侧的 解除 / 删除挂载 按钮
-
确认 → 前台立即不再显示该位置的内容
解除挂载 ≠ 停用插件:
- 解除挂载:插件仍启用,只是不在那个位置渲染了
- 停用插件:插件代码完全不加载,所有挂载位置都失效
卸载插件前必须先解除所有挂载
Section titled “卸载插件前必须先解除所有挂载”卸载流程:① 停用插件② 「插件挂载」找到所有挂着该插件的 slot → 全部解除③ 回到插件卡片 → 卸载详见 安装与启用 - 卸载第三方插件。
切换主题后挂载关系
Section titled “切换主题后挂载关系”跟主题的处理一致:
- 新主题有同名 slot → 挂载关系自动保留
- 新主题没有同名 slot → 挂载在新主题前台不显示,但数据库记录还在
切换主题前:截图保存当前的所有挂载,新主题装好后对照恢复(如果旧 slot 名换了,要在新主题对应位置重挂)。
插件挂载 vs 插件全局注入
Section titled “插件挂载 vs 插件全局注入”| 特性 | 挂到 slot | 全局注入 |
|---|---|---|
| 典型用例 | 轮播图、特性区、订阅 | GA、客服、cookie 同意 |
| 位置 | 由 slot 决定 | 由插件代码决定(通常 <head> 或浮层) |
| 多次挂载 | 支持 | 不支持(启用即一次) |
| 配置 | 每次挂载独立 | 全局一份 |
| 依赖主题 | 主题必须有对应 slot | 不依赖主题 |
怎么判断:
- 看插件文档(最准确)
- 启用后看前台是否自动出现 → 是则全局注入;否则需要挂 slot
- 看「插件挂载」面板的”可用插件”列表里有没有这个插件 → 没有的话很可能是全局注入
挂载关系本身不分语言——挂上就所有语言生效。
但插件配置可以多语言独立——比如挂「订阅插件」到 footer-extra,订阅文案、按钮文字按语言独立填写。
改了挂载会立即生效
Section titled “改了挂载会立即生效”保存即时生效,前台硬刷新可见。
但有缓存:
- SSR / CDN:1-5 分钟
- 浏览器:硬刷新
我能给某个 slot 设置”只在某语言下显示”吗?
Section titled “我能给某个 slot 设置”只在某语言下显示”吗?”当前 slot 层面不支持——挂上就所有语言生效。
如果业务需要”只在中文站显示某个插件”:
- 有些插件支持”按语言过滤”配置 → 在插件设置里调
- 否则让开发者改插件代码
同一个插件挂多次会冲突吗?
Section titled “同一个插件挂多次会冲突吗?”通常不会——每次挂载是独立实例。
但少数插件设计为”单实例”(如客服浮窗、cookie 同意横幅),挂多次会有警告或合并行为。
挂错位置了怎么办?
Section titled “挂错位置了怎么办?”直接拖到正确的 slot——左侧挂载列表支持跨 slot 拖拽。或者先解除再重新挂。
拖拽挂载没反应?
Section titled “拖拽挂载没反应?”排查:
| 检查 | 怎么看 |
|---|---|
| 插件是否启用 | 「扩展市场 → 插件」状态 active |
| 浏览器是否支持拖拽 | 换 Chrome 试 |
| 浏览器有 JS 错误 | F12 → Console 看 |
| 是否当前用户没权限 | 普通运营可能不能改挂载 |
挂上去前台没反应?
Section titled “挂上去前台没反应?”详见 常见问题清单。
我能给插件挂载排”显示时间”吗(如周末才显示)?
Section titled “我能给插件挂载排”显示时间”吗(如周末才显示)?”当前不支持——挂载是静态关系。
如果业务需要”定时显示某个 slot 的内容”:
- 让开发者改插件加”定时显示”配置
- 或写一个”定时管理”插件来管理其他插件的启用 / 停用