Global Data fonksiyonları

Global Data, site genelindeki değerleri (telefon numarası, adres, çalışma saatleri) tutar; bunları WPM Fields › Global Data ekranından yönetir ve istediğiniz yerde yazdırırsınız. Her kayıt; bir anahtarı, bir türü (metin, textarea, sayı, aralık, e-posta, URL veya parola), bir değeri ve isteğe bağlı görüntüleme ayarları olan bir değişkendir. Değişkenlere şablonlarda {{ glb.key }} olarak da erişebilirsiniz (bkz. Değişkenler ve hook'lar).

Tüm fonksiyonlar key değişken anahtarını alır (sanitize_key() ile küçük harfe çevrilir; 'PHONE' ile 'phone' aynıdır).

wpmcf_get_global()

wpmcf_get_global( string $key, array $args = [] ): mixed

Değeri ham ve kaçışlanmamış bir dize olarak döndürür. $args['default'], anahtar mevcut değilse veya değer boşsa ('') döndürülür.

$phone = wpmcf_get_global( 'phone', [ 'default' => 'n/a' ] );
echo esc_html( $phone );

• Doğrulandı: değerlerin tamamı dizedir ('0', '42', '1.5').
• {{ ... }} ifadeleri değerde çözümlenir (yazdıran fonksiyonlar da aynısını yapar) ('Call {{ glb.phone }}!' ifadesi 'Call 555!' sonucunu verir).
• Parola değişkenleri düz metin olarak döndürülür (şifresi çözülmüş halde). Kendi kodunuz için ham bir okuyucudur; asla yazdırmayın (bkz. Parola yardımcıları ve güvenlik).
• Değeri wpmcf/global/value filtresi değiştirir (argümanlar: değer, anahtar, $args).

wpmcf_the_global()

wpmcf_the_global( string $key, array $args = [] ): void

Değeri kaçışlanmış biçimde, <span class="wpmcf-global-value ..."> içinde ve değişkenin görüntüleme ayarlarıyla (sarmalayıcı sınıfı, sarmalayıcı ID, önek, sonek) yazdırır.

wpmcf_the_global( 'phone' );
// <span class="wpmcf-global-value ph">Tel: +1 &lt;b&gt;555&lt;/b&gt; &amp; &quot;q&quot;</span>

wpmcf_the_global( 'phone', [ 'wrap' => false ] );
wpmcf_the_global( 'site_url', [ 'format' => 'url', 'wrap' => false ] );

Doğrulandı: <b>bold</b><script>x</script> değerine sahip bir textarea, auto ile tamamen kaçışlanmış yazdırılır; post_html ile <b>bold</b> korunur ve script kaldırılır. 0 değeri yazdırılır (boş sayılmaz). Parola değişkenleri hiçbir şey yazdırmaz; ancak wpmcf/global/the_password filtresi true döndürürse auto biçimi (şifresi çözülmüş) değeri yazdırır.

wpmcf_has_global()

wpmcf_has_global( string $key, array $args = [] ): bool

Değişken mevcutsa ve değeri boş değilse true döner. '0' bir değer sayılır; '' sayılmaz.

wpmcf_update_global()

wpmcf_update_global( string $key, mixed $value ): bool

Bir mevcut değişkenin değerini, Global Data ekranının kaydettiği biçimde saklayarak ayarlar (parola değişkenleri depolamada şifrelenir).

• Şu durumlarda false döner: bilinmeyen anahtar (değişken oluşturmaz), dizi veya nesne değeri ya da başarısız yazma.
• Dizeleri, sayıları, true ('1' olarak saklanır), false (boş saklanır) ve null (boş saklanır) değerlerini kabul eder.
• Değer sanitize_textarea_field() işleminden geçer: HTML etiketleri kaldırılır ('+90 <i>212</i>' ifadesi '+90 212' halini alır).
• Ekrandan kaydetmede olduğu gibi, değişkenlerin tamamıyla wpmcf/global_data/saved hook'unu tetikler (sayfa önbellekleri temizlenir).
• Yetki kontrolü yapılmaz. Kullanıcı girdisini iletmeden önce izinleri kontrol edin.

if ( current_user_can( 'manage_options' ) ) {
    wpmcf_update_global( 'phone', sanitize_text_field( wp_unslash( $_POST['phone'] ?? '' ) ) );
}

Shortcode

[wpmcf_global key="phone"] aynı kaçışlanmış çıktıyı yazdırır. Bkz. Shortcode'lar.

Shortcode ve fonksiyon farkları

Shortcode'un wrap davranışı fonksiyonunkinden daha katıdır: shortcode'da true, 1, yes veya on dışındaki her değer (örneğin wrap="garbage") sarmalayıcıyı kaldırır; PHP fonksiyonu ise yukarıdaki "kapalı" listesi dışındaki her değerde sarmalayıcıyı korur.

Geçerli sürümde değişen davranış

Eski sürümler {{ }} ifadesini olduğu gibi yazdırıyor ve default değerini yok sayıyordu. Artık wpmcf_the_global() ve [wpmcf_global], {{ }} ifadelerini wpmcf_get_global() gibi çözümlüyor (doğrulandı: Call {{ glb.phone }}! girdisi Call 555! olarak yazdırılır) ve default değeri, üçü için de eksik ve boş değişkenlerde kullanılır (kaçışlanmış yazdırılır: N/A <b> girdisi N/A <b> olarak yazdırılır; boş bir değişken için wpmcf_has_global() sonucu false kalır).