Görünürlük ve Gösterim Kuralları — RUTHH COD Form & Upsells

Settings → Visibility (/app/settings) ve Form Builder → Form Designer (/app/form-builder) ekranlarını kullanarak COD formunun hangi sayfalarda görüneceğini, ürün sayfası siparişlerinin mevcut sepet ürünlerini kapsayıp kapsamayacağını, hangi ürün/koleksiyonların kapıda ödemeye uygun olduğunu ve yerel Shopify butonlarının nasıl davranacağını yapılandırmak.

• Tema Uygulama Uzantısının (cod-app-embed) aktif temanızda etkinleştirilmiş olması.
• Mağaza ürün ve koleksiyonlarınızın Online Mağaza satış kanalında yayında olması.

1. Form Builder → Form Designer (/app/form-builder) sayfasına gidin.
2. Form Type kartında desteklenen iki moddan birini seçin:
   • Popup (POPUP): Uygun ürün sayfalarında, sepet sayfasında ve sepet çekmecesinde özelleştirilebilir bir kapıda ödeme tetikleyici butonu gösterir. Butona tıklandığında form açılır pencere olarak açılır. İsterseniz Show product page offers (showProductPageOffers) seçeneğini açarak Adet İndirimlerini (Quantity Offers) form açılmadan önce doğrudan ürün sayfasında gösterebilirsiniz.
   • Embedded (EMBEDDED): COD sipariş formunu bir açılır pencere butonu yerine doğrudan ürün sayfası düzeninin içine gömülü bir kart olarak yerleştirir.

1. Settings → Visibility (/app/settings) sayfasına gidin.
2. Form Display (displaySurface) altından COD deneyiminin nerede çalışacağını seçin:
   • Product and cart pages (PRODUCT_AND_CART — varsayılan; hem ürün hem sepet sayfalarında aktif)
   • Product pages only (PRODUCT_ONLY — yalnızca ürün sayfalarında aktif)
   • Cart page only (CART_ONLY — yalnızca sepet sayfasında ve çekmecesinde aktif)
   • Disabled (DISABLED — mağaza ön yüzünde gösterimi durdurur ve sunucuda tüm COD fiyat/sipariş isteklerini DISPLAY_DISABLED koduyla reddeder)
3. Order Contents (orderContents) altından ürün sayfası siparişlerinin nasıl oluşturulacağını seçin:
   • Current product + Cart items (CURRENT_PRODUCT_PLUS_CART — varsayılan; ürün sayfasında seçilen varyantı müşterinin Shopify sepetindeki mevcut ürünlerle birleştirir)
   • Current product only (CURRENT_PRODUCT_ONLY — sepetteki diğer ürünleri dikkate almadan yalnızca o anki ürün sayfasında seçilen ürünü sipariş eder)

1. Settings → Visibility (/app/settings) ekranında Product & Collection Targeting bölümüne gelin.
2. Shopify Kaynak Seçici (Resource Picker) butonlarını kullanarak şunları belirleyin:
   • Dahil Edilen Ürünler (includeProductGids — en fazla 100 ürün)
   • Hariç Tutulan Ürünler (excludeProductGids — en fazla 100 ürün)
   • Dahil Edilen Koleksiyonlar (includeCollectionGids) ve Hariç Tutulan Koleksiyonlar (excludeCollectionGids — iki liste toplamında en fazla 25 koleksiyon)
3. Sunucu ve mağaza ön yüzünde uygulanan kesin öncelik sırasına dikkat edin:
   • Kural 1 — Hariç Tutma Her Zaman Önceliklidir (Exclude Always Wins): excludeProductGids listesindeki veya excludeCollectionGids içindeki bir koleksiyona üye olan hiçbir ürün kapıda ödemeye uygun değildir (PRODUCT_EXCLUDED).
   • Kural 2 — Dahil Listelerinin Birleşimi: Her iki dahil etme listesi de boşsa, hariç tutulmayan tüm ürünler uygundur. Dahil listelerinden herhangi biri doluysa, ürünün includeProductGids içinde olması VEYA includeCollectionGids koleksiyonlarından birine üye olması gerekir (PRODUCT_NOT_INCLUDED).
   • Kural 3 — Karma Sepet Kuralı: Siparişteki tüm ana ürünlerin uygun olması şarttır; sepetteki tek bir uygunsuz ürün tüm siparişi kapıda ödemeye kapatır.

1. Settings → Visibility ekranında Order Value (orderValue) bölümünü bulun.
2. Mağaza para biriminizde isteğe bağlı Minimum Ara Toplam (minSubtotalMinor) ve/veya Maksimum Ara Toplam (maxSubtotalMinor) değerlerini girin.
3. SaveBar üzerinden Save butonuna tıklayın. Bu sınırlar, kargo, ek ücret ve vergiler öncesindeki (ancak Adet İndirimi veya paket indirimleri sonrasındaki) net ürün ara toplamı üzerinden değerlendirilir.

1. Settings → Visibility ekranında Native Shopify Buttons (buttons) bölümünü bulun:
   • Hide Shopify Checkout button (hideCheckoutButton — sepet sayfası ve sepet çekmecesindeki Ödeme butonu)
   • Hide Add to Cart button (hideAddToCartButton — ürün sayfasındaki Sepete Ekle butonu)
   • Hide Buy Now / Dynamic Checkout button (hideBuyNowButton — ürün sayfasındaki Hemen Al / Dinamik Ödeme butonu)
2. İstediğiniz seçenekleri işaretleyip Save butonuna tıklayın.

• Çakışan Listeler Reddedilir: Aynı ürün hem dahil hem hariç listesine eklenemez; aynı koleksiyon hem dahil hem hariç koleksiyon listesinde yer alamaz.

• Sipariş MIXED_PRODUCTS_NOT_ALLOWED hatasıyla reddediliyor: displaySurface ayarı PRODUCT_ONLY ve orderContents ayarı CURRENT_PRODUCT_ONLY iken birden fazla farklı ana ürün gönderilmeye çalışıldığında sunucu bu isteği engeller.
• Sipariş SUBTOTAL_BELOW_MINIMUM veya SUBTOTAL_ABOVE_MAXIMUM ile reddediliyor: Ara toplam sınırlarının kargo dahil toplama değil, indirimler düşüldükten sonraki net ürün ara toplamına uygulandığını unutmayın.

• Kurulum ve Tema Uygulama Uzantısı (App Embed)
• Form Alanları, Doğrulama ve Kademeli İl/İlçe Seçimi
• COD Kargo Ücretlerini Yapılandırma