跳到主要内容

更新您的 theme

在 Theme Store 上首次发布 theme 后,您开始进入迭代流程:考虑商家反馈,通过定期质量保证测试持续改进构建,并积极整合 Shoplazza 要求的更新。

作为 Shoplazza Theme Partner,您需要持续为 theme 提供更新,以留在 Shoplazza Theme Store 上。

以下部分介绍 theme 更新流程和更新类型。

Theme 更新流程

您可以通过 Partner 控制台将更新以 ZIP 文件形式提交审核。每次更新应根据更新内容确定版本号发行说明

商家将在在线商店 > Themes 页面看到通知,告知他们可以更新 theme。商家可以将更新应用到 theme 的未发布副本,以便在发布之前进行审核。

为避免给商家造成更新疲劳,更新之间应至少间隔 4 周。

📘 注意

每个 theme 只有一个 Theme Store 列表,即最新版本。这意味着所有评价都将显示在同一列表中,无论评价提交时对应哪个 theme 版本。这也意味着您不能为不同 theme 版本收取不同价格。

更新成功审核和发布后,您将收到自动通知邮件。

新版本的注意事项

创建新版本时,请考虑以下内容及其对商家的影响:

  • 如果您修改了现有 setting 使得商家的当前值不再有效,商家的值将重置为新版本中指定的默认值。为了减少对现有商家的影响,应尽可能保持相同的默认 settings。

  • 如果您更改了 setting 的 ID,当前 theme 中的 setting 将被视为已删除,新 setting 将以默认值添加。这会带来较差的商家体验,应尽量避免。

  • 如果您更改了 setting 的类型,商家当前的 setting 值可能会失效并重置为默认值。

版本控制

Theme 版本帮助商家轻松识别他们拥有的 theme,以便确定哪些功能可用,或是否有更新版本可以更新。

构建版本字符串时,应使用 X.Y.Z 格式的语义化版本

组件

说明

X

表示引入或修改非向后兼容功能的主要版本,例如:

  • 修改 setting 的值。
  • 删除 setting、section 或 block。
  • 添加全局 setting。

例如,从 1.4.8 升级到 2.0.0

发布主要版本时,商家将在在线商店 > Themes 页面看到通知,告知他们可以将更新应用到 theme 的未发布副本以进行审核和发布。

Y

表示引入或修改向后兼容功能的次要版本,例如:

  • 修改现有 setting 的标签或默认值。
  • 添加 section 或 block。
  • 在不更改 setting schema 的情况下更改现有 section 或 block 的视觉设计或功能。

例如,从 1.4.8 升级到 1.5.0

发布次要版本时,商家将在在线商店 > Themes 页面看到通知,告知他们可以将更新应用到 theme 的未发布副本以进行审核和发布。

Z

表示修复 bug 或安全问题,或进行非视觉性代码改进的维护版本。

例如,从 1.4.8 升级到 1.4.9

发布维护版本时,商家将在在线商店 > Themes 页面看到通知,告知他们可以将更新应用到 theme 的未发布副本以进行审核和发布。

theme 版本可以通过 theme metadata 包含在 theme 中。

发行说明

每个 theme 版本都需要有发行说明,突出显示该版本的主要功能。

发行说明的主要受众是商家,因此您使用的语言应反映这一点。发行说明不是变更日志,而是会影响商家或其买家的精选内容列表。因此,应包含所有面向用户的变更,应排除面向开发者的变更。您还应只包含与当前发布相关的信息。

在 theme 中包含发行说明

要在 theme 中包含发行说明,请在 theme ZIP 根目录中创建一个名为 release-notes.md 的 Markdown 文件。文件内容应包含以下组件:

组件

说明

描述

对此版本最重要变更的简要描述。

变更列表

版本中包含的变更列表。变更可以归入以下标题之一:

  • Added(新增)
  • Changed(变更)
  • Removed(移除)
  • Security(安全)
  • Other fixes and improvements(其他修复和改进)

变更应以项目符号列在各自的标题下。每个标题应作为 H3,因此需要以 ### 开头。例如,### Added。

如果有特定变更需要特别关注,可以在变更前加上 Important:。例如:

  • Important: This is an important change.

渲染发行说明时,这些重要变更将以视觉方式突出显示。

示例:

我们新增了为顾客添加支付选项的功能,移除了 Instagram section,并更改了社交媒体 section 的工作方式。

### Added

- Important: 新增搜索分面筛选
- 在购物车通知中新增销售计划

### Changed

- Important: 将默认社交媒体分享图片更改为来自商店管理后台的图片。您可以添加默认图片,在无法找到页面特色图片时使用。

### Removed

- 由于 API 已被弃用且没有合适的替代方案,移除了 Instagram section。今后您需要改用 App 来显示 Instagram 动态。

### Security

- 修复了安全问题

### Fixes and other improvements

- 合集页面侧边栏现在与工具栏对齐
- 修复了顾客登录页面的"忘记密码"链接

紧急更新

紧急更新是商家立即需要的 theme 更新,以确保业务不中断。通常,只有解决购买流程问题的更新才被视为紧急。购买流程是顾客进行购买时的完整过程,从商品页面开始,通过快速结账按钮继续,或从购物车通过结账行动号召或快速结账按钮继续到结账。

如果您认为某个重要更新不影响购买流程,可以在提交更新之前咨询 Theme Partner 经理。