Asset API

如果你的应用必须编辑 Online Store 1.0 主题代码,你可以在应用内使用主题的 Asset API 将应用集成到主题中。你可以通过 Asset REST Admin API 来读取、添加、更改或删除主题相关的资源文件及内容。

注意

注意:使用 Asset API 集成的方式会导致主题私有化,这也意味着私有化的主题将享受不到官方主题版本升级带来的更新。因此,更加推荐下面的做法:

  • 提供有关这些主题资源的更新代码和详细规范
  • 注意已经集成了应用的主题是否有新版本。参考 Online Store 2.1 主题 获得有关主题版本的信息。当你使用的主题更新时,请确保你的应用程序与新版本兼容。

我们不推荐你使用 Asset API,所以考虑下面的方式:

  • 如果你需要注入内联内容到 OS 2.0 及以上的主题,可以使用主题应用扩展代替。有关替代方法的详细说明,请参考常见资产资源用例的替代方案的替代方法。
  • 如果你需要修改主题的组件及样式,你可以指导商家使用下列的方法来编辑他们的主题:
    • SHOPLINE Admin 主题编辑器中通过下面的方式自定义 HTML
      • 进入在线商店 > 设计
      • 点击设计
      • 点击添加组件并选择自定义HTML
    • 通过主题编辑器的自定义 CSS 来修改内容的样式

常见资产资源用例的替代方案

下表提供了探索常见资产资源用例的备选方案。

使用案例推荐替代方案(其中之一)
加载自定义 JavaScript,为你的应用程序提供额外的功能在线商店主题:App Embed Blocks 或 App Blocks
为你的应用程序加载提供样式的自定义 CSS,例如自定义颜色或字体
向商店添加自定义元数据,例如元描述、关键字或社交媒体标签App Embed Blocks
实现自定义弹出窗口,例如注册表单或促销优惠
自定义搜索结果页面,例如添加自定义搜索结果在线商店主题:App Blocks
添加自定义产品评论,例如客户评级或客户反馈
通过添加附加产品信息来自定义产品详细信息页面
通过添加自定义购物车信息来自定义购物车页面
自定义联系页面,例如添加自定义联系表单或自定义联系信息
注释掉页面详细信息(例如块的标题)以隐藏元素或注入其他值使用 App Embed Blocks 可以添加内容或加载脚本来实现类似的功能
编辑 CSS 类或向现有主题元素添加属性使用 App Embed Blocks 和加载脚本来定位页面的特定元素

使用 App Embed Blocks 并利用现有组件的自定义 CSS 设置

使用 App Embed Blocks 或主题 App Blocks 来提供替代元素,而不是修改主题块
这篇文章对你有帮助吗?

Error loading component.

Error loading component.