Shopify Online Store 2.0

layout 漏了 content_for_layout 后页面只剩页头

现象#

换过 layout 后所有页面只剩页头和页脚,商品、集合、文章正文全部不见,编辑器预览区一片空白但控制台没有报错。

原因#

  • layout/theme.liquid 必须输出 {{ content_for_layout }},模板内容才会被注入
  • 重写 layout 时把该输出放进条件分支,部分模板走不到
  • 把 section group 的 {% sections 'header-group' %} 误当成内容占位
  • 主题有多套 layout,只有一套带该输出,而模板的 layout 字段指向了另一套

处理步骤#

  1. 打开 layout/theme.liquid,确认 {{ content_for_layout }} 位于 body 内的主内容区
  2. 把它移出任何 {% if %} 分支,保证所有页面都能输出
  3. 检查模板 JSON 是否指定了 layout 字段,对应的 layout 文件同样要补占位
  4. 页头页脚 section group 的输出要保留,和内容占位互不替代
  5. 推送后在编辑器依次打开首页、商品、集合页,确认正文恢复

验收标准#

各页面正文正常渲染,查看源码能看到模板中 section 的 shopify-section- 容器。

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