Değişkenlerin çalıştığı yerler

Son güncelleme 3 Eki 20264 dk okuma

İfadeler bir değer okunduğunda ya da çizildiğinde değerlendirilir, kaydedilirken asla. Veritabanı yazdığınız metni saklar (Hello {{ glb.name }}); ziyaretçi sonucu görür. Bu yüzden bir Global Data değerini değiştirmek, onu kullanan her metni yeniden kaydetmeye gerek kalmadan günceller.

Alan değerleri

Alan çalışma zamanından geçen her metin değeri değerlendirilir. Buna şunlar dahildir:

wpmcf_get_field(), wpmcf_the_field(), wpmcf_get_option_field(), wpmcf_the_option_field()
Şunlar: [wpmcf_field] shortcode'u ve WPM Field bloğu
Block Bindings için WPM Fields kaynağı
Elementor Pro, Bricks, Divi, Breakdance ve Oxygen için dinamik etiketler (bkz. entegrasyonlar)
Yoast SEO ve Rank Math değişkenleri olarak kullanılan alan değerleri

php

wpmcf_update_field( 'product', 'headline', 'Hello {{ glb.company }} - {{ wp.post_title }}', $post_id );

echo wpmcf_get_field( 'product', 'headline', $post_id );
// Hello Acme - Blue widget

Ayrıntılar:

Kural	Davranış
Hangi değerler	Metin olan üst düzey değerler. Bir grup, tekrarlayıcı ya da esnek içerik alanının içindeki bir değer, liste olarak geldiği için değerlendirilmez.
Hangi alan türleri	Değeri bir metin olan herhangi biri: metin, metin alanı, WYSIWYG, e-posta, URL ve diğer metin benzeri alanlar.
Ne zaman çalışır	Her okumada, `wpmcf/field/value` filtresinden sonra.
Çıktı kaçışlama	`wpmcf_the_field()` ve shortcode, sonucu çıktı biçimi için (HTML, öznitelik, URL) kaçışlar; bu yüzden bir değişkenden gelen `<script>` metin olarak yazdırılır. `wpmcf_get_field()` ham sonucu döndürür; kaçışlamayı kendiniz yapın.
Kimler kullanabilir	Yalnızca güvenilen biri tarafından yazılan değerler. Aşağıya ve Güvenlik sayfasına bakın.
Yalnızca bir düzey	Başka bir alanı okuyan bir ifade (`{{ fg.group.other }}`) o alanın saklanan metnini alır; onun kendi `{{ }}` ifadeleri metin olarak kalır. Kendine başvuran bir alan kendi ham metnini yazdırır.
REST ve GraphQL	Değerlendirilmiş metni değil, saklanan metni döndürür.

Bir alan değerinde ifadeleri kimler kullanabilir

Değerin sahibi	Değerlendirilir mi?
Bir yazı	Yalnızca yazının yazarı, `unfiltered_html` yetkisine sahipse (tek sitede yöneticiler ve editörler; yazarlar ya da katkıda bulunanlar değil)
Bir kullanıcı profili	Yalnızca o kullanıcı şu yetkiye sahipse: `unfiltered_html`
Bir yorum	Asla
Bir terim, bir widget, bir seçenekler sayfası	Evet (bu yönetim ekranlarını yalnızca açabilen kişiler düzenleyebilir)

Bir site, cevabı wpmcf/field/resolve_variables filtresiyle değer başına değiştirebilir. Cevap hayır olduğunda metin, süslü parantezler dahil, tam olarak saklandığı gibi yazdırılır.

Placeholder ve varsayılan değer

Alan oluşturucuda bir alanın Placeholder ve Default value girdileri ifade kabul eder.

Düzenleme ekranı çizilirken placeholder değerlendirilir (Hi {{ glb.company }} ifadesi Hi Acme olarak görünür). Bu bir ipucudur, asla saklanmaz.
Düzenlenen nesne için varsayılan değer (alanın başlangıç değeri, henüz hiçbir şey kaydedilmeden gösterilir) değerlendirilir. İçinde {{ }} bulunan bir varsayılan değer, veritabanı sütununun varsayılanı olarak asla kullanılmaz.
Bir Group veya tekrarlayıcı içindeki alanın varsayılan değeri de aynı şekilde değerlendirilir.

Her iki girdide de örnek eklemek için {} yardımcısı bulunur.

Global Data

Bir Global Data değişkeninin değeri, wpmcf_get_global(), wpmcf_the_global() ya da [wpmcf_global] ile okunduğunda değerlendirilir. Global Data'yı yalnızca yöneticiler düzenler; bu yüzden yazar başına bir denetim yoktur.

Variable "banner" = Welcome to {{ glb.company }}, open since {{ sys.year }}.
[wpmcf_global key="banner"]   →   Welcome to Acme, open since 2026.

