> ## 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 的兼容性

> 本文概述如何排查主题与 Upcart 的兼容性问题，并提供获得最佳性能的最佳实践。

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

Upcart 旨在与大多数 **Shopify 官方主题**顺畅集成。但是，由于代码结构和自定义方式的差异，某些第三方主题可能会导致功能问题。

Shopify 原生主题由 Shopify 自行开发，可确保无缝兼容；而自定义或第三方主题即使是通过 Shopify 平台购买的，也可能引发问题。

我们建议使用 **Shopify 内置主题**（例如 **Dawn**），它们与 Upcart 的兼容性和性能最佳。我们团队对第三方主题的支持范围有限，因为其开发方式的差异可能导致超出我们控制范围的冲突。

需要说明的是，像 FOXECOM 这样的主题，即使是在 Shopify 上购买的，也归类为第三方主题，在功能上可能存在某些限制。

***

<div id="incompatible-themes">
  ## 不兼容的主题
</div>

以下主题经证实会持续导致 Upcart 出现问题，因此不受支持：

* **Trade**

如果你正在使用此主题并遇到 Upcart 的问题，我们建议切换到兼容性更好的 Shopify 官方主题，以确保完整功能。

***

<div id="themes-that-may-cause-issues">
  ## 可能引发问题的主题
</div>

据报告，以下主题可能与 Upcart 产生冲突，或无法完全按预期工作：

* **Shrine**
* **Impulse**
* **Impact**
* **Prestige**

虽然这些主题在某些情况下可以正常工作，但 Upcart 的某些元素或功能可能无法按预期显示或运行。如果你在使用这些主题时遇到问题，我们建议使用 **Dawn** 或其他 Shopify 官方主题进行测试，以获得最佳效果。

对于存在兼容性挑战的主题，开发者可以利用 [Upcart Public API](https://rokt.notion.site/upcart-public-api) 来解决问题。

注意

上面列出的主题只是已发现与 Upcart 存在潜在兼容性问题的示例。可能还有其他尚未发现的主题。随着新案例的发现或报告，此列表将持续更新。

***

<div id="partially-supported-themes">
  ## 部分支持的主题
</div>

许多 Shopify 主题都与 Upcart 兼容，我们也在努力让使用自定义或非默认主题的商家尽可能顺利地使用本应用。

如果你怀疑自己的主题仅得到部分支持：

这可能包括聘请 Shopify 专家使用 Upcart API、确保使用标准 Shopify 元素，或考虑切换到 Shopify 原生主题以消除兼容性挑战。

1. 请先查阅以下文章：

* [**在主题中更改购物车类型**](/zh/upcart/change_cart_type_in_theme)

- **主题代码格式错误**

2. 如果按照这些步骤操作后问题仍然存在，请联系 **Upcart 支持团队**以获得进一步帮助。
3. 向主题开发者提供 [UpCart Public API](https://rokt.notion.site/upcart-public-api) 的访问权限，以有效解决主题兼容性问题。

***

<div id="testing-recommendation">
  ## 测试建议
</div>

在正式上线任何更改之前，我们建议**在主题预览中**或在主题的**副本版本**上测试 Upcart。这样你可以在不影响线上店面的情况下验证所有购物车和 upsell 功能是否正常运行。

操作方法：

1. 在 Shopify 后台中，前往 **Online Store > Themes**。
2. 点击线上主题旁边的 **Actions**，然后选择 **Duplicate**。
3. 打开副本主题并点击 **Preview**。
4. 测试你的 Upcart 设置，包括购物车交互、折扣和 upsell。
5. 确认无误后，发布更新后的主题。

提前测试可确保兼容性，并有助于在问题影响客户之前防止任何显示或性能问题。

***

<div id="best-practices">
  ## 最佳实践
</div>

为了保持最佳性能并确保 Upcart 与你的主题顺畅协作：

* **保持主题为最新版本。** Shopify 和主题开发者会定期发布更新，以提升兼容性和性能。
* **在任何主题编辑后进行测试。** 如果你更改了代码或布局，请测试购物车行为，确保所有内容正确显示。
* **避免大量第三方自定义。** 大规模的设计或脚本修改可能会干扰购物车功能。
* **谨慎使用 Shopify 的主题编辑器。** 在发布前预览更改，以防止出现显示或结账问题。

遵循这些最佳实践有助于保持设置稳定，并确保你的商店与 Upcart 顺畅运行。