Skip to main content

​
Overzicht

Hier vind je antwoorden op enkele van de meest gestelde vragen over het gebruik van de Upcart API.

​
Waar voeg ik Upcart API-scripts toe?

Je kunt scripts toevoegen in de Custom HTML-instellingen van Upcart of rechtstreeks in je Shopify-themacode. De beste optie hangt af van je aanpassingsbehoeften.

​
Hoe gebruik ik de Custom HTML van Upcart?

  1. Ga naar Upcart → Settings → Custom HTML
  2. Gebruik API-scripts om het winkelwagengedrag aan te passen, zoals het moment van openen of de weergave van upsells
  3. Pas elementen buiten Upcart aan, zoals het verbergen van knoppen op productpagina’s

​
💡 Voorbeeld: Verberg de sticky winkelwagenknop wanneer de winkelwagen leeg is

Legacy-opmerking: window.upcartOnCartLoaded-callbacks werken nog steeds, maar zijn verouderd en loggen waarschuwingen in de console. Gebruik upcartSubscribeCartLoaded voor alle nieuwe scripts. Let op: event.cart heeft geen item_count-eigenschap — gebruik event.cart.items.reduce((total, item) => total + item.quantity, 0) om het totale aantal artikelen te berekenen.

​
Moet ik een ontwikkelaar zijn om de Upcart API te gebruiken?

Nee! De Upcart API is eenvoudig te gebruiken, zelfs zonder programmeerkennis. Veel functies zijn ingebouwd en onze aanpassingsdocumentatie bevat kant-en-klare scripts die je in de Custom HTML-instellingen van Upcart kunt kopiëren — geen programmeerwerk nodig! Als je zelf aangepaste scripts wilt schrijven, helpt basiskennis van JavaScript. Ben je nieuw met JavaScript? Geen zorgen! Deze beginnersvriendelijke bronnen — W3Schools en MDN Web Docs — helpen je op weg.

​
Kan de Upcart API integreren met andere apps van derden?

Ja! De Upcart API werkt met apps voor vertalingen, analytics, upsells en meer. Sommige integreren automatisch, terwijl andere een klein script nodig hebben. Als je bijvoorbeeld TripleWhale gebruikt voor tracking, moet je het volgende script toevoegen om ervoor te zorgen dat winkelwagenactiviteit correct wordt geregistreerd:
Legacy-opmerking: window.upcartOnAddToCart-callbacks werken nog steeds, maar zijn verouderd en loggen waarschuwingen in de console. Gebruik upcartSubscribeAddedToCart voor alle nieuwe scripts. Let op: de event-eigenschappen staan op event.item (met variantId en quantityAdded) en worden niet als aparte parameters doorgegeven.
Omdat elke app anders is, raadpleeg je het supportteam van je app om te zien of extra code nodig is. Upcart biedt geen scriptondersteuning voor apps van derden, maar je app-aanbieder heeft mogelijk een integratiegids.

​
Hoe test ik of mijn API-wijzigingen werken?

Nadat je een script hebt toegevoegd aan de Custom HTML-instellingen van Upcart, volg je deze stappen om te controleren of het werkt:
  1. Vernieuw je winkel en voeg een artikel toe aan de winkelwagen.
  2. Wis je cache en probeer het opnieuw om de nieuwste wijzigingen te zien.
  3. Voeg een testbericht toe: Plaats console.log("The script works!"); vóór </script> om te controleren of je script draait.
  4. Controleer je browserconsole:
    • Open Dev Tools (F12 of Ctrl + Shift + J op Windows, Cmd + Option + J op Mac).
    • Ga naar het tabblad Console en zoek naar “The script works!”
    • Zie je het bericht? Dan draait je script! Zo niet, dan wordt het script mogelijk niet correct uitgevoerd.
  5. Test verschillende acties (bijv. een artikel verwijderen) om het verwachte gedrag te controleren.
Los problemen op door te controleren op typefouten of consolefouten en de code waar nodig aan te passen.

​
Wat moet ik doen als een API-script niet werkt?

Als je API-script niet werkt, probeer dan deze probleemoplossingsstappen:
  • Controleer op typefouten – Zelfs kleine fouten kunnen een script breken. Zoek naar ontbrekende tekens of onjuiste syntaxis.
  • Controleer de plaatsing van het script – Zorg dat het script in de juiste sectie staat onder Upcart → Settings → Custom HTML. Upcart heeft tien scriptsecties (negen HTML-injectiepunten plus één Scripts-before-load-sectie) — Bekijk deze secties hier.
  • Controleer de browserconsole – Volg de stappen hierboven om naar fouten te zoeken.
  • Test een ander script – Probeer een ander kant-en-klaar Upcart API-script om te zien of het probleem in je code zit.
  • Loop je nog steeds vast? – Als je je Shopify-thema aanpast of apps van derden integreert, kan een Shopify Expert uit de Shopify Partner Directory helpen.
Met deze stappen zou je de meeste scriptproblemen moeten kunnen vinden en oplossen!

​
Hoe maak ik wijzigingen ongedaan als ik een script toevoeg dat iets kapotmaakt?

Als je een script toevoegt dat niet werkt zoals verwacht, kun je het eenvoudig verwijderen of uitschakelen:
  • Ga naar de Custom HTML-instellingen van Upcart waar het script is toegevoegd.
  • Verwijder het script of schakel het tijdelijk uit door // aan het begin van elke regel toe te voegen (dit maakt er een opmerking van, waardoor het niet wordt uitgevoerd).
  • Sla de wijzigingen op en vernieuw je winkel om te controleren of het probleem is opgelost.
Als het probleem aanhoudt, probeer dan je cache te wissen of recente themawijzigingen terug te draaien — dit lost vaak verborgen conflicten op.
🚧 Op zoek naar geavanceerde aanpassingen? Heb je winkelbrede aanpassingen of integraties met apps van derden nodig? Dan heb je mogelijk een ontwikkelaar nodig om de Upcart API aan je Shopify-thema toe te voegen. Overweeg een Shopify Expert in te huren via de Shopify Partner Directory en deel onze API-documentatie met hen voor ondersteuning