Bir Global Data değerinin kendi nesnesi yoktur. Bu nedenle wp.post_* ve fg, varsa görüntülenen yazıyı kullanır. Oluşturulan bir Programatik SEO sayfasında pseo.* da kullanılabilir.

Sayfa oluşturucular

Elementor (ücretsiz Elementor eklentisi yeterlidir): {{ }} ifadesi her öğenin ayarlarında çalışır: başlıklar, metin düzenleyiciler, düğme etiketleri, bağlantılar ve metin olarak yazılan her şey. İfadeler, öğe işlenmeden hemen önce geçerli yazı için değerlendirilir.

Ayar	Sonucun eklenme biçimi
Metin benzeri ayarlar	Düz metin olarak: etiketler temizlenir, özel karakterler kaçışlanır, hiçbir shortcode çalışmasın diye `[` ve `]` kodlanır. Değişkenin çevresinde yazdığınız metin kendi işaretlemesini korur.
Bir `url` (bağlantı) ayarı	Ayar tam olarak tek bir değişkense, sonucu URL'dir. Değişken yazılı bir URL'nin içindeyse (`https://example.com/{{ glb.slug }}`) sonuç URL kodlamasından geçer. Nihai URL temizlenir; bu yüzden `javascript:` kaldırılır.
Anahtarı şu karakterle başlayan ayarlar: `_`	Atlanır (Elementor iç ayarları).

Değişken içeren öğeler Elementor'ın öğe önbelleğine alınmaz; böylece bir yazının değerleri başka bir yazıda asla gösterilmez. Elementor düzenleyicisinde, Elementor'ın JavaScript şablonlarıyla önizlediği widget'lar (Heading, Button ve benzerleri) {{ }} ifadesini yazıldığı gibi gösterir; canlı sayfa ve PHP ile işlenen önizlemeler sonucu gösterir.

Diğer sayfa oluşturucular (Bricks, Divi, Breakdance, Oxygen) alanları, yukarıdaki alan çalışma zamanını kullanan dinamik etiketlerle okur. Bkz. entegrasyonlar.

Programatik SEO (Pro)

Bir Programatik SEO görevinin şablonları, pseo.* değişkenleri ve bu sayfadaki diğer her şeyle yazılır.

Şablon	Notlar
URL yolu (üst öğe ve slug)	Etiketler temizlenir; sonuç bir yola normalleştirilir
Sayfa başlığı	Etiketler temizlenir
SEO başlığı, açıklama ve diğer SEO metinleri	Etiketler temizlenir
Sayfa oluşturucu içeriği dahil sayfa içeriği	Değerler HTML için temizlenir; bir etiketin ya da blok yorumunun içinde öznitelik için kaçışlanır
Yapılandırılmış veri (JSON-LD)	Ham bir JSON şablonunda her sonuç JSON dizesi olarak kaçışlanır
Sayfalar yazıya dönüştürülürken şablonun yazı meta verileri	Dönüştürülen her sayfa için değerlendirilir

Alan değerleri ve Global Data da oluşturulan bir sayfada yazdırıldığında pseo.* kullanabilir; çünkü sayfanın veri satırı değerlendirme bağlamlarına eklenir (wpmcf/variables/context filtresi aracılığıyla). Kaçışlama kuralları için Ad alanları sayfasına bakın.

Kendi PHP kodunuz

php

echo esc_html( wpmcf_resolve_variables( 'Hello {{ glb.company }}!' ) );

Bağlamlar ve motoru genişletme için PHP API sayfasına bakın.

Değişkenlerin çalışmadığı yerler

Yer	Neden
Düzenleyicide yazılan yazı başlıkları ve yazı içeriği	Hiçbir şey çekirdek içeriği değerlendirmez. Şunları kullanın: `[wpmcf_field]` ya da `[wpmcf_global]` shortcode'u, alan bloğu veya bir Programatik SEO şablonu.
Bir grup, tekrarlayıcı ya da esnek içerik alanının içindeki değerler	Bunlar listedir ve yalnızca metin değerleri değerlendirilir
Yorum alanları	Güvenlik için asla değerlendirilmez
Şu yetkisi olmayan kişilerin yazdığı yazı ve kullanıcı değerleri: `unfiltered_html`	Saklandığı gibi yazdırılır
REST, GraphQL, dışa aktarma dosyaları ya da yönetim liste sütunları üzerinden okunan metin	Bunlar saklanan metni gösterir
Bir değişkenin `{{ }}` olarak döndürdüğü metin	Bir sonuç asla yeniden değerlendirilmez
Parola alanları ve parola Global Data değerleri	Bir ifadeden asla okunamaz

Bu sayfa yardımcı oldu mu?

Hâlâ takıldınız mı? Destek ile iletişime geçin