跳到主要内容

FAQ 与排错

最常被问到的问题的快速解答。

安装与设置​

Vertex 是否需要 Shopify Plus 或 Advanced 套餐?​

不需要。 Vertex 可安装在每个 Shopify 套餐上。然而,原生 B2B 功能(公司、B2B 目录、NET 条件、免税、多地址)需要 Shopify Plus 或带 B2B 附加组件的 Advanced。没有这些时,Vertex 仍可作为精致的 B2C 工业用品主题运行 — 每一项 B2B 功能都会优雅降级。

我是否需要配套应用?​

不需要。 Vertex 端到端使用 Shopify 原生 B2B 功能。无需报价管理应用、批发定价应用、多币种应用或对比应用。

完整安装需要多长时间?​

  • 基础安装(仅主题):5 分钟
  • 完整 B2B 安装(主题 + 原生 B2B + 公司 + 目录 + metafield):首次 45–60 分钟。后续每家公司 5 分钟。

我可以先在开发店铺上使用 Vertex 吗?​

可以。 在任何开发店铺上安装 Vertex 并进行定制,不影响线上店铺。准备好后再发布。

B2B 元素可见性​

为什么琥珀色 B2B 问候栏没有出现?​

按可能性排序:

  1. 你未以 B2B 客户身份登录。 仅当 customer.b2b? 为 true 且 customer.current_company 已设置时才会渲染。
  2. Storefront mode 被设置为 B2C-only。 打开 Theme settings ▸ B2B ▸ Storefront mode 并切换到 Hybrid (auto) 或 B2B-only。
  3. Shopify 后台未启用原生 B2B。 前往 Settings ▸ Customer accounts ▸ B2B ▸ Manage ▸ Enable B2B。
  4. 买家的公司已被删除或撤销。 当 customer.current_company 在会话中变为 nil 时,Vertex 防御性地跳过该栏。

为什么销售代表胶囊没有出现在页头中?​

仅当三个条件全部为真时,代表胶囊才会渲染:

  1. 买家以 B2B 身份登录(customer.b2b? == true)
  2. 买家的公司设置了 vertex.rep_name metafield
  3. Storefront mode 不是 B2C-only

请在 Customers ▸ Companies ▸ [公司名称] ▸ Metafields 中核实 vertex.rep_name 已填充。

为什么 PDP 上没有显示批量定价层级?​

Vertex 从 Shopify 原生 quantity_price_breaks 读取批量层级。仅当满足以下条件时,PDP 上的批量表才会渲染:

  1. 买家登录到某家公司
  2. 该公司被分配到某个 B2B 目录
  3. 该目录的价格列表为该产品包含基于数量的定价层级

如果表为空,请仔细检查 B2B ▸ Catalogs ▸ [目录名称] ▸ Price list 中的价格列表。

为什么我的 B2B 买家即使登录后仍看到"登录查看价格"?​

Theme settings ▸ B2B ▸ Hide prices until customer logs in 切换处于开启状态。此功能仅对访客隐藏价格。已登录客户(B2C 或 B2B)应始终能看到价格。如果他们看不到,关闭该设置并保存。

为什么即便我以 B2B 身份登录,店铺仍像"B2C"?​

可能原因:

  1. Storefront mode 被设置为 B2C-only。 将其更改为 Hybrid 或 B2B-only。
  2. 该客户记录未关联到公司。 打开 Customers ▸ [客户名称] 并确认他们在 Companies 选项卡下关联到了公司。

定制​

如何更改品牌颜色?​

  1. 打开 Theme settings ▸ Colors
  2. 选择 Starter color palette 实现一键重新着色,或选择 Custom 并单独覆盖每个颜色

如何添加自定义字体?​

Theme settings ▸ Typography 下的字体选择器使用 Shopify 的字体库。要使用其外的字体,在 theme.liquid 中添加 <link> 并更新 --font-body / --font-heading CSS 自定义属性。

  1. 打开主题编辑器并在 sections 面板中点击 Header
  2. 点击 Logo image 上传你的文件
  3. 推荐高度:~40 px;首选 SVG

如何自定义公告栏文字?​

  1. 在主题编辑器中打开 Header group ▸ Announcement bar
  2. 编辑 Text 字段
  3. 该栏内置可关闭的 ×,会遵循 localStorage

如何添加/编辑次级导航(特别优惠 / 指南 / 服务 / FAQ)?​

  1. 前往 Online Store ▸ Navigation
  2. 创建一个 handle 为 secondary-menu 的新菜单(Vertex 会自动检测)
  3. 添加链接 — 它们会在桌面端页头中以右对齐方式显示

