Sözdizimi
5 dk okuma
Bu sayfadaki her şey src/Variables içindeki motora karşı denetlendi. Sonuçlar, motorun yazdırdığı biçimde gösterilir.
Bloklar
Bir blok {{ ile başlar ve eşleşen }} ile biter. Süslü parantezlerin içindeki boşluklar ve satır sonları yok sayılır; bu yüzden ve aynıdır. Parantezlerin dışındaki metin, boşlukları dahil, yazıldığı gibi korunur.
Şablon | Sonuç |
|---|---|
| |
| |
|
|
|
|
|
|
|
|
{{ içermeyen bir metin olduğu gibi döndürülür ve hiçbir maliyeti olmaz.
Dilbilgisi
expression := ternary ( '|' filter )*
ternary := or ( '?' or ':' or )?
or := and ( '||' and )*
and := comparison ( '&&' comparison )*
comparison := primary ( ( '==' | '!=' | '>' | '<' | '>=' | '<=' ) primary )?
primary := literal | '(' expression ')' | path | function-call
path := namespace '.' segment ( '.' segment )*
function := 'fn' '.' name '(' ( expression ( ',' expression )* )? ')'
filter := name ( '(' ( expression ( ',' expression )* )? ')' )?Boru karakterleri (pipe) en düşük önceliğe sahiptir; bu yüzden a ? b : c | upper tüm üçlü (ternary) sonucunu büyük harfe çevirir ve (a | upper) == b için parantez gerekir.
Değişmezler (literal)
Tür | Örnekler | Notlar |
|---|---|---|
String |
| İki tırnak türü de olur. Kaçış dizileri: |
Integer |
|
|
Decimal |
| Bir nokta ve ardından rakamlar. Üslü gösterim yoktur. |
Boolean |
|
|
Null |
| Hiçbir şey yazdırmaz. |
Negatif sayılar çalışır. {{ fn.abs(-5) }}, 5 yazdırır ve {{ fn.substr('abcdef', -2) }}, ef yazdırır. - yalnızca bir sayının önünde işarettir; yine de aritmetik bir operatör değildir.
Fazladan sözcükler bloğun boş işlenmesine neden olur. Geçerli bir ifadeden sonra başıboş sözcükler içeren bir blok, örneğin {{ glb.phone extra }}, yarım bir değer yerine boş işlenir.
Yollar
namespace.segment.segment. İlk bölüm namespace (ad alanı) değeridir; kalan segmentlerin ne anlama geldiği ad alanına bağlıdır.
- Adlar harflerden, rakamlardan ve alt çizgilerden oluşur ve bir harf ya da alt çizgiyle başlamalıdır. İlkinden sonraki segmentler düz tamsayılar da olabilir (
name.2). - Ad alanı, filtre ve fonksiyon adlarında büyük/küçük harf ayrımı yoktur:
,{{ FN.UPPER('a') }}ve{{ 'a' | UPPER }}çalışır. Segment olarak verdiğiniz anahtarlar yazıldığı gibi eşleştirilir. - Bilinmeyen bir ad alanı, bilinmeyen bir anahtar veya boş bir değer hiçbir şey işlemez.
- Bir yol iç içe bir blok içeremez:
{{ glb.{{ 'name' }} }}boş işlenir.
Global Data anahtarları bir harfle başlamalı ve yalnızca küçük harf, rakam ve alt çizgi kullanmalıdır; başka herhangi bir anahtarı kaydetmek422 wpmcf_invalid_keyile reddedilir; böylece kaydedilen her anahtarolarak yazılabilir. (Bu kuraldan önce kaydedilen ve tire içeren ya da rakamla başlayan anahtarlar yol olarak yazılamaz:boş işlenir. Bunları yeniden adlandırın;wpmcf_get_global( 'my-key' )yine çalışır.) Bkz. Sorun giderme.
Filtreler
Bir filtre, solundaki değeri dönüştürür. İstediğiniz kadarını | ile zincirleyin. Argümanlar parantez içine yazılır; argüman yoksa parantezler isteğe bağlıdır.
{{ glb.name | upper }} ACME PLUMBING
{{ glb.name | upper() }} ACME PLUMBING
{{ glb.name | lower | slug }} acme-plumbing
{{ glb.price | number(2) }} 1,234.57
{{ glb.price | number(1, ',', '.') }} 1.234,6
{{ glb.tags | split(',') | join(' / ') }} red / green / blueArgümanlar tam ifadelerdir ({{ 'abc' | truncate(1 > 0 ? 2 : 1) }}, ab... yazdırır). Var olmayan bir filtre değeri değiştirmeden geçirir ({{ 'a' | nosuchfilter }}, a yazdırır). Liste Filtreler ve fonksiyonlar sayfasındadır.
Fonksiyon çağrıları
Fonksiyonlar fn ad alanı üzerinden çağrılır: {{ fn.name(arguments) }}. func, fonk ve function takma adları fn ile aynıdır. Fonksiyonları yalnızca bu dört ad çağırır; wp.title(1) boş işlenir. Bilinmeyen bir fonksiyon boş işlenir.
{{ fn.concat('a', 'b', 1) }} ab1
{{ fn.if(src.n > 5, 'big', 'small') }} big
{{ fn.coalesce('', null, 'c') }} cOperatörler
Operatör | Anlamı | Sonuç |
|---|---|---|
| Eşit, eşit değil (PHP gevşek karşılaştırması) |
|
| Sıralama karşılaştırması |
|
| İkisi de doğru değerli (truthy) |
|
| Sol taraf doğru değerliyse sol taraf, aksi halde sağ taraf (boolean değil) |
|
| Üçlü (ternary): koşul, doğruysa değer, değilse değer |
|
| Gruplama |
|
Dilde olmayan şeyler:
Kullanılamaz | Denemenin sonucu | Bunun yerine kullanın |
|---|---|---|
|
|
|
|
|
|
Zincirleme karşılaştırma ( | Yalnızca ilk karşılaştırma okunur |
|
Üçlü bir dalın içinde filtre ( | Boş işlenir | Parantez içine alın veya tüm sonucu filtreleyin |
Döngüler, değişkenler, atamalar | yok | Değeri PHP'de hesaplayın ve şununla okuyun: |
Zincirleme bir üçlü (a ? b : c ? d : e) tamamen okunur: ilk doğru koşul kazanır, yoksa son değer.
Doğru/yanlış değerlendirmesi PHP'yi izler: boş string, 0, "0", null, false ve boş dizi yanlıştır.
Bir sonucun yazdırılma biçimi
Değer | Yazdırılan |
|---|---|
String | String, escape edilmeden |
Sayı | Sayı ( |
|
|
| hiçbir şey |
Liste | Öğeler virgül ve boşlukla birleştirilir ( |
Metin HTML escape edilmez. Bir değer <b> içeriyorsa çıktı da içerir. Escape işlemini çıktının gittiği yer belirler (alan çıktı fonksiyonları sizin yerinize escape eder; bkz. Güvenlik). Bir ifadenin içinde escape etmek için escape, esc_attr veya esc_url filtrelerini kullanın.
İç içe bloklar
Bir blok, bir fonksiyonun veya filtrenin argümanlarının içinde yer alabilir. İç blok önce çözülür (en fazla 5 düzey derinliğe kadar) ve sonucu dış ifadeye data olarak aktarılır:
{{ fn.upper() }} ACME PLUMBING
{{ fn.concat('Hi ', '') }} Hi Acme Plumbing
{{ fn.concat('a', ) }} a1234.5678Kurallar:
- Düz bir sayı olan sonuç (
123,1.5) sayı olarak kalır. Başka her şey tırnaklı bir string olur. - Bir string değişmezinin içinde sonuç, o tırnak için escape edilir; bu yüzden bir değer string'i kapatıp kod ekleyemez.
glb.baddeğeria') }} {{ fn.option('blogname') }} ('içeriyorsa,{{ fn.upper() }}bu metni büyük harflerle yazdırır ve hiçbir şey çalıştırmaz. - 5 düzeyden derin iç içe geçme boş işlenir.
Sınırlar ve hatalar
Sınır | Değer | Aşıldığında ne olur |
|---|---|---|
Tek bir bloğun uzunluğu | 1000 karakter | Blok boş işlenir |
| 5 düzey | Boş işlenir |
Parantez ve argüman derinliği | 32 | Boş işlenir |
| 100 tekrar, 10.000 karakter | Sonuç üst sınırda kesilir |
| 10 | 10'a sabitlenir |
Ayrıştırılamayan veya değerlendirilemeyen her şey boş string olarak işlenir:
Hata | Sonuç |
|---|---|
| boş |
| boş (beklenmeyen karakter) |
| boş (filtre adı eksik) |
|
|
|
|
WP_DEBUG açıkken her hata PHP hata günlüğüne yazılır (wp-content/debug.log dosyasına, WP_DEBUG_LOG açıksa) şu biçimde:
[wpmcf] Variable resolution failed — "{{ @ }}" — Unexpected character: @
[wpmcf] Variable resolution failed — "{{ aaaa… }}" — Expression is too long.Ziyaretçilere veya editörlere hiçbir şey gösterilmez. Bkz. Sorun giderme.
Hâlâ takıldınız mı? Destek ile iletişime geçin