TSOFT_APPS Callback Referans Dokümantasyonu

Genel Bakış

TSOFT_APPS, TSOFT e-ticaret platformu üzerinde çalışan mağazalara yönelik bir JavaScript entegrasyon arayüzüdür. Bu dokümantasyon, callback-test.js dosyasında tanımlı tüm callback noktalarını, ne zaman tetiklendiklerini, hangi parametreleri döndürdüklerini ve nasıl kullanılacaklarını açıklamaktadır.

Tüm callback tanımlamaları window'un DOMContentLoaded olayının içinde yapılmalıdır; aksi takdirde TSOFT_APPS nesnesi henüz hazır olmayabilir.

Temel Kullanım Şekli

Her callback, ilgili dizi nesnesine bir fonksiyon push edilerek kayıt altına alınır:

window.addEventListener('DOMContentLoaded', function () {
  TSOFT_APPS.<grup>.<callback>.push(function (params) {
    // Buraya kendi kodunuzu yazın
  })
})

Örnek Callback Kullanımı:

Ürün Detay Sayfası : https://tsoftappsv5.tsoft.biz/ornek-urun-3-sari
Konsol üzerinden ilgili sayfaya ait Callback kodunu ekleyebilirsiniz. İlgili eventler konsol üzerinden listelenecektir.

TSOFT_APPS.product.detail.callback.push(function
 (params) {console.log("Product2Detail: ", params)})

Çıktı:

{
  "available": true,
  "barcode": "",
  "brand": "T-Soft",
  "category": "Gömlek",
  "category_id": "346",
  "category_ids": "346,343,342,350,349,348,347,345,344",
  "category_path": "Kadın > Üst Giyim >",
  "code": "T774",
  "currency": "TL",
  "currency_target": "TL",
  "id": "774",
  "image": "https://public.tsoftcdn.com/Data/O/D77/755.webp",
  "model": "",
  "name": "Örnek Ürün 4 - İlişkili Ürün (Sarı)",
  "personalization_id": 0,
  "price": 665.83333333,
  "quantity": 399987,
  "sale_price": 565.9583333305,
  "subproduct_code": "TK0276",
  "subproduct_id": "810",
  "subproduct_name": "",
  "supplier_code": "T774",
  "total_base_price": 799,
  "total_price": 799,
  "total_sale_price": 679.15,
  "url": "ornek-urun-3-sari",
  "variant1": null,
  "variant2": null,
  "vat": 20
}

Örnek Event Kullanımı (Ürün İsmi Yazdırma) :

params[0] ile gelen tüm eventleri tetikleyebilirsiniz.

TSOFT_APPS.product.detail.callback.push(function (params) {
        console.log("Ürün İsmi: ", params[0].name)
    })

Ürün İsmi: Örnek Ürün 4 - İlişkili Ürün (Sarı)

Callback Özet Tablosu (22 adet)

Detaylı Callback Referansı

1. Sepet (Cart) Callbackleri

Kullanıcının sepet işlemlerini (ekleme, silme, güncelleme vb.) dinlemek için kullanılır.

cart.callback.add

Ne zaman tetiklenir: Sepete ürün eklendiğinde

Ne için kullanılır: Piksel izleme, analitik olayları veya özel bildirimler için kullanılabilir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.cart.callback.add.push(function (params) {
  console.log("Add2Cart: ", params)
})

cart.callback.delete

Ne zaman tetiklenir: Sepetten ürün silindiğinde

Ne için kullanılır: Stok yönetimi veya analitik takibi için uygundur.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.cart.callback.delete.push(function (params) {
  console.log("Delete2Cart: ", params)
})

cart.callback.deleteAll

Ne zaman tetiklenir: Sepet tamamen temizlendiğinde

Ne için kullanılır: Oturum sıfırlama veya analitik olayları için kullanılabilir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.cart.callback.deleteAll.push(function (params) {
  console.log("DeleteAll2Cart: ", params)
})

cart.callback.update

Ne zaman tetiklenir: Sepette tek bir ürün güncellendiğinde

Ne için kullanılır: Sepetteki bir ürünün miktarı veya özellikleri değiştirildiğinde tetiklenir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.cart.callback.update.push(function (params) {
  console.log("Update2Cart: ", params)
})

