> ## 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.

# Kompatybilność aplikacji z Upcart

Ten artykuł opisuje, jak rozwiązywać problemy z kompatybilnością aplikacji z Upcart, i przedstawia najlepsze praktyki zapewniające optymalne działanie.

<div id="overview">
  ## **Przegląd**
</div>

Upcart jest zaprojektowany tak, aby płynnie integrować się z większością aplikacji Shopify. Jednak niektóre aplikacje firm trzecich mogą powodować problemy z działaniem, w zależności od tego, jak modyfikują logikę koszyka, checkoutu, cen lub walut w Shopify.\
​

Upcart działa jako nakładka cart drawera, ulepszając doświadczenie koszyka zakupowego bez całkowitego zastępowania natywnego koszyka lub checkoutu Shopify.\
​

Aplikacje, które nadpisują zachowanie koszyka Shopify, przechwytują akcje Add to Cart lub zastępują natywny system cen lub walut Shopify, mogą wchodzić w konflikt z Upcart.

Zalecamy korzystanie z natywnych funkcji Shopify wszędzie tam, gdzie to możliwe (np. Shopify Markets do przeliczania walut). **Nasz zespół ma ograniczony zakres wsparcia dla aplikacji firm trzecich, które znacząco zmieniają domyślną strukturę koszyka Shopify.**

Nawet jeśli aplikacja jest dostępna w Shopify App Store, nadal może być klasyfikowana jako aplikacja firmy trzeciej i mieć pewne ograniczenia w połączeniu z Upcart.

<div id="incompatible-apps">
  ## **Niekompatybilne aplikacje**
</div>

Stwierdzono, że następujące aplikacje konsekwentnie powodują problemy z Upcart i nie są obsługiwane:

**BUCKS (Currency Converter App)**\
Upcart nie jest kompatybilny z aplikacjami firm trzecich do przeliczania walut. Upcart korzysta z natywnego przeliczania walut Shopify poprzez Shopify Markets. Aplikacje konwertujące waluty, takie jak BUCKS, zmieniają ceny jedynie wizualnie na stronie sklepu i nie modyfikują rzeczywistej waluty koszyka. Z tego powodu nie wpłyną na wyświetlanie waluty w Upcart i mogą powodować niespójności.

Jeśli potrzebujesz obsługi wielu walut, zalecamy korzystanie z **Shopify Markets.**

**CloudFox Checkout**\
Aplikacje firm trzecich zastępujące checkout nie są kompatybilne z Upcart.

**CartPanda**\
Systemy checkoutu firm trzecich nie są obsługiwane.

***

<div id="apps-that-may-cause-issues">
  ## **Aplikacje, które mogą powodować problemy**
</div>

Zgłaszano, że następujące aplikacje powodują konflikty lub mogą nie działać w pełni zgodnie z oczekiwaniami z Upcart:

* **qikify Quick View Popups**
* **Vitals**
* **Bundle Bear**

Chociaż te aplikacje mogą w niektórych przypadkach działać, pewne elementy lub funkcje Upcart mogą się nie wyświetlać lub nie działać zgodnie z oczekiwaniami.

Jeśli napotkasz problemy podczas korzystania z którejkolwiek z tych aplikacji, zalecamy włączenie ustawienia kompatybilności opisanego poniżej.\
​

