Lewati ke konten

Tambahkan field ke blok apa pun

JSON murni. Tanpa template, tanpa callback render.

Field kustom, tanpa template

Buat file JSON, targetkan blok dengan name, lalu definisikan field. set memetakan nilai ke kelas, gaya, atribut data, atau atribut HTML lainnya.

Blockstudio menerapkan output menggunakan Tag Processor WordPress HTML. Tanpa template atau callback render.

extend-animation.json
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "allowNull": "None",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ],
        "set": [{
          "attribute": "class",
          "value": "animate-{attributes.animation}"
        }]
      }
    ]
  }
}

Targetkan blok apa pun

Perluas satu blok, daftar, atau wildcard namespace.

Properti set

Petakan field ke kelas, gaya, atribut data, atau atribut HTML apa pun.

Field kondisional

Tampilkan field berdasarkan nilai lain dengan logika bergaya blok.

Fitur lengkap

Semua tipe field, logika kondisional, pengisian, dan properti.

Penempatan inspektur

Tempatkan field di tab pengaturan, gaya, atau lanjutan.

Urutan prioritas

Atur urutan beberapa ekstensi yang menargetkan blok yang sama.

Tanpa callback render

Tag Processor HTML menerapkan output secara otomatis.

JSON Schema

Pelengkapan otomatis dan validasi skema khusus.

Petakan nilai ke HTML menggunakan set

set memetakan nilai ke kelas, gaya inline, atribut data, atau atribut HTML apa pun menggunakan notasi titik seperti {attributes.fieldId}.

Akses nilai objek bertingkat, terapkan secara kondisional, atau keluarkan satu field ke beberapa atribut.

Field yang mengembalikan beberapa nilai menerapkan set pada masing-masing nilai. Kelas dan gaya akan digabungkan; untuk atribut lain, "join": true menulis setiap nilai dengan pemisah spasi, alih-alih hanya menyimpan nilai terakhir.

extend-color.json
{
  "name": "core/heading",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "returnFormat": "both",
        "options": [
          { "value": "#f00", "label": "Red" },
          { "value": "#00f", "label": "Blue" }
        ],
        "set": [
          { "attribute": "style", "value": "color: {attributes.customColor.value}" },
          { "attribute": "data-color", "value": "{attributes.customColor.label}" },
          { "attribute": "class", "value": "has-custom-color" }
        ]
      }
    ]
  }
}

Targetkan satu blok atau ribuan

Targetkan satu nama seperti "core/paragraph", larik nama, atau seluruh namespace dengan "core/*".

Beberapa ekstensi JSON dapat menargetkan blok yang sama. Prioritas menentukan urutannya di inspektur.

Daftar exclude tingkat atas melewati blok yang akan cocok dengan name, menggunakan pencocokan persis dan wildcard yang sama. Blok yang dikecualikan tidak mendapatkan field maupun keluarannya.

extend-animation.json
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ]
      }
    ]
  }
}

Kecualikan blok

Lewati blok satuan atau seluruh prefiks yang sebaliknya akan cocok dengan wildcard.

Nilai gabungan

Tulis setiap nilai terpilih dari field multi-nilai ke dalam satu atribut.

Field atribut

Field atribut menulis pasangan nama dan nilainya pada blok tanpa aturan set.

Periksa dari PHP

bs_block_extension_fields() mengembalikan field yang ditambahkan setiap ekstensi yang cocok ke sebuah blok, termasuk blok inti dan pihak ketiga.

Plus

Kit ekstensi resmi

Template situs premium, instruksi sistem AI, dan komunitas Discord privat. Pembelian satu kali, pembaruan seumur hidup.

  • 500+ templat situs
  • Instruksi sistem AI
  • Pembaruan seumur hidup
  • Komunitas privat Discord