如何在 4 个演示店铺之间切换(Vertex / Throttle / OfficeIT / Inkline)?​

两种方式:

  1. 永久重新着色 — Theme settings ▸ Colors ▸ Starter color palette — 选择 4 个预设之一
  2. 临时预览 — 在你店铺的任何 URL 后附加 ?view=throttle(或 officeit / printsupply)

→ 详情请参阅 演示预设指南。

性能​

Vertex 店铺的 Lighthouse 分数是多少?​

在展示演示上记录:

  • 移动端性能: 65–100(取决于页面类型)
  • 桌面端性能: 每个页面 90+
  • 可访问性: 92–95
  • 最佳实践: 95+
  • SEO: 100

如何进一步提升 Lighthouse 性能?​

  1. 优化 hero 图片。 使用多宽度的 WebP;目标每张幻灯片低于 300 KB。
  2. 将 hero 限制为 1 张幻灯片。 多幻灯片 hero 旋转器会消耗 LCP。默认仅 1 张幻灯片。
  3. 限制 Shopify app embeds。 每个第三方应用都会注入 JS — 每个都会增加 TBT。

为什么我的移动端性能低于桌面端性能?​

这是 Shopify 主题的常态 — Lighthouse 中移动端被节流(更慢的 CPU + 更慢的网络)。真实的 iPhone 14 / Galaxy S22 用户得到的分数远好于 Lighthouse 数字。

可访问性与国际化​

Vertex 是否符合 WCAG 2.1 AA?​

是的。 键盘导航、可见焦点、最低 4.5:1 对比度、移动端 24 px 触控目标、正确的 ARIA 角色、跳至内容链接、带标签的表单输入。

Vertex 预装哪些语言?​

5 种:英语(默认)、法语、意大利语、德语、西班牙语。UI 字符串 + schema 标签都已翻译。

Vertex 支持 RTL 语言吗?​

支持 — 完整支持。<html dir> 会自动为阿拉伯语、希伯来语、波斯语、乌尔都语、意第绪语、库尔德语、迪维希语和普什图语翻转。CSS 使用逻辑属性,因此布局可干净镜像。

我可以添加另一种语言吗?​

可以。 将 locales/en.default.json 翻译为你的目标语言,保存为 locales/{code}.json。Schema 标签位于 locales/en.default.schema.json — 翻译到 locales/{code}.schema.json 以同时本地化编辑器 UI。

Metafield 与产品数据​

Vertex 使用哪些 metafield?​

在 vertex 命名空间中:

  • vertex.mpn(产品)— 制造商零件号,索引在预测搜索中
  • vertex.ships_from(产品)— 每个产品的发货城市
  • vertex.price_history(产品)— {date, price} 条目的 JSON 列表
  • vertex.datasheet、vertex.msds、vertex.brochure、vertex.tech_sheet、vertex.install_guide、vertex.warranty(产品)— PDF 文件选择器
  • vertex.rep_name、vertex.rep_email、vertex.rep_phone(公司)— 每家公司的销售代表
  • vertex.payment_terms(公司)— NET 条件徽章标签的覆盖

外加用于技术规格表的 vertex.tech_specs(产品)— 一个带 label / value / 可选 unit 的「spec」条目列表(不是 metaobject)。

→ 完整参考:Metafield 设置指南。

如果 metafield 缺失会怎样?​

对应的 PDP 块会自动隐藏。Vertex 对缺失的 metafield 是防御性的 — 空值永远不会渲染为损坏的 UI。

定价与许可​

Vertex 多少钱?​

$399 美元 单店铺许可。包含所有 v1.x 发行版的免费更新。

我可以将一份 Vertex 许可用于多个店铺吗?​

不可以 — 标准 Theme Store 许可是单店铺的。如需多店铺许可,请通过 Theme Store 支持门户提交工单。

Vertex 会收到更新吗?​

会。 v1.x 发行版包括 bug 修复、性能改进和新区块。请参阅更新日志。

常见错误与修复​

"Theme Check 在我的定制版本上显示 18 个警告"​

你可能编辑了 Liquid 模板并引入了未使用的变量或硬编码路由。在本地运行 shopify theme check 查看详情。Vertex 自身发布时零 Theme Check 违规。

"我的自定义 CSS 被覆盖了"​

Vertex 的逐区块 CSS 文件比通用样式表具有更高的特异性。通过以下方式添加覆盖:

  1. Theme settings ▸ Colors ▸ Custom(首选 — 大多数内容由 CSS 变量驱动)
  2. 在现有规则之后于 assets/vertex.css 中添加自定义 CSS
  3. 使用 !important 的新 assets/custom-overrides.css(最后手段)

仍然卡住?​