Lewati ke konten

Dennis · 7 Februari 2026

Introducing Blockstudio 7

Blockstudio 7 telah hadir. Ini adalah rilis terbesar dalam sejarah proyek: penulisan ulang seluruh basis kode dari awal hingga tuntas. Setiap kelas, setiap hook, setiap baris kode dibangun ulang dari awal dengan fokus pada standar coding PHP modern, WordPress, dan kemudahan pemeliharaan jangka panjang.

Namun, ini bukan sekadar refaktor. Blockstudio 7 menghadirkan fitur besar seperti halaman dan pola berbasis file, sistem penyimpanan meta pos, integrasi SEO, serta parser HTML-ke-blok baru yang mendukung semuanya. Selain itu, Blockstudio kini sepenuhnya gratis dan bersumber terbuka.

Mari kita bahas semua yang baru.

Gratis dan sumber terbuka

Saya telah mengerjakan Blockstudio sejak 2020 dan merilis puluhan versi selama bertahun-tahun. Orang-orang yang menggunakannya menyukainya, tetapi menemukan kecocokan pasar untuk framework blok komersial WordPress selalu menjadi tantangan.

LLM mengubah keadaan. Asisten coding AI kini cukup mahir menulis kode blok, tetapi mereka membutuhkan struktur berbasis file yang rapi. Markup blok WordPress berantakan: komentar HTML serialisasi dengan atribut JSON tertanam, bercampur dengan struktur DOM. Ini sulit bagi manusia, dan bahkan lebih sulit bagi LLM untuk melakukannya dengan benar.

Pendekatan yang mengutamakan file dari Blockstudio sejak awal dirancang agar semuanya tetap sederhana: sebuah block.json dan templat PHP di dalam folder. Tanpa entri database, tanpa React, tanpa langkah build. Dengan v7, filosofi ini diterapkan lebih jauh. Parser HTML-ke-blok memungkinkan Anda menulis HTML biasa dan mengubahnya secara otomatis menjadi markup blok yang valid. Semuanya tetap berada di sistem file. Penulisan database hanya terjadi saat sinkronisasi halaman diminta secara eksplisit melalui PHP API atau CLI, dan prosesnya digerakkan oleh templat file.

Menjadikan Blockstudio sumber terbuka adalah langkah berikutnya yang wajar. Semakin banyak LLM dilatih dengan kode Blockstudio, semakin baik kemampuannya untuk menghasilkan kode tersebut. Basis kode terbuka, dokumentasi terbuka, dan file konteks AI siap pakai yang dapat digunakan oleh alat apa pun: inilah cara membangun lingkungan terbaik untuk pengembangan WordPress berbantuan AI.

Plugin lengkap tersedia di GitHub untuk digunakan, di-fork, dan dikontribusikan siapa saja. Tanpa kunci lisensi, tanpa paywall, tanpa pembatasan fitur.

Fitur baru

Halaman berbasis file

Ini salah satu tambahan terbesar di versi 7.0. Kini Anda dapat menentukan seluruh halaman WordPress sebagai templat file yang disinkronkan ke database sebagai konten blok native saat Anda menjalankan API atau CLI sinkronisasi halaman.

Buat folder dengan page.json dan sebuah file templat:

JSON
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
PHP
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>

Jalankan wp bs pages sync agar Blockstudio mengurai HTML menjadi blok WordPress dan membuat atau memperbarui halaman di database.

Penggabungan blok berdasarkan kunci

Saat templat disinkronkan, perubahan pengguna biasanya akan tertimpa. Atribut key mengatasi hal ini dengan mempertahankan konten pengguna di setiap sinkronisasi:

HTML
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>

Blok dengan kunci yang cocok mempertahankan konten yang telah diedit pengguna saat templat diperbarui. Blok tanpa kunci akan diganti sepenuhnya.

Block Bindings

Sebagai alternatif kunci, Anda dapat menggunakan Block Bindings dari WordPress core API untuk menghubungkan blok langsung ke meta pos. Ini bukan fitur Blockstudio, melainkan WordPress API native. Blockstudio hanya meneruskan atribut metadata ke markup blok yang dihasilkan. Konten disimpan di meta, bukan di markup blok, sehingga sinkronisasi templat tidak pernah menghapus perubahan pengguna. Data ini juga dapat dikueri melalui WP_Query dan tersedia melalui REST API.

