Shopify 帮助、手册与政策
从问题和型号找到资料,再连接适用政策、账户与人工服务。
按型号组织可展开 FAQ
问题来自实际兼容、使用、订单或售后任务,答案保留条件和下一步。使用原生 details 可先保证无脚本阅读,再按需要增强分类。
数据与依赖
- custom.faqs:list.metaobject_reference。
- question 为文本,answer 为 rich_text_field,guide 为 page_reference。
交互逻辑
- 键盘和触摸均可展开。
- 无指南时保留答案,不造占位链接。
示例代码 · snippets/ww-faq.liquid
{% assign questions = product.metafields.custom.faqs.value %}
{% if questions != blank %}
<section aria-labelledby="Questions-{{ section.id }}">
<h2 id="Questions-{{ section.id }}">Questions about this model</h2>
{% for question in questions %}
<details>
<summary>{{ question.question.value | escape }}</summary>
<div>{{ question.answer | metafield_tag }}</div>
{% if question.guide.value != blank %}
<a href="{{ question.guide.value.url | escape }}">Read the guide</a>
{% endif %}
</details>
{% endfor %}
</section>
{% endif %}
验收检查
- 初始 HTML 中能找到完整答案。
- 核同型号、地区、版本与关联页面。
FAQ 是可读帮助内容;不要仅为富结果自动制造 FAQPage 或复制不适用条款。
型号索引、操作步骤与手册
手册以型号、版本和语言为索引,关键安装或排障步骤用 HTML;PDF 用于完整下载。商品到手册与手册回商品应有明确关系。
数据与依赖
- Section 的 records 为 ww_manual 类型的 metaobject_list;在编辑器选择可公开且已核验的记录。
- model 必填;aliases/revision/language 为文本,instructions 为富文本,download 为受控 PDF 文件引用,product 为可选商品引用。
交互逻辑
- 每个型号使用原生 details 展开;版本与语言为空时不输出空分隔符。
- 文件缺失保留已核HTML说明与联系入口;不替换其他型号文件。
接入位置与初始化
- 先建立 HANDOFF.md 中的 metaobject 定义并启用 storefront 读取,仅挑选已核记录。
- 把 Section 加到开发主题 JSON 模板;合并三语 locale 叶键,不能覆盖原 locale。
- 帮助模块脚本在 theme.liquid 用 defer 只加载一次;custom element 随 Section 重建连接/断开并清除事件。
示例代码 · sections/ww-manual-index.liquid
<section aria-labelledby="Manuals-{{ section.id }}">
<h2 id="Manuals-{{ section.id }}">{{ 'ww_support.manuals' | t }}</h2>
{% assign valid_count = 0 %}
{% for record in section.settings.records %}
{% assign file = record.download.value %}
{% if record.model.value != blank %}
{% assign valid_count = valid_count | plus: 1 %}
<details><summary>{{ record.model.value | escape }}{% if record.revision.value != blank %} · {{ record.revision.value | escape }}{% endif %}{% if record.language.value != blank %} · {{ record.language.value | escape }}{% endif %}</summary>
{% if record.aliases.value != blank %}<p>{{ record.aliases.value | escape }}</p>{% endif %}
{% if record.instructions.value != blank %}{{ record.instructions | metafield_tag }}{% endif %}
{% if file != blank and file.media_type == 'generic_file' and file.url != blank %}
<a href="{{ file.url | escape }}">{{ 'ww_support.download' | t }}</a>
{% else %}<p>{{ 'ww_support.no_file' | t }}</p>{% endif %}
{% if record.product.value != blank %}<a href="{{ record.product.value.url | escape }}">{{ record.product.value.title | escape }}</a>{% endif %}
</details>
{% endif %}
{% endfor %}
{% if valid_count == 0 %}<p>{{ 'ww_support.empty' | t }}</p>{% endif %}
{% if section.settings.contact != blank %}<a href="{{ section.settings.contact | escape }}">{{ 'ww_support.contact' | t }}</a>{% endif %}
</section>
{% schema %}
{
"name": "WESWOO manual-index",
"settings": [
{
"type": "metaobject_list",
"id": "records",
"label": "Reviewed records",
"metaobject_type": "ww_manual",
"limit": 50
},
{
"type": "url",
"id": "contact",
"label": "Contact page"
}
],
"presets": [
{
"name": "WESWOO manual-index"
}
]
}
{% endschema %}
示例代码 · locales/en.default.json
{
"ww_support": {
"manuals": "Manuals and instructions",
"download": "Open reviewed manual",
"no_file": "Download unavailable; use the instructions or contact us.",
"empty": "No published records available.",
"contact": "Contact support",
"help": "Help resources",
"query": "Model or question",
"search_all": "Search store pages and articles",
"clear": "Clear local filter",
"scope": "The local filter checks only the links listed on this page.",
"no_match": "No local matches. Clear the filter, search the store, or contact support.",
"stores": "Stores",
"open_map": "Open external map (new tab)",
"no_map": "Map unavailable; use the address above.",
"count": "[count] resources in this page index."
}
}示例代码 · locales/zh-CN.json
{
"ww_support": {
"manuals": "手册与操作说明",
"download": "打开已核手册",
"no_file": "下载暂不可用,请阅读说明或联系支持。",
"empty": "暂无已发布记录。",
"contact": "联系支持",
"help": "帮助资源",
"query": "型号或问题",
"search_all": "搜索商店页面与文章",
"clear": "清空本页筛选",
"scope": "本页筛选仅匹配下方列出的链接。",
"no_match": "本页无匹配,请清空筛选、搜索全站或联系支持。",
"stores": "门店",
"open_map": "打开外部地图(新标签页)",
"no_map": "地图暂不可用,请使用上方文字地址。",
"count": "本页目录有 [count] 条匹配资源。"
}
}示例代码 · locales/zh-TW.json
{
"ww_support": {
"manuals": "手冊與操作說明",
"download": "開啟已核手冊",
"no_file": "下載暫不可用,請閱讀說明或聯絡支援。",
"empty": "暫無已發佈記錄。",
"contact": "聯絡支援",
"help": "協助資源",
"query": "型號或問題",
"search_all": "搜尋商店頁面與文章",
"clear": "清空本頁篩選",
"scope": "本頁篩選僅比對下方列出的連結。",
"no_match": "本頁無符合項目,請清空篩選、搜尋全站或聯絡支援。",
"stores": "門市",
"open_map": "開啟外部地圖(新分頁)",
"no_map": "地圖暫不可用,請使用上方文字地址。",
"count": "本頁目錄有 [count] 條符合資源。"
}
}验收检查
- 核文件实际可下载及内容版本。
- 核型号别名、语言和返回商品入口。
- 测试空记录、草稿、缺必填字段、三语、禁用JS与Section重排/删除/重建;目标店尚待验收。
示例字段不自动上传手册;未核实的文件或其他型号说明不能充作当前型号资料。
物流、退换与保修的地区条件
先按地区和实际条款对应摘要与申请入口,再供商品、安心条与帮助页引用。更改地区时重新匹配,空匹配不能套用任意地区的承诺。
数据与依赖
- shop.custom.market_policies:list.metaobject_reference。
- country_code、title、summary 为文本;policy_page 为 page_reference。
- shop.custom.policy_index:page_reference;明确选择已审核且可公开访问的政策索引页。
交互逻辑
- 输出当前国家代码匹配,且具备标题、摘要和正文页面的政策记录。
- 无匹配时显示条款尚未确认;仅在明确配置政策索引后提供链接。
接入位置与初始化
- 先建立并填好 market_policies 与可选 policy_index 字段;以已审核的公开页面为引用目标。
- 把下列三个语言片段的 ww_policy 键合并到主题实际对应的 locale 文件,保留原文件其他键。
- 变更店面国家后重新渲染当前 Section;在目标店铺核对 Metaobject 访问与页面可见性。
示例代码 · snippets/ww-market-policy.liquid
{% assign policies = shop.metafields.custom.market_policies.value %}
{% assign country_code = localization.country.iso_code %}
{% assign matched = false %}
{% for policy in policies %}
{% if policy.country_code.value == country_code and policy.title.value != blank and policy.summary.value != blank and policy.title.value and policy.summary.value and policy.policy_page.value.url and policy.policy_page.value.url != blank %}
{% assign matched = true %}
<section>
<h2>{{ policy.title.value | escape }}</h2>
<p>{{ policy.summary.value | escape }}</p>
{% if policy.policy_page.value != blank %}
<a href="{{ policy.policy_page.value.url | escape }}">{{ 'ww_policy.read_applicable' | t }}</a>
{% endif %}
</section>
{% endif %}
{% endfor %}
{% unless matched %}
<section>
<h2>{{ 'ww_policy.unconfirmed_heading' | t }}</h2>
<p>{{ 'ww_policy.unconfirmed_body' | t }}</p>
{% assign policy_index = shop.metafields.custom.policy_index.value %}
{% if policy_index and policy_index.url and policy_index.url != blank %}
<a href="{{ policy_index.url | escape }}">{{ 'ww_policy.open_index' | t }}</a>
{% endif %}
</section>
{% endunless %}
示例代码 · locales/en.default.json · merge ww_policy keys
{
"ww_policy": {
"read_applicable": "Read the applicable policy",
"unconfirmed_heading": "Regional terms not yet confirmed",
"unconfirmed_body": "Applicable terms for the selected region have not yet been confirmed.",
"open_index": "View policy index"
}
}
示例代码 · locales/zh-CN.json · merge ww_policy keys
{
"ww_policy": {
"read_applicable": "阅读适用政策",
"unconfirmed_heading": "地区条款尚未确认",
"unconfirmed_body": "当前所选地区的适用条款尚未确认。",
"open_index": "查看政策索引"
}
}
示例代码 · locales/zh-TW.json · merge ww_policy keys
{
"ww_policy": {
"read_applicable": "閱讀適用政策",
"unconfirmed_heading": "地區條款尚未確認",
"unconfirmed_body": "目前所選地區的適用條款尚未確認。",
"open_index": "查看政策索引"
}
}
验收检查
- 核条款正文、摘要和申请责任方。
- 核地区切换、退款条件及凭证要求。
按国家匹配只是示例;跨国家 Markets、自定义 B2B 合同和商品例外应按实际业务建模。
Shopify 帮助中心的型号与问题索引
先把型号、说明书、退换保修和联系入口组织成可点击的资源目录,再增强本页筛选。找不到时保留全站帮助搜索与客服路径;本页匹配不应伪装成搜索了整个商店。
数据与依赖
- Section 的 records 选择 ww_help_topic 条目,title 与 destination 必填,models/purpose 提供可读型号、别名与任务词。
- 本页只匹配已输出记录;GET 表单使用 routes.search_url 和 type=page,article。URL 与正文语言由商家维护,contact 是可选入口。
交互逻辑
- JS 筛选只隐藏本页已有资源,并播报数量。
- 无匹配时说明范围,允许清空、全站搜索或联系客服。
接入位置与初始化
- 先建立 HANDOFF.md 中的 metaobject 定义并启用 storefront 读取,仅挑选已核记录。
- 把 Section 加到开发主题 JSON 模板;合并三语 locale 叶键,不能覆盖原 locale。
- 在theme.liquid结束body前仅一次 render ww-support-assets;不要放入每个Section。custom element随Section重建连接/断开并清除事件。
状态、触发与反馈
- 完整目录输入关键词 → 仅匹配当前目录
- 无匹配清空或全站搜索 → 恢复目录或进入实际搜索
- 脚本失败阅读链接列表 → 仍可到达全部已列资源
示例代码 · sections/ww-help-routing.liquid
{% assign valid_count = 0 %}
{% for record in section.settings.records %}
{% if record.title.value != blank and record.destination.value != blank %}
{% assign valid_count = valid_count | plus: 1 %}
{% endif %}
{% endfor %}
<ww-support-index>
<h2>{{ 'ww_support.help' | t }}</h2>
<form action="{{ routes.search_url | escape }}" method="get" role="search">
<label for="HelpQuery-{{ section.id }}">{{ 'ww_support.query' | t }}</label>
<input id="HelpQuery-{{ section.id }}" name="q" type="search" data-query>
<input type="hidden" name="type" value="page,article">
<button type="submit">{{ 'ww_support.search_all' | t }}</button>
<button type="button" data-clear hidden>{{ 'ww_support.clear' | t }}</button>
</form>
<p>{{ 'ww_support.scope' | t }}</p>
<p role="status" aria-live="polite" data-count data-template="{{ 'ww_support.count' | t | escape }}"></p>
<p data-empty{% if valid_count > 0 %} hidden{% endif %}>{{ 'ww_support.no_match' | t }}</p>
<ul>
{% for record in section.settings.records %}
{% assign destination = record.destination.value %}
{% if record.title.value != blank and destination != blank %}
<li data-row data-key="{{ record.title.value | append: ' ' | append: record.models.value | append: ' ' | append: record.purpose.value | escape }}">
<a href="{{ destination | escape }}">{{ record.title.value | escape }}</a>
{% if record.models.value != blank %}<span>{{ record.models.value | escape }}</span>{% endif %}
</li>
{% endif %}
{% endfor %}
</ul>
{% if section.settings.contact != blank %}<a href="{{ section.settings.contact | escape }}">{{ 'ww_support.contact' | t }}</a>{% endif %}
</ww-support-index>
{% schema %}
{
"name": "WESWOO help-routing",
"settings": [
{
"type": "metaobject_list",
"id": "records",
"label": "Reviewed records",
"metaobject_type": "ww_help_topic",
"limit": 50
},
{
"type": "url",
"id": "contact",
"label": "Contact page"
}
],
"presets": [
{
"name": "WESWOO help-routing"
}
]
}
{% endschema %}
示例代码 · locales/en.default.json
{
"ww_support": {
"manuals": "Manuals and instructions",
"download": "Open reviewed manual",
"no_file": "Download unavailable; use the instructions or contact us.",
"empty": "No published records available.",
"contact": "Contact support",
"help": "Help resources",
"query": "Model or question",
"search_all": "Search store pages and articles",
"clear": "Clear local filter",
"scope": "The local filter checks only the links listed on this page.",
"no_match": "No local matches. Clear the filter, search the store, or contact support.",
"stores": "Stores",
"open_map": "Open external map (new tab)",
"no_map": "Map unavailable; use the address above.",
"count": "[count] resources in this page index."
}
}示例代码 · locales/zh-CN.json
{
"ww_support": {
"manuals": "手册与操作说明",
"download": "打开已核手册",
"no_file": "下载暂不可用,请阅读说明或联系支持。",
"empty": "暂无已发布记录。",
"contact": "联系支持",
"help": "帮助资源",
"query": "型号或问题",
"search_all": "搜索商店页面与文章",
"clear": "清空本页筛选",
"scope": "本页筛选仅匹配下方列出的链接。",
"no_match": "本页无匹配,请清空筛选、搜索全站或联系支持。",
"stores": "门店",
"open_map": "打开外部地图(新标签页)",
"no_map": "地图暂不可用,请使用上方文字地址。",
"count": "本页目录有 [count] 条匹配资源。"
}
}示例代码 · locales/zh-TW.json
{
"ww_support": {
"manuals": "手冊與操作說明",
"download": "開啟已核手冊",
"no_file": "下載暫不可用,請閱讀說明或聯絡支援。",
"empty": "暫無已發佈記錄。",
"contact": "聯絡支援",
"help": "協助資源",
"query": "型號或問題",
"search_all": "搜尋商店頁面與文章",
"clear": "清空本頁篩選",
"scope": "本頁篩選僅比對下方列出的連結。",
"no_match": "本頁無符合項目,請清空篩選、搜尋全站或聯絡支援。",
"stores": "門市",
"open_map": "開啟外部地圖(新分頁)",
"no_map": "地圖暫不可用,請使用上方文字地址。",
"count": "本頁目錄有 [count] 條符合資源。"
}
}示例代码 · assets/ww-support-index.js
// Original WESWOO teaching example. Load once with defer from theme.liquid.
if (!customElements.get('ww-support-index')) {
customElements.define('ww-support-index', class extends HTMLElement {
connectedCallback() {
this.controller?.abort();
this.controller = new AbortController();
const input = this.querySelector('[data-query]');
const clear = this.querySelector('[data-clear]');
const empty = this.querySelector('[data-empty]');
const status = this.querySelector('[data-count]');
const rows = [...this.querySelectorAll('[data-row]')];
if (!input || !clear || !empty) return;
const normalize = value => value.normalize('NFKC').trim().toLocaleLowerCase();
const update = () => {
const query = normalize(input.value);
let count = 0;
rows.forEach(row => {
row.hidden = !normalize(row.dataset.key || '').includes(query);
if (!row.hidden) count++;
});
empty.hidden = count !== 0;
if (status) status.textContent = status.dataset.template.replace('[count]', String(count));
clear.hidden = !query;
};
input.addEventListener('input', event => { if (!event.isComposing) update(); }, {signal:this.controller.signal});
input.addEventListener('compositionend', update, {signal:this.controller.signal});
clear.addEventListener('click', () => { input.value=''; update(); input.focus(); }, {signal:this.controller.signal});
update();
}
disconnectedCallback() { this.controller?.abort(); }
});
}
示例代码 · snippets/ww-support-assets.liquid
{% comment %}Render once in layout/theme.liquid before </body>, never inside each Section.{% endcomment %}
<script src="{{ 'ww-support-index.js' | asset_url }}" defer></script>
验收检查
- 按完整型号、问题片段和无匹配词各测试一次。
- 无 JS 仍能读全部目录;每个手册和政策入口实际可用。
- 测试空记录、草稿、缺必填字段、三语、禁用JS与Section重排/删除/重建;目标店尚待验收。
这是一个已策划资源列表的本页匹配器。索引字段需要维护;大型目录应增加真正的分页 / 服务端搜索,不能把有限前端数组称为完整知识库。
账户自助与客服表单
账户入口交给平台实际账户路由,帮助问题通过带标签的原生表单提交。字段错误、服务端成功和人工后续处理是不同状态。
数据与依赖
- routes.account_login_url。
- contact[email]、contact[body] 与表单结果。
交互逻辑
- 只在 posted_successfully? 时显示提交成功。
- 错误保留在表单旁,不模拟工单已解决。
示例代码 · snippets/ww-support-contact.liquid
<a href="{{ routes.account_login_url | escape }}">Open your customer account</a>
{% assign support_form_id = 'Support-' | append: section.id %}
{% form 'contact', id: support_form_id %}
<label for="Email-{{ section.id }}">Email</label>
<input id="Email-{{ section.id }}" name="contact[email]" type="email" autocomplete="email" required>
<label for="Message-{{ section.id }}">Model and question</label>
<textarea id="Message-{{ section.id }}" name="contact[body]" required></textarea>
<button type="submit">Send the question</button>
{% if form.posted_successfully? %}
<p role="status">Your message was submitted.</p>
{% else %}
<div role="alert">{{ form.errors | default_errors }}</div>
{% endif %}
{% endform %}
验收检查
- 用获准测试资料核必填与回执。
- 核账户跳转、新旧账户配置和手机操作。
原生联系表单不是订单权限系统;不让顾客在公开字段提交密码或支付敏感资料。
Shopify 客户账户、登录与订单入口
先确认商店启用的客户账户方式,再使用 Shopify 提供的路由连接登录和订单。返回商店与进入订单列表是两种不同目的,不要用自建密码表单替代当前账户系统。
数据与依赖
- shop.customer_accounts_enabled 决定是否显示账户入口。
- customer 表示当前主题会话中的客户状态;具体账户服务由商店配置负责。
交互逻辑
- 未登录时分别提供订单登录和返回商店的登录入口。
- 已登录显示账户 / 订单及退出;未启用时隐藏入口组。
接入位置与初始化
- 确认实际客户账户设置和需要的返回目的地。
- 把片段放到导航或帮助页,沿用 routes 对象输出链接。
- 使用测试客户人工验收登录与订单;没有保修登记能力就保留政策 / 联系入口。
状态、触发与反馈
- 账户关闭渲染 → 隐藏账户入口
- 未登录选择登录目标 → 进入对应 Shopify 账户路径
- 已登录进入账户 → 打开订单与账户服务
示例代码 · snippets/ww-account-links.liquid
{% if shop.customer_accounts_enabled %}
<nav aria-label="Customer self service">
{% if customer %}
<a href="{{ routes.account_url | escape }}">Orders and account</a>
<a href="{{ routes.account_logout_url | escape }}">Sign out</a>
{% else %}
<a href="{{ routes.account_login_url | escape }}">Sign in to view orders</a>
<a href="{{ routes.storefront_login_url | escape }}">Sign in and return to the store</a>
{% endif %}
</nav>
{% endif %}
验收检查
- 测试未登录、已登录、账户关闭和实际账户方式。
- 完成一次真实登录后核返回位置;自助保修只挂已实现的功能。
示例只提供路由,不接触密码或认证凭证。不要手工拼接 /account/login 来假定账户版本;账户扩展的额外路径需要按官方规则处理已有查询参数。
先理解,再整合,最后验证
- 选择模块,确认数据和输入输出。
- 将片段接入当前主题或框架。
- 用真实变体、市场和失败恢复场景验收。
代码为 Shopify 主题或 Headless 项目的教学实现,说明实际输入、交互与接入边界。先在开发主题中连接已有组件和真实资料,再做商店实测。没有对应的 WESWOO 文章时保留官方依据,不以相似标题凑关联。
架构参考
示例由 WESWOO 编写,结合 Shopify 官方文档和固定版本的仓库参考。采用仓库代码时应保留适用许可。
依据核对 2026-11-17