# Shoplazza 主题开发

> 开发 Shoplazza 主题的文档，包括 Liquid 和 Ajax API 参考。

顶层索引：https://www.shoplazza.dev/zh-CN/llms.txt

## 快速入门

- [Shoplazza 主题快速入门](https://www.shoplazza.dev/zh-CN/docs/theme/getting-started.md): 开始构建 Shoplazza 主题：用 Liquid、JSON template 与 section 新建主题或自定义现有主题，再按架构与功能指南继续深入。
- [CLI 快速开始](https://www.shoplazza.dev/zh-CN/docs/theme/getting-started/develop-with-cli.md): 配置 Shoplazza CLI，基于 Nova 2023 新建主题或下载商家现有主题，再预览、推送并发布。
- [从零开始](https://www.shoplazza.dev/zh-CN/docs/theme/getting-started/create-a-theme.md): 从零手写第一个 Shoplazza 主题：创建 layout、首页 template、section、snippet、导航菜单和商品详情页，再上传预览。

## 主题架构

- [主题架构](https://www.shoplazza.dev/zh-CN/docs/theme/architecture.md): Shoplazza 主题的标准目录结构：assets、config、layout、locales、sections、snippets 与 templates 分别控制什么。
- [主题架构概述](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/overview.md): Shoplazza 主题的组织方式：Liquid 标记文件、辅助资产与 JSON 配置文件，以及 layout、template、section 和 block 之间的关系。
- [Layouts](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/layouts.md): Shoplazza 主题的 layout 目录存放 theme.liquid——包裹每个页面的 HTML 外壳，本页讲它为什么必需、该放哪些内容。
- [主题 layout 概述](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/layouts/overview.md): Shoplazza 主题的 layout 如何渲染所有 template、theme.liquid 里该放什么，以及 template 怎样指定自定义 layout 或不使用 layout。
- [Templates](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates.md): Shoplazza 在线商店的每种页面类型都对应一个 template，本页列出 index、product、collection、cart、blog、search、404 等全部类型。
- [主题 template 概述](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/overview.md): Template 如何决定 Shoplazza 主题中每种页面类型的渲染内容、模板文件放在哪里，以及页面类型与 template 的对应关系。
- [Liquid 模板](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/liquid-templates.md): Liquid template 是 JSON 数据文件，规定 Shoplazza 主题页面渲染哪些 section 及其顺序，本页讲它的 schema 与各个属性。
- [article](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/article.md): Shoplazza 主题的 article template 渲染单篇博客文章页并展示完整内容，本页讲文件位置与应引用的对象。
- [blog](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/blog.md): Shoplazza 主题的 blog template 渲染列出某个博客下全部文章的页面，本页讲文件位置与应引用的对象。
- [cart](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/cart.md): Shoplazza 主题的 cart template 渲染 /cart 页面，逐行展示客户购物车中的商品，本页讲文件位置与应引用的对象。
- [collection](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/collection.md): Shoplazza 主题的 collection template 渲染分类页并列出该分类下的全部商品，本页讲文件位置与应引用的对象。
- [customers/addresses](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/customers-addresses.md): Shoplazza 主题的 customers/addresses template 渲染客户地址簿（查看、编辑、新增地址），并给出表单提交的 Ajax API 接口。
- [customers/login](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/customers-login.md): Shoplazza 主题的 customers/login template 渲染客户账号登录表单，并给出表单提交的 Ajax API 登录接口。
- [customers/order](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/customers-order.md): Shoplazza 主题的 customers/order template 渲染已登录客户的历史订单详情页，本页讲文件位置与页面内容。
- [customers/register](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/customers-register.md): Shoplazza 主题的 customers/register template 渲染客户注册表单，并给出表单提交的 Ajax API 注册接口。
- [customers/reset_password](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/customers-reset-password.md): Shoplazza 主题的 customers/reset_password template 渲染密码重置表单，并给出表单提交的 Ajax API 密码重置接口。
- [customers/reset_success](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/customers-reset-success.md): Shoplazza 主题的 customers/reset_success template 渲染客户成功重置账号密码后看到的页面，本页讲文件位置与页面内容。
- [index](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/home.md): Shoplazza 主题的 index template 渲染店铺根地址上的首页——商家给客户的第一印象页，本页讲该放哪些内容。
- [order](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/order.md): Shoplazza 主题的 order template 渲染客户订单详情页，本页讲文件位置以及如何在其中使用 order 对象。
- [order-verify](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/order-verify.md): Shoplazza 主题的 order-verify template 渲染订单查询页，客户可以用邮箱或手机号查找自己的订单。
- [page](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/page.md): Shoplazza 主题的 page template 渲染商家自建的静态页面，如「关于我们」「联系我们」，本页讲文件位置与页面内容。
- [password](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/password.md): Shoplazza 主题的 password template 渲染店铺开启密码保护时的落地页，包含商家可编辑的文案与密码表单。
- [product](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/product.md): Shoplazza 主题的 product template 渲染商品页：媒体、内容，以及客户选择子款式并加入购物车的表单。
- [search](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/search.md): Shoplazza 主题的 search template 渲染店面搜索结果页，本页讲文件位置与该放哪些内容。
- [404](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/templates/404.md): Shoplazza 主题的 404 template 渲染客户访问无效店铺地址时看到的页面，本页讲文件位置与该放哪些内容。
- [Sections](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/sections.md): Section 是商家在 Shoplazza 主题编辑器中排布的可复用内容模块，这里是 section schema、section 资源与 app block 的入口。
- [主题 section 概述](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/sections/overview.md): Shoplazza 主题的 section 如何工作：带 block 的可复用 Liquid 模块，可通过 Liquid template 动态添加，也可静态嵌入页面。
- [区块 schema](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/sections/section-schema.md): schema 标签定义 Shoplazza 主题 section 的名称、设置、block、预设与可用 template，本页列出全部支持的属性与使用限制。
- [主题中的 App block](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/sections/app-blocks-for-themes.md): 让 Shoplazza 主题的 section 支持 app block：在 section schema 里加通用 @app 块并渲染应用内容，商家无需改 theme 代码。
- [区块资源](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/sections/section-assets.md): 用 section 专属的 javascript 与 stylesheet 这两个 Liquid 标签，把 CSS、JS 打包进 Shoplazza 主题的 section，并说明代码注入位置。
- [Config](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/config.md): Shoplazza 主题的 config 目录包含 settings_schema.json、settings_data.json 与 settings_presets.json，本页说明三者各自的职责。
- [主题配置文件概述](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/config/overview.md): Shoplazza 主题的配置文件如何定义并存储主题编辑器「主题设置」区域的内容、文件放在哪里，以及 Liquid 怎么读取设置值。
- [settings_schema.json](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/config/settings-schema-json.md): settings_schema.json 决定 Shoplazza 主题编辑器「主题设置」区域的组织与内容，本页讲它的分类数组 schema 和每项设置必需的属性。
- [settings_data.json](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/config/settings-data-json.md): settings_data.json 保存 Shoplazza 主题当前的设置值与生效的风格预设，本页讲它的结构，以及商家的选择是怎么存下来的。
- [settings_presets.json](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/config/settings-presets-json.md): settings_presets.json 定义 Shoplazza 主题自带的风格预设，本页讲它的 schema，以及预设值如何对应 settings_schema.json。
- [Locales](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/locales.md): Locale 文件为 Shoplazza 主题提供翻译后的店面文案，这里介绍它们的组织方式，以及店面 locale 文件格式的说明入口。
- [主题 locale 文件概述](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/locales/overview.md): Locale 文件如何为 Shoplazza 主题保存翻译字符串、在主题中放在哪个目录，以及商家怎样在 Shoplazza 语言编辑器里修改它们。
- [店铺前台语言文件](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/locales/storefront-locale-files.md): 店面 locale 文件保存 JSON 翻译字符串，Shoplazza 主题用 Liquid 的 t 过滤器输出它们，本页含文件命名与插值写法。
- [Settings](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/settings.md): 主题设置让商家在主题编辑器里自定义 Shoplazza 主题，这里是输入型设置、侧边栏设置、动态数据源与字体的入口。
- [主题设置概述](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/settings/overview.md): Shoplazza 主题的设置在 theme、section、block 三个级别如何工作、在哪里定义，以及 Liquid 怎样读取商家选择的值。
- [输入型设置](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/settings/input-settings.md): Shoplazza 主题能在主题编辑器中开放的全部输入型设置：文本、下拉、复选、颜色、图片等，并列出通用属性。
- [侧边栏设置](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/settings/sidebar-settings.md): 侧边栏设置用 header 和 paragraph 元素在主题编辑器里组织并说明 Shoplazza 主题的输入型设置，本页讲这两种类型及其属性。
- [动态数据源](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/settings/dynamic-sources.md): 让商家把 Shoplazza 主题 section 或 block 的设置绑定到元字段或资源属性，并说明哪些设置类型支持动态数据源。
- [字体](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/settings/fonts.md): 为 Shoplazza 主题添加字体：从 Shoplazza 字体库中选择、用系统字体提升性能，或加载第三方自定义字体。
- [Assets](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/assets.md): Shoplazza 主题的 assets 目录：CSS、JavaScript、图片与字体放在哪里，支持哪些文件类型，以及如何在 Liquid 中引用。
- [代码片段](https://www.shoplazza.dev/zh-CN/docs/theme/architecture/snippets.md): Snippet 是 Shoplazza 主题中可复用的 Liquid 片段，本页讲它们存放在哪里，以及如何在 layout、template 或 section 中引用。

## 开发者工具

- [主题开发者工具概述](https://www.shoplazza.dev/zh-CN/docs/theme/developer-tools.md): 构建 Shoplazza 主题的工具总览：Shoplazza CLI、后台的主题编辑器 / 代码编辑器 / 语言编辑器，以及参考主题 Nova 2023。
- [Shoplazza CLI 主题开发概述](https://www.shoplazza.dev/zh-CN/docs/theme/developer-tools/shoplazza-cli.md): 用 Shoplazza CLI 做主题开发：开发主题、热重载预览、基于 Nova 2023 初始化，以及在命令行推送与发布主题。
- [主题命令](https://www.shoplazza.dev/zh-CN/docs/theme/developer-tools/shoplazza-cli/theme-commands.md): Shoplazza CLI 主题命令参考：init、serve、pull、push、share、package、env、publish、list、delete 的参数与行为说明。
- [主题编辑器](https://www.shoplazza.dev/zh-CN/docs/theme/developer-tools/theme-editor.md): Shoplazza 主题编辑器让商家自定义内容并实时预览，本页讲如何开放设置，以及开发过程中怎样打开编辑器。
- [代码编辑器](https://www.shoplazza.dev/zh-CN/docs/theme/developer-tools/code-editor.md): Shoplazza 后台的代码编辑器让商家在浏览器里查看和修改主题文件，本页讲如何进入、怎样浏览文件，以及何时改用本地开发。
- [语言编辑器](https://www.shoplazza.dev/zh-CN/docs/theme/developer-tools/language-editor.md): Shoplazza 后台的语言编辑器让商家翻译主题文案，本页讲如何进入、切换主题语言，以及更新默认内容。
- [Nova 2023](https://www.shoplazza.dev/zh-CN/docs/theme/developer-tools/nova-2023.md): Nova 2023 是 Shoplazza 的参考主题，基于 Web Components 组件库，兼顾性能与灵活性，可用 Shoplazza CLI 克隆作为起点。

## 主题功能

- [主题功能概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features.md): Shoplazza 主题可支持的店面能力总览：商品展示、定价与支付、导航与搜索、SEO、自定义数据和追踪分析。
- [商品展示概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/product-merchandising.md): 在 Shoplazza 店面呈现商品，这里是子款式选择器、变体深链，以及商品图片、视频与 3D 模型支持的入口。
- [商品子款式](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/product-merchandising/product-variants.md): 在 Shoplazza 主题中支持商品子款式：用 product 与 variant 对象构建选择器，并处理地址栏中的变体深链。
- [商品媒体](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/product-merchandising/support-product-media.md): 在 Shoplazza 主题中展示商品图片、视频与 3D 模型：遍历 product 的媒体属性，配合 media_parse 过滤器封装成可复用 snippet。
- [定价与支付概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/pricing-and-payments.md): 在 Shoplazza 店面展示价格、折扣与支付信息，这里是 money 过滤器、多币种格式化与折扣展示的入口。
- [折扣](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/pricing-and-payments/discounts.md): 用 discount_applications 与 line_item 对象在 Shoplazza 主题中展示折扣，覆盖购物车、结账与订单级折扣。
- [货币格式化](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/pricing-and-payments/currency-formatting.md): 用 money 系列过滤器在 Shoplazza 主题中格式化价格：展示货币符号或代码，并在多币种店铺下保持金额正确。
- [导航与搜索概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search.md): 帮助客户在 Shoplazza 店面浏览和查找商品，这里是基于 linklist 的菜单、分类筛选与店面搜索的入口。
- [导航](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search/navigation.md): 用 linklists、linklist 与 link 对象为 Shoplazza 主题构建菜单，包括商家在 Shoplazza 后台维护的多级下拉菜单。
- [前台搜索概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search/storefront-search.md): Shoplazza 主题中前台搜索的工作方式：q 与 page 查询参数、搜索表单的写法，以及搜索结果页的 URL 结构。
- [预测搜索](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search/storefront-search/predictive-search.md): 为 Shoplazza 主题添加预测搜索，让商品建议在客户输入时即时出现，用到搜索 Ajax 接口与 search 对象。
- [筛选](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search/filtering.md): 店面筛选让客户按价格、颜色、尺码和库存状态收窄分类页商品，这里是筛选类型、实现方式与 UX 指南的入口。
- [店面筛选](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search/filtering/storefront-filtering.md): Shoplazza 店面筛选的工作方式：筛选器基于哪些商品与变体数据，以及筛选项之间 AND、筛选值之间 OR 的匹配逻辑。
- [支持店面筛选](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search/filtering/support-storefront-filtering.md): 在 Shoplazza 主题中实现店面筛选：用分类商品接口与 collection 对象渲染筛选器并展示筛选后的结果。
- [店面筛选 UX 指南](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/site-navigation-and-search/filtering/ux-guidelines.md): Shoplazza 主题店面筛选的设计建议：列表型筛选用复选框、价格区间用输入框，以及如何呈现当前的筛选状态。
- [主题 SEO 概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/seo.md): Shoplazza 主题应输出哪些元数据、结构化数据与语义化标记，才能让商家店面在搜索结果和分享预览中表现更好。
- [元数据](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/seo/metadata.md): 在 Shoplazza 主题的 head 中输出 SEO 元数据：标题标签、meta description 与 canonical 地址，以及各自对应的 Liquid 对象。
- [结构化数据](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/seo/structured-data.md): 为 Shoplazza 主题添加 JSON-LD 结构化数据与 Open Graph 标签，让搜索引擎展示富媒体结果、社交平台生成链接预览卡。
- [主题自定义数据概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/custom-data.md): 用自定义数据扩展 Shoplazza 内置数据模型：元字段让 Shoplazza 主题在商品等资源上存储并展示业务专属信息。
- [元字段](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/custom-data/metafields.md): 元字段为 Shoplazza 资源存储额外的自定义数据，这里是元字段概念、支持的数据类型与 Liquid 读取方式的入口。
- [主题元字段概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/custom-data/metafields/overview.md): Shoplazza 元字段由 namespace、key、type 和 value 四部分构成，本页用商品信息的实例说明它在主题中的存取方式。
- [类型](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/custom-data/metafields/type.md): Shoplazza 元字段支持的全部数据类型、各类型自带的校验规则，以及类型在拥有该定义的资源上如何统一生效。
- [在 Liquid 中使用 metafields](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/custom-data/metafields/using-metafields-in-liquid.md): 在 Shoplazza 主题中用 Liquid 读取并渲染元字段：访问语法、各类型的输出方式，以及取不到值时的处理。
- [追踪与分析概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/tracking-and-analytics.md): 追踪 Shoplazza 店面的客户行为，这里是 Web Pixel、第三方平台 pixel 模板与主题事件参考的入口。
- [Web Pixel](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/tracking-and-analytics/web-pixel.md): Shoplazza Web Pixel 是什么：轻量脚本，采集下单、浏览商品、加购等客户事件并上报给第三方平台。
- [构建 Web Pixel](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/tracking-and-analytics/build-web-pixel.md): 分步指引：用自定义代码嵌入应用把 pixel 代码装进 Shoplazza 店铺，并为订单完成页配置事件追踪。
- [平台 Pixel 与 Event 模板](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/tracking-and-analytics/platform-pixel-event-template.md): 如何在 Criteo 等第三方平台获取 pixel ID 与基础代码，以及可嵌入 Shoplazza 店铺的事件代码模板。
- [主题事件](https://www.shoplazza.dev/zh-CN/docs/theme/theme-features/tracking-and-analytics/theme-events.md): Shoplazza 主题在店面触发的事件参考，例如 dj.viewContent，含监听代码与每个事件携带的数据结构。

## 最佳实践

- [主题最佳实践概述](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices.md): Shoplazza 总结的主题开发最佳实践，涵盖 section 与 block、性能、图片、国际化、无障碍、配色系统与 JS / CSS 标签。
- [Sections 和 blocks](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/sections-and-blocks.md): 判断 Shoplazza 主题的某项能力该做成 section 还是 block，以及可定制组件的粒度应该划分到多细。
- [性能](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/performance.md): 优化 Shoplazza 主题的性能：减少 JavaScript、避免阻塞解析的脚本与重型框架，并把打包体积控制在预算之内。
- [预览检查器](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/preview-inspector.md): 让 section 与 block 轮廓在 Shoplazza 主题编辑器预览检查器中正确显示的设计规范：不用负 margin、不用 padding 做间距、不留视觉隐藏元素。
- [图片优化](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/image-optimization.md): 让 Shoplazza 主题更快：用 img_url 请求合适尺寸、用 srcset 提供响应式候选、避免布局偏移，并懒加载首屏外的图片。
- [国际化](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/internationalization.md): 让 Shoplazza 主题可翻译、可感知语言区域：用 t 过滤器的翻译 key、插值动态值，并适配格式与从右到左的布局。
- [无障碍](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/accessibility.md): 构建符合 WCAG 2.1 AA 级的 Shoplazza 主题：语义化 HTML、合理的标题层级、键盘可操作，以及屏幕阅读器兼容。
- [配色系统](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/color-system.md): 用按角色划分的 color 设置和 CSS 变量为 Shoplazza 主题搭建可复用配色系统，商家改一处即可为整个店面换色。
- [JS / CSS 标签](https://www.shoplazza.dev/zh-CN/docs/theme/best-practices/javascript-and-stylesheet-tags.md): Shoplazza 主题的 JS / CSS 何时用 script_tag、stylesheet_tag 走 assets 文件，何时打包进 section，以及如何避免阻塞渲染。

## 主题商店

- [Shoplazza Theme Store 概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store.md): 在 Shoplazza Theme Store 上销售主题的四个步骤：满足要求、测试主题、提交审核，以及经营你的主题业务。
- [Theme Store 要求](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/requirements.md): 主题要在 Shoplazza Theme Store 上架必须满足的完整清单：独家性、与免费主题的差异、功能、性能与设置规范。
- [提交前测试 theme](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/testing.md): 提交 Shoplazza Theme Store 之前如何测试主题：必需功能、Lighthouse 性能与无障碍、浏览器兼容，以及禁用 JavaScript 的验证。
- [审核流程](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/review-process.md): Shoplazza Theme Store 审核流程是怎么走的，这里是提交主题、撰写上架介绍页与规避常见拒绝原因的入口。
- [提交 theme](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/review-process/submit-theme.md): 通过 Partner Dashboard 把主题提交到 Shoplazza Theme Store，并说明审核团队要求修改时的后续流程。
- [Theme 列表](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/review-process/listing.md): Shoplazza Theme Store 上架介绍页的撰写规范：主题 ZIP 包、审核说明与测试指引、价值主张，以及商家看到的截图。
- [常见 theme 拒绝原因](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/review-process/common-rejections.md): Shoplazza Theme Store 审核团队拒绝主题最常见的原因，以及提交前先修复哪些问题可以降低被拒风险。
- [Theme 成功运营概述](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/success.md): 主题在 Shoplazza Theme Store 获批之后该做什么：避开禁止行为、持续发布更新，以及按规范下架主题。
- [禁止行为](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/success/prohibited-actions.md): 哪些行为会导致主题被 Shoplazza Theme Store 下架，或合作伙伴被移出计划：从不响应商家支持请求到滥用商家数据。
- [更新您的 theme](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/success/updating-your-theme.md): Shoplazza Theme Store 的主题更新流程：提交更新 ZIP、版本号规则、发布说明，以及两次更新之间的最短间隔。
- [下架 theme](https://www.shoplazza.dev/zh-CN/docs/theme/theme-store/success/removing-a-theme.md): 如何在尽量减少商家影响的前提下从 Shoplazza Theme Store 下架主题：该联系谁，以及下架后还需继续支持多久。

## API 与参考

- [Shoplazza Theme 参考概述](https://www.shoplazza.dev/zh-CN/docs/theme/references.md): Shoplazza Theme 参考文档的入口：渲染模板用的 Liquid 语言参考，以及店铺前台交互用的 Ajax API 接口参考。
- [Liquid 概览](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid.md): Shoplazza Theme 中 Liquid 模板语言的总览：什么是模板语言，以及 tags、filters、objects 如何配合渲染店铺前台页面。
- [基础](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/basics.md): 开发 Shoplazza Theme 前要先掌握的 Liquid 基础概念：handles、运算符、数据类型，以及哪些值算真值和假值。
- [Handles](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/basics/handles.md): Liquid 中 handle 如何标识 Shoplazza 店铺资源：handle 怎样由标题生成、遵循哪些规则，以及在主题里如何引用它。
- [运算符](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/basics/liquid-operators.md): Liquid 在条件标签中支持的逻辑运算符与比较运算符，包括 contains 的用法，以及运算符从左到右求值的顺序。
- [类型](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/basics/liquid-types.md): Shoplazza Theme 中 Liquid 输出可返回的六种数据类型，逐一说明各自承载什么内容、在表达式里如何表现。
- [真值与假值](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/basics/true-and-false.md): Shoplazza Theme 中 Liquid 的哪些值是真值、哪些是假值，以及为什么空字符串和 EmptyDrop 仍要用 blank 或 empty 判断。
- [标签](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/tags.md): Liquid tags 如何定义 Shoplazza Theme 模板的逻辑：tag 的写法、带参数的 tag，以及条件、迭代、语法、主题、变量五类标签。
- [条件标签](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/tags/conditional.md): Shoplazza Theme 中的 Liquid 条件标签：if、elsif、else、unless 和 case，以及决定代码块是否执行的条件写法。
- [HTML](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/tags/html.md): Liquid 的 snippet 标签：用带 Shoplazza 特有商品属性的 HTML div 包裹内容，便于店铺前台识别该元素。
- [迭代标签](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/tags/iteration.md): Shoplazza Theme 中的 Liquid 迭代标签：for、break、continue、cycle、tablerow 和 paginate，含 50 次迭代上限和循环对象。
- [语法标签](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/tags/syntax.md): Shoplazza Theme 中的 Liquid 语法标签：comment 阻止表达式被输出，raw 将 Liquid 标记按原文输出。
- [Theme 标签](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/tags/theme-tags.md): Shoplazza Theme 中的 Liquid 主题标签：include、render、section、javascript 和 stylesheet，用于在模板中引入片段、区块与主题资源。
- [Variable 标签](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/tags/variable-tags.md): Shoplazza Theme 中的 Liquid 变量标签：assign、capture、increment 和 decrement，以及变量重名会覆盖 Liquid 对象的注意点。
- [过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters.md): Liquid filters 如何修改 Shoplazza Theme 的输出：filter 写法、传参方式、多个 filter 串联，以及按类别划分的 filter 分组。
- [数组过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/array-filters.md): Shoplazza Theme 的 Liquid 数组过滤器：concat、first、join、last、map、reverse、size、sort、uniq，用于输出前处理数组。
- [Collection 过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/collection.md): Liquid 的 within 过滤器：生成限定在某个专辑内的商品链接，让 Shoplazza Theme 的前台链接保留专辑上下文。
- [颜色过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/color.md): Shoplazza Theme 的 Liquid 颜色过滤器：读取、提亮、加深、混合与转换 CSS 颜色字符串，常用于颜色类主题设置的取值。
- [客户过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/customer.md): Liquid 的 customer_login_link 过滤器：输出让顾客在 Shoplazza 店铺前台登录账号的链接地址。
- [默认过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/default.md): Liquid 的 default 过滤器：当变量为 nil、false 或空值时，为 Shoplazza Theme 提供一个兜底取值。
- [字体过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/font.md): Shoplazza Theme 的 Liquid 字体过滤器：font_face 和 font_url，用于加载字体或为 font_picker 设置产生的 font 对象生成地址。
- [格式过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/format.md): Shoplazza Theme 的 Liquid 格式过滤器：date 格式化日期与 Unix 时间戳，json 序列化取值，weight_with_unit 输出带单位的重量。
- [HTML 过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/html.md): Shoplazza Theme 的 Liquid HTML 过滤器：link_to、script_tag、stylesheet_tag、preload_tag、time_tag 及占位 SVG，用于生成 HTML 元素。
- [托管文件过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/hosted-file.md): Shoplazza Theme 的 Liquid 托管文件过滤器：为 Shoplazza CDN 上的资源生成地址，包括在管理后台上传的文件。
- [本地化过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/localization.md): Liquid 的 t 过滤器：按 key 在主题语言文件中取值，让 Shoplazza 店铺前台按访客语言渲染文案。
- [数学过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/math-filters.md): Shoplazza Theme 的 Liquid 数学过滤器：abs、ceil、floor、round、plus、minus、times、divided_by、modulo，串联时从左到右依次生效。
- [媒体过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/media.md): Shoplazza Theme 的 Liquid 媒体过滤器：img_url 用于生成指定尺寸的图片地址，media_parse 用于解析店铺资源关联的媒体。
- [Metafield 过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/metafield.md): Shoplazza Theme 的 Liquid 元字段过滤器：metafield_tag 把元字段渲染进对应 HTML 元素，metafield_text 以纯文本输出。
- [货币过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/money.md): Shoplazza Theme 的 Liquid 货币过滤器：按 Shoplazza 管理后台配置的货币格式格式化价格，可带或不带货币符号。
- [商品过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/product.md): Shoplazza Theme 的 Liquid 商品过滤器：secondary_image 取商品的第二张图，option_thumbnails 取商品选项的缩略图。
- [字符串过滤器](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/filters/string-filters.md): Shoplazza Theme 的 Liquid 字符串过滤器：append、replace、truncate、handleize、escape、upcase 以及各类哈希等字符串处理。
- [对象](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects.md): Liquid objects 如何把店铺数据提供给 Shoplazza Theme：对象承载什么内容、怎样访问属性，以及各对象在什么场景下可用。
- [address](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/address.md): Shoplazza Theme 中的 address Liquid 对象：表示订单收货地址这类地址，并列出它的全部属性。
- [all_products](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/all_products.md): all_products Liquid 对象：包含 Shoplazza 店铺的全部商品，可按商品 id 取单个商品，未找到时返回空数组。
- [article](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/article.md): Shoplazza Theme 中的 article Liquid 对象：表示博客中的一篇文章，并列出它的全部属性。
- [articles](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/articles.md): articles Liquid 对象：包含 Shoplazza 店铺所有博客下的文章，可按文章 handle 访问其中一篇。
- [block](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/blocks.md): Shoplazza Theme 中的 block Liquid 对象：承载 section block 的内容和 settings，在模板渲染时使用。
- [blog](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/blog.md): Shoplazza Theme 中的 blog Liquid 对象：承载店铺中某个博客的信息，并列出它的全部属性。
- [canonical_url](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/canonical_url.md): canonical_url Liquid 对象：返回 Shoplazza 店铺前台当前页面的规范 URL，用于页面的 SEO 元数据。
- [cart](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/cart.md): Shoplazza Theme 中的 cart Liquid 对象：承载顾客的购物车，含行项目、金额与附加信息，并列出全部属性。
- [collection](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/collection.md): Shoplazza Theme 中的 collection Liquid 对象：表示店铺中的一个 collection，并列出它的全部属性。
- [collections](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/collections.md): collections Liquid 对象：包含 Shoplazza 店铺的所有 collections，主题可遍历它构建列表，也可定位到某一个。
- [content_for_header](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/content_for_header.md): content_for_header Liquid 对象：输出 Shoplazza 所需的全部脚本，必须放在主题 layout 文件的 head 标签内。
- [content_for_layout](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/content_for_layout.md): content_for_layout Liquid 对象：渲染当前 template 的内容，必须放在主题 layout 文件的 body 标签内。
- [customer](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/customer.md): Shoplazza Theme 中的 customer Liquid 对象：承载已登录顾客，未登录时返回 nil，并列出它的全部属性。
- [default_collection](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/default_collection.md): default_collection Liquid 对象：提供默认的 collection 数据，让 Shoplazza Theme 在没有真实数据时也能渲染 collection 版式。
- [default_product](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/default_product.md): default_product Liquid 对象：提供默认的商品数据，让 Shoplazza Theme 在没有真实数据时也能渲染商品版式。
- [discount_application](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/discount_application.md): discount_application Liquid 对象：描述折扣的意图，让 Shoplazza Theme 能展示折扣如何作用于购物车或订单。
- [filter](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/filter.md): filter Liquid 对象：表示 Shoplazza Theme 中的一个店面筛选项，含在专辑页或搜索页渲染它所需的属性。
- [filter_value](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/filter_value.md): filter_value Liquid 对象：表示店面筛选项下的一个可选值，并列出它的全部属性。
- [font](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/font.md): Shoplazza Theme 中的 font Liquid 对象：来自 font_picker 设置，配合字体过滤器加载字体或获取字体变体。
- [forloop](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/forloop.md): forloop Liquid 对象：在 Shoplazza Theme 中暴露所在 for 循环的状态，例如当前序号和是否为最后一次循环。
- [handle](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/handle.md): handle Liquid 对象：返回当前 Shoplazza 模板所关联资源的 handle，仅在本页列出的 templates 中有值。
- [image](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/image.md): Shoplazza Theme 中的 image Liquid 对象：表示商品或 collection 图片，配合 img_url 过滤器在店铺前台展示。
- [images](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/images.md): images Liquid 对象：包含 Shoplazza 店铺中的所有图片，主题可按文件名访问其中一张。
- [ip_address](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/ip_address.md): ip_address Liquid 对象：在 Shoplazza Theme 的订单验证模板中返回访客 IP 对应的国家/地区代码。
- [line_item](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/line_item.md): Shoplazza Theme 中的 line_item Liquid 对象：表示购物车或订单中的一行，对应一个商品 variant，并列出全部属性。
- [link](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/link_item.md): Shoplazza Theme 中的 link Liquid 对象：表示店铺菜单中的一个链接，含渲染导航所需的属性。
- [linklist](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/linklist.md): Shoplazza Theme 中的 linklist Liquid 对象：表示店铺中的一个菜单，以及菜单内包含的链接。
- [linklists](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/linklists.md): linklists Liquid 对象：包含 Shoplazza 店铺的所有菜单，主题可按菜单 id 取到指定菜单。
- [measurement](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/measurement.md): measurement Liquid 对象：承载 dimension、volume、weight 这类元字段返回的计量值与单位。
- [media](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/media.md): media Liquid 对象：Shoplazza Theme 中的抽象媒体对象，可代表视频等挂在店铺资源上的媒体类型。
- [metafield](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/metafield.md): Shoplazza Theme 中的 metafield Liquid 对象，以及如何访问父级对象上的元字段，含对象类型和各数据类型的取值方式。
- [option_thumbnail](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/option_thumbnail.md): option_thumbnail Liquid 对象：表示 Shoplazza Theme 中 option_thumbnails 过滤器返回的一张选项缩略图。
- [order](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/order.md): Shoplazza Theme 中的 order Liquid 对象：承载店铺中的一个订单，并列出它的全部属性。
- [order_allowed_actions](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/order_allowed_actions.md): order_allowed_actions Liquid 对象：告诉 Shoplazza Theme 顾客在当前订单上可以执行哪些操作。
- [order_info](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/order_info.md): order_info Liquid 对象：承载 Shoplazza Theme 中订单的说明性信息，并列出它的全部属性。
- [order_payment_line](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/order_payment_line.md): order_payment_line Liquid 对象：表示 Shoplazza Theme 中订单的一条支付行，并列出它的全部属性。
- [order_shipping_email](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/order_shipping_email.md): order_shipping_email Liquid 对象：在 Shoplazza Theme 的订单验证模板中，订单通过邮箱下单时返回 true。
- [order_shipping_phone](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/order_shipping_phone.md): order_shipping_phone Liquid 对象：在 Shoplazza Theme 的订单验证模板中，订单通过电话下单时返回 true。
- [page](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/page.md): Shoplazza Theme 中的 page Liquid 对象：表示店铺中的一个自定义页面，并列出它的全部属性。
- [page_description](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/page_description.md): page_description Liquid 对象：提供 Shoplazza 店铺前台当前页面的 meta 描述，用于搜索结果和社交预览。
- [page_title](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/page_title.md): page_title Liquid 对象：提供 Shoplazza 店铺前台当前页面的标题，用于搜索结果和社交预览。
- [pages](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/pages.md): pages Liquid 对象：包含 Shoplazza 店铺的所有自定义页面，主题可按页面 id 取到指定页面。
- [paginate](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/paginate.md): paginate Liquid 对象：描述 Shoplazza Theme 中一对 paginate 标签内的分页状态，用于渲染分页导航。
- [part](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/part.md): part Liquid 对象：表示 Shoplazza Theme 分页导航中的一个部分，例如某个页码或省略位。
- [phone_area](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/phone_area.md): phone_area Liquid 对象：在 Shoplazza Theme 的订单验证模板中返回电话区号数据。
- [product](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/product.md): Shoplazza Theme 中的 product Liquid 对象：承载店铺中的一个商品，含 variants、选项、媒体和价格等全部属性。
- [product_option](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/product_option.md): product_option Liquid 对象：表示 Shoplazza Theme 中的商品选项，例如颜色或尺寸，并列出它的全部属性。
- [rating](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/rating.md): rating Liquid 对象：由 Shoplazza Theme 中 rating 类型的元字段返回，通过元字段的 value 属性读取。
- [routes](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/routes.md): routes Liquid 对象：为 Shoplazza Theme 生成店铺前台的标准 URL，让链接在多语言和 URL 格式变化下依然可用。
- [search](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/search.md): Shoplazza Theme 中的 search Liquid 对象：承载店铺前台当前的搜索查询与结果，并列出它的全部属性。
- [section](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/sections.md): Shoplazza Theme 中的 section Liquid 对象：暴露当前正在渲染的 section 的属性、settings 和 blocks。
- [settings](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/settings.md): settings Liquid 对象：让 Shoplazza Theme 访问 settings_schema.json 中定义的所有主题设置，并说明如何引用某个取值。
- [shop](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/shop.md): Shoplazza Theme 中的 shop Liquid 对象：承载店铺级信息，例如店铺地址、商品总数和各项店铺设置。
- [tablerowloop](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/tablerowloop.md): tablerowloop Liquid 对象：在 Shoplazza Theme 中暴露所在 tablerow 循环的状态，例如行号、列号和序号。
- [template](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/template.md): template Liquid 对象：告诉 Shoplazza Theme 当前页面由哪个 template 渲染，并列出它的全部属性。
- [variant](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/variant.md): Shoplazza Theme 中的 variant Liquid 对象：表示商品的一个 variant，含价格、库存、选项取值等全部属性。
- [variant_option](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/variant_option.md): variant_option Liquid 对象：表示 Shoplazza Theme 中商品 variant 的一个选项取值，例如某个具体颜色或尺寸。
- [video](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/video.md): Shoplazza Theme 中的 video Liquid 对象：承载已上传视频的信息，并列出它的全部属性。
- [video_source](https://www.shoplazza.dev/zh-CN/docs/theme/references/liquid/objects/video_source.md): video_source Liquid 对象：描述 Shoplazza Theme 中某个视频的源文件，例如每个文件的格式和地址。
- [Ajax API 概述](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api.md): Shoplazza Ajax API 的总体说明：它能用于哪些前台场景、主题里怎么发起请求，以及为什么接口要使用多语言 URL。
- [购物车](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/cart.md): 购物车相关的 Ajax API 接口：读取购物车，单个或批量加购规格，改行项目数量，移除行项目，选择参与结账的行项目，保存备注。
- [商品](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/product.md): 读取商品数据的 Ajax API 接口：按商品 id 获取商品 JSON、获取最近浏览商品列表，以及获取商品的周期购计划。
- [专辑](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/collection.md): 专辑相关的 Ajax API 接口：分页获取专辑下的商品、按条件筛选专辑商品，以及获取专辑可用的筛选项。
- [搜索](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/search.md): 店铺前台搜索的 Ajax API 接口：按关键词查询商品，用于在访客输入过程中展示预测搜索结果。
- [商品推荐](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/product-recommendations.md): 返回指定商品推荐商品的 Ajax API 接口，主题可据此在商品页渲染相关商品模块。
- [顾客](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/customer.md): 顾客账号相关的 Ajax API 接口：注册、登录登出、重置密码、读取和修改顾客资料、管理收货地址，以及订阅营销邮件。
- [订单](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/order.md): 订单相关的 Ajax API 接口：读取已登录顾客的订单列表与详情、取消订单、确认收货、请求删除订单，以及按运单号查物流。
- [结账](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/checkout.md): 在前台 JavaScript 中开启结账会话的 Ajax API 接口，用于立即购买按钮，以及为未付款订单重新开启支付的去支付按钮。
- [博客](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/blog.md): 读取店铺博客及博客下文章的 Ajax API 接口，匿名访客即可调用，用于在主题中构建博客列表。
- [自定义页](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/page.md): 返回店铺自定义页列表和单个自定义页 HTML 内容的 Ajax API 接口，匿名访客即可调用。
- [导航](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/menu.md): 返回店铺导航菜单列表和单个菜单层级菜单项的 Ajax API 接口，主题可在 JavaScript 中据此渲染导航。
- [元字段](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/metafields.md): 在前台 JavaScript 中按对象 id 读取元字段的 Ajax API 接口，补上页面渲染后 Liquid 取不到值的场景。
- [其他](https://www.shoplazza.dev/zh-CN/docs/theme/references/ajax-api/other.md): 返回前台基础数据的 Ajax API 接口：电话区号、货币、国家/地区与省州、访客所在地、商品优惠券，以及主题语言包。