Shopify Online Store 2.0

Shopify disabled_on 配错模板类型不生效

现象#

配置了 disabled_on 仍能在禁用模板里插入该 section,或反过来:以为禁用了 cart 模板,商家却仍能添加。审核或 QA 对照文档失败。

成因#

disabled_on 与 enabled_on 不要同时胡乱叠加——应以当前主题架构文档的推荐方式二选一为主。模板类型字符串必须是平台认识的值;自定义 JSON 模板名(如 product.alternate)的限制写法与基础类型不同,写错即“不生效”。缓存的旧主题编辑器会话也可能仍显示过期 schema,造成“我改了但不生效”的错觉。另:应用区块的目标限制在应用扩展 toml/schema,不是主题 section 那份,查错文件会白忙。

步骤#

  1. 确认你改的是主题 sections/*.liquid 的 schema,而非应用扩展目录。
  2. 仅保留 disabled_on 或 enabled_on 其一作为主策略,删除矛盾项。
  3. 按 section schema 核对 templates / groups 字段拼写。
  4. 保存后关闭编辑器标签页,重新进入「在线商店 → 主题 → 自定义」。
  5. 在应禁用的模板点添加分区,确认列表无该项;在允许的模板应能添加。
  6. 若走 CI,把 schema 片段纳入 theme check 或单元校验,防止再次被合并请求改坏。

通过条件#

禁用列表行为与文档声明一致;无编辑器缓存误导;相关 PR 描述写明限制意图。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。