Tapahtumat
Viisi tapahtumaa, jotka sovellus laukaisee kaupassa, kukin esimerkin kera.
Sovellus laukaisee nämä document-objektissa, joten kuuntele niitä document.addEventListener-metodilla. Sijoita koodi teeman resurssitiedostoon tai theme.liquid-tiedostoon ennen </body>-tagia.
| Tapahtuma | detail | Laukaistaan, kun |
|---|---|---|
gpoRenderCompleted | { form, product } | Vaihtoehdot on piirretty valmiiksi |
gpoElementChanged | {} | Asiakas muutti vaihtoehtoa |
gpoProductPriceUpdated | {} | Näytetty hinta laskettiin uudelleen |
gpoValidated | { success } | Tarkistus suoritettiin ostoskoriin lisättäessä |
gpoAddedToCart | {} | Tuote ja sen lisäosat päätyivät ostoskoriin |
gpoRenderCompleted
Laukaistaan, kun vaihtoehtokentät ovat DOMissa. Tämän varaan kannattaa rakentaa. Sovellus piirtää asynkronisesti, joten DOMContentLoaded-tapahtumassa suoritettava koodi ajetaan ennen kuin vaihtoehdot ovat olemassa, eikä se löydä mitään.
detail sisältää kentät form, eli tuotelomakkeen, johon vaihtoehdot piirrettiin, ja product, eli tuotteen, jolle ne piirrettiin.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // tähän tuotteeseen ei kohdistu vaihtoehtosarjaa
// Vaihtoehtokenttiä voi nyt hakea turvallisesti form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Se laukaistaan uudelleen aina, kun vaihtoehdot piirretään uudelleen — variantin vaihtumisen jälkeen teemoissa, jotka piirtävät tuotteen uudelleen, tai kun kutsut GPOConfigs.initialize(). Kirjoita käsittelijä niin, ettei kahdesti suorittamisesta ole haittaa.
gpoElementChanged
Laukaistaan aina, kun asiakas muuttaa vaihtoehtoa: kirjoittaa kenttään, valitsee värimallin tai rastittaa valintaruudun.
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() === '';});Se laukaistaan jokaisella näppäilyllä tekstikentässä, joten viivästä (debounce) kaikki raskas — verkkopyynnöt ja raskaat asettelun uudelleenlaskennat.
gpoProductPriceUpdated
Laukaistaan, kun sovellus on kirjoittanut näytetyn hinnan uudelleen asiakkaan valitsemien vaihtoehtojen mukaiseksi. Käytä sitä pitämään oma hintanäyttösi ajan tasalla — kiinteä palkki, yhteenvetolohko tai osamaksuarvio.
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;});Sivulla näkyvä hinta on esikatselu. Shopify soveltaa asiakkaalta todellisuudessa veloitettavan summan kassalla, joten älä koskaan pidä tätä lukua lopullisena summana. Katso Miten hinnoittelua sovelletaan.
gpoValidated
Laukaistaan, kun asiakas yrittää lisätä tuotteen ostoskoriin ja sovellus on tarkistanut vaihtoehdot. detail.success on false, kun jokin on vialla — pakollinen vaihtoehto on tyhjä, merkkiraja on ylitetty tai valintoja on liian vähän.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// Ostoskoriin lisääminen estettiin if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});Sovellus vierittää jo ensimmäiseen virheeseen, kun Siirry automaattisesti ensimmäiseen virheilmoitukseen on päällä, joten sinun ei tarvitse tehdä sitä itse. Katso Widgetin toiminta.
gpoAddedToCart
Laukaistaan, kun tuote ja mahdolliset lisäosatuotteet on lisätty. Tässä vaiheessa ostoskori on todella muuttunut, joten se on oikea paikka ostoskorin avaamiselle ja analytiikalle.
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; });});Tuotteeseen perustuva lisäosa on oma ostoskorin rivinsä, joten yksi ostoskoriin lisäys voi lisätä useita rivejä. Lue ostoskori uudelleen sen sijaan, että olettaisit yhden tuotteen tulleen lisätyksi. Katso Päätuotteen ja lisäosien yhdistäminen.
Huomautukset
- Kaikki viisi edellyttävät, että sovelluksen upotus on käytössä. Ilman sitä sovellus ei koskaan käynnisty eikä mitään laukaista.
- Tapahtumat eivät sisällä asiakastietoja sen lisäksi, mitä sivulla jo on. Lue tuote, ostoskori ja asiakas window.GPOConfigs-objektista.
- Tähän liittämäsi koodin ylläpito on sinun vastuullasi, ja se on ensimmäinen tarkistettava asia, kun kauppa toimii väärin teeman tai sovelluksen päivityksen jälkeen.
Oliko tästä apua?
Kiitos palautteestasi! Kerro, mitä puuttui
Ilmoita ongelmasta