Shopify Template type 与 alternate template
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 | 仅在真实导航任务不同且可复用时增加 |
page | Page 资源 | /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 Us | Page | page | page.about.json |
| Brand Story | Page | page | page.brand-story.json |
| Contact Us | Page | page | page.contact.json |
| FAQ | Page | page | page.faq.json |
| Shipping & Returns | Page | page | page.shipping-returns.json |
| Size Guide | Page | page | page.size-guide.json |
| Campaign Landing Page | Page | page | page.campaign.json |
| Press | Page | page | page.press.json |
| Reviews | Page | page | page.reviews.json |
| Loyalty Program | Page | page | page.loyalty.json |
| Policies | Page | page | page.policies.json |
| Order Tracking | Page | page | page.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,阅读旧主题时不能把这套目录当成当前必备页面。