Shopify disabled_on 配错模板类型不生效
现象#
配置了 disabled_on 仍能在禁用模板里插入该 section,或反过来:以为禁用了 cart 模板,商家却仍能添加。审核或 QA 对照文档失败。
成因#
disabled_on 与 enabled_on 不要同时胡乱叠加——应以当前主题架构文档的推荐方式二选一为主。模板类型字符串必须是平台认识的值;自定义 JSON 模板名(如 product.alternate)的限制写法与基础类型不同,写错即“不生效”。缓存的旧主题编辑器会话也可能仍显示过期 schema,造成“我改了但不生效”的错觉。另:应用区块的目标限制在应用扩展 toml/schema,不是主题 section 那份,查错文件会白忙。
步骤#
- 确认你改的是主题
sections/*.liquid的 schema,而非应用扩展目录。 - 仅保留
disabled_on或enabled_on其一作为主策略,删除矛盾项。 - 按 section schema 核对
templates/groups字段拼写。 - 保存后关闭编辑器标签页,重新进入「在线商店 → 主题 → 自定义」。
- 在应禁用的模板点添加分区,确认列表无该项;在允许的模板应能添加。
- 若走 CI,把 schema 片段纳入 theme check 或单元校验,防止再次被合并请求改坏。
通过条件#
禁用列表行为与文档声明一致;无编辑器缓存误导;相关 PR 描述写明限制意图。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。