TR

Form Alanları, Doğrulama ve Kademeli İl/İlçe Seçimi — RUTHH COD Form & Upsells

Form Builder → Form Designer (/app/form-builder) ekranında giriş alanlarını, bölüm sıralamasını, doğrulama kurallarını, aktif teslimat ülkelerini ve Ülke → İl → İlçe kademeli adres seçicilerini yapılandırmak.

  • Form Builder → Form Designer (/app/form-builder) ekranına erişiminizin olması.
  • Kargo firmanızın ve operasyon sürecinizin ihtiyaç duyduğu teslimat ülkelerini ve zorunlu adres alanlarını belirlemiş olmanız.

1. Aktif Teslimat Ülkelerini Ayarlayın (CountriesCard)

Section titled “1. Aktif Teslimat Ülkelerini Ayarlayın (CountriesCard)”
  1. Form Builder → Form Designer (/app/form-builder) sayfasını açın.
  2. Countries (Ülkeler) kartını (FormConfiguration.countries) bulun.
  3. Tek ülke veya çoklu ülke modunu seçin, gönderim yaptığınız ISO ülke kodlarını ekleyin ve Varsayılan Ülke (defaultCountry) ayarını belirleyin.
  4. Ülke uygunluk rozetlerini kontrol edin ve Shipping Rates kısayolunu kullanarak her aktif ülke için uygun bir COD kargo kuralı tanımlandığından emin olun.

2. Form Bölümlerini Sıralayın ve Alan Görünürlüğünü Yönetin

Section titled “2. Form Bölümlerini Sıralayın ve Alan Görünürlüğünü Yönetin”
  1. Form Designer sol panelindeki Form Elements listesinde yer alan bölümleri (Sipariş Özeti, Kargo Ücretleri, Müşteri ve Teslimat Alanları, Ek Satış Blokları ve Gönder Butonu) inceleyin.
  2. Alanları mağaza akışınıza göre sürükleyip yeniden sıralayın.
  3. Herhangi bir alana (Ad, Soyad, Telefon, E-posta, Adres, Adres 2, İl / Eyalet, İlçe / Şehir, Posta Kodu veya Sipariş Notu) tıklayarak şu ayarları yapın:
    • Visible (Görünür): Alanı mağaza formunda gösterin veya gizleyin.
    • Required (Zorunlu): Sipariş kabul edilmeden önce hem tarayıcıda hem sunucuda zorunlu alan doğrulaması uygulayın.
    • Label & Placeholder: Alan başlığını ve yardımcı ipucu metnini özelleştirin.
    • Hide Label (hideLabel) ve Show Icon (showIcon): Her alan için bağımsız olarak etiket gizleme ve ikon gösterme tercihini belirleyin.

3. Kademeli İl ve İlçe Seçicilerini Etkinleştirin

Section titled “3. Kademeli İl ve İlçe Seçicilerini Etkinleştirin”
  1. Form Designer içinde Province / State (İl) ve City / District (İlçe) alanlarını etkinleştirin.
  2. Seçilen teslimat ülkesi yapılandırılmış alt bölge verisine sahip olduğunda (Türkiye TR için eksiksiz 81 il ve tüm ilçeler dahildir), mağaza formu serbest metin kutularını otomatik olarak kademeli açılır listelere dönüştürür:
    • Ülke seçildiğinde İl listesi yüklenir.
    • İl (örneğin İstanbul) seçildiğinde ilgili İlçe seçenekleri (Kadıköy, Beşiktaş, Üsküdar vb.) otomatik olarak filtrelenir.
  3. SaveBar üzerindeki Save butonuna tıklayarak güncel cod_form.v2_snapshot verisini yayınlayın.
  • Telefon Doğrulaması: Telefon numaraları sahte sipariş kara listeleri kontrol edilmeden ve sipariş oluşturulmadan önce seçilen ülke koduna göre sunucuda normalize edilerek doğrulanır.
  • İlçe açılır listesi dolmuyor: Province / State (İl) alanının açık ve görünür olduğunu ve desteklenen bir ülkenin (örneğin TR) seçildiğini doğrulayın.
  • Gizlenen bir alan yüzünden form gönderilemiyor: Görünürlüğünü kapattığınız bir alanı Required (Zorunlu) olarak işaretlemeyin; şema doğrulayıcısı çelişkili gizli+zorunlu durumların kaydedilmesini engeller.