İçeriğe geç

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.

JSON
{
  "$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:

Sorgu İşlev
posts get_posts
users get_users
terms get_terms

Bağımsız Değişkenler

arguments özniteliğini kullanarak özel bağımsız değişkenler geçirebilirsiniz:

JSON
{
  "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:

JSON
{
  "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:

JSON
{
  "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:

JSON
{
  "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):

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "postTypes",
        "type": "checkbox",
        "label": "Post types",
        "populate": {
          "type": "function",
          "function": "get_post_types",
          "arguments": [[], "objects"]
        }
      }
    ]
  }
}

Döndürülen Biçim

JSON
{
  "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:

JSON
{
  "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:

PHP
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:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "posts",
        "type": "select",
        "label": "Posts",
        "populate": {
          "type": "custom",
          "custom": "customData"
        }
      }
    ]
  }
}

Harici Veriler

Harici bir kaynaktan veri alın:

JSON
{
  "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.

JSON
{
  "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.