Lewati ke konten

Dennis · 14 Maret 2026

Blockstudio 7.1

Blockstudio 7.1 adalah rilis fitur pertama sejak penulisan ulang v7. Jika v7 membangun ulang fondasinya, 7.1 menambahkan bagian-bagian yang mengubah blok menjadi sesuatu yang lebih: lapisan database, fungsi server, tugas terjadwal, dan CLI. Kini, folder blok dapat menjadi aplikasi lengkap.

Berikut semua hal baru.

Komponen

Selalu ada ketegangan antara blok yang digunakan editor di inserter dan blok yang digunakan developer sebagai blok penyusun untuk hal lain. Kartu, lencana, widget statistik, input formulir. Semua itu memerlukan alur Blockstudio lengkap (atribut, templat, aset, Tailwind), tetapi tidak seharusnya muncul di inserter.

7.1 memperkenalkan komponen untuk mengatasi hal ini. Tetapkan "component": true di block.json Anda, dan blok akan melewati seluruh alur build tetapi tidak pernah didaftarkan ke registri jenis blok milik WordPress. Blok tidak muncul di inserter maupun di data editor yang dikirim ke JavaScript, tetapi tetap tersedia sepenuhnya untuk dirender secara terprogram.

JSON
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}

Render dari PHP:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);

Atau gunakan sintaks tag HTML yang baru:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

Tag blok

Kini, blok dapat disematkan sebagai tag HTML menggunakan dua sintaks yang dapat saling dipertukarkan:

HTML
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />

Keduanya menghasilkan output yang sama. Keduanya berfungsi dengan blok Blockstudio dan blok inti WordPress. Di dalam templat blok, keduanya dirender secara otomatis tanpa perlu mengaktifkan apa pun. Artinya, Anda dapat menyusun seluruh tata letak dari blok lain langsung di dalam templat:

Twig
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-heading level="2">Section Title</bs:core-heading>
  <block name="core/group">
    <block name="core/paragraph">Inside a core group block.</block>
    <bs:mytheme-cta variant="primary" />
  </block>
</div>

Kedua sintaks dapat disarangkan secara bebas. Blok Blockstudio dirender melalui alur lengkap (templat, Tailwind, aset). Blok inti dirender melalui WordPress menggunakan perender yang sama dengan yang menjalankan Pages and Patterns.

Untuk perenderan tingkat halaman (konten kiriman, area widget), aktifkan di blockstudio.json:

JSON
{ "blockTags": { "enabled": true } }

Daftar izinkan dan daftar tolak mengatur blok mana yang dapat dirender melalui tag menggunakan pola wildcard. Atribut data-* dan html-* diteruskan ke elemen akar HTML blok yang dirender. Perender khusus dapat didaftarkan melalui filter blockstudio/block_tags/renderers.

Di balik layar, parser tag menggunakan pemindai string ringan baru yang sepenuhnya menggantikan DOMDocument. Parser ini menangani tag bertingkat dengan pelacakan kedalaman, blok kontainer rekursif, dan sintaks campuran dalam satu kali proses. Dalam pengujian performa, parser memproses 1,000 tag datar dalam 2.4ms dan 100 tingkat penyarangan dalam 3.7ms, secara konsisten lebih cepat daripada DOMDocument maupun WP_HTML_Tag_Processor milik WordPress. Parser yang sama juga menangani penguraian elemen HTML mentah untuk Pages and Patterns, menggantikan parser berbasis DOMDocument yang sebelumnya menangani elemen <p>, <div>, dan HTML lainnya.

Jenis field baru

Blok

Jenis field block baru yang memungkinkan Anda merujuk blok Blockstudio lain sebagai atribut. Field blok yang dirujuk diperluas secara inline menggunakan idStructure dan overrides, sama seperti field khusus. Bedanya, di dalam templat, mengakses nilainya akan mengembalikan output blok yang telah dirender.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

Jika mytheme/card memiliki field heading dan content, blok induk akan mendapatkan card_heading dan card_content di bilah sisinya. Di dalam templat, {{ a.card }} menghasilkan kartu yang telah dirender. Berfungsi dengan blok biasa maupun komponen.

Tag HTML

Setiap tema memiliki blok dengan tingkat judul yang perlu berubah sesuai konteks. H1 di beranda, H2 di halaman dalam. Kini tersedia jenis field html-tag khusus dengan preset bawaan, sehingga Anda tidak perlu lagi membuatnya sebagai field pilihan dengan opsi yang ditetapkan secara hardcode setiap kali.

