了解 3.0 主题手动升级的影响范围
SHOPLINE 官方主题会持续更新并发布新版本。如果您的店铺使用的是修改过代码的 SHOPLINE 官方主题或第三方开发者主题，需要手动升级才能使用最新功能。手动升级会以新版本主题的内容为准，您自行添加的文件和部分修改不会保留。例如，您在主题代码中添加的自定义样式文件，升级后需要重新添加。本文说明哪些主题需要手动升级、如何升级，以及升级后哪些内容会保留、哪些会被清除。
适用手动升级的 3.0 主题类型
以下 2 类 3.0 主题在发布新版本后，需要由您手动升级：
- 修改过代码的 SHOPLINE 官方主题：您在 SHOPLINE 官方主题的基础上修改过主题代码。
- 第三方开发者主题：由第三方开发者提供的主题。
|
备注：
|
手动升级 3.0 主题的操作步骤
当主题有新版本时，店铺设计 页面会显示升级提示。要手动升级主题：
- 进入 在线商店 > 店铺设计。
- 在当前主题的升级提示（例如「可升级到最新版本 Fashion 0.2.44」）中，点击 查看详情。
- 在弹窗中确认当前版本和最新版本，然后点击 立即升级。
系统会生成一个最新版本的主题副本。预览并确认副本没有问题后，再发布该主题。
恢复为升级前的 3.0 主题
升级不会删除原本的主题。如果发布新主题后发现问题，只需重新发布原本的主题即可。要恢复为升级前的主题：
- 进入 在线商店 > 店铺设计。
- 在 主题库 中找到原本的主题。
- 重新发布该主题。
手动升级 3.0 主题后会保留的内容
手动升级时，系统只会保留以下 3 类内容：
- templates 文件夹中的 .json 文件：页面模板的内容和版面设置，包括您新增的 .json 模板。
- sections 文件夹中的 .json 文件：各组件的内容和设置，包括您新增的 .json 文件。
- theme.config.json 文件：您为主题设置的配置内容。
| 备注： 除上述 3 类保留内容外，您自行添加或修改的其他文件都会被清除，并以新版本主题的内容为准。 |
手动升级 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 | 您当前的内容会完整保留。 |
手动升级对 3.0 主题多语言内容的影响
3.0 主题的多语言文字可以通过以下 3 个入口修改。手动升级后的结果如下：
- 编辑语言：在 主题 > 更多 > 编辑语言 中的修改不会保留，以新版本主题的语言内容为准。
- 编辑代码中的 i18n 文件：在 主题 > 更多 > 编辑代码 的 i18n 文件夹中修改或新增的内容都会被清除。
- UGC 多语言可视化翻译插件：通过该插件设置的多语言内容不受影响，会完整保留。
手动升级后 3.0 主题的类型与后续升级方式
手动升级完成后，主题类型和之后的升级方式如下：
- 修改过代码的 SHOPLINE 官方主题：升级后会恢复为 SHOPLINE 官方主题。之后有新版本时，系统会自动升级，并保留您所有主题内容。
- 第三方开发者主题：升级后主题类型不变。之后有新版本时，仍需手动升级。
常见问题
为什么手动升级主题后，原本添加的 Section Gallery 组件无法使用？
手动升级会清除 Section Gallery 添加到主题中的文件，因此组件暂时无法使用。您只需将 Section Gallery 组件重新添加到主题中，即可恢复使用。原本在 Section Gallery 中设置的内容会保留，无需重新设置。