Bloklar ve Block Bindings
5 dk okuma
Blok düzenleyicide alan değerlerini göstermenin, ikisi de ücretsiz iki yolu:
Massbase Field bloğu ( | Massbase Block Bindings kaynağı ( | |
|---|---|---|
Nedir | Kendi başına dinamik bir blok | Çekirdek blokların öznitelikleri için bir veri kaynağı |
En uygun olduğu durum | Bir alanı önek, sonek, yedek değer, bağlantı veya görselle yazdırmak | Bir paragrafı, başlığı, düğmeyi veya görseli alanın kendisi yapmak |
Çıktı |
| çekirdek bloğun kendi işaretlemesi |
Query Loop içinde çalışır | evet | evet |
İkisi de geçerli yazıdan ya da bir Query Loop içindeki her yazıdan okur ve ikisi de aynı alan kataloğunu kullanır. Parola alanları hiçbirinde görünmez. Bir Group alanının içindeki alanlar da seçilebilir (group.field.sub_field başvuruları olarak), harita bloğunda da. Terimler veya seçenek sayfaları için bir şablonda, bağlamalar düzenleyicide bir önizleme gösterir.
Başvurular: group.field[.path]
İkisi de group_key.field_key biçiminde bir alan başvurusu alır; isteğe bağlı olarak ardından bir Group veya Repeater değerinin içine giden bir yol gelir:
listing.price
listing.details.city (Group field "details", sub-field "city")
listing.items.0.name (Repeater "items", first row, sub-field "name")Başvurular küçük harfe çevrilir ve her segment için sanitize_key() ile temizlenir. Görünür bir alanı adlandırmayan başvuru boş olarak çıktılanır. Yalnızca seçenek sayfalarında görünen bir grup, seçenek değerini okur ve bir yazı gerektirmez.
Massbase Field bloğu
Massbase Field bloğunu ekleyin (kategori Text, anahtar sözcükler "custom field", "meta", "dynamic") ve kenar çubuğunda bir alan seçin. Blok dinamiktir: her seferinde sunucuda işlenir.
Öznitelikler
Öznitelik | Tür | Varsayılan | Açıklama |
|---|---|---|---|
| string |
| Alan başvurusu. Boşsa hiçbir şey yazdırmaz (ya da yedek değeri yazdırır). |
|
|
| Aşağıya bakın. Başka her değer |
| string |
| Değerden önceki metin, |
| string |
| Değerden sonraki metin, |
| string |
|
|
| string |
|
|
| string |
| Değer boş olduğunda değerin yerine yazdırılır (escape edilir). Önek ve sonek yedek değere eklenmez. |
Blok destekleri: geniş/tam/sol/orta/sağ hizalama, kenar boşluğu (margin), iç boşluk (padding), yazı tipi boyutu, satır yüksekliği, metin ve arka plan rengi, bağlantı rengi.
Kaydedilen içerikte:
<!-- wp:wpmcf/field {"field":"listing.price","prefix":"From ","suffix":" EUR","fallback":"Ask for a price"} /-->Biçimler
| Çıktı |
|---|---|
| Alan türünün kendi biçimlendirilmiş, escape edilmiş HTML'i (bir Select'in etiketi, |
| Değer düz metin olarak, escape edilmiş. Türün eklediği işaretleme atılır. |
|
|
| Bir Image alanının görseli (veya galerinin ilk görseli), |
Sarmalayıcı: sonucun tamamı <div class="wp-block-wpmcf-field"> içindedir (ayrıca bloğun hizalama, renk ve boşluk sınıfları). Yazdırılacak bir şey ve yedek değer yoksa hiçbir işaretleme üretilmez.
Bir metin değeri için doğrulanmış çıktılar: Hello <x> & "y" (şu şekilde saklanan: Hello & "y"):
<div class="wp-block-wpmcf-field">Hello & "y"</div>
<div class="wp-block-wpmcf-field"><span class="wpmcf-field-block__prefix"><P> </span>Hello ...<span class="wpmcf-field-block__suffix"> S</span></div>Hangi yazı
Blok, varsa Query Loop öğesini (postId blok bağlamı), yoksa geçerli yazıyı (get_the_ID()) kullanır. Değerler yalnızca görüntüleyen kişi o yazıyı görebiliyorsa gösterilir; kural WordPress'in kendi yazı meta bağlamasıyla aynıdır: yazı herkese açık olarak görüntülenebilir olmalı ya da görüntüleyen kişi read_post yetkisine sahip olmalı ve yazı parola korumalı olmamalıdır. Aksi halde blok hiçbir şey yazdırmaz (ya da yedek değerini yazdırır).
"Massbase" Block Bindings kaynağı
Kaynak olarak wpmcf/field adıyla, etiketi Massbase olacak şekilde kaydedilir. Düzenleyicide bir çekirdek blok seçin, Attributes panelini açın ve bir özniteliği bir alana bağlayın; alan listesi Password ve yerleşim alanları dışındaki her alanı gösterir. Kaydedilen içerikte bir bağlama, blok meta verisidir:
<!-- wp:paragraph {"metadata":{"bindings":{"content":{"source":"wpmcf/field","args":{"key":"listing.title"}}}}} -->
<p>Placeholder</p>
<!-- /wp:paragraph -->args.key alan başvurusudur.
Her özniteliğin aldığı değer
Öznitelik | Değer |
|---|---|
| alanın URL'si (URL, Link, Email, File, Image, Page link, Post object, oEmbed alanları; aksi halde boş) |
| Image alanının ek kimliği |
| görsel URL'si (yoksa alanın URL'sine döner) |
| ekin alt metni (yoksa alanın metnine döner) |
diğer her şey ( | alanın düz metni |
URL benzeri olmayan (düz metin) bir alana yapılan url/href bağlaması boş bir URL verir (doğrulandı).
Zengin metin öznitelikleri (örneğin bir paragrafın content değeri) metni HTML escape edilmiş olarak alır; bu yüzden gerçek bir < karakteri metin olarak kalır (doğrulandı: a < b & c şu şekilde işlenir: a < b & c). Çekirdeğin öznitelik olarak çıktıladığı öznitelikler çekirdek tarafından escape edilir.
Doğrulanmış örnekler:
Blok ve bağlama | İşlenen çıktı |
|---|---|
paragraph |
|
heading |
|
button |
|
button | Link alanının URL'si |
image | ekin |
bir Password veya bilinmeyen alana bağlı paragraph | boş bir paragraph |
yalnızca seçenek sayfalarında bulunan bir gruba bağlı paragraph | seçenek değeri (görüntüleyen kişi görebiliyorsa) |
Eksik bir alan, bilinmeyen bir başvuru veya gizli bir yazı boş bir değer verir: yer tutucu metin korunmaz, bu yüzden blok boş işlenir.
Hangi yazı
Blokla aynı: Query Loop öğesi, yoksa geçerli yazı; görüntüleyen kişiye görünür olmalı, aksi halde boş.
Seçenek sayfası değerleri
Bir grubun alanına başvuru, grup yalnızca seçenek sayfalarında gösterilse bile hem blokta hem bağlamalarda, yazı olsun olmasın çalışır. Yazı içeriğinde yazı yazarı seçenek yetkisine sahip olmalıdır (varsayılan olarak manage_options ya da wpmcf/options/capabilities filtresinin döndürdüğü yetki); kural shortcode ile aynıdır. REST isteklerinde yazı içeriği dışında (düzenleyici önizlemeleri) bu yetki geçerli kullanıcıda olmalıdır.
Düzenleyici REST rotaları (dahili)
Düzenleyici betiği verileri iki wpmcf/v1 rotasından yükler. Bunlar blok arayüzü içindir, herkese açık bir API değildir.
Rota | Yöntem | İzin | Amaç |
|---|---|---|---|
| GET |
| Bir kullanım türü için alan kataloğu ( |
| POST |
| Bağlama önizlemesi için canlı değerler: |
Doğrulandı: yönetici ve editör 200, abone 403, oturumu kapalı bir istek 401 alır.
Sorun giderme
Belirti | Neden |
|---|---|
Blok sitede hiçbir şey göstermiyor ama düzenleyicide çalışıyor | Alan boştur, yazı görüntüleyen kişi için özeldir veya parola korumalıdır ya da bir yazının dışındasınız ( |
Alan seçicide görünmüyor | Bir Password veya yerleşim (tab, accordion) alanıdır ya da alan grubu etkin değildir. Bir Group alanının alt alanları kendi girdileri olarak görünür. |
Attributes panelinde "Massbase" yok | Blok bağlamaları desteklemiyor. |
Bir görsel alanı dosya URL'sini metin olarak yazdırıyor | Blokta |
Sayfa oluşturucu karşılıkları (Elementor, Bricks, Divi, Breakdance, Oxygen) Integrations bölümündedir.
Hâlâ takıldınız mı? Destek ile iletişime geçin