Events
Die fünf Events, die die App im Shop auslöst, jeweils mit einem ausgearbeiteten Beispiel.
Die App löst diese Events auf document aus. Hören Sie sie daher mit document.addEventListener ab. Legen Sie den Code in ein Theme-Asset oder in theme.liquid oberhalb von </body>.
| Event | detail | Ausgelöst, wenn |
|---|---|---|
gpoRenderCompleted | { form, product } | Die Optionen fertig gerendert sind |
gpoElementChanged | {} | Der Kunde eine Option geändert hat |
gpoProductPriceUpdated | {} | Der angezeigte Preis neu berechnet wurde |
gpoValidated | { success } | Die Prüfung beim Hinzufügen zum Warenkorb gelaufen ist |
gpoAddedToCart | {} | Der Artikel und seine Add-ons im Warenkorb angekommen sind |
gpoRenderCompleted
Wird ausgelöst, sobald die Optionsfelder im DOM existieren. Auf diesem Event sollten Sie aufbauen. Die App rendert asynchron, daher läuft Code, der bei DOMContentLoaded ausgeführt wird, bevor die Optionen existieren, und findet nichts.
detail enthält form, das Produktformular, in das die Optionen gerendert wurden, und product, das Produkt, für das sie gerendert wurden.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // für dieses Produkt gilt kein Optionssatz
// Die Optionsfelder können jetzt sicher abgefragt werden form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Es wird erneut ausgelöst, wann immer die Optionen neu gerendert werden – nach einem Variantenwechsel bei Themes, die das Produkt neu rendern, oder nachdem Sie GPOConfigs.initialize() aufgerufen haben. Schreiben Sie den Handler so, dass eine doppelte Ausführung keinen Schaden anrichtet.
gpoElementChanged
Wird jedes Mal ausgelöst, wenn der Kunde eine Option ändert: Tippen in einem Feld, Auswählen eines Musters, Aktivieren eines Kontrollkästchens.
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() === '';});Es wird bei jedem Tastendruck in einem Textfeld ausgelöst. Verwenden Sie daher Debouncing für alles Aufwendige – eine Netzwerkanfrage, ein umfangreiches Neu-Layout.
gpoProductPriceUpdated
Wird ausgelöst, nachdem die App den angezeigten Preis so umgeschrieben hat, dass er die vom Kunden gewählten Optionen enthält. Verwenden Sie es, um Ihre eigene Preisanzeige synchron zu halten – eine Sticky-Leiste, einen Zusammenfassungsblock, eine Ratenzahlungsschätzung.
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;});Der auf der Seite angezeigte Preis ist eine Vorschau. Was dem Kunden tatsächlich berechnet wird, wendet Shopify im Checkout an. Behandeln Sie diesen Betrag daher nie als Endbetrag. Siehe So werden Preise angewendet.
gpoValidated
Wird ausgelöst, wenn der Kunde versucht, den Artikel in den Warenkorb zu legen, und die App die Optionen geprüft hat. detail.success ist false, wenn etwas nicht stimmt – eine erforderliche Option ist leer, eine Zeichenbegrenzung überschritten oder es wurde zu wenig ausgewählt.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// Das Hinzufügen zum Warenkorb wurde blockiert if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});Die App scrollt bereits zur ersten Fehlermeldung, wenn Automatisch zur ersten Fehlermeldung scrollen aktiviert ist, sodass Sie das nicht selbst tun müssen. Siehe Widget-Verhalten.
gpoAddedToCart
Wird ausgelöst, nachdem der Artikel und alle Add-on-Produkte hinzugefügt wurden. Erst zu diesem Zeitpunkt hat sich der Warenkorb tatsächlich geändert. Deshalb ist dies der richtige Ort, um den Warenkorb zu öffnen oder Analysen auszulösen.
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; });});Ein Add-on, das auf einem Produkt basiert, ist eine eigene Warenkorbposition, daher kann ein einziges Hinzufügen zum Warenkorb mehrere Positionen hinzufügen. Lesen Sie den Warenkorb erneut aus, statt anzunehmen, dass ein Artikel hinzugefügt wurde. Siehe Hauptprodukt und Add-ons zusammenführen.
Hinweise
- Alle fünf erfordern eine aktivierte App-Einbettung. Ohne sie läuft die App nie und es wird nichts ausgelöst.
- Die Events enthalten keine Kundendaten über das hinaus, was bereits auf der Seite steht. Lesen Sie window.GPOConfigs für Produkt, Warenkorb und Kunde aus.
- Code, den Sie hier anhängen, müssen Sie selbst pflegen. Er ist das Erste, was Sie prüfen sollten, wenn sich der Shop nach einem Theme- oder App-Update falsch verhält.
War diese Seite hilfreich?
Danke für Ihr Feedback! Sagen Sie uns, was gefehlt hat
Problem melden