HTML
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>

Kedua pendekatan dapat digunakan dalam templat yang sama.

Kontrol pengeditan

Halaman mendukung blockEditingMode dan templateLock untuk mengatur bagian yang dapat diubah pengguna:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}

Pengaturan ini mengunci struktur halaman sekaligus tetap memungkinkan pengguna mengedit teks dan media. Elemen individual dapat mengesampingkan pengaturan tingkat halaman dengan atribut blockEditingMode di dalam templat.

Menautkan ke ID pos

Gunakan postId untuk menautkan templat halaman ke pos WordPress yang sudah ada, sehingga halaman duplikat tidak dibuat dan templat selalu memperbarui pos yang benar:

JSON
{
  "name": "home",
  "title": "Home",
  "postId": 2
}

Untuk detail lengkap, lihat dokumentasi Halaman.

Pola berbasis file

Seperti halaman, kini Anda dapat menentukan pola blok sebagai templat file. Tulis pola Anda dalam HTML, lalu Blockstudio mengurainya menjadi markup blok dan mendaftarkannya sebagai pola blok WordPress native. Pola tersebut muncul di penyisip blok dan dapat ditempatkan di mana saja oleh pengguna.

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
HTML
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>

Tidak seperti halaman, pola tidak membuat entri database. Pola didaftarkan di memori setiap kali halaman dimuat. Lihat dokumentasi Pola.

Parser HTML-ke-blok

Halaman dan pola didukung oleh parser HTML baru yang mengubah templat HTML standar menjadi markup blok WordPress. Parser ini menangani blok kontainer (seperti grup dan kolom) serta blok daun (seperti paragraf dan judul) secara otomatis. Parser menggunakan arsitektur perender berbasis trait, sehingga mudah diperluas untuk mendukung jenis blok tambahan melalui filter blockstudio/parser/renderers:

PHP
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
    $renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
        $content = $parser->get_inner_html( $element );
        $html    = '<div class="acme-hero">' . $content . '</div>';

        return array(
            'blockName'    => 'acme/hero',
            'attrs'        => $attrs,
            'innerBlocks'  => array(),
            'innerHTML'    => $html,
            'innerContent' => array( $html ),
        );
    };

    return $renderers;
}, 10, 2 );

Setelah terdaftar, Anda dapat menggunakan blok tersebut dalam templat halaman atau pola apa pun:

HTML
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>

Penyimpanan

Kini field dapat menyimpan nilainya di meta pos atau opsi situs, selain di atribut blok. Fitur ini sangat penting:

JSON
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}

Dengan nilai yang tersimpan di meta pos, Anda dapat:

  • Mengueri pos berdasarkan nilai field menggunakan WP_Query dan meta_query
  • Mengakses data field melalui REST API untuk konfigurasi headless
  • Berbagi data dengan plugin lain, seperti alat SEO dan lapisan caching

Anda juga dapat menyimpan nilai di tabel opsi untuk pengaturan global yang berlaku di seluruh situs:

JSON
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}

Lihat dokumentasi Penyimpanan untuk API selengkapnya.

Field kustom

Kini definisi field yang dapat digunakan ulang bisa dibagikan di beberapa blok. Tentukan sekumpulan field sekali, lalu gunakan referensinya dari blok mana pun. Cara ini menghilangkan pengulangan saat beberapa blok memiliki struktur field yang sama.

Buat field.json di direktori blockstudio Anda:

JSON
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}

Lalu gunakan referensinya dari blok mana pun dengan prefiks custom/:

JSON
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}

Properti idStructure menambahkan prefiks pada setiap ID field, sehingga heading menjadi hero_heading. Anda juga dapat mengesampingkan properti field tertentu untuk setiap instans dengan kunci overrides.

Lihat dokumentasi Field Kustom.

Tailwind CSS v4

Dukungan Tailwind telah dibangun ulang sepenuhnya untuk v4. Alih-alih dikompilasi di sisi klien melalui CDN lalu disimpan ke disk saat pos disimpan (pendekatan v6), Blockstudio 7 mengompilasi Tailwind di sisi server pada setiap permintaan frontend melalui TailwindPHP. Tanpa Node.js, tanpa CLI, tanpa perlu langkah build.

