Start Strong
Sell Smart
Manage with Ease
Market to Success

了解 OS 3.0 主题手动升级的影响范围

SHOPLINE 官方主题会持续更新并发布新版本。如果您的店铺使用的是修改过代码的 SHOPLINE 官方主题或第三方开发者主题，需要手动升级才能使用最新功能。手动升级会以新版本主题的内容为准，您自行添加的文件和部分修改不会保留。例如，您在主题代码中添加的自定义样式文件，升级后需要重新添加。本文说明哪些主题需要手动升级、如何升级，以及升级后哪些内容会保留、哪些会被清除。

 

 

适用手动升级的 OS 3.0 主题类型

以下 2 类 OS 3.0 主题在发布新版本后，需要由您手动升级：

  • 修改过代码的 SHOPLINE 官方主题：您在 SHOPLINE 官方主题的基础上修改过主题代码。
  • 第三方开发者主题：由第三方开发者提供的主题。

注意：

  • 未修改代码的 SHOPLINE 官方主题由系统自动升级，您无需手动操作。
  • 您自行上传的主题包不支持升级。

 

 

手动升级 OS 3.0 主题的操作步骤

当主题有新版本时，店铺设计 页面会显示升级提示。要手动升级主题：

  1. 进入 在线商店 > 店铺设计。
  2. 在当前主题的升级提示（例如「可升级到最新版本 Fashion 0.2.44」）中，点击 查看详情。
  3. 在弹窗中确认当前版本和最新版本，然后点击 立即升级。

系统会生成一个最新版本的主题副本。预览并确认副本没有问题后，再发布该主题。

 

 

恢复为升级前的 OS 3.0 主题

升级不会删除原本的主题。如果发布新主题后发现问题，只需重新发布原本的主题即可。要恢复为升级前的主题：

  1. 进入 在线商店 > 店铺设计。
  2. 在 主题库 中找到原本的主题。
  3. 重新发布该主题。

 

 

手动升级 OS 3.0 主题后会保留的内容

手动升级时，系统只会保留以下 3 类内容：

  • templates 文件夹中的 .json 文件：页面模板的内容和版面设置，包括您新增的 .json 模板。
  • sections 文件夹中的 .json 文件：各组件的内容和设置，包括您新增的 .json 文件。
  • theme.config.json 文件：您为主题设置的配置内容。
注意： 除上述 3 类保留内容外，您自行添加或修改的其他文件都会被清除，并以新版本主题的内容为准。

 

 

手动升级 OS 3.0 主题后会被清除或覆盖的内容

要查看以下文件，请进入 在线商店 > 店铺设计 > 编辑代码。各文件夹和文件在手动升级后的结果如下：

文件夹或文件 手动升级后的结果
layout 您在原有 .html 文件中新增的内容会被新版本覆盖，您新增的 .html 文件会被清除。
templates 您在原有 .html 文件中新增的内容会被新版本覆盖，.json 文件会保留。
sections 您在原有 .html 文件中新增的内容会被新版本覆盖，您新增的 .html 文件会被清除，.json 文件会保留。
blocks 您在原有文件中新增的内容会被新版本覆盖，您新增的所有文件（包括 CSS、JS、HTML、JSON、图片、视频和字体）会被清除。
components 您在原有文件中新增的内容会被新版本覆盖，您新增的所有文件（包括 CSS、JS、HTML、JSON、图片、视频和字体）会被清除。
public 您在原有文件中新增的内容会被新版本覆盖，您新增的所有文件（包括 CSS、JS、HTML、JSON、图片、视频和字体）会被清除。
i18n 会被新版本的语言文件完整覆盖。
theme.schema.json 您的修改会被清除。
theme.config.json 您当前的内容会完整保留。

 

 

手动升级对 OS 3.0 主题多语言内容的影响

OS 3.0 主题的多语言文字可以通过以下 3 个入口修改。手动升级后的结果如下：

  • 编辑语言：在 主题 > 更多 > 编辑语言 中的修改不会保留，以新版本主题的语言内容为准。
  • 编辑代码中的 i18n 文件：在 主题 > 更多 > 编辑代码 的 i18n 文件夹中修改或新增的内容都会被清除。
  • UGC 多语言可视化翻译插件：通过该插件设置的多语言内容不受影响，会完整保留。

 

 

手动升级后 OS 3.0 主题的类型与后续升级方式

手动升级完成后，主题类型和之后的升级方式如下：

  • 修改过代码的 SHOPLINE 官方主题：升级后会恢复为 SHOPLINE 官方主题。之后有新版本时，系统会自动升级，并保留您所有主题内容。
  • 第三方开发者主题：升级后主题类型不变。之后有新版本时，仍需手动升级。

 

 

常见问题

为什么手动升级主题后，原本添加的 Section Gallery 组件无法使用？

手动升级会清除 Section Gallery 添加到主题中的文件，因此组件暂时无法使用。您只需将 Section Gallery 组件重新添加到主题中，即可恢复使用。原本在 Section Gallery 中设置的内容会保留，无需重新设置。