JSON
{
  "id": "tag",
  "type": "html-tag",
  "default": "h2",
  "tags": "heading",
  "exclude": ["h5", "h6"]
}

Preset: heading (h1-h6), text (judul + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. Atau berikan array khusus. exclude menghapus tag tertentu dari preset mana pun.

Twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>

Database

Inilah fitur utama rilis ini. Tambahkan file db.php ke direktori blok mana pun, lalu Blockstudio akan membuat lima endpoint CRUD REST, memvalidasi setiap operasi tulis terhadap skema, mengelola backend penyimpanan secara otomatis, serta menyediakan klien JavaScript (bs.db()) dan PHP API (Db::get()). Tanpa file migrasi, kelas pengontrol, maupun pendaftaran rute.

PHP
return [
    'subscribers' => [
        'storage'    => 'table',
        'capability' => [
            'create' => true,
            'read'   => true,
            'update' => 'edit_posts',
            'delete' => 'manage_options',
        ],
        'fields' => [
            'email' => [
                'type'     => 'string',
                'format'   => 'email',
                'required' => true,
                'validate' => function ($value) {
                    if (str_ends_with($value, '@spam.com')) {
                        return 'This domain is blocked.';
                    }
                    return true;
                },
            ],
            'name' => ['type' => 'string', 'maxLength' => 100],
            'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
        ],
    ],
];

Skema itu saja menghasilkan API yang berfungsi penuh dengan endpoint buat, daftar, ambil, perbarui, dan hapus, semuanya dilengkapi validasi input.

Penyimpanan

Lima backend penyimpanan, masing-masing sesuai untuk kasus penggunaan yang berbeda:

  • table: Tabel MySQL khusus yang dikelola melalui dbDelta(). Menambahkan field ke skema akan menambahkan kolom saat halaman dimuat berikutnya. Default produksi.
  • sqlite: Satu file SQLite di folder db/ blok. Kueri SQL sungguhan, mode WAL untuk pembacaan serentak, dan sepenuhnya portabel. Salin foldernya, salin databasenya.
  • jsonc: Satu objek JSON per baris dalam file datar. Mudah dibaca manusia, dapat dikontrol versinya, ramah git.
  • meta: Array JSON di meta pos WordPress, terikat pada pos tertentu.
  • post_type: Setiap record menjadi pos WordPress dalam jenis pos khusus. Field disimpan sebagai entri meta pos terpisah, sepenuhnya dapat dikueri dengan WP_Query.

Klien

Di sisi JavaScript, bs.db() menyediakan klien CRUD lengkap:

JavaScript
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);

Tiga utilitas pendamping disertakan bersama klien ini:

  • bs.cache: Cache kueri dalam memori dengan get, set, invalidate, dan clear. Digunakan bersama oleh semua pemanggilan kueri dan mutasi.
  • bs.query(key, fn, options): Membungkus fungsi asinkron apa pun dengan caching, deduplikasi permintaan, dan staleTime yang dapat dikonfigurasi. Beberapa pemanggilan dengan kunci yang sama saat permintaan sedang berlangsung akan mengembalikan promise yang sama.
  • bs.mutate(options): Menangani mutasi optimistis dengan rollback otomatis. Berikan objek state reaktif, aksi (create, update, delete), dan data optimistis. UI diperbarui seketika. Jika pemanggilan server gagal, state dikembalikan ke snapshot sebelum mutasi.

Ketiganya mencakup seluruh siklus baca/tulis: bs.query untuk pembacaan yang di-cache, bs.mutate untuk penulisan optimistis, bs.cache untuk kendali manual.

Di sisi PHP, kelas Db menyediakan operasi yang sama:

PHP
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);

Validasi

Kesalahan validasi dikembalikan sebagai array kesalahan per field, terinspirasi format fieldErrors milik Zod. Beberapa aturan dapat gagal pada field yang sama, dan strukturnya memudahkan pemetaan kesalahan ke field formulir di frontend:

JSON
{
  "data": {
    "status": 400,
    "errors": {
      "email": ["Must be a valid email address.", "This domain is blocked."],
      "plan": ["Must be one of: free, pro."]
    }
  }
}

Callback validate khusus dijalankan di sisi server untuk hal-hal yang tidak dapat ditangani aturan bawaan: pemblokiran domain, validasi lintas field, dan pencarian eksternal.