Kompilasi menggunakan caching berbasis kandidat: Blockstudio mengekstrak semua nama kelas CSS dari HTML akhir, mengurutkannya dan membuat hash bersama konfigurasi CSS Anda, lalu memeriksa apakah ada file cache. Kelas yang sama menghasilkan cache hit yang sama, meskipun HTML di sekitarnya berubah (nonce, stempel waktu, konten dinamis).

Konfigurasi menggunakan sintaks yang mengutamakan CSS milik Tailwind v4. Tentukan tema kustom dan kelas utilitas langsung di blockstudio.json Anda atau melalui filter blockstudio/tailwind/css:

PHP
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});

Di editor blok, skrip Tailwind CDN yang disertakan menyediakan pratinjau langsung saat Anda mengetik. Jenis field classes menawarkan pelengkapan otomatis untuk semua utilitas Tailwind. Frontend selalu menggunakan CSS yang dikompilasi di server, disisipkan sebagai tag gaya inline sebelum </head>.

Lihat dokumentasi Tailwind untuk panduan penyiapan lengkap.

API Interaktivitas

Blockstudio kini mendukung WordPress Interaktivitas API. Aktifkan di block.json Anda:

JSON
{
  "blockstudio": {
    "interactivity": true
  }
}

Tambahkan direktif data-wp-* ke templat Anda:

PHP
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>

Lalu buat script.js dengan logika store Anda:

JavaScript
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});

Blockstudio menangani importmap, pemuatan modul, dan pemrosesan direktif di frontend maupun editor blok. Blok yang hanya menggunakan direktif deklaratif dengan data-wp-context (seperti data-wp-bind--hidden atau data-wp-text) dapat berfungsi tanpa JavaScript sama sekali. Status sisi server melalui wp_interactivity_state() juga didukung di frontend.

Lihat dokumentasi Interaktivitas untuk panduan penyiapan lengkap.

Analisis konten SEO

Blok Blockstudio bersifat dinamis, sehingga konten field-nya tidak terlihat oleh plugin SEO secara default. Blockstudio 7 mengatasi hal ini dengan integrasi otomatis untuk Yoast SEO, Rank Math, dan SEOPress. Nilai teks dari field text, textarea, richtext, wysiwyg, dan link (termasuk baris repeater bertingkat) diekstrak dan diberikan kepada analisis konten setiap plugin. Plugin SEO kini dapat menganalisis konten blok Anda dengan baik untuk kepadatan kata kunci, keterbacaan, dan metrik lainnya. Tidak perlu konfigurasi.

Baris default repeater

Kini field repeater mendukung properti default yang berisi larik baris terisi sebelumnya. Saat blok disisipkan, repeater akan diisi dengan baris dan nilainya, baik di editor maupun frontend:

JSON
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "default": [
    { "title": "Fast", "icon": "bolt" },
    { "title": "Secure", "icon": "shield" }
  ],
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    { "id": "icon", "type": "text", "label": "Icon" }
  ]
}

Properti min juga berfungsi dengan nilai default tingkat field: jika repeater memiliki min: 3 dan field di dalamnya memiliki nilai default, baris yang dibuat otomatis akan diisi dengan nilai default tersebut, bukan dibiarkan kosong.

Penyempurnaan dan perbaikan

  • Repeater min dengan nilai default field: baris minimum yang dibuat otomatis kini menggunakan nilai default tingkat field di frontend dan editor
  • Gaya editor Tailwind: Tailwind CSS yang dikompilasi kini disisipkan ke iframe editor blok bersama CDN, sehingga aturan @apply kustom dan konfigurasi tema berfungsi di editor
  • File konteks AI: blockstudio-llm.txt dibangun ulang sebagai file statis yang dirangkai dari seluruh dokumentasi v7 dan skema JSON yang dideduplikasi (~48k token), menggantikan pembuatan dinamis dari v6
  • Jendela pop-out field kode: field kode kini dapat dibuka di jendela terpisah, dengan urungkan/ulangi mandiri dan penyorotan sintaks JavaScript
  • Kompilasi sisi server Tailwind v4: lihat bagian Tailwind di atas
  • API versi 3: blok kini dirender dengan benar di editor ber-iframe, termasuk editor situs dan pratinjau responsif
  • Notasi titik untuk aset: konvensi penamaan file yang lebih rapi untuk sufiks aset (*.inline.css, *.editor.js, *.scoped.css)
  • Memperbaiki peringatan bs_render_block() dari WP_Block_Supports saat menggunakan useBlockProps
  • Memperbaiki field kondisional yang tidak mengikuti nilai default saat pemuatan pertama
  • Memperbaiki tanda dolar yang dihapus dari konten <RichText /> di frontend
  • Memperbaiki fitur populate agar berfungsi dengan taksonomi yang didaftarkan plugin lain
  • Memperbaiki kesalahan null optionsPopulate dalam konteks WPML

