Her alanın ortak ayarları

Her alan, kendi Type settings ayarlarının (her türün sayfasında anlatılır) yanı sıra aynı seçenek kümesine sahiptir. Bunlara, WPM Fields › Field Groups ekranında bir alanı açıp alanın Advanced options panelini kullanarak ulaşırsınız. Sekmeler şunlardır: Type settings, General, Validation, Display ve Conditional logic. Alan grupları sayfası oluşturucunun kendisini anlatır; bu sayfa ise seçeneklerin türlere göre nasıl davrandığını açıklar.

General sekmesi

Varsayılan değerler

• Varsayılan değer veritabanı sütununun bir parçasıdır; bu yüzden nesne için bir satır oluşturulduğunda uygulanır, yani grubun herhangi bir alanı o yazı, kullanıcı veya terim için ilk kez kaydedildiğinde. O âna kadar nesnenin satırı yoktur ve wpmcf_get_field(), null (ya da ilettiğiniz default argümanı, aşağıya bakın) döndürür.
• Yeni bir nesnenin düzenleme ekranında denetim varsayılan değerle önceden doldurulur.
• İçinde {{ expression }} bulunan bir varsayılan değer (örneğin {{ wp.post_title }}) düzenleme ekranında nesne başına hesaplanır ve SQL sütun varsayılanı olarak saklanmaz; sütun varsayılan almaz, dolayısıyla düzenleme ekranını hiç açmayan nesneler boş başlar.
• Varsayılan değer türe uymalıdır. Date veya Time varsayılanı, sütun biçiminde tam bir değer olmalıdır (2026-01-01, 08:30:00); aksi halde grup kaydedilemez ("the default value does not fit this field type"). Password hiçbir zaman varsayılan değer almaz.
• Bir SQL sütun fonksiyonu olan (örneğin upper veya md5) bir alan aynı zamanda varsayılan değere sahip olamaz. Önce fonksiyonu temizleyin.
• JSON saklayan türler (Checkboxes, Link, Map, Group, Repeater, Relationship, Taxonomy, User) ve uzun metin türleri (Text area, URL, WYSIWYG, oEmbed) veritabanı varsayılanı taşıyamaz. Bunlarda varsayılan değer yalnızca düz metin kabul eden bir denetimi (örneğin Text area) önceden doldurabilir; yapılandırılmış değerleri kodla belirleyin.

Bundan ayrı olarak wpmcf_get_field() fonksiyonu, değer boş olduğunda döndürülen bir default argümanı kabul eder:

$phone = wpmcf_get_field( 'company', 'phone', $post_id, [ 'default' => 'Not available' ] );

[wpmcf_field] kısa kodu da aynı default="…" değerini kabul eder. Bkz. Çıktı, biçimler ve escape işlemi.

Constraints

Sunucuda zorunluluk bir engel değil, bir uyarıdır: klasik editör boş bir zorunlu alan içeren yazıyı kaydettiğinde yazı kaydedilir ve bir yönetici bildirimi "Saved, but these required fields are empty: …" der. Blok editörü Save düğmesini kilitler. wpmcf_update_field() veya REST API ile yazılan değerlerde zorunluluk denetlenmez.

Validation sekmesi

Gösterilen Validation rules türe göre değişir.

Neyin nerede uygulandığı:

Validation sekmesi ayrıca alanın sütununu (Column: SQL türüyle birlikte) ve SQL türü geçersiz kılma gibi SQL sütun seçeneklerini gösterir. Her tür sayfası hangi SQL türlerine izin verdiğini listeler.

Display sekmesi

Bu seçenekler bir değer wpmcf_the_field() veya [wpmcf_field] ile yazdırıldığında geçerlidir. wpmcf_get_field() fonksiyonunu etkilemezler.

<!-- Prefix "$", suffix " USD", wrapper class "price" -->
<span class="wpmcf-field-value price">$19.9 USD</span>

Sarmalayıcı bir <span class="wpmcf-field-value">'dir. Ham çıktıyı almak için wrap="false" (kısa kod) veya 'wrap' => false (PHP) ile kapatın. Prefix ve suffix düz metin olarak escape edilir.

Conditional logic

Conditional logic sekmesi (Enable conditional logic, Add condition), bir alanı düzenleme ekranında aynı gruptaki ve aynı düzeydeki diğer alanlara göre gösterir veya gizler (bir alt alan yalnızca kardeş alt alanlarına bağlı olabilir).

• Kuralları and (hepsi eşleşmeli) veya or (herhangi biri eşleşir) ile birleştirin.
• Operatörler: has value, is empty, equals, not equals, contains, not contains, greater than, less than.
• Listeler (Checkboxes, Relationship ve benzerleri) en az bir öğe seçildiğinde "has value" sayılır; equals ise öğelerden biri değere eşit olduğunda eşleşir. True / false alanı 1 (açık) veya 0 (kapalı) olarak karşılaştırılır; bu yüzden "açık" için equals 1 kullanın. 0 bir değer sayıldığı için, "has value" bir True / false alanı açık da olsa kapalı da olsa doğrudur.
• Var olmayan bir alanı işaret eden kural geçer.

Önemli davranış:

• Gizlemek veriyi silmez. Gizli bir alan saklanan değerini yine gönderir; bu yüzden bir koşulu kapatıp açmak hiçbir şeyi kaybettirmez.
• Gizli bir alan hiçbir zaman zorunlu değildir; ne tarayıcıda ne de sunucuda.
• Koşullar yalnızca düzenleme ekranını denetler. Şablonlar saklanan değeri yine okur; gizli değerin gösterilmemesi gerekiyorsa şablonunuzda denetleyen alanı kontrol edin.

// Show the "reason" text only when the "refund" switch is on.
if ( wpmcf_get_field( 'order', 'refund' ) ) {
    wpmcf_the_field( 'order', 'reason' );
}

Değerlerde değişkenler

Text, Text area, Email ve URL alanları, düzenleme ekranında değere bir {} düğmesiyle bir {{ variable }} ifadesi eklemenizi sağlar. Çıktıda, bu alanlardaki ifadeler değerin yazarı filtrelenmemiş HTML yayınlamaya yetkiliyse çözümlenir. İfade dili için Değişkenler ve hook'lar sayfasına bakın. Yorumlardaki değerler hiçbir zaman çözümlenmez.

Sorun giderme

• Grubu kaydederken "Field key is reserved" hatası: başka bir anahtar seçin (bkz. Alan türlerine genel bakış).
• Varsayılan değer wpmcf_get_field() sonucunda görünmüyor: nesnenin henüz satırı yok; grubun herhangi bir alanını o nesne için kaydedin veya default argümanını iletin.
• Bir kural yok sayılıyor gibi görünüyor: sunucuda yalnızca max length ve min/max value uygulanır; yukarıdaki tabloya bakın.