Ön yüz formlarına genel bakış

Bir form, sitenizin ziyaretçilerinin veya üyelerinin wp-admin'e girmeden normal bir sayfadan içerik oluşturmasını ya da değiştirmesini sağlar. Formu yönetim panelinde mevcut alan gruplarınızdan (veya bir veri tablosundan) oluşturursunuz; eklenti formu çizer, girdiyi denetler, spamdan korur ve değerleri düzenleme ekranlarıyla birebir aynı şekilde kaydeder.

Şunu açın: WPM Fields › Forms (wp-admin/admin.php?page=wpmcf-forms, Pro tools menüsünde). Ekranda iki sekme vardır:

• Forms: bu sitenin formları (bu sayfa ve sonraki sayfalar);
• Connections: diğer form eklentilerinin gönderimlerini bir veri tablosuna kaydedin, bkz. Diğer form eklentilerine bağlantılar.

Formlar bir Pro özelliğidir. Ücretsiz eklentide form yoktur.

Dört tür

Şu tür: Data table entry yalnızca planınız veri tablolarını da içeriyorsa sunulur (Pro içerir).

Forms listesi

Hiç form yoksa ekranda No forms yet yazar: "Build a form from your field groups, then put its shortcode or the "WPM Form" block on any page." Bir formu silerken Delete form? sorulur ("«Title» disappears from every page that shows it. Entries it already created stay."); formun oluşturduğu yazılara, kullanıcılara ve satırlara dokunulmaz.

İlk yapılacak şey Create a form düğmesine tıklamaktır.

Bir formu sayfaya yerleştirme

Bir sayfada, yazıda, shortcode çalıştıran bir widget alanında veya şablonda şunlardan birini kullanın:

• shortcode: [wpmcf_form key="contact"];
• blok: WPM Form (kategori: Widgets). Formu Form › Form bölümünden seçin; pasif formlar "(inactive)" ile işaretlenir.

Var olan bir yazıyı düzenlemek için yazı formu ayrıca bir yazı kimliği (ID) alır: [wpmcf_form key="submit_event" post_id="123"] veya bloktaki Edit post ID alanı; bkz. Yazı formları.

Bilinmeyen bir anahtar ziyaretçilere hiçbir şey yazdırmaz; yöneticiler There is no form with the key "x". Only administrators see this note. notunu görür. Formun stil dosyası ve betiği yalnızca form içeren sayfalarda yüklenir.

Bir gönderim nasıl çalışır

1. Ziyaretçi formu doldurur ve düğmeye tıklar. Tarayıcı formu, aynı sayfaya olağan bir post isteği olarak gönderir (multipart olduğundan dosyalar da çalışır). admin-ajax yoktur ve göndermek için JavaScript gerekmez.
2. Sunucu şu sırayla denetler: lisans, honeypot, güvenlik kanıtı (misafirler için imzalı bir token, oturum açmış kullanıcılar için bir nonce), formu kimlerin kullanabileceği, hız sınırı, kendi CAPTCHA filtreniz, yinelenen gönderim koruması, ardından değerler (türler, zorunlu alanlar, yüklemeler). Bkz. Misafirler ve spam koruması.
3. Başarılı olursa kayıt saklanır, isteğe bağlı e-posta gönderilir ve ziyaretçi, ?wpmcf_done=... işaretiyle birlikte sayfaya geri yönlendirilir (HTTP 303). Sayfa daha sonra Success message metninizi bir kez gösterir (ya da ziyaretçi bunun yerine Redirect to adresine gönderilir). Sayfayı yeniden yüklemek mesajı tekrar göstermez ve formu asla iki kez göndermez.
4. Bir sorun olduğunda aynı sayfa, Your entry was not sent: başlıklı ve her sorunu ilgili alana bağlantıyla listeleyen bir kutuyla yeniden gösterilir; ziyaretçinin yazdığı değerler korunur (parola asla korunmaz).

Sayfa önbelleğe alınabilir: misafir kanıtı, ziyaretçiye özel bir nonce değil, imzalı bir token'dır ve bir betik göndermeden önce eski token'ı yeniler. Oturum açmış ziyaretçiler nonce alır; bu yüzden sayfa önbelleğinin oturum açmış ziyaretçilere bir formun önbelleğe alınmış kopyasını sunmasına izin vermeyin.

Gönder düğmesi tıklandıktan sonra devre dışı kalır; böylece çift tıklama formu iki kez göndermez.

Bir formda hangi alan türleri çalışır

Form, seçilen alan gruplarının (veya tablo sütunlarının) herkese açık bir sayfada çalışabilen türdeki tüm alanlarını gösterir. Form düzenleyicide çalışamayan bir alan Not available in forms rozetiyle listelenir ve formda yer almaz.

Kapsayıcılar için kurallar:

• Bir Group veya Repeater yalnızca alt alanlarının tümü çalışıyorsa çalışır. Alt alanı Image olan bir repeater kullanılamaz olarak listelenir; çünkü yüklemeler yalnızca en üst düzeydeki alanlarda çalışır.
• Düzen alanları (Tab, Accordion) alan olarak gösterilmez; alan listesinde yer almaz.
• Image ve File alanları ziyaretçinin cihazından yükleme yapar (bkz. Dosya yüklemeleri).
• Bir Password alanı çalışır. Alanın Confirm seçeneği açıksa parolayı iki kez ister, bir karma (hash) saklar ve parolayı asla geri yazdırmaz.
• Conditional logic ve Required ayarları, alanlarda belirlendiğinde formda da düzenleme ekranlarındaki gibi çalışır.
• Formun gösteremediği bir alan, form var olan bir yazıyı veya kullanıcıyı düzenlerken değiştirilmeden bırakılır.

Planlar ve lisanslar

Bir lisansın süresi dolduğunda veya deneme sona erdiğinde:

• Forms ekranı ve API'si kilitlenir (Your current plan does not include this feature.);
• form tanımları korunur;
• sayfadaki bir form ziyaretçilere hiçbir şey yazdırmaz; yöneticiler ise Your plan does not include front-end forms, so visitors do not see this form. Only administrators see this note. notunu görür;
• yine de ulaşan bir gönderim This form is not available right now. yanıtıyla reddedilir;
• daha önce oluşturulmuş kayıtlar (yazılar, kullanıcılar, satırlar) kalır.

Bkz. Deneme, yenileme ve süre sonu.

Stillendirme

Form sade, anlamsal HTML'dir: form.wpmcf-form (ayrıca wpmcf-form--post, --user-profile, --user-register veya --entry), .wpmcf-form__field, .wpmcf-form__label, .wpmcf-form__input, .wpmcf-form__help, .wpmcf-form__errors, .wpmcf-form-notice ve .wpmcf-form__submit düğmesi; bu düğme ayrıca WordPress'in wp-element-button sınıfını taşır, böylece temanız onu her blok düğmesi gibi stillendirir. Form görünen yerde küçük bir varsayılan stil dosyası yüklenir.

Geliştiriciler için

• Bir kayıt saklandıktan sonra wpmcf/forms/submitted action'ı tetiklenir (form, nesne ID'si, tür); bkz. action başvurusu.
• Hız sınırı, istemci IP'si, CAPTCHA, yüklemeler, kayıt rolleri ve parola gücü için filtreler sonraki sayfalarda ve filtre başvurusunda açıklanır.
• Form tanımları form_{key} ayar satırları olarak saklanır ve /wp-json/wpmcf/v1/forms altındaki REST rotalarıyla yönetilir (yalnızca yönetici; plan her çağrıda denetlenir).