Skip to main content
Dit artikel beschrijft hoe je compatibiliteitsproblemen tussen apps en Upcart oplost en geeft best practices voor optimale prestaties.

Overzicht

Upcart is ontworpen om soepel te integreren met de meeste Shopify-apps. Bepaalde apps van derden kunnen echter functionaliteitsproblemen veroorzaken, afhankelijk van hoe ze de winkelwagen-, checkout-, prijs- of valutalogica van Shopify aanpassen.
Upcart werkt als een cart drawer-overlay die de winkelwagenervaring verbetert zonder de native winkelwagen of checkout van Shopify volledig te vervangen.
Apps die het winkelwagengedrag van Shopify overschrijven, Add to Cart-acties onderscheppen of het native prijs- of valutasysteem van Shopify vervangen, kunnen conflicteren met Upcart. We raden aan om waar mogelijk de native functionaliteit van Shopify te gebruiken (zoals Shopify Markets voor valutaconversie). Ons team heeft een beperkte supportreikwijdte voor apps van derden die de standaard winkelwagenstructuur van Shopify aanzienlijk wijzigen. Zelfs als een app beschikbaar is in de Shopify App Store, kan deze nog steeds worden aangemerkt als een app van derden en bepaalde beperkingen hebben bij gebruik met Upcart.

Incompatibele apps

Van de volgende apps is vastgesteld dat ze consequent problemen veroorzaken met Upcart; ze worden niet ondersteund: BUCKS (Currency Converter App)
Upcart is niet compatibel met valutaconversie-apps van derden. Upcart gebruikt de native valutaconversie van Shopify via Shopify Markets. Valuta-omzetter-apps zoals BUCKS wijzigen prijzen alleen visueel op de storefront en passen de daadwerkelijke winkelwagenvaluta niet aan. Daardoor hebben ze geen invloed op de valutaweergave binnen Upcart en kunnen ze inconsistenties veroorzaken.
Als je multi-valutafunctionaliteit nodig hebt, raden we Shopify Markets aan. CloudFox Checkout
Checkout-vervangende apps van derden zijn niet compatibel met Upcart.
CartPanda
Checkoutsystemen van derden worden niet ondersteund.

Apps die problemen kunnen veroorzaken

Van de volgende apps is gemeld dat ze conflicten veroorzaken of mogelijk niet volledig werken zoals bedoeld met Upcart:
  • qikify Quick View Popups
  • Vitals
  • Bundle Bear
Hoewel deze apps in sommige gevallen kunnen werken, kunnen bepaalde elementen of functies van Upcart niet worden weergegeven of niet functioneren zoals verwacht. Als je problemen ondervindt bij het gebruik van een van deze apps, raden we aan de hieronder beschreven compatibiliteitsinstelling in te schakelen.
Ontwikkelaars kunnen ook de Upcart Public API gebruiken om tot een oplossing te komen.

Enhanced AJAX API Compatibility

Als je conflicten ondervindt met een andere app, raden we aan het volgende in te schakelen: Enhanced AJAX API Compatibility Om deze instelling in te schakelen: Ga naar Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility. Er is geen Settings-bestemming op het hoogste niveau in het Upcart-beheer — de instelling bevindt zich in de cart editor, achter het ingeklapte onderdeel Advanced Settings. Deze instelling zorgt ervoor dat Upcart stopt met het onderscheppen van Add to Cart-aanroepen. De instelling doet ook iets tweeds dat de naam niet doet vermoeden: Upcart plaatst aanroepen naar de Ajax cart API van Shopify (/cart/add, /cart/add.js, /cart/update.js, /cart/change.js) in een wachtrij zodat ze één voor één worden uitgevoerd, waardoor gelijktijdige updates van verschillende scripts elkaar niet kunnen overschrijven. Omdat die wachtrij alle winkelwagen-netwerkverzoeken op de pagina patcht, schakel je de instelling alleen in wanneer je die nodig hebt en test je de storefront achteraf. Hierdoor kunnen andere apps, zoals bundel-apps, page builders, aanpassings-apps en productoptie-apps, zonder verstoring functioneren.

Belangrijk:

Deze instelling brengt wel een afweging met zich mee. Omdat Upcart Add to Cart-aanroepen niet langer onderschept, kan het niet voorkomen dat andere apps klanten omleiden naar de native winkelwagenpagina. Als klanten na het inschakelen van deze instelling worden weggeleid van de cart drawer:
  1. Controleer de instellingen van de conflicterende app.
  2. Zoek naar opties zoals:
    • Disable redirect to cart
    • Stay on page after add to cart
    • Enable AJAX add to cart
  3. Pas die instellingen aan om gedwongen omleidingen naar de winkelwagenpagina te voorkomen.
Testen na het inschakelen van deze instelling wordt sterk aanbevolen. De hierboven vermelde apps zijn voorbeelden van apps die compatibiliteitsproblemen met Upcart hebben laten zien. Er kunnen nog andere apps zijn die nog niet zijn geïdentificeerd. Deze lijst wordt bijgewerkt naarmate nieuwe gevallen worden gemeld.

Als Upcart niet opent of omleidt

Als Upcart niet goed opent of in plaats daarvan omleidt naar de winkelwagenpagina, raadpleeg dan onze gids voor probleemoplossing: Problemen oplossen wanneer Upcart niet opent of omleidt naar de winkelwagenpagina Deze gids behandelt veelvoorkomende oorzaken en stapsgewijze oplossingen, waaronder:
  • Conflicten met thema- of aangepaste code
  • Problemen met AJAX-winkelwageninstellingen
  • Controles van app-compatibiliteit
  • Stappen voor browser- en cacheproblemen
Als het probleem na het volgen van de gids aanhoudt, neem dan contact op met support en vermeld je winkel-URL en een korte beschrijving van het probleem.

Testadvies

Voordat je wijzigingen live zet, raden we aan Upcart te testen op een duplicaat van je thema. Zo doe je dat:
  • Ga in het Shopify-beheer naar Online Store > Themes
  • Klik op Actions naast je live thema en selecteer Duplicate
  • Open het gedupliceerde thema en klik op Preview
  • Test winkelwageninteracties, bundels, kortingen, valutaweergave en upsells
  • Publiceer het bijgewerkte thema zodra alles is bevestigd
Vooraf testen helpt weergave- of prestatieproblemen te voorkomen voordat ze klanten raken.