Dennis · 27 Juli 2026
Blockstudio 7.6
Blockstudio 7.6 membuat proyek dapat dibaca dan dirender dari PHP, serta memindahkan default frontend produksi ke blockstudio.json: inventaris API, rendering mandiri, helper templat untuk media dan Tailwind, profil performa, satu direktori cache, prerender statis dengan penyajian awal, preset analisis yang lebih ketat, serta alat proyek yang dihasilkan untuk agen coding.
Dua pemanggilan mencakup sebagian besar rilis ini. Canvas::inventory() mengembalikan setiap halaman, blok, pola, templat Site Editor, bagian templat, dan contoh UI terbundel yang didaftarkan proyek. Render::document() mengembalikan HTML yang sudah jadi untuk semuanya, beserta aset yang tepat yang digunakan saat rendering.
Pembaruan 7.6.2: Halaman berbasis file tidak lagi direkonsiliasi selama permintaan WordPress biasa. Jalankan
wp bs pages syncatau panggilBlockstudio\Pages::reconcile()saat menerapkan perubahan sumber. Perutean koleksi dan defaulttemplateFormenggunakan konfigurasi runtime yang tersimpan, dan rekonsiliasi eksplisit menghindari kueri OR-meta multibahasa besar sebelumnya. OpsithemeDefaults.syncPagesInDevelopmentberumur singkat telah dihapus karena sinkronisasi halaman tidak lagi berjalan dari hook permintaan.Pages::init()kini hanya berjalan saat bootstrap; integrasi yang meneruskanforceharus menggunakanPages::reconcile()atau CLI. Membuka Canvas tetap menjalankan satu rekonsiliasi eksplisit yang terautentikasi untuk inventaris penulisan.
7.6.12 pembaruan: Stylesheet editor kini diberi prefiks melalui satu proses penulisan ulang, bukan kompilasi SASS untuk setiap aset, sehingga build editor dingin di situs dengan banyak blok tidak lagi berisiko menghabiskan batas memori yang terbatas. Halaman prarender yang di-cache dan stylesheet Tailwind-nya yang memiliki hash konten telah dihapus dari cache akan dirender ulang, bukan disajikan tanpa gaya, baik melalui cache PHP maupun drop-in Early Serve. Atribut blok yang ditulis di tingkat teratas kini dibaca saat perenderan, bukan diabaikan, sehingga skema Blockstudio yang terdaftar pada
WP_Block_Typedihormati oleh penulis programatik.
7.6.11 pembaruan: Instalasi artefak Graph kini mengganti dokumen rute secara atomik saat salinan di penyimpanan berubah dengan kunci yang sama, membiarkan dokumen identik tetap utuh, serta melaporkan rute yang dipromosikan, diganti, dilewati, dan dipertahankan melalui
Static_Prerender_Early_Serve::last_promotion().
7.6.10 pembaruan: Cache runtime kini mendeteksi aset kompilasi yang dihapus bahkan selama jeda debounce pemantauan, dan cache runtime datar sebelum 7.6 dikarantina secara atomik lalu dihapus dalam batch cron yang dibatasi. Global UI yang dibundel hanya dikeluarkan sekali per halaman. Early Serve dalam mode Graph dapat menyajikan rute yang dirender langsung di luar peta rute yang diterapkan dari cache identitas. Tailwind dapat secara opsional mengeluarkan file cache dengan hash kontennya menggunakan
tailwind.output: "link"; keluaran inline tetap menjadi default.
Singkatnya:
- Inventaris proyek:
Canvas::inventory()mengembalikan setiap rekaman terdaftar beserta sumber dan urutan tampilan yang stabil. - Pemilihan terarah: menyebutkan blok dan halaman membatasi penemuan, sinkronisasi, perenderan, dan kompilasi hanya pada rekaman tersebut.
- Perenderan mandiri:
Blockstudio\Rendermengembalikan HTML yang sudah selesai untuk sebuah blok, komposisi, atau dokumen lengkap. - UI keluarga komponen:
Blockstudio\Uimengelompokkan pustaka yang dibundel menjadi satu keluarga publik untuk setiap komponen, masing-masing dengan satu contoh. - Dimensi gambar stabil:
bs_media_image()merender aset tema dengan dimensi nyata dariassets/media.jsonyang dihasilkan. - Tailwind helper kelas:
bs_tw_merge()danbs_tw_variants()menggabungkan kelas di PHP dengan penggabungan yang memperhitungkan konflik. - Profil performa:
performance.profilesekaligus mengaktifkan default frontend produksi; nilai turunan menggantikannya. - Akses pengaturan bertipe:
Settings::get_bool()dan saudaranya membacablockstudio.jsondengan tipe yang sesuai dan menampilkan kesalahan penguraian. - Satu direktori cache: setiap file yang dihasilkan berada di bawah
cache.path, dengan kunci berupa identitas runtime. - Prarender statis: HTML anonim dapat di-cache, dibatalkan melalui grafik dependensi, dan disajikan sebelum WordPress dimulai.
- Preset analisis:
theme,extreme-theme, danwordpress-rendermemperluasblockstudio/phpstanmelampaui templat blok. - Hook commit terkelola:
blockstudio-githooks syncmenulis dan mengelola hook pre-commit yang menjalankan preset terkonfigurasi. - Kontrak proyek:
blockstudio-agentsmenulisAGENTS.mdyang menjelaskan apa yang dibuat oleh penulis proyek, fitur yang diaktifkan, dan hal yang diberlakukan oleh presetnya. - Indeks dokumentasi: file konteks AI kini menjadi indeks semua dokumen, tujuannya, dan identifier yang dimilikinya.
- Tag blok kanonis: sebuah perintah mandiri menulis ulang bentuk singkat prefiks dan alias menjadi
<bs:namespace-slug>, dengan uji coba. - Kompatibel secara default: tidak satu pun hal di atas mengubah situs sampai disebutkan di
blockstudio.json.
Membaca dan merender proyek
Inventaris proyek
Canvas::inventory() mengembalikan semua yang didaftarkan proyek sebagai satu array biasa, tanpa merender apa pun.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Rekaman dikelompokkan berdasarkan tipe: pages, blocks, patterns, templates, parts, dan ui. order adalah urutan tampilan stabil untuk semua tipe, sources memetakan setiap rekaman ke jalur sumbernya, dan warnings serta errors mengumpulkan masalah sebagai entri terstruktur.
Rekaman blok memuat id, name, title, source, path, provenance, dan declaration yang siap dirender. Rekaman halaman menyimpan source sebagai identitas stabil dan path sebagai templat yang melakukan perenderan.
Pemilihan terarah
Menyebutkan rekaman membatasi pekerjaan sejak awal, alih-alih memfilternya setelah itu.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
Hasilnya adalah satu blok dan satu halaman. patterns, templates, parts, dan ui kosong, dan sumbernya tidak pernah dibaca, disinkronkan, dirender, atau dikompilasi.
Aturannya tepat:
- Tanpa kunci tipe, semua tipe dimuat.
true,null, atau"*"memuat semua rekaman dari tipe tersebut.- String atau daftar mencocokkan ID, nama, slug, jalur, atau jalur sumber secara persis.
- String kosong, daftar kosong, atau
falsetidak memuat rekaman apa pun dari tipe tersebut. - Jika ada kunci tipe, tipe yang tidak disebutkan tidak disentuh.
Identifier yang sudah tidak ada dikembalikan di bawah deleted alih-alih menyebabkan kegagalan, dan endpoint penyegaran Canvas REST menerapkan aturan yang sama pada parameter blocks dan pages.
Canvas::documents() menggunakan pemilihan yang sama dan menambahkan satu dokumen hasil render untuk setiap rekaman. Halaman yang dipilih dirender dalam konteks frontend yang dipulihkan, sehingga conditional query, kelas body, shortcode, tata letak, pengalihan, dan callback enqueue melihat halaman tersebut, bukan permintaan yang memintanya.
Perenderan mandiri
Blockstudio\Render mengembalikan HTML hasil render sebagai string melalui pipeline yang sama dengan frontend.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
Di baliknya terdapat satu bentuk deklarasi dengan empat kunci: name, attributes, content, dan children. root, data, inner, innerBlocks, layers, dan example adalah kemudahan input yang disatukan oleh Render::normalize(). Anak dirender secara rekursif, dan input yang tidak valid memunculkan pengecualian yang menyebutkan blok penyebabnya.
Render::document() membungkus keluaran dalam dokumen HTML mandiri yang lengkap.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body adalah keluaran blok saja, html adalah dokumen yang dirangkai, blocks adalah nama blok yang berkontribusi, dan assets membagi markup menjadi head, footer, styles, scripts, modules, interactivity, ui, dan tailwind. Aset dibatasi pada yang digunakan dalam hasil render, sehingga aset khusus editor tidak pernah muncul.
Render::document_from_html() membungkus HTML yang dirender di tempat lain, sedangkan Render::content() merender konten blok berseri tanpa dokumen. Panggil Blockstudio\Batch_Render::reset() di antara dokumen dalam satu proses PHP; Canvas::documents() sudah melakukannya.
Keluarga komponen UI
Blockstudio\Ui menyajikan pustaka UI yang dibundel sebagai satu entri untuk setiap komponen publik, bukan sebagai daftar bagian internal.
Ui::inventory() mengembalikan satu entri untuk setiap keluarga, beserta blok akar, judul, dan blok implementasi yang dibutuhkannya. Ui::examples() menambahkan deklarasi deterministik untuk setiap keluarga: nilai default dipertahankan, lapisan anak yang wajib ditempatkan di bawah induknya, dan teks ilustratif yang stabil digunakan saat suatu bidang kosong. Deklarasi tersebut bersifat kanonis, sehingga langsung dimasukkan ke Render::document().
Canvas mengelompokkannya dengan cara yang sama. UI yang dibundel muncul di bawah tipe ui sebagai satu contoh untuk setiap keluarga, sementara pendaftaran implementasi tidak dimasukkan ke blocks.
Keluarga ini dirancang untuk dirangkai: select terbuka di dalam dialog dengan overlay listbox di atas pemicunya, menu dan combobox menambatkan diri menggunakan koordinat viewport tetap yang tidak berubah saat halaman digulir, modal ditumpuk dan ditutup satu per satu dengan Escape, dan setiap footer menggabungkan kontrol tutup yang sama dengan sebuah varian. Penjelasan tentang cara kerja hubungan ini dan invarian yang menjaganya dibahas di bab komposisi; /ui/examples menampilkan komposisinya secara langsung.
Helper templat
Dimensi gambar stabil
bs_media_image() merender aset tema dengan lebar, tinggi, dan rasio aspek nyata yang dicadangkan, sehingga gambar di luar pustaka media tidak lagi menggeser tata letak.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Keluarannya berupa figure.blockstudio-media dengan aspect-ratio inline di sekeliling img yang memuat width, height, loading, dan decoding dengan nilai nyata. Dimensi diperoleh dari assets/media.json yang dihasilkan, yang ditulis oleh Blockstudio\Media_Metadata_Builder dalam langkah build atau secara manual.
src menerima jalur relatif terhadap tema, jalur absolut, atau URL lengkap, sedangkan attachmentId mencakup gambar dari pustaka media. eager memilih untuk tidak melakukan lazy loading pada area di atas lipatan, dan sources mengeluarkan <picture>.
Saat performance.media.lazy aktif, URL yang sebenarnya dipindahkan ke data-src di balik placeholder berukuran tepat.
Helper kelas Tailwind
bs_tw_merge() dan bs_tw_variants() menggabungkan kelas Tailwind di templat PHP menggunakan mesin Blockstudio yang sudah dibundel.
bs_tw_merge('px-2 text-sm', 'px-4') mengembalikan text-sm px-4: px-2 yang berkonflik dihapus dan nilai yang muncul belakangan akan digunakan. Array bersarang yang berisi nilai kelas juga diterima.
bs_tw_variants() mengembalikan fungsi yang dapat dipanggil untuk varian komponen berukuran kecil:
$button = bs_tw_variants([
'base' => 'inline-flex items-center',
'variants' => [
'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
],
'defaultVariants' => ['size' => 'sm'],
]);
echo $button(['size' => 'lg', 'class' => 'rounded']);
Hasilnya adalah inline-flex items-center h-12 px-6 rounded. Kelas dasar, varian, varian default, varian gabungan, serta class atau className yang diberikan saat pemanggilan semuanya didukung.
Konfigurasi produksi
Profil performa
performance.profile mengaktifkan default frontend produksi dari satu tempat.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat adalah default dan tidak mengubah apa pun. speed dan strict mengaktifkan rangkaian yang sama: keluaran generator, emoji, feed, discovery, dan pos terkait dihapus dari head; discovery oEmbed dan skrip host dihilangkan; XML-RPC, pingback, dan discovery editor jarak jauh dinonaktifkan; aset frontend inti umum dihapus; default keluaran gambar diterapkan; Heartbeat diperlambat di luar editor; dokumen dari origin yang sama diprafetch saat kursor diarahkan atau fokus diberikan; dan pemuat gambar milik Blockstudio digunakan.
Setiap nilai turunan menggantikan profil, seperti yang dilakukan preload.links di atas. Penghapusan aset frontend inti adalah hal pertama yang perlu diuji, karena halaman yang bergantung padanya akan terlihat rusak. Runtime_Settings::current() menampilkan profil yang telah ditetapkan.
themeDefaults menangani dua hal yang biasanya dibuat sendiri oleh tema: titleTag dan suppressDirectoryUpdates untuk menyembunyikan tema anak dan tema induk yang aktif dari hasil pembaruan.
Akses pengaturan bertipe
Blockstudio\Settings membaca konfigurasi dengan tipe yang sesuai, alih-alih mengembalikan apa pun yang tersimpan di JSON.
use Blockstudio\Settings;
$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');
foreach (Settings::errors() as $error) {
error_log($error);
}
JSON yang formatnya tidak valid dilaporkan melalui Settings::errors() alih-alih menggunakan nilai default. Settings::get_raw() hanya mengembalikan hal yang dinyatakan oleh sumber aktif, sehingga nilai yang ditetapkan ke false dapat dibedakan dari nilai yang belum pernah ditetapkan.
Settings::fingerprint() mengembalikan identitas stabil untuk pengaturan efektif, dan akses memuat ulang saat blockstudio.json berubah.
Satu direktori cache
Setiap file yang dihasilkan kini berada di bawah cache.path, yang default-nya adalah wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Payload build, data pendaftaran blok, aset editor, Tailwind CSS yang dikompilasi, dokumen hasil render, fragmen island, HTML statis, indeks graph, antrean pemanasan, dan diagnostik semuanya berada di bawah direktori tersebut. Jalur relatif ditetapkan dari WP_CONTENT_DIR, sedangkan jalur absolut mengarahkannya ke volume khusus.
Objek disimpan berdasarkan jaringan dan situs saat ini, lalu berdasarkan identitas runtime: sidik jari dari versi Blockstudio, WordPress, dan PHP, pengaturan efektif, tema dan plugin aktif, sumber penemuan, serta file sumber yang terlibat. Jika input berubah, objek yang terdampak menjadi objek baru; objek lama dibersihkan.
Build dingin hanya dijalankan sekali: satu permintaan membangun dan menerbitkan hasil secara atomik, sementara permintaan lain menunggu. Penyegaran yang gagal tetap menyajikan objek terakhir yang baik selama kegagalannya tetap dapat diamati, dan Blockstudio\Runtime_Cache::purge('tailwind') membersihkan satu cakupan.
Prarender statis
Prarender statis menyimpan dokumen HTML anonim yang lengkap di cache dan dapat menyajikannya sebelum WordPress dimulai. Fitur ini nonaktif secara default.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Kelayakan
Hanya dokumen HTML anonim yang lengkap yang memenuhi syarat. Permintaan selain GET, string kueri, admin, REST, Ajax, cron, feed, pencarian, pratinjau, permintaan yang membawa nonce, cookie yang dipersonalisasi, dan jalur apa pun di bawah dynamicPaths akan dilewati. Respons dapat memilih untuk tidak ikut sama sekali dengan penanda <!-- blockstudio:no-cache -->.
Pencocokan jalur menghormati batas segmen, sehingga /account mencakup /account/orders, tetapi tidak mencakup /accounting.
Mode tanda tangan dan graph
invalidate menentukan cara kedaluwarsa entri. Mode default signature mengisi respons berkunci identitas saat terjadi cache miss anonim dan memperbaruinya setelah perubahan tingkat situs, sehingga cocok untuk situs biasa.
Mode graph ditujukan untuk alat build dan deploy eksplisit. Mode ini mencatat dependensi sumber tiap halaman, sehingga sebuah rencana hanya membangun ulang URL yang terdampak.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
Penyajian awal
Saat earlyServe aktif, Blockstudio mengelola peta rute kecil per situs dan drop-in advanced-cache.php yang mengalirkan respons cache yang memenuhi syarat sebelum WordPress, plugin, atau tema dimulai.
Fitur ini tidak pernah menimpa peta, drop-in, atau deklarasi WP_CACHE milik pihak lain. Artefak graph memvalidasi setiap file HTML yang dirujuk sebelum peta diganti, sehingga deploy yang dirender setengah jalan membiarkan graph sebelumnya tetap aktif. Entri multisitus tetap terisolasi berdasarkan host, jalur home, dan ID situs.
Pengisian cache dan status
Tiga perintah WP-CLI mencakup penggunaan sehari-hari:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status melaporkan identitas aktif, jumlah file dan byte, rekaman graph, status antrean, serta penghitung hit, miss, build, dan kegagalan untuk setiap cakupan.
Analisis dan alat agen
Preset analisis
blockstudio/phpstan menambahkan tiga lapisan di atas analisis bloknya, serta satu perintah untuk menjalankan lapisan yang dipilih proyek.
| Preset | Yang ditambahkan |
|---|---|
base |
Analisis skema, templat, hook, pengaturan, dan API yang sudah ada. |
theme |
Akar tema, header gaya, aset, cakupan selector, default bidang, batas repeater. |
extreme-theme |
PHPStan max, PHP yang tidak aman, escaping, Tailwind, JavaScript, dan pemeriksaan Interactivity. |
wordpress-render |
Probe render langsung yang disediakan pemanggil di atas extreme-theme. |
Default berasal dari blockstudio.json, sehingga eksekusi interaktif, CI, dan hook commit menggunakan satu konfigurasi:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Kode keluar adalah 0 saat berhasil, 1 untuk diagnostik, dan 2 untuk penggunaan yang tidak valid. Wrapper menyusun konfigurasinya di direktori sementara sistem, sehingga tidak ada konfigurasi, baseline, atau cache hasil generate yang masuk ke proyek, dan batas memori PHPStan dinaikkan menjadi 1G.
Paket ini juga menyertakan penyedia BC Math, sehingga pemeriksaan JavaScript tidak lagi memerlukan ext-bcmath.
Hook commit terkelola
Satu pengaturan dan satu perintah menjadikan preset terkonfigurasi sebagai gerbang commit.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Sinkronisasi menulis hook dan catatan kepemilikan di direktori umum milik Git, mengarahkan core.hooksPath ke direktori terkelola, dan meneruskan hook pre-commit yang dikonfigurasi sebelumnya. Hook mencari repositori dan akar proyek saat commit dilakukan, sehingga checkout tertaut dan jalur yang memuat spasi dapat digunakan.
Hook menjalankan vendor/bin/blockstudio-phpstan saja; hook tidak pernah memformat atau menulis ulang file. Dengan mengatur commit ke false lalu menyinkronkan lagi, atau menjalankan blockstudio-githooks remove, jalur hook yang tercatat dipulihkan dan hanya file milik Blockstudio yang dihapus.
Kontrak proyek
blockstudio-agents menulis AGENTS.md yang menyatakan lokasi blok, arti halaman dalam proyek ini, fitur yang diaktifkan, dan hal yang akan ditolak oleh penganalisis.
vendor/bin/blockstudio-agents
Dokumen ini diturunkan dari proyek, bukan dari templat. Tema dengan header style.css, blok, dan halaman berbasis file memiliki kontrak yang berbeda dari plugin yang hanya mendaftarkan blok, lengkap dengan jumlah, direktori, namespace, dan bahasa templat yang ditemukan oleh pemindai. blockstudio.json menentukan fitur yang ditampilkan, sehingga proyek tanpa prarender statis tidak akan menyebutkannya.
Bagian kebenaran dibaca lapis demi lapis dari file aturan milik preset yang dipilih, sehingga saat sebuah preset mendapat aturan baru, setiap kontrak yang dihasilkan ikut berubah.
Kepemilikannya bekerja seperti hook commit. File tanpa penanda hasil generate akan ditolak, bukan diganti, kecuali --force menyatakan sebaliknya; bagian catatan di akhir tetap ada saat dibuat ulang; --check keluar dengan kode 1 jika kontrak sudah kedaluwarsa; dan --stdout menampilkannya tanpa menyentuh sistem file.
Indeks dokumentasi
blockstudio-llm.txt kini berupa indeks, bukan penggabungan dokumen. Setiap dokumen yang dipublikasikan muncul satu kali di bagian dan subbagiannya, beserta rute, file sumber, tujuan satu baris, dan identifier yang dimilikinya: jalur pengaturan, nama hook, fungsi dan kelas PHP, serta perintah.
## Docs / Dev / Inspection Tools
### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
Sebuah agen membaca indeks, menemukan satu dokumen yang memiliki pengenal yang dibutuhkannya, lalu membuka dokumen itu. Gabungan setengah megabita sebelumnya tetap dibuat dan diterbitkan di /blockstudio-llm-full.txt; kini bukan lagi hal pertama yang diberikan kepada siapa pun.
Tag blok kanonis
Perintah mandiri menulis ulang singkatan prefix dan alias menjadi ejaan kanonis <bs:namespace-slug>, yang mencatat nama blok sebenarnya dan dapat di-resolve tanpa filter proyek dimuat.
Dengan prefix brand di atas theme-components dan prefix ui di atas bsui,
singkatan ini:
<brand-card>
<ui-input />
</brand-card>
berarti sama dengan:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Prefix dan alias persis tetap berfungsi dan tidak deprecated. Perintah ini tidak memuat WordPress dan tidak menulis apa pun tanpa --apply:
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
--root="$PWD" \
--prefix-map=/tmp/prefixes.json \
--known-blocks=/tmp/blocks.json \
--report=/tmp/tag-migration.json \
--dry-run
--prefix-map memetakan setiap prefix ke namespace-nya dan --known-blocks mencantumkan nama blok yang terdaftar. Laporan mencatat pemetaan lama ke kanonis beserta jumlah kemunculan, hash per berkas, serta daftar terpisah untuk tag tak dikenal, alias ambigu, dan tag dinamis. --apply menolak menulis selama masih ada yang tersisa, kecuali --allow-unresolved diberikan.
Markup berpasangan, bertingkat, dan tag mandiri ditangani, termasuk tag literal dalam string PHP. Hanya nama tag yang berubah, proses kedua tidak menghasilkan perubahan, dan contoh di dalam komentar, blok kode, <pre>, atau <code> hanya dilaporkan.
Perilaku default
Menginstal 7.6 tidak mengubah apa pun dengan sendirinya.
Profil performa secara default adalah compat. Output head, oEmbed, XML-RPC,
Heartbeat, default gambar, prefetch tautan, pemuatan lambat, dan frontend
<title> tetap seperti yang ditetapkan WordPress dan tema.
Semua ini tetap nonaktif kecuali diaktifkan: setiap kunci performance.staticPrerender,
performance.measurement, performance.media, dan themeDefaults, ditambah
githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled, dan
blockTags.enabled. Prarender statis tidak menulis berkas dan tidak memasang drop-in
selama nonaktif.
Canvas dan Render bersifat pasif. Keduanya membaca registri yang sudah ada dan hanya merender yang diminta pemanggil; keduanya tidak memasang hook ke output frontend maupun mendaftarkan rute. Layar admin Canvas tetap memerlukan dev.canvas.enabled dan edit_posts.
Analisis yang lebih ketat harus disebutkan secara eksplisit. Menginstal blockstudio/phpstan hanya mengaktifkan ekstensi dasar, dan perintah kanonis menjalankan base kecuali proyek menyebutkan preset.
Berkas yang dihasilkan memerlukan perintahnya untuk dijalankan. githooks.commit tidak melakukan apa pun sampai blockstudio-githooks sync dijalankan, dan AGENTS.md juga tidak sampai blockstudio-agents dijalankan.
Memutakhirkan dari 7.5
Persyaratannya tidak berubah: PHP 8.2 atau lebih baru, WordPress 6.7 atau lebih baru.
composer require blockstudio/blockstudio
Cache dibangun ulang sekali. Identitas runtime mencakup versi Blockstudio,
sehingga permintaan pertama setelah pemutakhiran berjalan tanpa cache dan objek lama dipangkas. Cache Tailwind lama di wp-content/uploads/blockstudio/tailwind/cache dapat dihapus; cuplikan yang melakukan glob terhadapnya sebaiknya memanggil Blockstudio\Runtime_Cache::purge('tailwind').
Direktori wp-content/blockstudio/cache/runtime datar sebelum 7.6 otomatis diganti namanya agar keluar dari jalur aktif, lalu dihapus melalui proses WP-Cron terbatas. Karena itu, pohon berkas lock lama yang besar tidak perlu dihapus selama permintaan deployment.
Berkas yang dihasilkan memiliki pemilik. assets/media.json sebaiknya berada di kontrol versi atau dalam langkah build. Peta rute, drop-in advanced-cache.php, dan deklarasi WP_CACHE hanya ada saat earlyServe diaktifkan, dan hook pre-commit hanya ada selama sinkron. Semua hasil generasi lainnya berada di bawah cache.path dan aman untuk dihapus.
Tidak ada yang dihapus atau diganti namanya. bs_render_block(), bs_block(),
Blockstudio\Pages, dan Blockstudio\Patterns tetap menjadi permukaan konten kanonis berbasis berkas.
Rollback dilakukan per fitur. performance.profile kembali ke compat,
staticPrerender.enabled ke false, githooks.commit ke false ditambah
sync, dan cache.enabled ke false masing-masing membatalkan satu lapisan.
Urutan penerapan yang wajar:
- Atur
performance.profilekespeed, lalu periksa output head, feed, dan plugin apa pun yang bergantung pada oEmbed atau XML-RPC. - Buat
assets/media.json, pindahkan template kebs_media_image(), lalu aktifkanperformance.media.lazy. - Aktifkan
performance.staticPrerenderdenganearlyServenonaktif, verifikasi hit denganwp bs prerender status, lalu aktifkanearlyServe. - Jalankan
blockstudio-phpstan --preset themehingga bersih sebelum menempatkan preset apa pun di balikgithooks.commit.
Lokasi detail selengkapnya
- Canvas dan inventaris serta dokumen API
- Rendering, Komponen UI, dan Komposisi UI
- Pengaturan dan performa
- Performa, Caching, dan Prarender Statis
- Tailwind CSS
- PHPStan: preset, perintah kanonis, hook commit terkelola, dan kontrak proyek
- Integrasi AI: indeks dokumentasi dan teks lengkap
- Migrasi dan Hook PHP