Kurulum ve Tema Uygulama Uzantısı (App Embed) — RUTHH COD Form & Upsells

Shopify Tema Düzenleyicisi’nde RUTHH COD Form & Upsells Tema Uygulama Uzantısını (cod-app-embed) etkinleştirerek theme.liquid dosyasını düzenlemeden kapıda ödeme butonunun, açılır/gömülü formun ve mağaza koordinatörlerinin çalışmasını sağlamak.

• RUTHH COD Form & Upsells uygulamasının Shopify mağazanızda kurulu olması.
• Online Mağaza → Temalar bölümünde aktif temayı düzenleme yetkinizin bulunması.
• Form Builder → Form Designer içindeki Ülkeler (Countries) kartında en az bir teslimat ülkesinin etkin olması.

1. Shopify Yönetim Paneli’nde RUTHH COD Form & Upsells (/app) sayfasını açın.
2. Kurulum kontrol listesindeki Theme App Embed durum kartını bulun.
3. Enable in Theme Editor butonuna tıklayın. Bu bağlantı (buildThemeEditorUrl), aktif temanızın düzenleyicisini cod-app-embed uzantısı seçili olarak (?context=apps&activateAppId={apiKey}/cod-app-embed) açar.

1. Tema Düzenleyicisi’nin sol panelindeki App embeds (Uygulama yerleştirmeleri) sekmesinde RUTHH COD Form & Upsells anahtarının Açık (On) olduğunu doğrulayın.
2. Sağ üst köşedeki Save (Kaydet) butonuna tıklayın.
3. RUTHH COD Form & Upsells yönetim paneli sekmesine geri dönün. Uygulama, pencere odaklandığında useEmbedActivation() (shopify.app.extensions()) aracılığıyla durumu otomatik kontrol eder ve rozeti Active (Aktif) olarak günceller.

Varsayılan olarak App Embed (cod-app-embed), ürün sayfalarındaki (form[action*="/cart/add"]) ve sepet sayfası/çekmecesindeki (button[name="checkout"], input[name="checkout"]) buton yerleşimini otomatik olarak yönetir.

Belirli bir ürün şablonunda COD butonunun veya gömülü formun tam dikey konumunu kendiniz belirlemek isterseniz:

1. Shopify Tema Düzenleyicisi’nde Ürünler → Varsayılan ürün (veya özel ürün şablonunuz) sayfasına gidin.
2. Ürün bilgileri (Product information) bölümü altında Blok ekle (Add block) seçeneğine tıklayın ve Uygulamalar altından COD Form (cod-form) bloğunu seçin.
3. Bloğu istediğiniz konuma (örneğin varyant seçicinin veya satın alma butonlarının hemen altına) sürükleyin ve Save butonuna tıklayın.

• Yayında olmayan (taslak) temalar: Taslak bir temada test yapıyorsanız Online Mağaza → Temalar → Özelleştir adımıyla ilgili taslak temanın düzenleyicisini açıp App embeds altından uzantıyı etkinleştirin.

• Tema Düzenleyicisi’nde kaydettikten sonra durum rozeti hâlâ “Inactive” görünüyor:
  1. Değişikliği taslak bir tema yerine yayındaki (canlı) temanızda kaydettiğinizden emin olun.
  2. Uygulama sekmesine tekrar tıklayın veya /app sayfasını yenileyerek shopify.app.extensions() sorgusunun güncellenmesini sağlayın.
• Etkinleştirme sonrasında ürün veya sepet sayfasında COD butonu görünmüyor:
  1. Settings → Visibility (/app/settings) ekranında Form Display ayarının Disabled (Devre Dışı) olmadığını veya yalnızca sepet sayfasıyla (Cart page only) sınırlandırılmadığını kontrol edin.
  2. Ürünün, ürün/koleksiyon hedefleme kuralları veya minimum/maksimum ara toplam sınırları nedeniyle hariç tutulmadığını doğrulayın.

• Ürüne Genel Bakış ve Mimari
• Görünürlük ve Gösterim Kuralları
• Sorun Giderme Rehberi