Seçenekleri Doldurma
Posts, Users veya Terms gibi farklı alan türleri sağlamak yerine, Blockstudio verileri doğrudan block.json üzerinden doldurmanın modüler bir yolunu sunar. Bu özellik select, radio, checkbox, color ve gradient alan türleriyle çalışır.
Veriler dört şekilde doldurulabilir:
- Sorgu – Bir yazı, kullanıcı veya terim sorgusundan sonuç döndürür
- Getirme – Harici bir kaynaktan sonuç döndürür
- İşlev – Özel bir işlevden sonuç döndürür
- Özel – Özel bir veri kümesinden sonuç döndürür
Sorgu
Sorgu modu seçildiğinde Posts, Users veya Terms doldurulabilir.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/native",
"title": "Native Block",
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts"
}
}
]
}
}
Kullanılabilir sorgu türleri, dahili olarak şu WordPress işlevlerini kullanır:
Bağımsız Değişkenler
arguments özniteliğini kullanarak özel bağımsız değişkenler geçirebilirsiniz:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "jobs",
"numberposts": "20"
}
}
}
]
}
}
Döndürülen Biçim
Varsayılan olarak Blockstudio şunları döndürür:
| Sorgu | Değer | Etiket |
|---|---|---|
posts |
yazı nesnesi | post_title |
users |
kullanıcı nesnesi | display_name |
terms |
terim nesnesi | name |
Yanıtı returnFormat ile özelleştirin:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "posts",
"numberposts": "20"
},
"returnFormat": {
"value": "id",
"label": "post_name"
}
}
}
]
}
}
Getirme Modu
fetch seçeneğiyle dinamik aramayı etkinleştirin:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"fetch": true,
"arguments": {
"post_type": "posts",
"numberposts": "20"
}
}
}
]
}
}
Bu, stylisedUi özelliğini etkinleştirir ve başlangıçta ilk 20 yazıyı getirir. Seçim alanına yazmak, s bağımsız değişkenini kullanarak yazılarda arama yapar.
İşlev
Seçenekleri doldurmak için özel bir işlev kullanın:
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types"
}
}
]
}
}
Bağımsız Değişkenler
Bağımsız değişkenleri bir dizi olarak geçirin (dahili olarak call_user_func_array kullanır):
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": [[], "objects"]
}
}
]
}
}
Döndürülen Biçim
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": [[], "objects"],
"returnFormat": {
"value": "name",
"label": "label"
}
}
}
]
}
}
Seçenekleri Birleştirme
Statik seçenekleri doldurulmuş verilerle birleştirin:
{
"blockstudio": {
"attributes": [
{
"id": "users",
"type": "radio",
"label": "Users",
"options": [
{
"value": "administrators",
"label": "Administrators"
},
{
"value": "editors",
"label": "Editors"
}
],
"populate": {
"type": "query",
"query": "users",
"position": "before"
}
}
]
}
}
position seçeneği (before veya after), doldurulmuş seçeneklerin statik seçeneklere göre nerede görüneceğini belirler.
Uyarı
fetch modu kullanılırken seçenekleri birleştirme ve verilerle doldurma desteklenmez.
Özel Veriler
blockstudio/blocks/attributes/populate filtresiyle yeniden kullanılabilir veri kümeleri oluşturun. Filtre, ada göre anahtarlanmış tüm özel veri kümelerini içeren tek bir dizi bağımsız değişkeni alır. Veri kümenizi bir anahtar altına ekleyip diziyi döndürün:
add_filter('blockstudio/blocks/attributes/populate', function($options) {
$options['customData'] = [
['value' => '1', 'label' => 'Option 1'],
['value' => '2', 'label' => 'Option 2'],
];
return $options;
});
Ardından blokta bu anahtara başvurun:
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "custom",
"custom": "customData"
}
}
]
}
}
Harici Veriler
Harici bir kaynaktan veri alın:
{
"blockstudio": {
"attributes": [
{
"id": "select",
"type": "select",
"label": "Select",
"multiple": true,
"populate": {
"type": "fetch",
"arguments": {
"urlSearch": "https://example.com/wp-json/wp/v2/posts?search="
},
"returnFormat": {
"value": "id",
"label": "title.rendered"
}
}
}
]
}
}
Arama terimi, urlSearch sonuna eklenir.
Dinamik Bağımsız Değişkenler
Doldurma bağımsız değişkenleri, {attributes.*} söz dizimini kullanarak diğer blok özniteliklerine başvurabilir. Başvurulan öznitelik değiştiğinde alan, seçeneklerini otomatik olarak yeniden getirir.
{
"blockstudio": {
"attributes": [
{
"id": "post_type",
"type": "select",
"label": "Post Type",
"options": [
{ "label": "Pages", "value": "page" },
{ "label": "Posts", "value": "post" }
]
},
{
"id": "selected_post",
"type": "select",
"label": "Select Post",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "{attributes.post_type.value}",
"numberposts": 10
}
}
}
]
}
}
Bu, tüm doldurma türlerinde (query, function, custom) çalışır. Doldurma yapılandırmasındaki {attributes.*} içeren her değer, sorgu çalışmadan önce istemci tarafında geçerli öznitelik değeriyle çözümlenir.
Başvurular, düzenleyicide saklanan değerleri kullanır. Bir seçim seçeneği için, değer olarak {attributes.post_type.value}, etiket olarak {attributes.post_type.label} kullanın; returnFormat bu saklanan düzenleyici biçimini değil, şablon değerini denetler.
İç içe bağımsız değişkenler, şablon dizesine dönüştürülmeden çözümlenir.
Tek bir yer tutucudan oluşan bağımsız değişkenler; sayı, boole değeri, dizi ve nesneler de dahil olmak üzere başvurulan türü korur. Başka bir metne gömülü yer tutucu dize üretir. Eksik başvurular değiştirilmeden bırakılır; tırnak içindeki veya birden çok satıra yayılan değerler olduğu gibi iletilir.
İşlev geri çağırımları, konumsal bağımsız değişken listelerini korur. Düzenleyici, arama bağımsız değişkenleri olan WordPress değerini yalnızca query doldurmalarına ekler; işlev çağrılarına eklemez.
Bağımlı Seçimlerin Oluşturulması
Her blok örneğinin bağımsız değişkenleri farklı olabileceğinden, blok kaydedildiğinde bağımlı seçenekler yüklenmez. Oluşturma sırasında boş bir seçenek listesine göre elemek yerine kaydedilmiş seçim kullanılır. Doldurma geri çağırımı ön yüzde yeniden çalıştırılmaz.
Alan için returnFormat hâlâ geçerlidir:
returnFormat |
Tekli seçim | Çoklu seçim |
|---|---|---|
value (varsayılan) |
Kaydedilen değer, örneğin "a" |
Kaydedilen değerlerden oluşan bir dizi, örneğin ["a", "b"] |
label |
Kaydedilen etiket | Kaydedilen etiketlerden oluşan bir dizi |
both |
Kaydedilen {value, label} seçeneği |
Kaydedilen seçeneklerden oluşan bir dizi |
Sorguyla doldurulan seçimlerde değerler, populate.returnFormat.value "id" olmadıkça karşılık gelen WordPress yazı, kullanıcı veya terim nesnesine çözülür. Etiketler kaydedilen seçimden alınır. İçe aktarılan bir seçimin etiketi yoksa değeri etiket olarak kullanılır. options içinde tanımlanan eşleşen statik seçenek, kaydedilen seçeneğe öncelik tanır; bu nedenle güncel etiketi uygulanır.
Boş seçimler false (veya alanın yapılandırılmış fallback değeri) olarak kalır. Bu, sıradan statik seçeneklerin doğrulanmasını değiştirmez: statik seçenek listesinde artık bulunmayan kayıtlı bir değer yine de false döndürür.
Dinamik seçimler, seçenekleri ertelenmiş olsa da default ve fallback seçimlerini korur. Çoklu seçim için skaler bir değer, {value, label} seçeneği veya bunlardan oluşan bir dizi kullanın. Skaler değer, tanımlanmış bir statik seçenekle eşleşmediği sürece etiket olarak kendi değerini kullanır. Seçenek nesnesi, sağlanan etiketini korur; eşleşen statik seçenek öncelik kazanır. Sunucuda bu varsayılanları aramak için populate geri çağırması çalıştırılmaz.