将应用集成到 OS 3.0 主题中

在 OS 3.0 主题中，您可以通过 App block 或 App embed 两种方式将应用程序集成到商店中。这些集成方式可帮助您自定义应用在前台的展示与功能，打造更灵活、互动性更强的购物体验。

每种方式各有优劣，具体适用情况取决于您的主题结构、应用功能与使用场景。

本指南将帮助您了解 App block 与 App embed 的差异、如何在主题编辑器中设置它们，以及各应用功能支持哪种集成方式。

了解应用集成类型

本部分比较了 App Block 与 App Embed 在功能特性、灵活性以及开发者自定义程度方面的主要差异。

设置 App Block

App Block 允许您将应用提供的功能添加至商店前台的指定区域，例如商品页或首页。您可以通过拖放模块来调整其显示顺序，以匹配页面布局需求。

如何启用 App Block

1. 在 SHOPLINE 后台中，前往在线商店 > 店铺设计。

   

2. 在我的主题标签页中，找到当前主题区块并点击设计。

   

3. 在主题编辑器中，您可以通过以下两种方式添加 App Block：

   方法一：在页面模块下添加 App Block

   1. 点击左侧栏的组件图标，在对应的页面模块下点击添加组件，然后切换至应用标签页，选择您要添加的应用。

      

   2. 所选 App block 将显示在对应的页面模块中，点击保存以套用变更。

      

方法二：在特定板块中添加 App Block

1.  
   1. 导航至您也可以使用更灵活的方式添加 App block。若希望将 App block 添加到特定组件中，可前往目标板块（例如 商品 页面下的 商品信息 模块），点击对应区块右侧的 + 图标，然后切换至应用标签页，选择要添加的 App block。
      

   2. 所选 App block 将显示在指定区块中，点击保存以套用变更。

      

管理未安装 App Block

当您安装或复制的 OS 3.0 主题中包含店铺尚未安装的 App block 时，SHOPLINE 会保留这些区块的配置数据，以确保主题布局完整，并引导您完成设置。

如何恢复缺失的 App Block

如果主题编辑器中的某个 App block 处于禁用状态，并显示错误讯息：「获取应用数据异常，请确认已正常安装/启用 {插件名}」，请按照以下步骤操作：

1. 直接点击该插件区块错误讯息中的 {插件名} 链接。
   
2. 系统将自动跳转到对应插件 SHOPLINE App Store 页面。请完成插件的安装与启用。
3. 返回主题编辑器，该 App block 将自动刷新并恢复正常。

设置 App Embed

App Embed 可启用全站范围内的应用功能，无需将其添加至特定页面模块中。

如何启用 App Embed

1. 在 SHOPLINE 后台中，前往在线商店 > 店铺设计。

   

2. 在我的主题标签页中，找到当前主题区块并点击设计。

   

3. 在主题编辑器中，点击左侧栏的 App Embed 图标。启用您需要的应用功能，并点击保存应用更改。

   

应用功能列表支持的集成方式

以功能维度列出在主题编辑器中支持的所有应用功能及其适用的集成方式（App Block 或 App Embed）。