> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在主题中更改购物车类型

> 本文介绍如何通过修改主题的购物车类型设置来排查 Upcart 抽屉问题。

<div id="overview">
  ## 概述
</div>

本指南帮助你排查 **Upcart 无法打开**，或客户被重定向到购物车页面而看不到 Upcart 抽屉的情况。大多数此类问题是由主题购物车类型设置、Enhanced AJAX API Compatibility 配置、第三方应用重定向或 checkout 按钮路由引起的。

<Note>
  如果 Upcart 完全无法打开或重定向到购物车页面，请参阅[排查 Upcart 无法打开或重定向到购物车页面的问题](/zh/upcart/troubleshooting_upcart_not_opening_or_redirecting)获取更全面的排查指南。
</Note>

***

<div id="what-cart-type-to-choose">
  ## 应选择哪种购物车类型
</div>

在深入排查之前，请先检查主题的购物车类型设置，因为这是最常见的原因。

* **Page**——这通常是最佳选项，因为 Upcart 会拦截对 **/cart** 页面的请求。
* **Drawer**——如果 Upcart 无法启动且 **/cart** 页面被触发，请选择此项。
* **Confirmation Popup**——如果你的主题支持此选项且其他选项无法解决问题，可使用此项。

测试这两个选项只需几分钟，但 **Page** 通常是最有效的选择。

<div id="how-to-change-cart-type-in-your-theme">
  ### 如何在主题中更改购物车类型
</div>

1. 在 Shopify 管理后台前往 **Online Store > Themes > Customize**。
2. 打开 **Theme Settings > Cart > Cart Type**。
3. 根据你要排查的行为，选择 **Page** 或 **Drawer**。
4. 保存更改并在店面上测试购物车。

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-type-theme-editor-settings-option.gif?s=81eef4e6af5190720b3eb86be578c605" alt="Shopify 主题编辑器购物车设置中显示购物车类型选项" width="644" height="1080" data-path="images/upcart/cart-type-theme-editor-settings-option.gif" />

<Note>
  如果你找不到此设置，请联系你的主题开发者。此设置由你的主题控制，Upcart 无法直接修改。
</Note>

***

<div id="troubleshooting-steps">
  ## 排查步骤
</div>

如果更改购物车类型无法解决问题，请按顺序执行以下步骤。

<div id="1-check-enhanced-ajax-api-compatibility">
  ### 1. 检查 Enhanced AJAX API Compatibility
</div>

此设置控制 Upcart 处理 Add to Cart 事件的方式，是重定向问题最常见的原因之一。

1. 前往 **Upcart > Cart Editor > Settings > Cart settings**，然后展开 **Advanced Settings**。
2. 找到 **Enhanced Ajax API compatibility**。
3. 对于大多数商店，此设置**默认禁用**。禁用时，Upcart 会拦截 Add to Cart 调用并防止重定向。
4. 如果它已启用，其他应用可以接管购物车行为并将客户重定向到购物车页面。请尝试禁用并测试。
5. 如果禁用后引发其他问题，请重新启用，并改用手动 Upcart API（`upcartRegisterAddToCart`）。

有关此设置的完整指南，请参阅 [Enhanced AJAX API Compatibility](/zh/upcart/enhanced_ajax_api_compatibility)。

<div id="2-check-for-third-party-app-redirects">
  ### 2. 检查第三方应用重定向
</div>

许多第三方应用会覆盖购物车行为，并可能将客户重定向离开 Upcart 抽屉。如果你的 Add to Cart 按钮明确将客户带到购物车页面，请参阅[为什么"Add to Cart"跳转到购物车页面而不是 Upcart？](/zh/upcart/why_does_add_to_cart_go_to_the_cart_page_instead_of_upcart)了解更多详情。

打开任何与购物车相关的应用的设置，查找类似以下的选项：

* Redirect to cart
* Go to cart after add
* Automatically open cart page
* Action after product is added

将这些选项改为 **Stay on page** 或 **Do nothing**。

**常见的应用专属修复方法：**

