Ad alanları

Bir ad alanı (namespace), yolun ilk sözcüğüdür: {{ glb.phone }}, phone adını glb ad alanından okur. Altısı yerleşiktir ve ücretsizdir; biri (pseo) Pro ile eklenir. Kendi kodunuz daha fazlasını ekleyebilir (bkz. PHP API).

Bilinmeyen bir ad alanı, bilinmeyen bir ad ya da boş bir değer hiçbir şey yazdırmaz. Yedek değer gerektiğinde default filtresiyle birlikte kullanın: {{ glb.tagline | default('Welcome') }}.

glb: Global Data

{{ glb.key }}, bu anahtara sahip Global Data değişkeninin saklanan değeridir.

• Anahtar, glb. ifadesinden sonra gelen her şeydir. Global Data anahtarları bir harfle başlamalı ve yalnızca küçük harf, rakam ve alt çizgi içermelidir; böylece kaydedilen her anahtar bir ifadede yazılabilir (tire içeren ya da rakamla başlayan eski anahtarlar yazılamaz; bkz. Sorun giderme).
• Değer saklandığı gibi eklenir. Değişkenin kendi değeri {{ }} içeriyorsa bu süslü parantezler metin olarak kalır: {{ glb.a }}, a değeri x {{ glb.b }} y olduğunda x {{ glb.b }} y yazdırır. (Değişkeni wpmcf_get_global() ya da [wpmcf_global] ile okumak kendi ifadelerini bir düzey değerlendirir.)
• Parola değişkenleri bir şablonda her zaman boştur (default filtresi kendi yedek değerini verir, parolayı asla). Bir site wpmcf/global/the_password filtresiyle buna izin verebilir.

fg: alan değerleri

{{ fg.group.field }}, bir alan grubunun bir alanını geçerli nesne için okur. Grup alanı ya da tekrarlayıcı (repeater) için alt anahtarları, liste için bir indeks ekleyin.

{{ fg.products.price }}
{{ fg.products.details.size }}            a field inside a Group field
{{ fg.team.members.0.name }}              first row of a Repeater
{{ fg.products.tags.0 }}                  first item of a Checkbox list

"Geçerli" nesne hangisidir:

• Bir alan değerinde ya da bir placeholder içinde, o değerin ait olduğu nesne (düzenlenen ya da görüntülenen yazı; bu bağlamlarda terim, kullanıcı veya yorum).
• Eğer wpmcf_resolve_variables() kullanıyorsanız, ilettiğiniz bağlamın nesnesi; bağlam iletmezseniz döngüdeki yazı (get_the_ID()). Nesne yoksa fg geçerli ya da sorgulanan yazıya döner; hiçbir yazının dışında sonuç boştur. Bkz. PHP API.
• Oluşturulan bir Programatik SEO sayfasında, sayfa şablonu yazısı.

Geri dönen değer:

Önemli kurallar:

• İkinci kez değerlendirme yapılmaz. Değer saklandığı gibi eklenir. {{ }} içeren bir alan değeri, başka bir ifade onu fg üzerinden okuduğunda değerlendirilmez. (wpmcf_get_field() ile okumak onu bir kez değerlendirir.)
• Parola alanları her zaman boştur. Grup ve tekrarlayıcı değerleri içindeki parola alt alanları da öyle. Bir site wpmcf/field/the_password filtresiyle buna izin verebilir.
• Değer, diğer tüm okumalar gibi wpmcf/field/value filtresinden geçer.

wp: yazılar, terimler ve oturum açmış kullanıcı

Diğer adlar (wp.title, wp.foo) hiçbir şey yazdırmaz.

Bilmeniz gerekenler:

• wp.post_* (wp.post_id dahil) yalnızca yazı bağlamında çözülür; bu durumda bağlam nesnesi yazıdır. Terim, kullanıcı, yorum ya da seçenekler bağlamında boştur; nesnenin ID'sini paylaşan başka bir yazıyı asla okumazlar.
• wp.user_*, yazı yazarını değil ziyaretçiyi tanımlar. Oturum açmamış ziyaretçiler için boştur.
• Önbellekleme. Bir ön yüz sayfasında bir wp.user_* adı ilk kez yazdırıldığında eklenti DONOTCACHEPAGE sabitini tanımlar ve önbelleğe almayı engelleyen başlıklar gönderir; böylece sayfa önbelleği bir ziyaretçinin adını saklayıp herkese sunmaz. Bu davranış, söz konusu sabiti okuyan WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache ve benzerleriyle uyumludur. wp-admin içinde hiçbir şey değişmez. Önbelleğe alınmasını istediğiniz sayfalarda wp.user_* kullanmaktan kaçının.
• wp.term_*, değerlendirme bağlamındaki terimi okur: bağlam türü term olduğunda bağlam nesnesini (böylece terim alanı değerlerinde ve wpmcf_make_context( $term_id, 'term' ) ile çalışır) ya da kodunuz term_id meta anahtarını ->withMeta( 'term_id', $id ) ile ayarladığında bu anahtarın gösterdiği terimi. İkisi birlikte varsa meta veri kazanır. Diğer bağlamlarda boştur.

sys: tarih, saat ve site

Tarihler site saat dilimini kullanır ve çevrilir (date_i18n). Filtrelerle birleştirin: {{ sys.timestamp | date('l') }}. Diğer adlar hiçbir şey yazdırmaz.

woo: WooCommerce ürünü

ID'si bağlam nesnesinin ID'si olan ürünü okur. WooCommerce etkin değilse, nesne yoksa ya da nesne bir ürün değilse hiçbir şey yazdırmaz.

src: kodunuzdan gelen değerler

src, üçüncü bağımsız değişken olarak ilettiğiniz değerleri okur: wpmcf_make_context(). Eklentinin kendi ekranları bunu asla doldurmaz; şablonlarınız için vardır.

$context = wpmcf_make_context( null, 'post', [ 'city' => 'London', 'n' => 10 ] );

echo wpmcf_resolve_variables( "{{ src.city == 'London' ? 'Capital' : 'City' }}", $context );   // Capital
echo wpmcf_resolve_variables( "{{ src.n >= 10 && src.city == 'London' ? 'yes' : 'no' }}", $context ); // yes
echo wpmcf_resolve_variables( "{{ src.zip || 'no zip' }}", $context );                          // no zip

İletilmeyen bir ad hiçbir şey yazdırmaz. Noktalı bir yol (src.details.size) önce details.size adlı bir anahtar arar, sonra details anahtarına bakar.

pseo: Programatik SEO sayfaları (Pro)

Pro ve üzeri planlarda, yalnızca Programatik SEO bir şablonu değerlendirirken (görevin URL'si, başlığı, SEO metinleri, sayfa içeriği ve yapılandırılmış veri) ve oluşturulan bir sayfada yazdırılan alan değerleri ile Global Data içinde kullanılabilir. Başka yerde hiçbir şey yazdırmaz.

Visit {{ pseo.src.cities.name }}, {{ pseo.src.cities.country | upper }}
{{ pseo.src.cities.name }} vs {{ pseo.src.cities.name.2 }}

Veri satırları içe aktarmalardan geldiği için pseo değerleri yazdırıldıkları yere göre temizlenir:

Bir değerde, ardından başka bir { gelen her { ve ardından başka bir } gelen her } karakterinin ardına bir boşluk eklenir (bir CSV hücresindeki {{ x }} değeri { { x } } olur); böylece veri hiçbir zaman şablona dönüşemez.

Sınırlar, kaynak kurulumu ve tüm iş akışı Programatik SEO belgelerinde yer alır.

fn: fonksiyonlar

fn bir veri ad alanı değildir. fn.name(...) yerleşik bir fonksiyonu çağırır; bkz. Filtreler ve fonksiyonlar.