Lewati ke konten

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 sync atau panggil Blockstudio\Pages::reconcile() saat menerapkan perubahan sumber. Perutean koleksi dan default templateFor menggunakan konfigurasi runtime yang tersimpan, dan rekonsiliasi eksplisit menghindari kueri OR-meta multibahasa besar sebelumnya. Opsi themeDefaults.syncPagesInDevelopment berumur singkat telah dihapus karena sinkronisasi halaman tidak lagi berjalan dari hook permintaan. Pages::init() kini hanya berjalan saat bootstrap; integrasi yang meneruskan force harus menggunakan Pages::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_Type dihormati 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\Render mengembalikan HTML yang sudah selesai untuk sebuah blok, komposisi, atau dokumen lengkap.
  • UI keluarga komponen: Blockstudio\Ui mengelompokkan 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 dari assets/media.json yang dihasilkan.
  • Tailwind helper kelas: bs_tw_merge() dan bs_tw_variants() menggabungkan kelas di PHP dengan penggabungan yang memperhitungkan konflik.
  • Profil performa: performance.profile sekaligus mengaktifkan default frontend produksi; nilai turunan menggantikannya.
  • Akses pengaturan bertipe: Settings::get_bool() dan saudaranya membaca blockstudio.json dengan 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, dan wordpress-render memperluas blockstudio/phpstan melampaui templat blok.
  • Hook commit terkelola: blockstudio-githooks sync menulis dan mengelola hook pre-commit yang menjalankan preset terkonfigurasi.
  • Kontrak proyek: blockstudio-agents menulis AGENTS.md yang 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.

PHP
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.

PHP
$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 false tidak 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.

PHP
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.

PHP
$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
<?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:

PHP
$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.

JSON
{
  "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.

PHP
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.

JSON
{
  "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.

JSON
{
  "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.

PHP
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:

Shell
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:

JSON
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
Shell
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.

JSON
{
  "githooks": {
    "commit": true
  }
}
Shell
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.

Shell
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.

Text
## 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:

HTML
<brand-card>
  <ui-input />
</brand-card>

berarti sama dengan:

HTML
<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:

Shell
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.

Shell
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:

  1. Atur performance.profile ke speed, lalu periksa output head, feed, dan plugin apa pun yang bergantung pada oEmbed atau XML-RPC.
  2. Buat assets/media.json, pindahkan template ke bs_media_image(), lalu aktifkan performance.media.lazy.
  3. Aktifkan performance.staticPrerender dengan earlyServe nonaktif, verifikasi hit dengan wp bs prerender status, lalu aktifkan earlyServe.
  4. Jalankan blockstudio-phpstan --preset theme hingga bersih sebelum menempatkan preset apa pun di balik githooks.commit.

Lokasi detail selengkapnya