İçeriğe geç
Uygulamayı yükle
Türkçe

Olaylar

Uygulamanın vitrinde tetiklediği beş olay ve her biri için çalışan bir örnek.

Uygulama bu olayları document üzerinde tetikler. Bu yüzden document.addEventListener ile dinleyin. Kodu bir tema varlığına veya theme.liquid dosyasında </body> etiketinin üstüne koyun.

OlaydetailNe zaman tetiklenir
gpoRenderCompleted{ form, product }Seçeneklerin çizimi tamamlandığında
gpoElementChanged{}Müşteri bir seçeneği değiştirdiğinde
gpoProductPriceUpdated{}Gösterilen fiyat yeniden hesaplandığında
gpoValidated{ success }Sepete eklemede doğrulama çalıştığında
gpoAddedToCart{}Ürün ve eklentileri sepete ulaştığında

gpoRenderCompleted

Seçenek alanları DOM’da oluştuğunda tetiklenir. Üzerine geliştirme yapmanız gereken olay budur. Uygulama eşzamansız çizer. Bu yüzden DOMContentLoaded sırasında çalışan kod, seçenekler oluşmadan çalışır ve hiçbir şey bulamaz.

detail, seçeneklerin çizildiği ürün formu olan form ile seçeneklerin çizildiği ürün olan product bilgisini taşır.

document.addEventListener('gpoRenderCompleted', function (event) {
const { form, product } = event.detail;
if (!form) return; // bu ürüne hiçbir seçenek kümesi uygulanmıyor
// Seçenek alanlarını artık güvenle sorgulayabilirsiniz
form.querySelectorAll('.gpo-form__group').forEach(function (group) {
group.classList.add('my-theme-option');
});
});

Seçenekler her yeniden çizildiğinde tekrar tetiklenir: ürünü yeniden çizen temalarda varyasyon değiştikten sonra veya GPOConfigs.initialize() çağırdıktan sonra. İşleyiciyi, iki kez çalışması zarar vermeyecek şekilde yazın.

gpoElementChanged

Müşteri bir seçeneği her değiştirdiğinde tetiklenir: bir alana yazarken, bir renk örneği seçerken, bir onay kutusunu işaretlerken.

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() === '';
});

Bir metin alanında her tuş vuruşunda tetiklenir. Bu yüzden ağ isteği veya ağır bir yeniden yerleşim gibi maliyetli işlemleri geciktirin (debounce).

gpoProductPriceUpdated

Uygulama, gösterilen fiyatı müşterinin seçtiği seçenekleri içerecek şekilde yeniden yazdıktan sonra tetiklenir. Kendi fiyat gösteriminizi uyumlu tutmak için kullanın: yapışkan çubuk, özet bloğu, taksit tahmini.

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;
});

Sayfada gösterilen fiyat bir önizlemedir. Müşteriden gerçekte alınan tutarı Shopify ödeme sırasında uygular. Bu yüzden bu rakamı asla nihai tutar olarak değerlendirmeyin. Fiyatlandırma nasıl uygulanır sayfasına bakın.

gpoValidated

Müşteri sepete eklemeye çalıştığında ve uygulama seçenekleri kontrol ettiğinde tetiklenir. Bir sorun olduğunda detail.success değeri false olur: boş bırakılmış zorunlu bir seçenek, aşılmış bir karakter sınırı, çok az seçim.

document.addEventListener('gpoValidated', function (event) {
if (event.detail.success) return;
// Sepete ekleme engellendi
if (window.analytics) {
window.analytics.track('Option validation failed', {
product: window.GPOConfigs?.product?.handle
});
}
});

İlk hata mesajına otomatik kaydır açık olduğunda uygulama zaten ilk hataya kaydırır. Bunu sizin yapmanıza gerek yoktur. Widget davranışı sayfasına bakın.

gpoAddedToCart

Ürün ve varsa eklenti ürünleri eklendikten sonra tetiklenir. Sepetin gerçekten değiştiği an budur. Bu yüzden sepeti açma ve analiz işlemleri için doğru yer burasıdır.

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;
});
});

Arkasında bir ürün bulunan eklenti kendi sepet satırıdır. Bu yüzden tek bir sepete ekleme işlemi birkaç satır ekleyebilir. Tek bir ürün eklendiğini varsaymak yerine sepeti yeniden okuyun. Ana ürünü ve eklentileri birleştirme sayfasına bakın.

Notlar

  • Beş olayın tümü uygulama yerleştirmesinin etkin olmasını gerektirir. O olmadan uygulama hiç çalışmaz ve hiçbir olay tetiklenmez.
  • Olaylar, sayfada zaten bulunanların ötesinde müşteri verisi taşımaz. Ürün, sepet ve müşteri için window.GPOConfigs nesnesini okuyun.
  • Buraya bağladığınız kodun bakımı size aittir. Bir tema veya uygulama güncellemesinden sonra vitrin hatalı davrandığında ilk kontrol edilecek yerdir.

Bu sayfa yardımcı oldu mu?

Sorun bildir