OpenCart entegrasyonu#
Room Visualizer'ü bir OpenCart 4 uzantısı veya özel tema aracılığıyla ekleyin ve kararlı bir mağaza vitrini ürün kodunu ideal.house kataloğuna eşleyin.
Doğrulama durumu: OpenCart 4 uzantı belgeleri 7 Eylül 2026 tarihinde incelendi. Test mağazası mevcut değildi. OpenCart 3 ve üçüncü taraf temalar farklı yollar ve olay sözleşmeleri kullanır; bu kılavuzu kurulu ana sürüme uyarlayın.
SDK'ü yüklemeden önce: Panel → Ayarlar sayfasını açın, mağaza vitrininizdeki kökeni (origin) Allowed Origins (CORS) listesine ekleyin ve Kaydet düğmesine tıklayın. Yayımlanan ana bilgisayar adını ve kullandığınız önizleme veya ön üretim (staging) 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 kod seçimi#
Bir ön üretim mağazası, uzantı/tema geliştirme erişimi, Shop ID, Publishable Key ve içe aktarılmış test kayıtları hazırlayın. OpenCart çekirdeği genellikle ürün şablonlarında model'i açıklar, ancak SKU sürüm ve temaya bağlı olarak denetleyici/uzantı işi gerektirebilir. Bir değeri seçin ve ideal.house sku olarak tutarlı bir şekilde kullanın.
Çekirdek katalog dosyalarını doğrudan düzenlemeyin. Değişiklikleri bir OpenCart 4 uzantısı olarak paketleyin veya sürüm kontrolü yapılan özel bir temada tutun.
Minimal SDK sözleşmesi#
<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>
Ürün Kodu, içe aktarılmış ideal.house sku ile karakter karakter eşit olmalıdır.
Ürün konteynerini görüntüleyin#
Aktif ürün şablonunu uzantınız aracılığıyla genişletin. OpenCart model alanını bilinçli olarak ideal.house sku'e eşlediyseniz, bunu ürün eylemlerinin yakınına yerleştirin:
{% if model %}
<div class="idealhouse-host">
<div
data-idealhouse-button-container
data-product-code="{{ model }}">
</div>
</div>
{% endif %}
Twig otomatik kaçış işlemi (autoescaping) ortam yapılandırmasına bağlıdır; seçilen değerin HTML-özniteliği olarak kaçış işlemine tabi tutulduğundan emin olun. Gerçek SKU alanını seçerseniz, o temizlenmiş değeri uzantınızda denetleyicinin şablon verilerine ekleyin ve model yerine onu görüntüleyin.
SDK'ü bir kez yükleyin#
Uzantı/tema mekanizması aracılığıyla bir mağaza vitrini JavaScript varlığı ekleyin. Gerekli özniteliklere sahip tek bir betik oluşturmalıdır:
if (!document.querySelector('script[src="https://sdk.ideal.house/sdk.js"]')) {
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);
}
İki halka açık değeri uzantı yapılandırmasında saklayın ve güvenli bir şekilde görüntüleyin. Asla bir ideal.house Client Secret'yi JavaScript, Twig, uzantı günlükleri veya önbelleğe alınmış HTML içine koymayın.
Seçenekler, varyantlar ve dinamik görüntüleme#
OpenCart seçenekleri, evrensel olarak SKU içeren varyantlarla bire bir eşleşmez. Mağazanız bir seçenek/varyant uzantısı kullanıyorsa, o uzantının belgelenmiş çözümlenmiş varyant geri çağırması ve veri modeliyle entegre edin. Konak öğesini yalnızca tam seçilen kodu sağladığında değiştirin:
function renderIdealhouseCode(host, productCode) {
host.replaceChildren();
const code = String(productCode || '').trim();
if (!code) return;
const container = document.createElement('div');
container.dataset.idealhouseButtonContainer = '';
container.dataset.productCode = code;
host.append(container);
}
Bu, müşteri adaptör kodudur; bu kılavuzda evrensel bir OpenCart varyant olayı yoktur. AJAX arama, kategori filtreleri, açılır pencereler ve hızlı görüntüleme için, uzantının şablonlarında temiz konteynerler görüntüleyin veya köprüyü belgelenmiş tamamlama geri çağırmasından çağırın. Asla SDK tarafından üretilen çocuk öğeleri kopyalamayın.
Ürünleri içe aktarın#
Her görselleştirilebilir öğe için seçilen OpenCart model/SKU'ü dışa aktarın ve ideal.house sku'ye eşleyin. Ürün yükleme kullanın, ardından ürünleri içe aktar, iş durumu, ürünleri listele, ürünleri güncelle, ürünü sil ve hatalar ve yeniden denemeler adımlarını izleyin.
OpenCart Yönetici API çağrıları, zamanlanmış dışa aktarmalar, olay dinleyicileri ve webhooks, müşteriye ait entegrasyon işidir.
Doğrula ve kaldır#
Basit ürünleri, desteklenen her seçenek kombinasyonunu, eksik ve yinelenen kodları, bilinmeyen ideal.house SKU'larını, kategori/arama sayfalarını, hızlı görüntülemeyi, tarayıcı Geri/İleri işlevlerini, mobil düzeni, birden fazla mağazayı, dilleri/para birimlerini, onayı ve üretim önbellekleme/küçültme işlevlerini test edin. Tam olarak tek bir SDK isteği ve tam kod eşleşmesini doğrulayın.
Kaldırmak için, uzantıyı devre dışı bırakın/kaldırın veya özel tema geçersiz kılma işlevini ve varlığı kaldırın, OpenCart değişiklikleri/olaylarını yenileyin, tema/CDN önbelleklerini temizleyin ve SDK isteği ve konteynerlerinin bulunmadığını doğrulayın.