Skip to main content

概述

此设置有两个作用:
  1. 对 Shopify Ajax 购物车调用进行排队。 当多个脚本同时调用 Shopify 的 Ajax 购物车 API(/cart/add/cart/add.js/cart/update.js/cart/change.js)时,Shopify 有时会丢失其中一个更改。Upcart 会强制这些调用逐个执行,确保每次更新都能生效。这是该设置的主要用途。
  2. 退出加入购物车流程的管理。 它还会禁用 Upcart 内置的加入购物车处理,这样需要完全控制该流程的应用或主题就不会与其冲突。
这两种行为绑定在同一个复选框上——你无法在启用请求排队的同时保留 Upcart 的加入购物车处理。

在哪里找到它

打开购物车编辑器,前往 Settings > Cart settings,然后展开 Advanced Settings
找到 “Enhanced Ajax API compatibility”

工作原理

Upcart 保持对加入购物车流程的完全控制。这可以确保行为一致,并允许 Upcart 阻止其他应用或脚本覆盖购物车流程。 这是大多数商店的推荐设置。除非你遇到 Upcart 无法拦截来自主题或其他应用的加入购物车事件等特定问题,否则请保持禁用。

启用

Upcart 将不再管理加入购物车流程。这允许其他应用、自定义 JavaScript 或你的主题在不受干扰的情况下修改购物车。 仅在以下情况下启用此设置:
  • 你的商店使用非标准的 AJAX 购物车 API
  • Upcart 无法拦截来自你的主题或其他应用的加入购物车事件
  • 你需要第三方应用直接控制购物车行为
启用后的重要权衡:
  • 其他应用可能会将顾客重定向到 Shopify 购物车页面,而不是打开 Upcart 抽屉
  • 你可能会遇到重定向循环或意外的购物车行为
  • Upcart 无法阻止外部应用更改购物车行为
如果启用后导致重定向循环:
  1. 禁用此设置
  2. 改用手动的 Upcart API(upcartRegisterAddToCart
  3. 参阅特定应用的集成指南(例如 Replo

测试

更改此设置后:
  1. 点击 Save
  2. 测试向购物车添加商品
  3. 验证 Upcart 抽屉能正确打开
  4. 检查你没有被重定向到 Shopify 购物车页面
如果启用后出现问题,请禁用该设置并联系支持团队获取替代方案。