Lewati ke konten

Dennis · 21 Juni 2026

Blockstudio 7.4

Blockstudio 7.4 berfokus membuat proyek berbasis file lebih portabel. Versi 7.2 memudahkan pemeriksaan dan distribusi proyek yang lebih besar, sementara 7.3 menambahkan lapisan UI di atasnya. Versi 7.4 berfokus memindahkan lebih banyak bagian proyek, halaman, dan konten pilihannya dari database ke file yang dikontrol versinya.

Fitur utamanya adalah koleksi halaman: cara untuk mengarahkan Blockstudio ke folder sumber halaman dan membuat struktur halaman WordPress bersarang yang lengkap darinya. Sumber tersebut dapat berupa PHP, Twig, Blade, HTML, Markdown, atau loader tepercaya yang mengembalikan halaman dari sumber lokal lain.

Singkatnya:

  • Koleksi halaman: pages.json dapat menentukan rangkaian lengkap halaman bersarang, nilai default, perilaku tipe pos, tata letak, loader, dan metadata koleksi.
  • Halaman Markdown: index.md dapat digunakan sebagai konten halaman, baik dengan page.json maupun sendiri dengan frontmatter.
  • Tata letak halaman frontend: layout.php dapat membungkus konten halaman yang disinkronkan dan menggunakan helper seperti blockstudio_page_tree() dan blockstudio_page_content().
  • Sumber dokumentasi eksternal: loader koleksi dapat membuat halaman dari file lokal atau Markdown/HTML yang dikembalikan.
  • Output Markdown mentah: sumber halaman Markdown dapat disajikan sebagai .md atau melalui Accept: text/markdown.
  • Tipe pos kustom koleksi: koleksi dapat memiliki URL yang rapi, pengosongan aturan rewrite otomatis, rute Markdown mentah, serta migrasi halaman ke CPT tanpa shim di sisi tema.
  • Content Sync: wp bs content pull, wp bs content push, dan wp bs content status memungkinkan pos, term, relasi, dan referensi meta yang dideklarasikan dan diizinkan dalam proyek disimpan sebagai file portabel.
  • Prefiks tag blok: prefiks proyek seperti <theme-card> dapat diresolusi di beberapa namespace berurutan tanpa alias per blok.
  • Sinkronisasi yang lebih andal: perubahan halaman terdeteksi di manifest, loader, tata letak, metadata, dan file sumber.
  • Perbaikan runtime dan editor: opsi dinamis tetap terbaru, class blok kueri tetap ada saat dirender secara programatis, bsui/select berfungsi lebih baik pada formulir padat, properti RichText diteruskan ke editor, dan penghapusan baris repeater dengan RichText tetap tersimpan setelah penyimpanan.

Halaman berbasis file

Sebagian besar fitur 7.4 dibangun di atas halaman berbasis file.

Koleksi halaman

Sebelum 7.4, halaman berbasis file umumnya hanya berupa fitur tingkat folder: buat page.json, tambahkan index.php atau index.twig, lalu Blockstudio menyinkronkan satu halaman itu ke WordPress.

Cara itu tetap berfungsi. 7.4 menambahkan mode kedua untuk struktur yang lebih besar.

Tambahkan manifest pages.json ke sebuah folder dan folder itu menjadi koleksi:

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
JSON
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}

Setiap sumber halaman di dalam koleksi ditemukan, dinormalisasi, disinkronkan, dan ditautkan berdasarkan jalur. Halaman di guide/install menjadi anak dari guide; jika halaman guide tidak ada, Blockstudio membuat halaman kontainer yang dihasilkan agar hierarki WordPress tetap sesuai dengan struktur sistem file.

Koleksi dapat menggunakan tipe pos page bawaan atau tipe posnya sendiri. Saat koleksi mendeklarasikan tipe pos yang belum ada, Blockstudio mendaftarkannya dari postTypeArgs. Manifest postType juga menjadi nilai default untuk setiap halaman dalam koleksi tersebut, sehingga proyek tidak perlu mengulanginya di defaults.

Tipe pos koleksi menggunakan slug koleksi sebagai basis URL publiknya. Koleksi docs mengarahkan halaman akarnya ke /docs/, halaman dengan path: "getting-started" ke /docs/getting-started/, serta jalur bersarang ke basis yang sama. URL berulang seperti /docs/docs/ dialihkan ke lokasi kanonis. Aturan rewrite dikosongkan otomatis saat perutean tipe pos koleksi berubah, sehingga koleksi baru tidak memerlukan penyimpanan permalink manual.

