Form Alanları, Doğrulama ve Kademeli İl/İlçe Seçimi — RUTHH COD Form & Upsells
Amaç ve Beklenen Sonuç
Section titled “Amaç ve Beklenen Sonuç”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.
Ön Koşullar
Section titled “Ön Koşullar”- 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.
Numaralı Uygulama Adımları
Section titled “Numaralı Uygulama Adımları”1. Aktif Teslimat Ülkelerini Ayarlayın (CountriesCard)
Section titled “1. Aktif Teslimat Ülkelerini Ayarlayın (CountriesCard)”- Form Builder → Form Designer (
/app/form-builder) sayfasını açın. - Countries (Ülkeler) kartını (
FormConfiguration.countries) bulun. - 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. - Ü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”- 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.
- Alanları mağaza akışınıza göre sürükleyip yeniden sıralayın.
- Herhangi bir alana (
Ad,Soyad,Telefon,E-posta,Adres,Adres 2,İl / Eyalet,İlçe / Şehir,Posta KoduveyaSipariş 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”- Form Designer içinde Province / State (İl) ve City / District (İlçe) alanlarını etkinleştirin.
- Seçilen teslimat ülkesi yapılandırılmış alt bölge verisine sahip olduğunda (Türkiye
TRiç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üdarvb.) otomatik olarak filtrelenir.
- SaveBar üzerindeki Save butonuna tıklayarak güncel
cod_form.v2_snapshotverisini yayınlayın.
Uyarılar ve Uç Durumlar
Section titled “Uyarılar ve Uç Durumlar”- 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.
Sorun Giderme Adımları
Section titled “Sorun Giderme Adımları”- İ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.