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 来修改内容的样式
- 在 SHOPLINE Admin 主题编辑器中通过下面的方式自定义 HTML
常见资产资源用例的替代方案
下表提供了探索常见资产资源用例的备选方案。
使用案例 | 推荐替代方案(其中之一) |
---|---|
加载自定义 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.