Ideal House
İçeriğe atla

Ecwid entegrasyonu#

Bir Ecwid özel mağaza vitrini uygulaması ve dokümante edilmiş Storefront JS API yaşam döngüsünü kullanarak Ecwid ürün sayfalarına Room Visualizer denetimlerini ekleyin.

Doğrulama durumu: Ecwid Storefront JS API dokümantasyonu 7 Eylül 2026 tarihinde incelendi. Kullanılabilir bir Ecwid uygulaması veya satıcı test mağazası yoktu. Sayfa yükü alanları, dağıtım öncesi güncel OnPageLoaded referansına karşı doğrulanmalıdır.

SDK yüklenmeden önce: Panel → Ayarlar sayfasını açın, mağaza vitrini kökeninizi Allowed Origins (CORS) listesine ekleyin ve Kaydet düğmesine tıklayın. Yayımlanan ana bilgisayar adını ve kullandığınız önizleme veya test ortamı kökenlerini dahil edin; birden fazla kökeni virgülle ayırın. yapılandırma adımları bölümüne bakın.

Ön koşullar ve desteklenen yol#

Ecwid, kalıcı mağaza vitrini özelleştirmesi için kendine ait barındırılan bir JavaScript dosyası gerektiren özel bir uygulama ister. Bir Ecwid geliştirme mağazası/uygulaması, HTTPS-barındırılan bir adaptör dosyası, Shop ID, Publishable Key ve içe aktarılmış ürün/çeşitlilik SKU'larını hazırlayın.

Eğer Ecwid başka bir CMS'e gömüldüyse, kod için güvenilir yer, Ecwid mağaza vitrininde çalıştığı için özel mağaza vitrini uygulaması olmaya devam eder. Üst sayfa betiği, her gömme modunda aynı yaşam döngüsünü veya belgesi paylaşmayabilir.

Minimal SDK sözleşmesi#

html
<script
  src="https://sdk.ideal.house/sdk.js"
  data-shop-id="<SHOP_ID>"
  data-publishable-key="<PUBLISHABLE_KEY>"
  async
></script>

<div data-idealhouse-button-container data-product-code="CHAIR-OAK-01"></div>

ideal.house sku olarak içe aktardığınız tam Ecwid SKU'yu kullanın.

Ecwid mağaza vitrini uygulamanızı başlatın#

Kendine ait barındırılan dosyayı kaydetmek için Ecwid'nin özel mağaza vitrini hızlı başlangıcını izleyin. Dokümante edilmiş API-hazır geri çağırmasıyla başlatın, ardından ideal.house SDK'ü bir kez yükleyin:

js
Ecwid.OnAPILoaded.add(function () {
  if (document.querySelector('script[src="https://sdk.ideal.house/sdk.js"]')) return;

  const script = document.createElement('script');
  script.src = 'https://sdk.ideal.house/sdk.js';
  script.async = true;
  script.dataset.shopId = '<SHOP_ID>';
  script.dataset.publishableKey = '<PUBLISHABLE_KEY>';
  document.head.append(script);
});

Çoklu mağaza uygulaması için, iki herkese açık ideal.house değerini uygulamanızın güvenli herkese açık yapılandırmasından alın. Asla bir Ecwid uygulama gizli anahtarı, erişim belirleyicisi veya ideal.house Client Secret'ı bu dosyaya koymayın.

Ürün sayfalarında görüntüleme#

Ecwid, Ecwid.OnPageLoaded.add()'i dokümante eder ve geri çağırmasına sayfa bilgisi sağlar. Ürün sayfası türünü ve tanımlayıcısını doğrulamak için güncel API referansını kullanın, ürün verilerini Ecwid'in desteklediği istemci arayüzü üzerinden getirin veya okuyun, ardından çözümlenen SKU'ı şuna iletin:

js
function mountIdealhouse(host, sku) {
  host.replaceChildren();
  const code = String(sku || '').trim();
  if (!code) return;

  const container = document.createElement('div');
  container.dataset.idealhouseButtonContainer = '';
  container.dataset.productCode = code;
  host.append(container);
}

Ecwid sayfa görüntülemesini bitirdikten sonra host'ı kararlı bir ürün detayları konumuna yerleştirin. Sayfa türü değiştiğinde önceki ana eviyi kaldırın. DOM seçici ve sayfa yükünden ürüne arama, Ecwid mağaza vitrini yerleşimleri ve yük sürümleri değişebileceğinden müşteri adaptör kodudur.

Seçenekler ve gezinme#

Bir alışverişçi ürün seçeneklerini seçtiğinde, Ecwid satın alınabilir çeşitliliği ve onun SKU'unu çözümlenene kadar bekleyin. O SKU ile mountIdealhouse()'yi çağırın veya seçim eksikse kapsayıcı öğeyi temizleyin. Kod üretmek için seçenek etiketlerini birleştirmeyin.

Ecwid tek sayfalı bir mağaza vitrinidir. Tarayıcı DOMContentLoaded'a yalnızca dinlemek yerine dokümante edilmiş sayfa yaşam döngüsünü (OnPageLoaded/sayfa değiştirme geri çağrılarını) kullanın. Kategori/arama gezinme, tarayıcı Geri/İleri, gömülü widget'lar ve ürün açılır pencereleri, eski ürün kapsayıcı öğelerini kaldırmalı ve görüntüleme sonrası yeni bir konteyner bağlamalıdır.

Ürünleri içe aktarma#

Ecwid ürün ve çeşitlilik SKU alanlarını dışa aktarın ve ideal.house sku'a eşleyin. Ürün yükleme'yi, ürünleri içe aktar, iş durumu, ürünleri listele, ürünleri güncelle, ürünü sil ve hatalar ve yeniden denemeler dahil kullanın.

Herhangi bir Ecwid REST API dışa aktarma, webhook, OAuth kurulumu veya düzenli senkronizasyon müşteriye aittir ve uygun Ecwid yetkilendirmesiyle sunucu tarafında uygulanmalıdır.

Doğrulama ve kaldırma#

Uygulama kurulumunu, API başlatmayı, ürün/kategori/arama geçişlerini, her çeşitliliği, eksik ve bilinmeyen SKU'ları, tarayıcı Geri/İleri'yi, başka bir sitede gömülü Ecwid widget'ını, mobil yerleşimi, onayı ve oturum açılmış/kapalı müşterileri test edin. Kapsayıcı öğeyi içeren belgede tek bir SDK isteğini ve tam SKU eşitliğini doğrulayın.

Kaldırmak için, kendine ait barındırılan JavaScript dosyasını özel uygulamadan ayırın veya uygulamayı kaldırın, enjekte edilen ana evileri/dinleyicileri kaldırın ve mağaza vitrini gezinmesi ve sert yenileme sonrası SDK URL'ın ve tüm data-idealhouse-* düğümlerinin kaybolduğunu doğrulayın.

Resmi platform referansları#