Di balik layar

Penulisan ulang menyeluruh

Ini bukan refaktor atau perapian. Setiap kelas ditulis ulang dari awal. Hasilnya adalah basis kode yang lebih rapi dan modular, serta lebih mudah dipelihara dan diperluas.

PHP modern

Blockstudio 7 memerlukan PHP 8.2+ dan menggunakan deklarasi tipe modern di seluruh bagian.

Perubahan yang tidak kompatibel

Sebagai pembaruan versi mayor, 7.0 mencakup beberapa perubahan yang tidak kompatibel. Sebagian besar memiliki mekanisme pengganti yang kompatibel dengan versi sebelumnya, tetapi Anda sebaiknya meninjaunya sebelum melakukan upgrade. Untuk panduan migrasi lengkap, lihat dokumentasi migrasi v7.

Nama hook kini menggunakan snake_case

Semua hook PHP telah diubah namanya dari camelCase menjadi snake_case, mengikuti konvensi core WordPress:

PHP
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
    return ['my-stylesheet'];
});

// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
    return ['my-stylesheet'];
});

Nama camelCase lama masih berfungsi, tetapi kami menyarankan Anda memperbaruinya.

Default switch field kini nonaktif

Properti switch kini secara default bernilai false, bukan true. Di v6, setiap field memiliki toggle tersembunyi di tepi kiri yang aktif secara default. Di v7, switch harus diaktifkan secara eksplisit dan menggunakan ikon mata yang terlihat pada label field. Jika Anda mengandalkan perilaku default switch, tambahkan "switch": true ke definisi field.

Penamaan file aset menggunakan notasi titik

Sufiks aset kini menggunakan titik, bukan tanda hubung (style.inline.css, bukan style-inline.css). Notasi tanda hubung lama masih berfungsi, tetapi notasi titik menjadi konvensi yang disarankan ke depannya.

Prefiks impor npm

Impor modul ES kini menggunakan npm:, bukan blockstudio/:

JavaScript
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";

Prefiks blockstudio/ masih didukung untuk kompatibilitas dengan versi sebelumnya.

Fitur yang dihapus

Area admin dan editor kode. Halaman pengaturan admin WordPress dan editor kode blok bawaan telah dihapus. Kini semua konfigurasi dilakukan melalui filter blockstudio.json dan PHP, sehingga penyiapan Anda tersimpan dalam version control bersama blok-blok Anda.

Editor kode berguna di versi-versi sebelumnya untuk melihat pratinjau blok, tetapi kemampuannya tidak pernah menyamai lingkungan pengembangan sungguhan. Selama bertahun-tahun, sejumlah fitur plugin tertahan karena tidak dapat didukung di editor mandiri tersebut. Editor itu juga tidak akan pernah menggantikan IDE lengkap. Dengan menghapusnya, plugin dapat sepenuhnya berfokus pada pengembangan berbasis file tanpa kompromi.

Kunci lisensi. Tidak lagi diperlukan. Blockstudio gratis dan bersumber terbuka.

Pustaka blok. Pustaka bawaan “Blockstudio Elements” (Galeri, Slider, Perbandingan Gambar, Kode, Ikon) telah dihapus. Semua itu adalah contoh blok siap pakai yang disertakan bersama plugin. Jika Anda menggunakannya, salin folder blok dari v6 ke direktori blockstudio tema Anda.

Memulai

Instal Blockstudio 7 dan buat blok pertama Anda dalam hitungan menit. Lihat panduan Memulai untuk langkah-langkahnya, atau panduan migrasi v7 jika Anda melakukan upgrade dari v6.

Kode sumber lengkap tersedia di GitHub. Masukan, isu, dan PR dipersilakan.