Inilah bagian yang membuat dokumentasi eksternal, panduan produk, basis pengetahuan, dan pustaka halaman terasa alami di WordPress: sumbernya tetap berada dalam file, tetapi hasilnya tetap berupa konten WordPress yang benar-benar dapat diedit.

Markdown sebagai konten halaman

Markdown kini menjadi sumber halaman kelas utama.

Halaman Markdown mandiri menggunakan frontmatter:

Markdown
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.

Anda juga dapat memasangkan page.json dengan index.md jika ingin memisahkan konfigurasi dan konten ke dalam beberapa file. Frontmatter dalam index.md dapat mengganti field page.json yang cocok, sedangkan kunci frontmatter yang tidak dikenal akan dipertahankan sebagai metadata.

Markdown dikonversi menjadi HTML lalu diteruskan melalui parser halaman yang sama dengan templat PHP, Twig, dan Blade, sehingga konten akhirnya berupa markup blok bawaan.

Tata letak dan helper halaman

Koleksi dapat menyertakan file layout.php. Di frontend, Blockstudio membungkus konten halaman yang disinkronkan dengan tata letak tersebut.

PHP
<main class="docs-layout">
  <aside>
    <?php foreach (blockstudio_page_tree('docs') as $item) : ?>
      <a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
        <?php echo esc_html($item['title']); ?>
      </a>
    <?php endforeach; ?>
  </aside>

  <article>
    <?php echo blockstudio_page_content(); ?>
  </article>
</main>

Helper baru menyediakan koleksi sebagai data terstruktur:

PHP
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();

Dengan begitu, Anda memiliki komponen yang diperlukan untuk membangun kerangka dokumentasi lengkap: navigasi dari pohon halaman, metadata halaman dari frontmatter, dan konten blok WordPress yang disinkronkan sebagai konten utama.

Loader dan Markdown mentah

Koleksi dapat menyertakan file loader.php lokal yang tepercaya. File itu dapat langsung mengembalikan halaman atau mengarahkan Blockstudio ke direktori lokal tambahan untuk ditemukan.

PHP
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];

Ini berguna jika sumbernya sudah dibuat di tempat lain: folder dokumentasi paket, ekspor Markdown, atau langkah build yang mengembalikan daftar halaman.

Sumber halaman Markdown juga dapat menyajikan sumber Markdown mentahnya. Minta halaman dengan sufiks .md, atau kirim Accept: text/markdown. Frontmatter dihapus dari respons agar alat mendapatkan isi dokumen yang mudah dibaca. Ini juga berfungsi untuk tipe pos koleksi, termasuk URL seperti /docs.md dan /docs/getting-started.md.

Baca dokumentasi Pages

Content Sync

7.4 juga memperkenalkan Content Sync, alur kerja WP-CLI bagi tim yang ingin lebih banyak bagian proyek WordPress direpresentasikan sebagai file.

Shell
wp bs content pull
wp bs content push --dry-run
wp bs content status

Blockstudio sudah menyimpan blok, field, templat, pola, dan halaman berbasis file dalam proyek Anda. Content Sync menambahkan konten database pilihan ke alur kerja yang mengutamakan file ini: pos, term, relasi, dan meta yang diizinkan dapat ditarik ke dalam file, ditinjau di git, lalu didorong ke lingkungan lain.

Fitur ini sengaja dibuat eksplisit. Aktifkan di blockstudio.json, izinkan tipe pos dan taksonomi yang ingin Anda kelola, lalu deklarasikan referensi meta yang perlu ditulis ulang antarlingkungan.

Saat menarik data, Blockstudio menulis pos portabel, term, relasi, dan meta yang diizinkan ke dalam file di tema Anda. Saat mendorong data, fitur ini memvalidasi rencana sebelum menulis dan mengubah referensi post, term, dan attachment yang dideklarasikan kembali menjadi ID database lokal. Fitur ini tidak menerka bahwa bilangan bulat sembarang adalah ID.

Cakupan 7.4 sengaja dibatasi: pos, term, relasi term, meta yang diizinkan, UID portabel, manifest lampiran, uji coba, penanganan pemangkasan, entitas terkunci, dan pelaporan status. Perekaman definisi taksonomi, penyalinan biner media, dan penulisan ulang ID markup blok sengaja tidak disertakan dalam versi pertama ini.

