Skip to main content

​
Overzicht

Deze instelling doet twee dingen:
  1. Zet Shopify Ajax cart-aanroepen in een wachtrij. Wanneer meerdere scripts tegelijk de Ajax cart-API van Shopify aanroepen (/cart/add, /cart/add.js, /cart/update.js, /cart/change.js), laat Shopify soms een van de wijzigingen vallen. Upcart dwingt die aanroepen om één voor één te draaien, zodat elke update wordt geregistreerd. Dit is het hoofddoel van de instelling.
  2. Trekt zich terug uit Add to Cart. De instelling schakelt ook de ingebouwde Add to Cart-afhandeling van Upcart uit, zodat een app of thema dat volledige controle over die flow nodig heeft er niet mee conflicteert.
Beide gedragingen zijn gekoppeld aan hetzelfde selectievakje — je kunt de wachtrij voor requests niet inschakelen zonder ook de Add to Cart-afhandeling van Upcart op te geven.

​
Waar vind je het

Open de cart-editor, ga naar Settings > Cart settings en klap Advanced Settings uit.
Zoek naar “Enhanced Ajax API compatibility.”

​
Hoe het werkt

Upcart behoudt volledige controle over het Add to Cart-proces. Dit zorgt voor consistent gedrag en stelt Upcart in staat te voorkomen dat andere apps of scripts de cart-flow overschrijven. Dit is de aanbevolen instelling voor de meeste winkels. Laat deze uitgeschakeld, tenzij je specifieke problemen ervaart waarbij Upcart geen add-to-cart-events van je thema of andere apps onderschept.

​
Ingeschakeld

Upcart beheert het Add to Cart-proces niet meer. Hierdoor kunnen andere apps, custom JavaScript of je thema de cart aanpassen zonder tussenkomst. Schakel deze instelling ALLEEN in wanneer:
  • Je winkel een niet-standaard AJAX cart-API gebruikt
  • Upcart geen add-to-cart-events van je thema of andere apps onderschept
  • Apps van derden directe controle over het cart-gedrag nodig hebben
Belangrijke nadelen wanneer ingeschakeld:
  • Andere apps kunnen klanten omleiden naar de Shopify-cartpagina in plaats van de Upcart-drawer te openen
  • Je kunt redirect-loops of onverwacht cart-gedrag ervaren
  • Upcart kan niet voorkomen dat externe apps het cart-gedrag wijzigen
Als inschakelen redirect-loops veroorzaakt:
  1. Schakel deze instelling uit
  2. Gebruik in plaats daarvan de handmatige Upcart-API (upcartRegisterAddToCart)
  3. Bekijk de integratiegidsen voor specifieke apps (bijv. Replo)

​
Testen

Na het wijzigen van deze instelling:
  1. Klik op Save
  2. Test het toevoegen van producten aan je cart
  3. Controleer of de Upcart-drawer correct opent
  4. Controleer of je niet wordt omgeleid naar de Shopify-cartpagina
Als je na het inschakelen problemen ervaart, schakel de instelling dan uit en neem contact op met support voor alternatieve oplossingen.