EN
Shopify 知识库 · 概念

Shopify Template type 与 alternate template

从 Shopify Template type 出发,说明默认模板、可选 alternate、关联资源和具体业务页面之间的关系。

Template type 是这张关系网的 Shopify 入口。它说明主题正在渲染哪类资源或系统页面;alternate template 则在同一个 type 下提供另一种可选页面组成。About Us、Brand Story 和 Contact Us 是具体业务页面,不是三种 Template type。

先读Template、业务页面与内容关系网。下表是主题型 Online Store 的常见 Template type,不代表每个商店都必须提供,也不是所有渠道和账户模式通用的 URL 接口规范。

Template type

Template type默认页面或资源路径样例alternate 的作用
index店面首页/通常直接维护默认首页;市场或 B2B 差异另判断 contextual template
product商品及其变体/products/{handle}为需要稳定不同组成的商品提供可分配模板
collection集合与商品列表/collections/{handle}为编辑型、活动型等集合提供不同组成
list-collections集合列表/collections仅在真实导航任务不同且可复用时增加
pagePage 资源/pages/{handle}为 About Us、Contact Us 等业务页面提供不同组成
blog博客与文章列表/blogs/{handle}为不同博客内容结构提供可分配模板
article单篇文章/blogs/{blog}/{article}为指南、故事等稳定文章结构提供可分配模板
cart当前购物车/cart只有经核验的页面组成差异需要长期复用时增加
search搜索结果/search只有真实搜索任务差异存在时增加
password店铺访问提示与密码表单/password只有真实受限访问场景需要时增加
404未找到页面无效地址通常使用一个明确的错误恢复页面
gift_card.liquid已签发礼品卡礼品卡专用地址受必须使用 Liquid 模板的边界约束
metaobject/{type}启用网页能力的自定义实体对应定义的页面地址随具体实体及其稳定页面组成决定

模板类型、用途与例外参见官方模板参考。JSON 模板主要保存 Sections 的组合与配置,Liquid 模板可以直接包含 Liquid 和 HTML;不能只替换扩展名理解其实现。gift_card、robots.txt、agents.md、llms.txt 与 llms-full.txt 五种模板只能使用 Liquid,其余类型可以在 JSON 与 Liquid 之间选择。metaobject/{type} 要求对应的 metaobject 定义启用网页(web page)能力,才会为每个条目渲染独立页面。

page type 的 alternate 与业务页面

业务页面原型Shopify 资源模板类型可选模板文件示例
About UsPagepagepage.about.json
Brand StoryPagepagepage.brand-story.json
Contact UsPagepagepage.contact.json
FAQPagepagepage.faq.json
Shipping & ReturnsPagepagepage.shipping-returns.json
Size GuidePagepagepage.size-guide.json
Campaign Landing PagePagepagepage.campaign.json
PressPagepagepage.press.json
ReviewsPagepagepage.reviews.json
Loyalty ProgramPagepagepage.loyalty.json
PoliciesPagepagepage.policies.json
Order TrackingPagepagepage.order-tracking.json

这些后缀是主题自己的命名示例,不是 Shopify 预置类型。多个页面可以共用默认 page.json,也可以共用同一个 alternate;只有页面组成确实不同并需要稳定复用时,才建立 alternate template。其命名、分配和预览方式见Alternate templates。三种代表页面的内容与模块组合见About Us、Brand Story 与 Contact Us。

核心 Template type 的页面配方

除 page 外,下列 Template type 已有入口与页面配方:

Template type入口与配方
index首页配方(本库 URL 使用 homepage,因为 index 作文件名会与目录索引和 /zh/shopify 路由冲突)
product商品页入口:标准商品页、预售与订阅商品页、尺码敏感商品页
collection集合页入口:品类集合页、活动与编辑型集合页
list-collections集合列表页配方
cart购物车页配方
search搜索结果页配方

blog 与 article 见博客、文章与普通页面;article 的入口与配方见 Article 文章页配方索引(购买指南文章、使用指南文章)。这些配方都是 WooDawn 的编辑模型,后缀命名(如 product.preorder.json)同样是主题自己的约定。

动作地址不等于页面模板

折扣分享链接用于应用折扣并可带跳转目的地;它不应在知识目录中被当作普通内容页。分享链接使用单数 discount,按后台生成的链接验证实际效果。折扣管理。

robots.txt、agents.md、llms.txt 和 llms-full.txt 虽然也由主题模板生成,但面向搜索引擎爬虫或 AI agent,不纳入顾客页面原型。真实礼品卡和订单地址可能携带访问凭证,本文不收录可复用的真实令牌。

哪些内容单独判断

结账、感谢与订单状态体验不是普通 Theme template type,先按购买旅程确定职责。Shopify 当前客户账户独立于主题;官方已将旧 customers/* 模板标为 deprecated,阅读旧主题时不能把这套目录当成当前必备页面。

改路径时阅读URL 重定向;理解代码结构进入主题架构;设计页面则继续到页面组合方法。