Ga naar inhoud
App installeren
Nederlands

Events

De vijf events die de app in de webwinkel afvuurt, elk met een uitgewerkt voorbeeld.

De app vuurt deze events af op document. Luister er dus naar met document.addEventListener. Zet de code in een thema-asset, of in theme.liquid boven </body>.

EventdetailAfgevuurd wanneer
gpoRenderCompleted{ form, product }De opties zijn klaar met renderen
gpoElementChanged{}De klant heeft een optie gewijzigd
gpoProductPriceUpdated{}De getoonde prijs is opnieuw berekend
gpoValidated{ success }De validatie bij toevoegen aan winkelwagen is uitgevoerd
gpoAddedToCart{}Het artikel en de add-ons ervan staan in de winkelwagen

gpoRenderCompleted

Wordt afgevuurd zodra de optievelden in de DOM staan. Dit is het event om op te bouwen. De app rendert asynchroon. Code die bij DOMContentLoaded draait, draait dus voordat de opties bestaan en vindt niets.

detail bevat form, het productformulier waarin de opties zijn gerenderd, en product, het product waarvoor ze zijn gerenderd.

document.addEventListener('gpoRenderCompleted', function (event) {
const { form, product } = event.detail;
if (!form) return; // geen optieset van toepassing op dit product
// De optievelden kunnen nu veilig worden opgevraagd
form.querySelectorAll('.gpo-form__group').forEach(function (group) {
group.classList.add('my-theme-option');
});
});

Het event wordt opnieuw afgevuurd telkens als de opties opnieuw worden gerenderd — na een variantwissel bij thema’s die het product opnieuw renderen, of nadat je GPOConfigs.initialize() aanroept. Schrijf de handler zo dat twee keer draaien geen kwaad kan.

gpoElementChanged

Wordt afgevuurd telkens als de klant een optie wijzigt: typen in een veld, een staal kiezen, een selectievakje aanvinken.

document.addEventListener('gpoElementChanged', function () {
const engraving = document.querySelector('[name="properties[Engraving text]"]');
const note = document.querySelector('.my-engraving-note');
if (!engraving || !note) return;
note.hidden = engraving.value.trim() === '';
});

Het event wordt bij elke toetsaanslag in een tekstveld afgevuurd. Gebruik dus debounce voor alles wat zwaar is — een netwerkverzoek, een zware herindeling van de lay-out.

gpoProductPriceUpdated

Wordt afgevuurd nadat de app de getoonde prijs heeft herschreven met de opties die de klant heeft gekozen. Gebruik het om je eigen prijsweergave gelijk te houden — een sticky balk, een overzichtsblok, een schatting van termijnbedragen.

document.addEventListener('gpoProductPriceUpdated', function () {
const main = document.querySelector('[data-gpo-product-unit-price]');
const sticky = document.querySelector('.my-sticky-bar .price');
if (main && sticky) sticky.textContent = main.textContent;
});

De prijs op de pagina is een voorbeeld. Wat de klant echt betaalt, past Shopify in de checkout toe. Behandel dit bedrag dus nooit als het eindbedrag. Zie Hoe prijzen worden toegepast.

gpoValidated

Wordt afgevuurd als de klant iets aan de winkelwagen probeert toe te voegen en de app de opties heeft gecontroleerd. detail.success is false als er iets mis is — een verplichte optie leeg, een tekenlimiet overschreden, te weinig selecties.

document.addEventListener('gpoValidated', function (event) {
if (event.detail.success) return;
// Het toevoegen aan de winkelwagen is geblokkeerd
if (window.analytics) {
window.analytics.track('Option validation failed', {
product: window.GPOConfigs?.product?.handle
});
}
});

De app scrolt al naar de eerste fout als Automatisch scrollen naar eerste foutmelding aan staat. Dat hoef je dus niet zelf te doen. Zie Gedrag van de widget.

gpoAddedToCart

Wordt afgevuurd nadat het artikel en eventuele add-onproducten zijn toegevoegd. Op dit moment is de winkelwagen echt veranderd. Het is dus de juiste plek om de winkelwagen te openen en voor analytics.

document.addEventListener('gpoAddedToCart', function () {
fetch(window.Shopify.routes.root + 'cart.js')
.then(function (res) { return res.json(); })
.then(function (cart) {
document.querySelector('.my-cart-count').textContent = cart.item_count;
});
});

Een add-on die aan een product gekoppeld is, is een eigen winkelwagenregel. Eén keer toevoegen aan de winkelwagen kan dus meerdere regels toevoegen. Lees de winkelwagen terug in plaats van aan te nemen dat er één artikel is toegevoegd. Zie Hoofdproduct en add-ons samenvoegen.

Opmerkingen

  • Alle vijf vereisen dat de app-insluiting is ingeschakeld. Zonder app-insluiting draait de app nooit en wordt er niets afgevuurd.
  • De events bevatten geen klantgegevens naast wat al op de pagina staat. Lees window.GPOConfigs voor het product, de winkelwagen en de klant.
  • Code die je hier koppelt, onderhoud je zelf. Het is het eerste wat je controleert als de webwinkel zich na een update van het thema of de app vreemd gedraagt.

Was dit nuttig?

Probleem melden