Data dengan cakupan pengguna

Untuk data per pengguna seperti daftar tugas, favorit, atau draf, tetapkan userScoped ke true dan Blockstudio akan menangani sisanya. Fitur ini menambahkan kolom user_id, mengisinya secara otomatis saat pembuatan, dan memfilter setiap kueri untuk pengguna saat ini. Pembaruan dan penghapusan memeriksa kepemilikan. Tanpa field user_id manual, hook before_create, atau pemfilteran di RPC. Cukup satu baris konfigurasi. Saat menggunakan penyimpanan post_type, userScoped dipetakan ke post_author, bukan ke kolom terpisah.

PHP
return [
    'storage'    => 'sqlite',
    'userScoped' => true,
    'fields'     => [ /* ... */ ],
];

Polling real-time

Tetapkan 'realtime' => true di skema Anda dan klien akan otomatis melakukan polling untuk memeriksa perubahan. Saat terjadi perubahan di server, store Interactivity API diperbarui dan UI dirender ulang tanpa perubahan JavaScript di sisi Anda. Konfigurasikan dengan 'realtime' => ['key' => 'todos', 'interval' => 5000] untuk kunci state dan interval khusus. Polling menggunakan perbandingan hash agar permintaan tetap ringan dan dijeda saat tab browser tersembunyi.

Keamanan, hook, portabilitas

Endpoint publik dilindungi oleh header CSRF X-BS-Token yang disisipkan otomatis. Gunakan 'open' jika Anda memerlukan akses yang benar-benar tanpa autentikasi, misalnya untuk webhook masuk.

Hook siklus hidup dijalankan sebelum dan sesudah setiap operasi tulis. Definisikan hook secara inline di db.php atau secara global melalui aksi WordPress.

Field dapat menentukan kunci component untuk perenderan formulir berbasis skema melalui bs_db_form().

Dengan penyimpanan SQLite atau JSONC, seluruh aplikasi berada dalam satu folder: kode, logika, kontrol akses, dan data. Salin folder itu untuk men-deploy aplikasi.

RPC

Terkadang CRUD saja tidak cukup. Anda memerlukan logika server khusus, seperti mengubah status tugas, mengirim notifikasi, atau mengagregasi statistik. Itulah fungsi rpc.php. Definisikan fungsi PHP, panggil dari frontend menggunakan bs.fn(), lalu Blockstudio akan menangani endpoint REST, autentikasi, perlindungan CSRF, dan serialisasi JSON. Polanya terinspirasi tRPC: prosedur didefinisikan di sisi server dan dipanggil dari klien berdasarkan nama.

PHP
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
JavaScript
const result = await bs.fn('subscribe', { email: 'user@example.com' });

Skrip inline (script-inline.js) mendeteksi otomatis nama blok dari atribut data-block pada tag skripnya, jadi Anda tidak perlu mengirimkannya secara manual. Skrip modul meneruskannya sebagai argumen ketiga.

Opsi kontrol akses mencakup public (dengan CSRF), 'open' (tanpa perlindungan), string kapabilitas, atau array. Kontrol metode HTTP per fungsi, hook siklus hidup, dan pemanggilan lintas blok dari JS maupun PHP semuanya didukung.

Cron

Tugas latar belakang didefinisikan dalam file cron.php. Tetapkan jadwal dan callback, lalu Blockstudio mendaftarkannya ke WordPress Cron saat inisialisasi. Ketika plugin dinonaktifkan, semua jadwal dibatalkan dengan rapi.

PHP
return [
    'cleanup' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db = Db::get('my-theme/app', 'logs');
            // delete old entries
        },
    ],
    'sync' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // pull from external API
        },
    ],
];

Semua jadwal WordPress bawaan didukung, ditambah interval khusus melalui filter cron_schedules.

CLI

Perintah wp bs baru mencakup seluruh rangkaian fitur Blockstudio: blok, database, RPC, cron, pengaturan, kompilasi Tailwind, kompilasi SCSS, field khusus, dan pengelolaan aset.

Shell
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled

Semua perintah mendukung --format=json untuk pembuatan skrip.

Peningkatan repeater

textMinimized untuk field objek

Baris repeater yang diciutkan kini menangani nilai field objek dengan benar. Sebelumnya, mengarahkan textMinimized ke field tautan akan menampilkan [object Object]. Kini Blockstudio membaca otomatis subproperti yang tepat berdasarkan jenis field: title untuk tautan, value untuk warna dan gradien, icon untuk ikon. Anda juga dapat menetapkan properti key secara eksplisit untuk membaca subproperti mana pun yang diinginkan.

