Hændelser
De fem hændelser, appen udløser i webshoppen, hver med et gennemgået eksempel.
Appen udløser disse på document, så lyt med document.addEventListener. Placer koden i en temaressource eller i theme.liquid over </body>.
| Hændelse | detail | Udløses, når |
|---|---|---|
gpoRenderCompleted | { form, product } | Optionerne er færdige med at blive vist |
gpoElementChanged | {} | Kunden har ændret en option |
gpoProductPriceUpdated | {} | Den viste pris er blevet genberegnet |
gpoValidated | { success } | Valideringen er kørt ved Læg i kurv |
gpoAddedToCart | {} | Varen og dens tilføjelser er nået frem til kurven |
gpoRenderCompleted
Udløses, så snart optionsfelterne findes i DOM’en. Det er den, du skal bygge videre på. Appen gengiver asynkront, så kode, der kører ved DOMContentLoaded, kører, før optionerne findes, og finder ingenting.
detail indeholder form, den produktformular, som optionerne blev gengivet i, og product, det produkt, de blev gengivet for.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // intet optionssæt gælder for dette produkt
// Nu er det sikkert at forespørge optionsfelterne form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Den udløses igen, hver gang optionerne gengives på ny – efter et variantskift i temaer, der gentegner produktet, eller efter at du kalder GPOConfigs.initialize(). Skriv handleren, så det ikke gør noget, at den kører to gange.
gpoElementChanged
Udløses, hver gang kunden ændrer en option: skriver i et felt, vælger en farveprøve, sætter flueben i et afkrydsningsfelt.
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() === '';});Den udløses ved hvert tastetryk i et tekstfelt, så brug debounce på alt, der er tungt – en netværksanmodning, en omfattende ny layoutberegning.
gpoProductPriceUpdated
Udløses, når appen har omskrevet den viste pris, så den inkluderer de optioner, kunden har valgt. Brug den til at holde din egen prisvisning i takt – en fastgjort bjælke, en opsummeringsblok, et estimat for afbetaling.
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;});Prisen, der vises på siden, er en forhåndsvisning. Det, kunden faktisk bliver opkrævet, anvendes af Shopify på betalingssiden, så behandl aldrig dette tal som det endelige beløb. Se Sådan anvendes priserne.
gpoValidated
Udløses, når kunden forsøger at lægge i kurven, og appen har tjekket optionerne. detail.success er false, når noget er forkert – en obligatorisk option er tom, en tegngrænse er overskredet, der er for få valg.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// Læg i kurv blev blokeret if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});Appen ruller allerede til den første fejl, når Automatisk rulning til første fejlmeddelelse er slået til, så det behøver du ikke selv at gøre. Se Widgetadfærd.
gpoAddedToCart
Udløses, når varen og eventuelle tilføjelsesprodukter er blevet tilføjet. Det er her, kurven reelt er ændret, og derfor er det det rette sted at åbne kurven og spore analyser.
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; });});En tilføjelse, der er baseret på et produkt, er sin egen kurvlinje, så ét Læg i kurv kan tilføje flere linjer. Læs kurven tilbage i stedet for at antage, at der blev tilføjet én vare. Se Flet hovedprodukt og tilføjelser.
Bemærkninger
- Alle fem kræver, at appintegrationen er aktiveret. Uden den kører appen aldrig, og intet udløses.
- Hændelserne indeholder ingen kundedata ud over det, der allerede er på siden. Læs window.GPOConfigs for produktet, kurven og kunden.
- Kode, du knytter til her, skal du selv vedligeholde, og den er det første, du skal tjekke, når webshoppen opfører sig forkert efter en tema- eller appopdatering.
Var dette nyttigt?
Tak for din feedback! Fortæl os, hvad der manglede
Rapportér et problem