Deweloperzy mogą również skorzystać z [<u>Upcart Public AP</u>](https://rokt.notion.site/upcart-public-api)I, aby wypracować rozwiązanie.

***

<div id="enhanced-ajax-api-compatibility">
  ## **Enhanced AJAX API Compatibility**
</div>

Jeśli występują u Ciebie konflikty z inną aplikacją, zalecamy włączenie:

**Enhanced AJAX API Compatibility**

Aby włączyć to ustawienie:

Przejdź do **Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility**. W panelu administracyjnym Upcart nie ma głównej sekcji Settings — to ustawienie znajduje się w edytorze koszyka, w zwiniętej sekcji **Advanced Settings**.

To ustawienie sprawia, że Upcart przestaje przechwytywać wywołania Add to Cart.

Robi też drugą rzecz, której nazwa nie sugeruje: sprawia, że Upcart kolejkuje wywołania do Ajax cart API Shopify (`/cart/add`, `/cart/add.js`, `/cart/update.js`, `/cart/change.js`), tak aby wykonywały się pojedynczo, zapobiegając nadpisywaniu się jednoczesnych aktualizacji z różnych skryptów. Ponieważ to kolejkowanie modyfikuje wszystkie żądania sieciowe koszyka na stronie, włączaj to ustawienie tylko wtedy, gdy jest potrzebne, i po włączeniu przetestuj stronę sklepu.

Pozwala to innym aplikacjom, takim jak aplikacje do bundli, kreatory stron, aplikacje personalizacyjne i aplikacje opcji produktów, działać bez zakłóceń.

<div id="important">
  ### **Ważne:**
</div>

To ustawienie wiąże się z pewnym kompromisem.

Ponieważ Upcart nie będzie już przechwytywać wywołań Add to Cart, nie może zapobiec przekierowywaniu klientów przez inne aplikacje na natywną stronę koszyka.

Jeśli po włączeniu tego ustawienia klienci są przekierowywani poza cart drawer:

1. Sprawdź ustawienia aplikacji powodującej konflikt.
2. Poszukaj opcji takich jak:
   * Disable redirect to cart
   * Stay on page after add to cart
   * Enable AJAX add to cart
3. Dostosuj te ustawienia, aby zapobiec wymuszonym przekierowaniom na stronę koszyka.

Zdecydowanie zalecamy testowanie po włączeniu tego ustawienia.

Wymienione powyżej aplikacje to przykłady tych, które wykazały problemy z kompatybilnością z Upcart. Mogą istnieć dodatkowe, jeszcze niezidentyfikowane aplikacje. Ta lista będzie aktualizowana w miarę zgłaszania nowych przypadków.

<div id="if-upcart-is-not-opening-or-is-redirecting">
  ### Jeśli Upcart się nie otwiera lub przekierowuje
</div>

Jeśli Upcart nie otwiera się prawidłowo lub zamiast tego przekierowuje na stronę koszyka, zapoznaj się z naszym przewodnikiem rozwiązywania problemów:

[Rozwiązywanie problemów z nieotwierającym się Upcart lub przekierowaniem na stronę koszyka](/pl/upcart/troubleshooting_upcart_not_opening_or_redirecting)

Ten przewodnik omawia najczęstsze przyczyny i rozwiązania krok po kroku, w tym:

* Konflikty z motywem lub niestandardowym kodem
* Problemy z ustawieniami koszyka AJAX
* Sprawdzanie kompatybilności aplikacji
* Kroki rozwiązywania problemów z przeglądarką i pamięcią podręczną

Jeśli problem nie ustąpi po wykonaniu kroków z przewodnika, skontaktuj się ze wsparciem, podając adres URL swojego sklepu i krótki opis problemu.

***

<div id="testing-recommendation">
  ## **Zalecenia dotyczące testowania**
</div>

Przed wprowadzeniem jakichkolwiek zmian na żywo zalecamy przetestowanie Upcart na zduplikowanej wersji motywu.

Aby to zrobić:

* W panelu administracyjnym Shopify przejdź do **Online Store > Themes**
* Kliknij **Actions** obok swojego aktywnego motywu, a następnie wybierz **Duplicate**
* Otwórz zduplikowany motyw i kliknij **Preview**
* Przetestuj interakcje z koszykiem, bundle, zniżki, wyświetlanie walut i upselle
* Po potwierdzeniu opublikuj zaktualizowany motyw

Testowanie z wyprzedzeniem pomaga zapobiec problemom z wyświetlaniem lub wydajnością, zanim wpłyną one na klientów.

***
