Shopify Online Store 2.0

JSON 模板 order 漏写 section 导致整段内容空白

现象#

在 templates/index.json 里加了一个 section,编辑器左侧栏能看到它并被选中,右侧预览和前台却完全没有这段内容,其余 section 正常。

原因#

  • 模板按 order 数组逐个渲染,sections 里存在却没写进数组的 id 不会进入渲染队列
  • 手工合并两个模板时把 order 整体覆盖成对方的值,本地新增的 id 全部丢失
  • 编辑器保存会按侧栏顺序重写 order,此前手工写入的顺序被整段替换
  • order 里写了 sections 中并不存在的 id 时,该项被静默跳过,界面不提示

处理步骤#

  1. 打开 templates/index.json,把 sections 对象的键与 order 数组逐个对照,列出差集
  2. 把缺失的 id 追加进 order,字符串与 sections 的键完全一致,注意大小写
  3. 删掉 order 里多出来的、sections 中不存在的 id,避免渲染阶段被跳过
  4. 保存后运行 shopify theme check,确认没有模板结构类报错
  5. 在编辑器里拖动一次该 section 的顺序并保存,让 Shopify 重新生成规范的 order

验收标准#

前台源码能搜到 id="shopify-section-你的id" 容器,且内容出现在拖动后的位置。

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