Skip to main content

Przegląd

To ustawienie robi dwie rzeczy:
  1. Kolejkuje wywołania Ajax cart Shopify. Gdy kilka skryptów jednocześnie odwołuje się do Ajax cart API Shopify (/cart/add, /cart/add.js, /cart/update.js, /cart/change.js), Shopify czasami gubi jedną ze zmian. Upcart wymusza wykonywanie tych wywołań pojedynczo, dzięki czemu każda aktualizacja zostaje zarejestrowana. To główny cel tego ustawienia.
  2. Wycofuje się z obsługi dodawania do koszyka. Wyłącza również wbudowaną obsługę dodawania do koszyka w Upcart, dzięki czemu aplikacja lub szablon wymagający pełnej kontroli nad tym przepływem nie wchodzi z nim w konflikt.
Oba zachowania są powiązane z jednym polem wyboru — nie możesz włączyć kolejkowania żądań bez jednoczesnej rezygnacji z obsługi dodawania do koszyka przez Upcart.

Gdzie to znaleźć

Otwórz edytor koszyka, przejdź do Settings > Cart settings i rozwiń Advanced Settings.
Poszukaj „Enhanced Ajax API compatibility”.

Jak to działa

Upcart zachowuje pełną kontrolę nad procesem dodawania do koszyka. Zapewnia to spójne zachowanie i pozwala Upcart zapobiegać nadpisywaniu przepływu koszyka przez inne aplikacje lub skrypty. To zalecane ustawienie dla większości sklepów. Pozostaw je wyłączone, chyba że doświadczasz konkretnych problemów, w których Upcart nie przechwytuje zdarzeń dodawania do koszyka z Twojego szablonu lub innych aplikacji.

Włączone

Upcart nie będzie już zarządzać procesem dodawania do koszyka. Pozwala to innym aplikacjom, niestandardowemu JavaScriptowi lub Twojemu szablonowi modyfikować koszyk bez zakłóceń. Włącz to ustawienie TYLKO wtedy, gdy:
  • Twój sklep używa niestandardowego AJAX cart API
  • Upcart nie przechwytuje zdarzeń dodawania do koszyka z Twojego szablonu lub innych aplikacji
  • Potrzebujesz, aby aplikacje firm trzecich miały bezpośrednią kontrolę nad zachowaniem koszyka
Ważne kompromisy po włączeniu:
  • Inne aplikacje mogą przekierowywać klientów na stronę koszyka Shopify zamiast otwierać koszyk wysuwany Upcart
  • Możesz doświadczyć pętli przekierowań lub nieoczekiwanego zachowania koszyka
  • Upcart nie może zapobiec modyfikowaniu zachowania koszyka przez zewnętrzne aplikacje
Jeśli włączenie powoduje pętle przekierowań:
  1. Wyłącz to ustawienie
  2. Użyj zamiast tego ręcznego API Upcart (upcartRegisterAddToCart)
  3. Zobacz przewodniki integracji dla konkretnych aplikacji (np. Replo)

Testowanie

Po zmianie tego ustawienia:
  1. Kliknij Save
  2. Przetestuj dodawanie produktów do koszyka
  3. Zweryfikuj, że koszyk wysuwany Upcart otwiera się poprawnie
  4. Sprawdź, czy nie jesteś przekierowywany na stronę koszyka Shopify
Jeśli po włączeniu wystąpią problemy, wyłącz ustawienie i skontaktuj się ze wsparciem w sprawie alternatywnych rozwiązań.