Dennis · 14 Oktober 2026
Blockstudio 7.7
Blockstudio 7.7 menambahkan rute virtual untuk dokumen tanpa post WordPress, menyempurnakan build prarender tertarget, serta meningkatkan keandalan saat mengedit dan merender blok yang ada. Versi ini juga memperluas pemeriksaan tag blok PHPStan dan meningkatkan aksesibilitas komponen UI yang disertakan.
Alur kerja berbasis berkas tetap sama. Blok dirender dari templatenya, dan halaman berbasis berkas diubah melalui sinkronisasi eksplisit CLI atau API. Rilis ini tidak memperkenalkan sinkronisasi halaman otomatis pada permintaan pengunjung atau admin.
Singkatnya:
- Rute virtual: sajikan galeri komponen, katalog, atau dokumen lengkap lainnya tanpa membuat post atau menulis handler pengalihan khusus.
- Build prarender tertarget: build HTTP mencatat berkas sumber yang digunakan setiap halaman, sehingga build berikutnya dapat merender hanya rute yang terdampak.
- Retensi cache: pertahankan stylesheet yang sudah tidak aktif agar tetap tersedia untuk halaman yang di-cache, serta periksa atau pangkas entri peta early-serve yang tidak digunakan.
- Keandalan editor: blok yang dipilih bersama mempertahankan nilainya masing-masing, undo dan redo berfungsi untuk RichText serta bidang sidebar, dan konteks turunan tetap melekat pada blok yang benar.
- Keutuhan konten berkas: daftar bertingkat, elemen pembentuk bagian, HTML inline, shortcode, dan atribut yang di-escape tetap utuh saat parsing dan rendering.
- Penyempurnaan PHPStan: tag prefix, alias, elemen halaman yang dipetakan, dan variabel template diperiksa terhadap definisi proyek itu sendiri.
- UI yang aksesibel: kontrol menampilkan statusnya dengan benar, label mengaktifkan input yang tepat, serta komponen daftar dan tabel menggunakan struktur HTML yang valid.
- Terjemahan: terjemahan JavaScript yang terpasang dimuat di editor dan ikhtisar admin, termasuk kontrol bidang yang sebelumnya belum diterjemahkan.
Rute virtual
Beberapa halaman berasal dari data, bukan dari post yang dikelola editor. Misalnya, referensi komponen mungkin memerlukan URL dan judul dokumennya sendiri, tetapi tidak memerlukan entri di wp_posts.
Daftarkan dokumen tersebut dengan Blockstudio\Virtual_Routes:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
Rute tersebut menyajikan /components/. Callback-nya berjalan di dalam buffer output Blockstudio, sehingga blok yang dirender menerima style, skrip, aset UI yang disertakan, dan output Tailwind melalui pipeline normal. WordPress tidak mengubah rute yang cocok menjadi 404 atau mengalihkannya ke post.
Untuk sekumpulan URL, atur prefix ke true dan berikan callback match. Callback menerima path di bawah rute tersebut dan mengembalikan nilai yang dibutuhkan renderer Anda. Jika mengembalikan null atau false, permintaan diteruskan ke WordPress. Gunakan urls untuk mencantumkan path yang harus disertakan dalam build prarender statis. Rute tunggal non-prefix menyertakan path-nya sendiri secara default.
Virtual_Routes::urls() mengembalikan URL absolut untuk integrasi yang menyusun sitemap. Ini tidak otomatis menambahkan dokumen virtual ke sitemap post WordPress.
Lihat Rute Virtual untuk API dan opsinya secara lengkap.
Build prarender yang lebih presisi
Build mode grafik yang dirender di atas HTTP kini mencatat berkas yang digunakan setiap rute: template WordPress, template dan aset blok yang dirender, definisi serta layout halaman berkas, dan dependensi yang ditambahkan melalui blockstudio/render/dependencies.
Pada build berikutnya, build_plan() membandingkan dependensi tersebut. Perubahan pada template blok menandai rute yang bergantung padanya untuk dirender, tanpa membangun ulang halaman lain yang tidak terkait. Perubahan konfigurasi bersama tetap memengaruhi seluruh build, dan rute baru atau kedaluwarsa dirender seperti sebelumnya.
Perubahan yang hanya terjadi di database bukanlah dependensi berkas. Deployment yang perlu mengambil opsi, post, atau nilai database lainnya harus memaksa build atau merender URL yang terdampak secara eksplisit.
Rilis ini juga memperbaiki perubahan identitas build saat rendering pertama, peta early-serve yang di-cache opcode dan sudah usang, serta URL valid yang dikecualikan hanya karena path-nya memuat search atau preview. Permintaan Markdown yang menggunakan Accept: text/markdown melewati HTML yang di-cache, dan respons terkait mengirimkan Vary: Accept.
Prarender statis kini menghormati filter yang didaftarkan tema aktif saat menentukan apakah hook-nya akan dipasang. Tema dapat menonaktifkan fitur ini tanpa pencarian pengaturan sebelumnya yang membuatnya tetap aktif.
Lihat Prarender Statis.
Retensi dan pemeliharaan cache
Halaman HTML yang di-cache dapat bertahan lebih lama daripada identitas runtime yang mengompilasi stylesheet-nya. cache.namespaceGrace mengatur berapa lama namespace yang sudah tidak aktif tetap tersedia setelah pembersihan pertama kali mendeteksi bahwa namespace tersebut tidak aktif:
{
"cache": {
"namespaceGrace": 777600
}
}
Contoh ini mempertahankan berkas yang sudah tidak aktif selama sembilan hari. Default-nya adalah satu hari. Namespace yang sedang aktif dan namespace yang menyajikan artefak prarender deployment dilindungi dari pembersihan untuk namespace yang tidak aktif.
Peta early-serve juga memiliki perintah untuk pemeriksaan dan pembersihan:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
Perintah tersebut melaporkan dan menghapus entri untuk situs yang dihapus atau direktori yang hilang. Menghapus situs multisite juga menghapus entrinya. Dokumen rute yang hilang dilaporkan secara terpisah agar seluruh entri situs yang valid tidak ikut dihapus.
Lihat Caching untuk panduan retensi dan pemeliharaan peta untuk perintahnya.
Editor yang lebih andal
Mengedit blok yang dipilih bersama kini hanya memperbarui blok tersebut. Saat menyimpan, konten, key, metadata, dan kunci masing-masing blok tetap dipertahankan tanpa menyalin atribut antarblok yang dipilih.
Nilai RichText tersimpan langsung di atribut blok, sehingga Gutenberg dapat menyertakannya dalam undo dan redo. Bidang sidebar turut masuk ke riwayat yang sama. InnerBlocks templateLock="false" diberikan sebagai boolean sungguhan dan membuka konten meskipun area luarnya terkunci.
Preload awal menerima ID dan tipe post yang sedang diedit, sehingga template dapat membaca metadata yang benar pada rendering pertama. Blok anak identik di bawah induk yang berbeda mempertahankan konteks turunan terpisah di preload dan cache render. Perubahan atribut atau konteks selama permintaan awal tidak lagi membuat pratinjau tertinggal.
Blockstudio juga berhenti menyisipkan elemen penanda render tersembunyi di antara akar blok. Selector saudara-berdekatan seperti .card + .card kini melihat hubungan antar-elemen yang sama di editor seperti di frontend, sementara render pratinjau editor dan inserter tetap terpisah.
Penyimpanan opsi seluruh situs yang lebih aman
Bidang berbasis opsi tetap menyediakan nilai di seluruh situs, tetapi menyimpan post tidak lagi menulis begitu saja semua salinan tersimpan dari bidang tersebut:
- Penyimpanan berstatus draf, tertunda, privat, dan terjadwal tidak menulis opsi situs aktif.
- Penyimpanan yang dipublikasikan menulis bidang yang diberikan dan berubah dalam edit tersebut.
- Penyimpanan yang hanya mengubah judul pada salinan lama tidak mengembalikan nilai situs yang lebih baru.
- Bidang yang tidak ada dan blok yang dihapus tidak menghapus opsi yang sudah ada.
nulleksplisit menghapus sebuah opsi. String kosong,false, nol, dan array kosong tetap merupakan nilai yang valid.
Inilah perubahan perilaku utama yang perlu diperiksa saat memutakhirkan. Jika integrasi menggunakan post privat atau draf untuk memperbarui opsi aktif, tulis opsi tersebut secara eksplisit atau gunakan post konfigurasi yang dipublikasikan. Penyimpanan post-meta tidak terpengaruh oleh pembatasan khusus untuk yang dipublikasikan.
Lihat Penyimpanan untuk aturan penyimpanan lengkap.
Konten berkas tetap utuh
Pipeline HTML ke blok mempertahankan lebih banyak struktur yang Anda tulis:
- Daftar bertingkat menjadi blok daftar bagian dalam dari item induknya. Kelas daftar dan item dipertahankan; daftar datar biasa tetap menghasilkan output seperti sebelumnya.
main,header,footer,article, danasidemenjadi blok grup yang mempertahankan elemennya, bukan HTML mentah yang melewati rendering blok.- Paragraf richtext yang dipetakan mempertahankan markup inline, paragraf yang hanya berisi gambar di-resolve ke blok gambar yang dipetakan, dan tag shortcode mempertahankan kontennya.
- Atribut yang di-escape di-decode dan di-escape sekali, termasuk atribut pada
InnerBlocks,RichText, dan elemenuseBlockProps. - Tanda lebih besar dari di dalam atribut tag tertutup mandiri yang dikutip diterima.
- Atribut HTML global diteruskan ke akar blok Blockstudio jika blok tersebut tidak mendeklarasikannya sebagai bidang.
wp bs pages syncmelaporkan atribut tersimpan yang tidak dirender.
Halaman, pola, dan template Site Editor berbasis Blade kini dirender melalui Blockstudio\Blade_Renderer, mendukung illuminate/view 8 hingga 12. Semua berkas ekstensi yang menargetkan blok yang sama kini didaftarkan, dan prioritas, bidang grup, serta daftar targetnya mengikuti skema terdokumentasi.
Dependensi SCSS bertingkat juga dilacak. Mengedit partial yang diimpor oleh partial lain mengubah versi stylesheet yang bergantung padanya dan memicu kompilasi ulang.
Penyempurnaan PHPStan
Paket blockstudio/phpstan yang dipasang secara terpisah memperluas validasi tag blok ke tag prefix dan alias, elemen halaman yang dipetakan, layout, blok UI yang disertakan, serta sumber PHP proyek lainnya secara opsional. Resolusi namespace sesuai dengan runtime, termasuk namespace yang mengandung tanda hubung, dan atribut HTML global yang diteruskan dapat diterima.
Variabel template blok seperti $a, $block, dan $context dianggap didefinisikan oleh Blockstudio. Tipe bidang tetap dipertahankan pada null coalescing dan isset() di bawah PHPStan 2.3, sedangkan template yang menetapkan $a sendiri tetap menggunakan tipe yang ditetapkannya.
Perubahan ini hadir dalam blockstudio/phpstan 0.1.9. Perbarui paket secara terpisah dari plugin; paket ini memerlukan PHPStan 2.1.47 atau yang lebih baru:
composer require --dev blockstudio/phpstan:^0.1.9
Lihat PHPStan untuk konfigurasi dan preset analisis.
Aksesibilitas dan terjemahan
Pemicu UI yang disertakan menampilkan status diperluasnya pada tombol yang sebenarnya. Label checkbox, switch, dan radio memberi nama pada kontrolnya serta mengaktifkannya. Breadcrumb, paginasi, menu navigasi, dan tabel tidak lagi menyisipkan elemen pembungkus yang tidak valid di antara daftar atau tabel dan anak-anaknya.
Tombol tampilkan/sembunyikan kata sandi menampilkan status tekan dan memiliki area klik yang lebih besar. Input menerima autocomplete, dan input kata sandi menerima ID eksplisit serta label aksesibel. Area pandang carousel dapat menerima fokus keyboard, dan animasi spinner serta skeleton menghormati preferensi gerakan yang dikurangi.
Editor dan ikhtisar admin memuat terjemahan JavaScript yang terpasang untuk domain teks blockstudio. Menu atribut dan teks placeholder, tindakan popup kode, serta lencana gambar dan berkas kini dapat diterjemahkan. String yang belum memiliki terjemahan tetap dalam bahasa Inggris.
Lihat pustaka UI dan penyiapan terjemahan.
Dokumentasi dan pemutakhiran
Dokumentasi ini menambahkan panduan untuk situs dokumentasi, Content Sync, templat Site Editor, tag blok, islands, jenis field kustom, deployment, prerendering, penyiapan registry, alat analisis, dan layar aplikasi UI. Panduan migrasi ACF mencerminkan pendaftaran ACF dan Block Bindings terkini.
Contoh populate kustom kini menggunakan filter dataset bernama dengan satu argumen yang didukung. Dokumentasi aset menjelaskan urutan stylesheet frontend dan cara memuat override tema setelah CSS blok. Instalasi kontributor menggunakan paket Font Awesome publik tanpa kredensial registry.
PHP 8.2 dan WordPress 6.7 tetap menjadi persyaratan minimum. Rute virtual dan perintah pemeliharaan baru tersedia tanpa mengubah koleksi halaman yang ada. Tinjau aturan penyimpanan opsi di atas, perbarui paket PHPStan terpisah jika Anda menggunakannya, dan tetap jalankan sinkronisasi halaman secara eksplisit seperti sebelumnya.
7.7.1 Tindak Lanjut
Patch 7.7.1 memperjelas dan membuat hasil sinkronisasi lebih aman. Penggabungan berdasarkan kunci yang tidak mengubah postingan tidak lagi membuat revisi atau memperbarui stempel waktu modifikasinya. Status publikasi yang ada tetap dipertahankan, penggantian judul dan slug yang dikelola file dilaporkan, serta halaman yang dikunci atau dihapus disebutkan dalam laporan CLI. Content Sync menandai isi yang dikelola Page Sync dan mempertahankan salinan tinjauan yang ada. Patch ini juga melindungi atribut yang dikelola WordPress dari ID bidang yang bertentangan dan mempertahankan kelas editor yang ditambahkan oleh filter lain.