cart.callback.updateAll

Ne zaman tetiklenir: Sepet toplu olarak güncellendiğinde

Ne için kullanılır: Birden fazla ürünün aynı anda güncellendiği durumlarda çalışır.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.cart.callback.updateAll.push(function (params) {
  console.log("UpdateAll2Cart: ", params)
})

cart.callback.load

Ne zaman tetiklenir: Sepet yüklendiğinde

Ne için kullanılır: Sayfa yüklenirken veya sepet verileri sunucudan çekildiğinde tetiklenir. Sepet içeriğini özelleştirmek için idealdir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.cart.callback.load.push(function (params) {
  console.log("Load2Cart: ", params)
})

2. Sipariş (Order) Callbackleri

Sipariş sürecinin farklı adımlarını (adres, ödeme, onay) dinlemek için kullanılır.

order.address.callback

Ne zaman tetiklenir: Sipariş adres adımı tamamlandığında

Ne için kullanılır: Adres doğrulama veya kargo hesaplama işlemlerinde kullanılabilir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.order.address.callback.push(function (params) {
  console.log("Order2Address: ", params)
})

order.payment.callback

Ne zaman tetiklenir: Sipariş ödeme adımı tamamlandığında

Ne için kullanılır: Ödeme analitikleri veya güvenlik kontrolleri için uygundur.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.order.payment.callback.push(function (params) {
  console.log("Order2Payment: ", params)
})

order.approve.callback

Ne zaman tetiklenir: Sipariş onaylandığında (tamamlandığında)

Ne için kullanılır: Dönüşüm piksellerini, e-posta tetikleyicilerini veya sadakat puan sistemlerini burada başlatabilirsiniz.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.order.approve.callback.push(function (params) {
  console.log("Order2Approve: ", params)
})

3. Ödeme Yöntemi (PaymentMethods) Callbackleri

Kullanıcının ödeme yöntemi değiştirme işlemini dinlemek için kullanılır.

paymentMethods.callback.change

Ne zaman tetiklenir: Ödeme yöntemi değiştirildiğinde

Ne için kullanılır: Ödeme formlarını dinamik güncelleme veya taksit bilgisi göstermek için kullanılabilir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.paymentMethods.callback.change.push(function (params) {
  console.log("Payment2Change: ", params)
})

4. Ürün (Product) Callbackleri

Ürün detay, hızlı görüntüleme ve istek listesi işlemlerini dinlemek için kullanılır.

product.detail.callback

Ne zaman tetiklenir: Ürün detay sayfası yüklendiğinde

Ne için kullanılır: Ürün görüntüleme analitiği veya kişiselleştirme için idealdir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.product.detail.callback.push(function (params) {
  console.log("Product2Detail: ", params)
})

product.quickView.callback.open

Ne zaman tetiklenir: Hızlı görüntüleme (Quick View) açıldığında

Ne için kullanılır: Analitik veya ek içerik yükleme için kullanılabilir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.product.quickView.callback.open.push(function (params) {
  console.log("Product2QuickView: ", params)
})

product.wishList.callback.add

Ne zaman tetiklenir: İstek listesine ürün eklendiğinde

Ne için kullanılır: Davranışsal analitik veya e-posta pazarlama tetikleyicileri için kullanılabilir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.product.wishList.callback.add.push(function (params) {
  console.log("WishList2Add: ", params)
})

product.wishList.callback.delete

Ne zaman tetiklenir: İstek listesinden ürün silindiğinde

Ne için kullanılır: Kullanıcı bir ürünü istek listesinden çıkardığında tetiklenir.

Parametreler:

• id — Silinen kaydın benzersiz kimliği.
• product — Silinen ürünün bilgilerini içeren nesne.

TSOFT_APPS.product.wishList.callback.delete.push(function (id, product) {
  console.log("WishList2Delete: ")
  console.log("id: ", id)
  console.log("product: ", product)
})

5. Sayfa (Page) Callbackleri

Belirli sayfa türleri yüklendiğinde veya kullanıcı o sayfalara geldiğinde tetiklenir.

page.cart.callback

Ne zaman tetiklenir: Sepet sayfası yüklendiğinde

