Filtreler ve fonksiyonlar
7 dk okuma
Filtreler ve işlevler adıyla kaydedilir. Bir şablon yalnızca bu sayfadakileri (ve kendi kodunuzun eklediklerini, bkz. PHP API) çağırabilir; bir PHP işlevi çağıramaz.
- Bir filtre solundaki değeri dönüştürür:
{{ glb.name | upper }}. Bağımsız değişkenler parantez içinde yazılır:{{ glb.name | truncate(10, '...') }}. Daha fazla dikey çizgiyle zincirleyebilirsiniz. - Bir işlev,
fnüzerinden çağrılır:{{ fn.concat('a', 'b') }}.func,fonkvefunction,fniçin takma adlardır. - Adlarda büyük/küçük harf ayrımı yoktur. Bilinmeyen bir filtre değeri olduğu gibi döndürür; bilinmeyen bir işlev hiçbir şey döndürmez.
Aşağıdaki örnekler şu değerleri kullanır: name = Acme Plumbing, price = 1234.5678, born = 1990-05-17, tags = red,green,blue, html = <b>Bold</b> & "q".
Metin filtreleri
Bunlar yalnızca dizelerde çalışır; başka her değer olduğu gibi geçer.
Filtre | Bağımsız değişkenler | Ne yapar | Örnek | Sonuç |
|---|---|---|---|---|
| Büyük harf (UTF-8 güvenli) |
|
| |
| Küçük harf |
|
| |
| Her iki uçtaki boşlukları kaldırır |
|
| |
|
| Baştaki karakterleri kaldırır; varsayılan boşluktur |
|
|
|
| Sondaki karakterleri kaldırır |
|
|
| URL slug'ı ( |
|
| |
|
| Her eşleşmeyi değiştirir (büyük/küçük harfe duyarlı) |
|
|
|
| Metni |
|
|
| Bir dizeyi veya listeyi tersine çevirir |
|
| |
|
| Metni tekrarlar; en fazla 100 kez ve 10.000 karakter |
|
|
|
| Bir dizeyi listeye çevirir |
|
|
Kaçışlama filtreleri
Değişken çıktısı kaçışlanmaz. Değerin gerektirdiği bir yere gittiği durumlarda bunları kullanın (bkz. Güvenlik).
Filtre | Bağımsız değişkenler | Ne yapar | Örnek | Sonuç |
|---|---|---|---|---|
|
|
|
| |
|
|
| yukarıdakiyle aynı | |
|
|
| hiçbir şey | |
| HTML etiketlerini ve betik içeriğini kaldırır |
|
| |
| Kaçışlar, ardından satır sonlarını şuna çevirir: |
|
|
Sayı filtreleri
Bunlar sayıya benzeyen değerler üzerinde çalışır; başka her değer olduğu gibi geçer ({{ 'abc' | number(2) }} şunu yazdırır: abc). Sonuçlar dizedir.
Filtre | Bağımsız değişkenler | Ne yapar | Örnek | Sonuç |
|---|---|---|---|---|
|
| Bir sayıyı biçimlendirir |
|
|
Avrupa biçimi |
|
| ||
|
| Yarım değerleri sıfırdan uzağa yuvarlar |
|
|
| Yukarı, tam sayıya yuvarlar |
|
| |
| Aşağı yuvarlar |
|
| |
| Mutlak değer |
|
| |
| Ondalık sayıya dönüştürür |
|
| |
| Her türlü değeri tam sayıya dönüştürür; sayı olmayanın sonucu |
|
|
Ondalıklar en fazla 10 ile sınırlıdır (number(99), number(10) gibi davranır).
Tarih filtreleri
Bir değer sayısalsa Unix zaman damgası olarak, değilse tarih metni olarak (strtotime işlevinin anladığı her şey) okunur. Ay ve gün adları site diline çevrilir ve site saat dilimi uygulanır. Boş değer hiçbir şey yazdırmaz; tarih olmayan bir metin olduğu gibi yazdırılır.
Filtre | Bağımsız değişkenler | Ne yapar | Örnek | Sonuç |
|---|---|---|---|---|
|
| Şununla biçimlendirir: PHP tarih harfleri |
|
|
|
| Şuna benzer: |
|
|
| Tarihten bugüne tam yıllar (365,25 günlük yıllar) |
|
|
{{ 86400 | date('Y-m-d') }} şunu yazdırır: 1970-01-02 (sayı bir zaman damgasıdır).
Değer ve liste filtreleri
Filtre | Bağımsız değişkenler | Ne yapar | Örnek | Sonuç |
|---|---|---|---|---|
|
| Değer hiçbir şey, boş dize veya |
|
|
|
| PHP'nin boş saydığı her şey için yedeği kullanır: ayrıca |
|
|
|
| Bir listeyi birleştirir; liste olmayan metne dönüşür |
|
|
| Bir dizenin karakterleri (UTF-8) veya bir listenin öğeleri. Diğer her şey |
|
| |
| Bir listenin öğeleri; |
|
| |
| Bir listenin ilk öğesi veya bir dizenin ilk karakteri |
|
| |
| Son öğe veya son karakter |
|
| |
| JSON metni (Unicode ve eğik çizgiler kaçışlanmaz) |
|
| |
|
|
|
| |
|
|
|
|
İşlevler
Metin
İşlev | Bağımsız değişkenler | Döndürür | Örnek | Sonuç |
|---|---|---|---|---|
| herhangi bir sayıda | Birleştirilmiş parçalar |
|
|
|
| Filtrelerle aynı |
|
|
|
| URL slug'ı |
|
|
|
| Bir dizenin parçası (UTF-8). Negatif başlangıç sondan sayar. |
|
|
|
| İlk eşleşmenin konumu (0 başlangıçtır); bulunamazsa hiçbir şey |
|
|
|
| Karakter sayısı (UTF-8) |
|
|
|
| HTML ayıklandıktan sonra kelimeler ve sayılar, her dilde. |
|
|
|
| MD5 karması |
|
|
|
| Parçaları birleştirir |
|
|
|
| Bir liste |
|
|
|
| JSON metni |
|
|
Metin işlevleri dizeler üzerinde çalışır; sabit olarak verilen bir sayı upper, lower, trim ve slug tarafından olduğu gibi döndürülür, 0 olarak ise characterCount tarafından sayılır.
Sayılar
İşlev | Bağımsız değişkenler | Döndürür | Örnek | Sonuç |
|---|---|---|---|---|
| herhangi bir sayıda | Toplam |
|
|
| herhangi bir sayıda | En büyük, en küçük (bağımsız değişken yoksa |
|
|
|
| Yuvarlanmış sayı (hassasiyet en fazla 10) |
|
|
|
| Mutlak değer; |
| |
|
| Aralarında rastgele bir tam sayı (uçlar dahil) |
|
|
|
| Listedeki öğe sayısı |
|
|
fn.rand her değerlendirmede yeni bir sayı döndürür. Önbelleğe alınan sayfalarda kullanmayın.
Tarihler
İşlev | Bağımsız değişkenler | Döndürür | Örnek | Sonuç |
|---|---|---|---|---|
|
| Geçerli tarih ve saat |
|
|
|
|
|
| |
| Unix zaman damgası |
|
| |
|
| Bir tarih; zaman damgası yoksa bugün |
|
|
Mantık
İşlev | Bağımsız değişkenler | Döndürür | Örnek | Sonuç |
|---|---|---|---|---|
|
|
|
|
|
| herhangi bir sayıda | Boş metin ve hiçbir şey olmayan ilk değer ( |
|
|
Bir işlevin her bağımsız değişkeni değerlendirilir; fn.if işlevinin her iki dalı da buna dahildir.
Site seçenekleri
fn.option('name') bir WordPress seçeneğinin değerini döndürür, yalnızca kısa bir izin listesindeki adlar için. Diğer her şey hiçbir şey döndürmez; böylece hiçbir gizli bilgi okunamaz.
İzin verilen seçenek adları |
|---|
|
{{ fn.option('blogname') }} My Site
{{ fn.option('admin_email') }} (nothing: not on the list)
{{ fn.option('active_plugins') }} (nothing)Seçenek adları sanitize_key ile temizlenir. Değeri tek bir değer olmayan (dizi veya nesne) bir seçenek hiçbir şey döndürmez. Daha fazlasına izin vermek için wpmcf/variables/allowed_options filtresini kullanın ve yalnızca herkese açık bir sayfada yazdırılması güvenli olan seçenekleri ekleyin.
Sık kullanılan kalıplar
{{ glb.phone | default('Call us') }}
{{ fg.products.price | number(2, ',', '.') }} EUR
{{ fg.events.start | date('l, F j') }}
{{ fn.if(fg.products.on_sale, 'Sale', '') }}
{{ wp.post_title | truncate(60) | escape }}
{{ fn.concat(wp.post_title, ' | ', sys.site_name) }}
{{ glb.tags | split(',') | count }} tags
{{ (fg.products.stock > 0 ? 'In stock' : 'Sold out') | upper }}Hâlâ takıldınız mı? Destek ile iletişime geçin