Fitur ini memberi tim cara yang rapi untuk mengontrol versi konten pilihan seperti anggota tim, studi kasus, lokasi, entri dokumentasi, atau rekaman terstruktur lainnya tanpa menjadikan seluruh database produksi sebagai migrasi. Fitur ini ditujukan bagi kumpulan konten yang masih dapat ditinjau sebagai file: puluhan atau ratusan baris, dan dalam beberapa proyek hingga beberapa ribu baris jika kontennya terstruktur dan jarang berubah. Fitur ini bukan pengganti cadangan database, sinkronisasi e-commerce/pesanan, analitik, log, pengiriman formulir, atau data bervolume tinggi lainnya.

Baca dokumentasi Content Sync

Sinkronisasi yang lebih andal

Blockstudio kini mendeteksi perubahan pada sumber halaman, manifest koleksi, file loader, file tata letak, metadata, dan jalur terkait. Jika salah satunya berubah, halaman WordPress yang disinkronkan akan diperbarui.

Alur halaman juga menangani detail yang membuat dokumentasi berbasis file praktis untuk proyek nyata:

  • Sumber halaman Markdown disinkronkan sebagai konten blok bawaan, termasuk atribut blok
  • Metadata frontmatter tersedia bagi helper dan tata letak frontend
  • Halaman koleksi mempertahankan identitas yang stabil di setiap sinkronisasi
  • Halaman bersarang nonkoleksi ditautkan ke halaman induknya
  • Halaman bersarang nonkoleksi dapat mewarisi layout.php leluhur terdekat
  • Sumber koleksi yang dihapus membersihkan halaman WordPress yang dihasilkannya
  • Mengubah koleksi dari page menjadi tipe pos kustom memigrasikan pos yang sudah disinkronkan, alih-alih membuat duplikat
  • Urutan halaman dipertahankan melalui menu_order

Prefiks tag blok

Tag blok kini mendukung prefiks namespace yang dapat dikonfigurasi. Proyek dapat mendaftarkan satu prefiks singkat dan membiarkan Blockstudio menyelesaikan blok di satu atau beberapa namespace:

PHP
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});

Dengan pengaturan ini, <theme-card> dapat diresolusikan menjadi theme-components/card, <theme-button> dapat beralih ke bsui/button, dan <theme-ui-feature-matrix> dapat diresolusikan menjadi theme-components/ui-feature-matrix.

tag_aliases eksplisit tetap diutamakan saat proyek memerlukan override khusus. Tag prefiks yang tidak dikenal dibiarkan apa adanya, dan filter izinkan/tolak tag blok yang sudah ada tetap berlaku untuk blok yang diresolusikan melalui prefiks.

Baca dokumentasi Block Tags

Perbaikan runtime dan editor

7.4 juga mencakup serangkaian perbaikan berdasarkan penggunaan proyek nyata.

  • Opsi yang diisi dari kueri dinamis tetap terbaru saat pos, term, pengguna, atau meta terkait berubah, dan pilihan kueri populate.fetch: true mengambil opsi langsung untuk pencarian editor yang kosong.
  • Tag blok core/query dan core/comments yang dibuat secara programatis mempertahankan className dalam markup pembungkus yang dihasilkan.
  • Komponen semu templat mempertahankan properti camelCase, sehingga properti seperti allowedFormats dan withoutInteractiveFormatting diteruskan ke komponen editor, alih-alih dihapus sebelumnya.
  • bsui/select menangani data opsi dan menu yang meluap dengan lebih andal, terutama di dalam kontrol editor yang lebih padat.
  • blockstudio/phpstan mengenali field yang dideklarasikan di dalam kontainer tabs, sehingga validasi templat, Twig/Blade, dan tag blok memahami bentuk field yang sama dengan yang digunakan Blockstudio dalam proyek.
  • Penghapusan baris repeater dengan RichText tetap tersimpan setelah penyimpanan. Nilai RichText usang tidak lagi dapat mengembalikan baris yang sudah dihapus.

Mengapa rilis ini penting

Tema 7.4 adalah portabilitas.

Koleksi halaman mengubah seluruh situs dokumentasi menjadi folder berisi file sumber. Halaman Markdown membuat konten tersebut mudah ditulis dan dibaca kembali. Content Sync memperluas model yang mengutamakan file ini ke konten database pilihan, sehingga pos, term, dan relasi dapat disimpan di git dan dipindahkan antarlingkungan. Prefiks tag blok membuat pustaka blok besar lebih mudah dibaca dalam templat.

Blockstudio tetap berbasis file. Blok tetap berupa folder. Halaman tetap berupa file. 7.4 memungkinkan lebih banyak bagian proyek, termasuk struktur halaman dan konten pilihannya, disimpan dalam file tersebut dan dibawa bersama proyek.