Ne için kullanılır: Ek öneri ürünleri veya indirim kupon alanı göstermek için kullanılabilir.

Parametreler:

• basket — Mevcut sepet içeriğini temsil eden nesne.
• cartLoad — Sepet yükleme durumuna ait ek veriler.

TSOFT_APPS.page.cart.callback.push(function (basket, cartLoad) {
  console.log("Page2Cart")
  console.log("Basket: ", basket)
  console.log("CartLoad: ", cartLoad)
})

page.category.callback

Ne zaman tetiklenir: Kategori sayfası yüklendiğinde

Ne için kullanılır: Kategori bazlı filtreleme veya banner yönetimi için idealdir.

Parametreler:

• CATEGORY_DATA — Aktif kategoriye ait bilgileri içeren nesne.
• PRODUCT_DATA — O kategoride listelenen ürün verilerini içeren nesne/dizi.

TSOFT_APPS.page.category.callback.push(function (CATEGORY_DATA, PRODUCT_DATA) {
  console.log("Page2Category")
  console.log("Category: ", CATEGORY_DATA)
  console.log("product: ", PRODUCT_DATA)
})

page.search.callback

Ne zaman tetiklenir: Arama sonuçları sayfası yüklendiğinde

Ne için kullanılır: Arama analitiği veya sonuç özelleştirme için kullanılabilir.

Parametreler:

• searchWord — Kullanıcının girdiği arama terimi (string).
• product — Arama sonucu dönen ürünlerin verilerini içeren nesne/dizi.

TSOFT_APPS.page.search.callback.push(function (searchWord, product) {
  console.log("Page2Search: ")
  console.log("searchWord: ", searchWord)
  console.log("product: ", product)
})

page.home.callback

Ne zaman tetiklenir: Ana sayfa yüklendiğinde

Ne için kullanılır: Kişiselleştirilmiş içerik yükleme veya kampanya banner yönetimi için kullanılabilir.

Parametreler: Parametre almaz.

TSOFT_APPS.page.home.callback.push(function () {
  console.log("Page2Home: ")
})

page.other.callback

Ne zaman tetiklenir: Tanımlanmamış diğer sayfalarda

Ne için kullanılır: Mağazadaki özel veya bilinmeyen sayfa türleri yüklendiğinde çalışır.

Parametreler: Parametre almaz.

TSOFT_APPS.page.other.callback.push(function () {
  console.log("Page2Other: ")
})

6. İzleme (Tracking) Callbackleri

Sipariş takip sayfasındaki onay, giriş ve kayıt adımlarını dinlemek için kullanılır.

page.tracking.approve.callback

Ne zaman tetiklenir: Sipariş takip onay adımında

Ne için kullanılır: Dönüşüm takibi veya müşteri bilgilendirmesi için kullanılabilir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.page.tracking.approve.callback.push(function (params) {
  console.log("Tracking2Approve: ", params)
})

page.tracking.login.callback

Ne zaman tetiklenir: Sipariş takip giriş adımında

Ne için kullanılır: Kullanıcı sipariş takibi için sisteme giriş yaptığında çalışır.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.page.tracking.login.callback.push(function (params) {
  console.log("Tracking2Login: ", params)
})

page.tracking.sign.callback

Ne zaman tetiklenir: Sipariş takip kayıt adımında

Ne için kullanılır: Kullanıcı sipariş takibi için yeni hesap oluşturduğunda / kayıt olduğunda tetiklenir.

Parametreler: Standartparamsnesnesi

TSOFT_APPS.page.tracking.sign.callback.push(function (params) {
  console.log("Tracking2Sign: ", params)
})

Önemli Notlar

1. Tüm callback tanımlamaları window DOMContentLoaded olayının içinde yapılmalıdır; aksi takdirde TSOFT_APPS nesnesi henüz hazır olmayabilir.
2. Birden fazla callback aynı olaya push edilebilir; hepsi sırayla çalışır.
3. params nesnelerinin içeriği mağaza yapılandırmasına göre farklılık gösterebilir; ilk çalıştırmada console.log ile yapıyı doğrulayın.
4. Performans için callback fonksiyonları mümkün olduğunca kısa tutulmalıdır; uzun işlemler asenkron (async/await veya setTimeout) yapılmalıdır.