* **PageFly**——在 PageFly 应用设置中禁用重定向规则。
* **Globo Product Options**——停用自动重定向到 Shopify 购物车。
* **Replo**——调整 "go to page" 设置以启用 cart drawer。
* **Zepto Product Personalizer**——前往 Zepto > Settings > Add to Cart Settings，将 "Action after a product is added to the cart" 改为 "Stay on the product page and show a success message"。

如果不确定是哪个应用导致冲突，请逐个禁用与购物车相关的应用，并在每次禁用后进行测试，直到 Upcart 恢复正常工作。

<div id="3-check-checkout-button-routing">
  ### 3. 检查 checkout 按钮路由
</div>

如果客户点击 Upcart 内的 checkout 按钮后被重定向到购物车页面而不是 checkout：

1. 前往 **Upcart > Cart Editor > Settings > Cart settings**。
2. 找到 **"Go to cart page when pressing checkout button"**。
3. 将其**关闭**。
4. 保存并测试。

<Note>
  自定义 checkout 页面重定向需要高级编码，Upcart 不直接支持。如果你需要将客户引导到自定义 checkout 页面，需要与开发者合作。
</Note>

<div id="4-check-theme-cart-redirect-settings">
  ### 4. 检查主题购物车重定向设置
</div>

某些主题会在添加商品后自动重定向客户，完全绕过 Upcart。

1. 前往 **Online Store > Themes > Customize**。
2. 打开 **Theme Settings > Products**（或 Cart）。
3. 查找类似以下的设置：
   * Enable cart redirection
   * Redirect to cart after add
   * Go to cart after add
4. 将这些**关闭**。
5. 保存并测试。

<div id="5-clear-browser-cache">
  ### 5. 清除浏览器缓存
</div>

旧的缓存脚本可能保留之前的购物车行为，导致 Upcart 无法正确加载。

1. 打开浏览器设置。
2. 前往 **Privacy and Security**。
3. 选择 **Clear Browsing Data**。
4. 清除缓存的图片、文件和 Cookie。
5. 刷新你的商店并测试。

<div id="6-test-with-a-default-shopify-theme">
  ### 6. 使用默认 Shopify 主题测试
</div>

如果问题仍然存在，请暂时切换到默认 Shopify 主题（如 Dawn），以排除主题特有的冲突。

1. 前往 **Shopify Admin > Online Store > Themes**。
2. 添加并启用免费主题（如 Dawn）。
3. 在默认主题上测试 Upcart。

如果 Upcart 在 Dawn 上正常工作，则问题出在你的自定义主题上。请联系你的主题开发者寻求帮助。

***

<div id="preventative-measures">
  ## 预防措施
</div>

* **更新后检查配置**——主题和应用更新可能会重置或覆盖购物车设置。任何重大更新后，请检查你的购物车类型和应用配置。
* **安装前测试应用兼容性**——添加新的第三方应用之前，请确认它们与 Upcart 兼容。
* **使用草稿主题进行测试**——在发布前先在草稿主题上测试更改，以避免影响正在运行的商店。有关说明，请参阅[仅在草稿主题中启用 Upcart](/zh/upcart/enabling_upcart_in_a_draft_theme_only)。

***

<div id="frequently-asked-questions">
  ## 常见问题
</div>

<AccordionGroup>
  <Accordion title="Upcart 的 checkout 按钮可以重定向到自定义 checkout 页面吗？">
    不可以，自定义 checkout 页面重定向需要高级编码，Upcart 不直接支持。如有此需求，你需要与开发者合作。
  </Accordion>

  <Accordion title="为什么启用 Upcart 后购物车仍会重定向到 Shopify？">
    请确保 Upcart 已在 Cart Editor 中激活并发布。同时清除浏览器缓存，确保更新后的行为生效。如果问题仍然存在，请按上述步骤检查第三方应用冲突。
  </Accordion>

  <Accordion title="如何修复导致重定向的商品附加组件应用？">
    打开该附加组件应用的设置，查找任何自动重定向或"go to cart"配置。如果它们与 Upcart 冲突，请将其禁用。有关应用专属示例，请参阅上文步骤 2。
  </Accordion>
</AccordionGroup>

***

**需要帮助？**

如果你已完成上述所有步骤但问题仍然存在，请通过应用内聊天或发送邮件至 [support@upcart.app](mailto:support@upcart.app) 联系我们的支持团队。