JSON
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}

RichText dan MediaPlaceholder

Kedua komponen templat kini berfungsi di dalam field repeater dengan notasi tanda kurung siku untuk menargetkan baris yang benar. Judul dan paragraf yang dapat diedit secara inline, serta zona unggah media tersedia di setiap baris repeater.

Twig
{% for item in a.items %}
  <div class="card">
    <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
    <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
    <RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
  </div>
{% endfor %}

Kondisi field khusus dengan idStructure

Saat menggunakan field khusus dengan idStructure, ID kondisi di dalam definisi field kini ditulis ulang secara otomatis agar sesuai dengan nama yang diperluas. Jika grup field ukuran font memiliki kondisi pada enable dan Anda memperluasnya menggunakan idStructure: "title_font_{id}", kondisi kini merujuk dengan benar ke title_font_enable, bukan ke enable yang asli.

Kondisi tingkat referensi juga didukung. Tambahkan conditions pada referensi field khusus untuk menerapkannya sekaligus ke setiap field yang diperluas.

Argumen populate dinamis

Argumen populate kini dapat merujuk atribut blok lain menggunakan sintaks {attributes.*}. Saat atribut yang dirujuk berubah, field pilihan akan mengambil ulang opsinya secara otomatis. Rangkaikan beberapa pilihan: satu untuk memilih jenis kiriman, lalu satu lagi untuk memuat kiriman dari jenis tersebut.

JSON
{
  "id": "selected_post",
  "type": "select",
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "{attributes.post_type}"
    }
  }
}

Ubah post_type menjadi “page” dan pilihan kedua akan memuat halaman. Ubah menjadi “post” dan pilihan itu akan memuat kiriman. Berfungsi dengan jenis populate dan atribut apa pun.

Composer

Blockstudio kini berfungsi saat dimuat dari mana pun di bawah wp-content/, bukan hanya dari direktori plugin. URL aset diselesaikan melalui konstanta BLOCKSTUDIO_URL, bukan plugins_url(), sehingga instalasi yang disertakan dalam tema dapat langsung berfungsi:

PHP
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';

Dependensi runtime composer.json telah dirapikan. Paket berskop (TailwindPHP, ScssPhp, Minify) yang sudah disertakan dalam lib/ tidak lagi tercantum sebagai dependensi runtime. Hanya php >= 8.2 dan plugin-update-checker yang tersisa.

Ketiga metode instalasi (zip plugin, plugin melalui Composer, tema yang menyertakan paket melalui Composer) menghasilkan kondisi awal yang sama: aktivasi penuh WordPress, pendaftaran blok, dan perenderan frontend.

Lihat dokumentasi Composer untuk petunjuk penyiapan.

Profiler performa

Tambahkan ?blockstudio-perf ke halaman mana pun URL dan panel debug akan muncul di bagian bawah, menampilkan waktu render per blok, rincian tiap fase, serta rasio cache hit. Data waktu juga dikirim sebagai header Server-Timing yang dapat dilihat di tab Network pada DevTools browser.

JSON
{ "dev": { "perf": true } }

Aktifkan secara permanen melalui pengaturan untuk membuat profil setiap pemuatan halaman. Hanya terlihat oleh pengguna yang sudah masuk dengan kapabilitas edit_posts.

Tag blok yang menutup dirinya sendiri kini juga di-cache di memori. Saat blok yang sama dengan atribut identik muncul beberapa kali di halaman, perenderan berikutnya melewati seluruh alur templat.

Perbaikan bug

  • Peringatan penghentian PHP 8.4: Memperbaiki peringatan penghentian strpos() dan str_replace() yang disebabkan oleh penerusan null ke add_submenu_page().

Lainnya

  • Field kode SCSS: Field kode mendukung language: "scss". Nilai dikompilasi melalui ScssPhp baik di editor maupun di frontend.
  • Blok WordPress standar: Direktori Blockstudio dapat berisi output @wordpress/create-block bersama blok Blockstudio. Blok akan didaftarkan otomatis tanpa kode plugin terpisah.

Jika Anda ingin melihat pola full-stack beraksi, panduan Full-Stack Blocks menjelaskan langkah demi langkah pembuatan aplikasi daftar tugas per pengguna dan formulir pendaftaran buletin publik dari awal.