Çıktı biçimleri ve kaçışlama

Yazdırma fonksiyonları

wpmcf_the_field( string $group_key, string $field_key, mixed $object = null, array $args = [] ): void
wpmcf_the_option_field( string $group_key, string $field_key, array $args = [] ): void
wpmcf_the_global( string $key, array $args = [] ): void

Kaçışlanmış, biçimlendirilmiş bir değeri echo ile yazdırır ve hiçbir şey döndürmezler. Boş değerler hiçbir şey yazdırmaz (boş sarmalayıcı oluşmaz). İlgili get fonksiyonunun argümanlarını (path, sub_key, default, context, widget_*) ve ek olarak iki çıktı argümanını alırlar.

format

Diğer her format değeri auto değerine döner. auto dışındaki her biçimde dizi değeri düzleştirilir: skaler öğeleri , ile birleştirilir (bir Checkbox ['red', 'blue'] değeri red, blue olarak yazdırılır: etiketler değil, saklanan değerler) ve iç içe diziler atılır. Bu yüzden auto dışında bir biçimle Group veya Repeater kullanmak işe yarar bir şey yazdırmaz: tek bir alt değer için bir path kullanın, Repeater'ın liste işaretlemesi için ise auto kullanın.

Bir metin değeri için doğrulanmış çıktı Hello W & "q":

wrap

Varsayılan olarak çıktı, bir <span> içine sarılır; bu öğe alanın Advanced display ayarlarını (sarmalayıcı sınıfı, sarmalayıcı ID'si, önek, sonek) taşır:

<span id="a03id" class="wpmcf-field-value a03 big">[Hello]</span>

• Span her zaman wpmcf-field-value sınıfına sahiptir (Global Data için wpmcf-global-value). Alanın Wrapper class değeri eklenir, Wrapper ID değeri ise id olur.
• Prefix ve suffix (yukarıdaki [ ve ]) esc_html() ile kaçışlanır ve span'ın içinde yazdırılır.
• 'wrap' => false span'ı kaldırır ve onunla birlikte önek ile soneki de: yalın, kaçışlanmış değeri alırsınız.

Sarmalayıcıyı kapatan değerler: false, 0, '0', 'false', 'no', 'off' (büyük/küçük harfe duyarsız). Başka her değer sarmalayıcıyı korur.

wpmcf_the_field( 'listing', 'title' );                         // <span class="wpmcf-field-value">...</span>
wpmcf_the_field( 'listing', 'title', null, [ 'wrap' => false ] ); // bare text

default

Varsayılan değer olan default, saklanan değer NULL olduğunda kullanılır ve diğer her değer gibi kaçışlanır:

wpmcf_the_field( 'listing', 'note', $id, [ 'default' => 'No note <b>' ] ); // prints: No note &lt;b&gt;

Global Data için default hem eksik hem de boş bir değişken için yazdırılır (bkz. Global Data fonksiyonları).

Hiçbir zaman yazdırılmayanlar

• Password alanları, wpmcf/field/the_password filtresi true döndürmedikçe hiçbir şey yazdırmaz (o zaman da yalnızca düz veya şifrelenmiş parolaları, asla hash'i). Bkz. Parola yardımcıları ve güvenlik.
• Alan türünün biçimlendiremediği skaler olmayan değerler (örneğin auto biçiminde bir Group) hiçbir şey yazdırmaz.
• Boş bir değer hiçbir şey yazdırmaz; bu yüzden temizlenecek boş bir <span> kalmaz.

Örnekler

// In an attribute: use the raw getter and esc_attr(); a printing function would echo its span there.
printf(
    '<div data-city="%s">',
    esc_attr( (string) wpmcf_get_field( 'listing', 'details', null, [ 'path' => 'city' ] ) )
);

// A link made of two fields.
printf(
    '<a href="%s">%s</a>',
    esc_url( (string) wpmcf_get_field( 'listing', 'website' ) ),
    esc_html( (string) wpmcf_get_field( 'listing', 'title' ) )
);

// A rich text field: keep post-level HTML.
wpmcf_the_field( 'listing', 'description', null, [ 'format' => 'post_html', 'wrap' => false ] );

// Options page value in the footer.
wpmcf_the_option_field( 'site_settings', 'company_name', [ 'wrap' => false ] );

Ham getter mı, yazdırma fonksiyonu mu?

Bir wpmcf_get_* sonucunu asla kaçışlamadan echo ile yazdırmayın. Değerler editörlerden, ziyaretçilerden (formlar), içe aktarmalardan ve diğer eklentilerden gelir.

Çıktı için hook'lar

wpmcf/field/the_escaped (kaçışlanmış iç metin) ve wpmcf/field/the_html (sarmalayıcı dahil son işaretleme) alan çıktısını filtreler; wpmcf/global/the_escaped ve wpmcf/global/the_html Global Data için aynısını yapar. Bkz. Değişkenler ve hook'lar.

Aynı kaçışlamanın nasıl paylaşıldığı

[wpmcf_field] ve [wpmcf_global], yazdırma fonksiyonlarıyla aynı kod yolunu kullanır (bkz. Kısa kodlar). Blok ve Block Bindings, Bloklar ve Block Bindings bölümünde anlatılan kendi biçimlendiricilerini kullanır.