Dennis · 27. júla 2026
Blockstudio 7.6
Blockstudio Verzia 7.6 umožňuje čítať a vykresľovať projekt z PHP a presúva predvolené nastavenia produkčného frontendu do blockstudio.json: inventár API, samostatné vykresľovanie, pomocné funkcie šablón pre médiá a Tailwind, profily výkonu, jeden adresár vyrovnávacej pamäte, predbežné statické vykresľovanie s včasným poskytovaním, prísnejšie predvoľby analýzy a generované nástroje projektu pre programovacích agentov.
Dve volania pokrývajú väčšinu možností vydania. Canvas::inventory() vráti každú stránku, blok, vzor, šablónu editora webu, časť šablóny a príklad pribaleného UI zaregistrovaný v projekte. Render::document() vráti hotové HTML pre ktorúkoľvek z nich spolu s presne tými prostriedkami, ktoré sa použili pri vykreslení.
Aktualizácia 7.6.2: Stránky zo súborov sa už nezosúlaďujú počas bežných požiadaviek WordPress. Pri uplatňovaní zmien zdrojov spustite
wp bs pages syncalebo zavolajteBlockstudio\Pages::reconcile(). Predvolené nastavenia smerovania kolekcií atemplateForpoužívajú uloženú konfiguráciu runtime prostredia a výslovné zosúladenie sa vyhýba predchádzajúcemu rozsiahlemu viacjazyčnému dopytu OR-meta. Krátkodobá možnosťthemeDefaults.syncPagesInDevelopmentbola odstránená, pretože synchronizácia stránok už neprebieha z hákov požiadaviek.Pages::init()teraz slúži iba na zavedenie; integrácie, ktoré odovzdávaliforce, musia použiťPages::reconcile()alebo CLI. Otvorenie Canvasu naďalej vykoná jedno výslovné, overené zosúladenie inventára pre tvorbu obsahu.
7.6.12 aktualizácia: Štýly editora sa teraz dopĺňajú o prefixy v jednom prepisovacom kroku namiesto kompilácie SASS pre každý súbor, takže zostavenie editora za studena na webe s mnohými blokmi už nehrozí prekročením skromného limitu pamäte. Stránka z predpripraveného vykreslenia uložená v cache, ktorej štýl Tailwind s hashom obsahu bol odstránený, sa vykreslí znova namiesto toho, aby sa zobrazila bez štýlov, a to cez cache PHP aj doplnok Early Serve. Atribúty blokov zapísané na najvyššej úrovni sa pri vykreslení načítajú namiesto zahodenia, takže schéma Blockstudio zaregistrovaná v
WP_Block_Typesa uplatní aj pri programovom zápise.
7.6.11 aktualizácia: Inštalácia artefaktov grafu teraz atómovo nahradí dokument trasy, keď sa kópia v úložisku zmenila pod tým istým kľúčom, nezmenené dokumenty ponechá bez zásahu a cez
Static_Prerender_Early_Serve::last_promotion()hlási povýšené, nahradené, preskočené a ponechané trasy.
7.6.10 aktualizácia: Zásahy do runtime cache teraz rozpoznajú odstránené skompilované súbory aj počas oneskorenia sledovania zmien a ploché runtime cache staršie než 7.6 sa atómovo umiestnia do karantény a odstránia v obmedzených dávkach cron. Globálne premenné UI v balíku sa vypíšu raz na stránku. Early Serve v režime grafu môže obsluhovať trasy vykreslené za behu, ktoré nie sú v nasadenej mape trás, z cache identít. Tailwind môže voliteľne vytvoriť súbor cache s hashom obsahu pomocou
tailwind.output: "link"; predvolene sa výstup vkladá priamo.
Stručne:
- Prehľad projektu:
Canvas::inventory()vráti všetky zaregistrované záznamy spolu so zdrojmi a stabilným poradím zobrazenia. - Cielený výber: pomenovanie blokov a stránok obmedzí vyhľadávanie, synchronizáciu, vykresľovanie a kompiláciu na tieto záznamy.
- Samostatné vykreslenie:
Blockstudio\Rendervráti hotové HTML pre blok, kompozíciu alebo celý dokument. - Rodiny komponentov UI:
Blockstudio\Uizoskupí pribalenú knižnicu do jednej verejnej rodiny pre každý komponent, ku každej pridá príklad. - Stabilné rozmery obrázkov:
bs_media_image()vykreslí zdroje témy so skutočnými rozmermi z vygenerovanéhoassets/media.json. - Pomocné funkcie tried Tailwind:
bs_tw_merge()abs_tw_variants()skladajú triedy v PHP a zlučujú ich s ohľadom na konflikty. - Výkonnostné profily:
performance.profilenaraz zapne predvolené nastavenia produkčného frontendu; hodnoty podriadených nastavení majú prednosť. - Prístup k typovaným nastaveniam:
Settings::get_bool()a jeho príbuzné funkcie čítajúblockstudio.jsonso skutočnými typmi a zobrazujú chyby pri parsovaní. - Jeden adresár cache: každý vygenerovaný súbor sa nachádza pod
cache.patha je označený identitou runtime prostredia. - Statické predvykresľovanie: anonymné dokumenty HTML možno ukladať do cache, zneplatniť cez graf závislostí a poskytnúť ešte pred spustením WordPress.
- Predvoľby analýzy:
theme,extreme-themeawordpress-renderrozširujúblockstudio/phpstanaj nad rámec šablón blokov. - Spravovaná kontrola pri commite:
blockstudio-githooks syncvytvorí a spravuje kontrolný skript pred commitom, ktorý spustí nakonfigurovanú predvoľbu. - Zmluva projektu:
blockstudio-agentsvytvorí súborAGENTS.md, ktorý opisuje, čo projekt tvorí, ktoré funkcie zapína a čo jeho predvoľba vynucuje. - Index dokumentácie: súbor kontextu pre AI teraz obsahuje index každého dokumentu, jeho účelu a identifikátorov, ktoré spravuje.
- Kanonické značky blokov: samostatný príkaz prepíše skrátené zápisy prefixov a aliasov na
<bs:namespace-slug>; podporuje aj skúšobný režim. - Kompatibilita v predvolenom nastavení: nič z uvedeného nezmení web, kým sa to výslovne neuvedie v
blockstudio.json.
Čítanie a vykresľovanie projektu
Prehľad projektu
Canvas::inventory() vráti všetko, čo projekt zaregistruje, ako jedno obyčajné pole bez toho, aby čokoľvek vykreslil.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Záznamy sú zoskupené podľa typu: pages, blocks, patterns, templates, parts a ui. order určuje stabilné poradie zobrazenia naprieč všetkými typmi, sources mapuje každý záznam na jeho zdrojové cesty a warnings a errors zhromažďujú problémy v podobe štruktúrovaných záznamov.
Záznamy blokov obsahujú id, name, title, source, path, provenance a declaration pripravené na vykreslenie. Záznamy stránok uchovávajú source ako stabilnú identitu a path ako šablónu na vykreslenie.
Cielený výber
Pomenovaním záznamov obmedzíte vykonávanú prácu, namiesto toho, aby ste výsledky filtrovali až dodatočne.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
Výsledkom je jeden blok a jedna stránka. patterns, templates, parts a ui budú prázdne a ich zdroje sa nikdy nenačítajú, nesynchronizujú, nevykreslia ani neskompilujú.
Pravidlá sú presné:
- Ak neuvediete žiadne kľúče typov, načítajú sa všetky typy.
true,nullalebo"*"načíta všetky záznamy daného typu.- Reťazec alebo zoznam presne zodpovedá ID, názvu, slug-u, ceste alebo zdrojovej ceste.
- Prázdny reťazec, prázdny zoznam alebo
falsenenačíta žiadny záznam daného typu. - Keď uvediete kľúč aspoň jedného typu, vynechané typy zostanú bez zmeny.
Neexistujúce identifikátory sa vrátia pod deleted namiesto toho, aby vyvolali chybu, a obnovovací koncový bod Canvas REST uplatňuje rovnaké pravidlo na svoje parametre blocks a pages.
Canvas::documents() používa rovnaký výber a pridá jeden vykreslený dokument pre každý záznam. Vybrané stránky sa vykreslia v obnovenom kontexte frontendu, takže podmienené výrazy dotazu, triedy tela, shortcody, rozloženia, presmerovania a funkcie enqueue pracujú s danou stránkou, nie so stránkou požiadavky, ktorá o vykreslenie požiadala.
Samostatné vykresľovanie
Blockstudio\Render vráti vykreslené HTML ako reťazec cez rovnaký postup, aký používa frontend.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
Vychádza sa z jedného tvaru deklarácie so štyrmi kľúčmi: name, attributes, content a children. root, data, inner, innerBlocks, layers a example sú pohodlnejšie vstupné možnosti, ktoré doň zlúči Render::normalize(). Podriadené prvky sa vykresľujú rekurzívne a pri nesprávnom vstupe sa vyvolá výnimka s názvom problematického bloku.
Render::document() obalí výstup do úplného samostatného dokumentu HTML.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body obsahuje iba výstup bloku, html zostavený dokument, blocks názvy blokov, ktoré prispeli k výsledku, a assets rozdelí značky na head, footer, styles, scripts, modules, interactivity, ui a tailwind. Zdroje sú obmedzené na obsah vykreslenia, takže sa nezobrazia zdroje určené iba pre editor.
Render::document_from_html() obalí HTML vykreslený inde a Render::content() vykreslí serializovaný obsah bloku bez dokumentu. Medzi dokumentmi v jednom procese PHP zavolajte Blockstudio\Batch_Render::reset(); Canvas::documents() to už robí.
Rodiny komponentov UI
Blockstudio\Ui sprístupňuje pribalenú knižnicu UI ako jednu položku pre každý verejný komponent namiesto zoznamu interných častí.
Ui::inventory() vráti jednu položku pre každú rodinu s jej koreňovým blokom, názvom a potrebnými implementačnými blokmi. Ui::examples() pridá pre každú rodinu deterministickú deklaráciu: zachová predvolené hodnoty, požadované podriadené vrstvy vnorené pod rodičov a stabilný ukážkový text tam, kde by pole zostalo prázdne. Táto deklarácia je kanonická, takže ju možno použiť priamo v Render::document().
Canvas zoskupuje položky rovnako. Pribalené UI sa zobrazujú pod typom ui ako jeden príklad pre každú rodinu a implementačné registrácie sa v blocks nezobrazujú.
Rodiny sú navrhnuté na skladanie: výberové pole sa otvorí vnútri dialógového okna a jeho zoznam prekryje spúšťač, ponuky a polia kombinovaného výberu zostanú ukotvené na pevných súradniciach výrezu aj pri posúvaní, modálne okná sa vrství a zatvárajú po jednom stlačení klávesu Escape a každá pätička skladá rovnaký ovládací prvok na zatvorenie s variantom. Ako tieto rozhrania fungujú a aké invarianty ich udržiavajú v správnom stave, vysvetľuje kapitola o skladaní; /ui/examples obsahuje živé ukážky kompozícií.
Pomocné funkcie šablón
Stabilné rozmery obrázkov
bs_media_image() vykresľuje zdroje témy so skutočnou šírkou, výškou a vyhradeným pomerom strán, takže obrázky mimo knižnice médií už nemenia rozloženie.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Výstupom je figure.blockstudio-media s vloženým aspect-ratio okolo img, ktoré obsahuje skutočné hodnoty width, height, loading a decoding. Rozmery pochádzajú z vygenerovaného assets/media.json, ktorý vytvorí Blockstudio\Media_Metadata_Builder počas zostavenia alebo sa pripraví ručne.
src prijíma cestu relatívnu k téme, absolútnu cestu alebo úplnú hodnotu URL; attachmentId slúži pre obrázky z knižnice médií. eager vypne lenivé načítavanie nad záhybom stránky a sources vytvorí <picture>.
Keď je zapnuté performance.media.lazy, skutočné URL sa presunie na data-src za zástupný prvok so správnymi rozmermi.
Pomocné funkcie tried Tailwind
bs_tw_merge() a bs_tw_variants() skladajú triedy Tailwind v šablónach PHP pomocou nástroja Blockstudio, ktorý je už súčasťou enginu.
bs_tw_merge('px-2 text-sm', 'px-4') vráti text-sm px-4: konfliktná px-2 sa odstráni a neskoršia hodnota má prednosť. Podporované sú vnorené polia hodnôt tried.
bs_tw_variants() vráti malú volateľnú funkciu pre varianty komponentu:
$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']);
Výsledkom je inline-flex items-center h-12 px-6 rounded. Podporované sú základné triedy, varianty, predvolené varianty, kombinované varianty a tiež class alebo className pre každé volanie.
Produkčná konfigurácia
Výkonnostné profily
performance.profile zapne predvolené nastavenia produkčného frontendu na jednom mieste.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
compat je predvolený a nič nemení. speed a strict zapínajú rovnakú súpravu: odstránia z hlavičky výstup generátora, emoji, informačného kanála, vyhľadávania a súvisiacich článkov; odstránia vyhľadávanie oEmbed a skripty hostiteľa; vypnú XML-RPC, pingbacky a vzdialené vyhľadávanie editora; odstránia všeobecné zdroje jadra frontendu; nastavia predvolené hodnoty výstupu obrázkov; obmedzia Heartbeat mimo editorov; prednačítajú dokumenty z rovnakej domény pri prejdení kurzorom alebo zámere zaostrenia a použijú načítavač obrázkov z Blockstudio.
Každá podriadená hodnota má prednosť pred profilom, ako ukazuje preload.links vyššie. Najskôr otestujte odstránenie zdrojov jadra frontendu, pretože stránka, ktorá od nich závisí, bude viditeľne poškodená. Runtime_Settings::current() sprístupňuje vyriešený profil.
themeDefaults pokrýva dve veci, ktoré by si témy inak museli pripraviť samy: titleTag a suppressDirectoryUpdates, ktoré skryjú aktívnu podriadenú aj nadradenú tému pred výsledkami aktualizácií.
Prístup k typovaným nastaveniam
Blockstudio\Settings číta konfiguráciu so skutočnými typmi namiesto vrátenia čohokoľvek, čo obsahovalo 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);
}
Nesprávne vytvorená hodnota JSON sa oznámi cez Settings::errors() namiesto toho, aby sa nahradila predvolenými hodnotami. Settings::get_raw() vráti iba hodnoty deklarované aktívnym zdrojom, vďaka čomu možno odlíšiť hodnotu nastavenú na false od hodnoty, ktorá nebola nikdy nastavená.
Settings::fingerprint() vráti stabilnú identitu efektívnych nastavení a prístup k nastaveniam ich znovu načíta, keď sa zmení blockstudio.json.
Jeden adresár cache
Každý vygenerovaný súbor sa teraz nachádza pod cache.path, ktorého predvolená hodnota je wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Dáta zostavenia, registračné údaje blokov, zdroje editora, skompilované Tailwind CSS, vykreslené dokumenty, fragmenty ostrovov, statické HTML, indexy grafu, fronty na predhriatie a diagnostika sa nachádzajú v tomto koreňovom adresári. Relatívna cesta sa vyhodnotí vzhľadom na WP_CONTENT_DIR, absolútna cesta ho nasmeruje na vyhradený zväzok.
Objekty sa ukladajú podľa aktuálnej siete a webu a potom podľa identity runtime prostredia: odtlačku verzií Blockstudio, WordPress a PHP, efektívnych nastavení, aktívnej témy a doplnkov, zdrojov vyhľadávania a použitých zdrojových súborov. Po zmene vstupu vzniknú nové dotknuté objekty a staré sa odstránia.
Prvé zostavenia sa vykonávajú po jednom: jedna požiadavka zostaví a atómovo zverejní výsledok, kým ostatné čakajú. Ak sa obnovenie nepodarí, naďalej sa poskytuje posledný správny objekt a chyba zostáva zaznamenaná. Funkcia Blockstudio\Runtime_Cache::purge('tailwind') vymaže jeden rozsah.
Statické predvykresľovanie
Statické predvykresľovanie ukladá celé anonymné dokumenty HTML do cache a môže ich poskytovať ešte pred spustením WordPress. V predvolenom nastavení je vypnuté.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Podmienky zaradenia
Zaradiť možno iba úplné anonymné dokumenty HTML. Obchádzajú sa požiadavky, ktoré nepoužívajú GET, požiadavky s reťazcami dotazu, administrácia, REST, Ajax, cron, informačné kanály, vyhľadávanie, náhľady, požiadavky obsahujúce nonce, personalizované súbory cookie a všetky cesty pod dynamicPaths. Odpoveď možno úplne vylúčiť pomocou značky <!-- blockstudio:no-cache -->.
Pri porovnávaní ciest sa rešpektujú hranice, takže /account zahŕňa /account/orders, ale nie /accounting.
Režimy podpisu a grafu
invalidate určuje, ako záznamy vypršia. Predvolený režim signature pri anonymnej požiadavke bez zásahu naplní odpoveďou položku označenú identitou a po zmenách na úrovni webu ju obnoví; hodí sa preto pre bežný web.
Režim graph je určený pre výslovné nástroje na zostavenie a nasadenie. Zaznamenáva vlastné zdrojové závislosti každej stránky, takže plán znovu zostaví iba dotknuté URL.
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']));
Včasné poskytovanie
Keď je zapnuté earlyServe, Blockstudio spravuje malú mapu trás pre každý web a doplnok advanced-cache.php, ktorý odošle vhodný zásah do cache ešte pred spustením WordPress, doplnkov alebo témy.
Nikdy neprepíše cudziu mapu, doplnok ani deklaráciu WP_CACHE. Artefakt grafu pred výmenou mapy overí každý odkazovaný súbor HTML, takže neúplne vykreslené nasadenie ponechá aktívny predchádzajúci graf. Položky vo viacerých weboch zostávajú oddelené podľa hostiteľa, domovskej cesty a ID webu.
Predhrievanie a stav
Na každodenné používanie slúžia tri príkazy WP-CLI:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status hlási aktívnu identitu, počet súborov a bajtov, záznamy grafu, stav frontu a počítadlá zásahov do cache, minutí, zostavení a zlyhaní pre jednotlivé rozsahy.
Analýza a nástroje pre agentov
Predvoľby analýzy
blockstudio/phpstan pridáva k analýze blokov tri vrstvy a jeden príkaz na spustenie vrstvy vybratej projektom.
| Predvoľba | Čo pridáva |
|---|---|
base |
Existujúca analýza schémy, šablón, hookov, nastavení a API. |
theme |
Korene témy, hlavičky štýlov, zdroje, rozsahy selektorov, predvolené hodnoty polí a hranice opakovačov. |
extreme-theme |
PHPStan max, nebezpečné PHP, escapovanie, Tailwind, JavaScript a kontroly Interactivity. |
wordpress-render |
Skúšobné živé vykreslenie dodané volajúcim, navyše k extreme-theme. |
Predvolené hodnoty pochádzajú z blockstudio.json, takže interaktívne spustenia, CI a kontroly pri commite zdieľajú jednu konfiguráciu:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Návratové kódy sú 0 pri úspechu, 1 pri diagnostike a 2 pri neplatnom použití. Obal zostaví konfiguráciu v dočasnom systémovom adresári, takže v projekte nezostane vygenerovaná konfigurácia, základná línia ani cache, a zvýši pamäťový limit PHPStan na 1G.
Súčasťou balíka je aj poskytovateľ BC Math, takže kontroly JavaScript už nepotrebujú ext-bcmath.
Spravovaná kontrola pri commite
Jedno nastavenie a jeden príkaz zmenia nakonfigurovanú predvoľbu na podmienku povolenia commitu.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Synchronizácia zapíše kontrolný skript a záznam o jeho správe do spoločného adresára Git, nasmeruje core.hooksPath na spravovaný adresár a nadviaže na prípadný predtým nakonfigurovaný kontrolný skript pred commitom. Skript pri commite zistí koreňový adresár úložiska a projektu, takže funguje aj pri prepojených pracovných kópiách a cestách obsahujúcich medzery.
Kontrolný skript spustí vendor/bin/blockstudio-phpstan a nič iné; súbory nikdy neformátuje ani neprepisuje. Nastavením commit na false a opätovnou synchronizáciou alebo spustením blockstudio-githooks remove sa obnoví zaznamenaná cesta ku kontrolnému skriptu a odstránia sa iba súbory spravované cez Blockstudio.
Zmluva projektu
blockstudio-agents vytvorí súbor AGENTS.md, ktorý uvádza, kde sa nachádzajú bloky, čo v tomto projekte predstavuje stránka, ktoré funkcie sú zapnuté a čo analyzátor odmietne.
vendor/bin/blockstudio-agents
Dokument sa odvodzuje od projektu, nejde o šablónu. Téma s hlavičkou style.css, blokmi a stránkami založenými na súboroch dostane inú zmluvu než doplnok, ktorý registruje iba bloky; zmluva obsahuje počty, adresáre, menných priestorov a jazyky šablón, ktoré skener našiel. O tom, ktoré funkcie sa uvedú, rozhoduje blockstudio.json, takže projekt bez statického predvykresľovania ho v dokumente vôbec nespomenie.
Časť o správnosti sa načítava priamo zo súborov pravidiel vybratej predvoľby, vrstvu po vrstve. Keď predvoľba získa nové pravidlo, zmenia sa všetky zmluvy, ktoré sa podľa nej vytvoria.
Správa vlastníctva funguje podobne ako pri kontrolnom skripte pri commite. Súbor bez značky vygenerovaného obsahu sa odmietne namiesto prepísania, ak --force neurčuje inak; oblasť poznámok na konci sa pri opätovnom vytvorení zachová; --check vráti kód 1, keď je zmluva neaktuálna, a --stdout ju vypíše bez zásahu do súborového systému.
Index dokumentácie
blockstudio-llm.txt je teraz indexom namiesto zreťazeného textu. Každý zverejnený dokument sa uvádza raz, vo svojej sekcii a podsekcii, spolu s trasou, zdrojovým súborom, stručným opisom účelu a identifikátormi, ktoré spravuje: cesty nastavení, názvy hookov, funkcie a triedy PHP a príkazy.
## 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()
Agent si prečíta index, nájde jediný dokument, ktorý obsahuje identifikátor, o ktorý sa zaujíma, a otvorí ho. Predchádzajúce spojenie s veľkosťou pol megabajtu sa stále vytvára a publikuje na /blockstudio-llm-full.txt; už to nie je prvá vec, ktorú každý dostane.
Kanonické značky blokov
Samostatný príkaz prepíše skratky prefixov a aliasov na kanonický zápis <bs:namespace-slug>, ktorý zaznamenáva skutočný názov bloku a rozlíši sa aj bez načítaného filtra projektu.
S prefixom brand pre theme-components a prefixom ui pre bsui má táto skratka takýto význam:
<brand-card>
<ui-input />
</brand-card>
znamená to isté ako:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Prefixy a presné aliasy naďalej fungujú a nie sú zastarané. Príkaz nenačíta WordPress a bez --apply nič nezapíše:
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 mapuje každý prefix na jeho menné priestory a --known-blocks uvádza registrované názvy blokov. V správe sú zaznamenané mapovania zo zastaraných názvov na kanonické vrátane počtov výskytov a hashov jednotlivých súborov, ako aj samostatné zoznamy neznámych značiek, nejednoznačných aliasov a dynamických značiek. --apply odmietne zapisovať, kým niektoré zostávajú, pokiaľ sa nepoužije --allow-unresolved.
Spracúvajú sa párové, vnorené aj samostatne uzatváracie značky vrátane doslovných značiek v reťazcoch PHP. Menia sa iba názvy značiek, druhý priechod neprinesie žiadne zmeny a príklady v komentároch, blokoch kódu, <pre> alebo <code> sa uvádzajú iba v správe.
Predvolené správanie
Samotná inštalácia verzie 7.6 nič nemení.
Profil výkonu má predvolene hodnotu compat. Výstup hlavičky, oEmbed, XML-RPC, Heartbeat, predvolené nastavenia obrázkov, prednačítanie odkazov, lenivé načítavanie a frontendové <title> zostávajú v stave WordPress, ktorý nastavila téma.
Tieto funkcie zostávajú vypnuté, kým ich nezapnete: všetky kľúče performance.staticPrerender, performance.measurement, performance.media a themeDefaults, ako aj githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled a blockTags.enabled. Kým je statické predgenerovanie vypnuté, nevytvára žiadne súbory ani neinštaluje žiadny doplnok.
Canvas a Render fungujú pasívne. Čítajú existujúce registre a vykresľujú iba to, čo od nich volajúci požaduje; nepripájajú sa k výstupu frontendu ani neregistrujú trasy. Obrazovka správy Canvas stále vyžaduje dev.canvas.enabled a edit_posts.
Prísnejšiu analýzu treba výslovne pomenovať. Inštaláciou blockstudio/phpstan sa povolí iba základné rozšírenie a kanonický príkaz spustí base, pokiaľ projekt neurčí predvoľbu.
Generované súbory vyžadujú spustenie príslušného príkazu. githooks.commit neurobí nič, kým sa nespustí blockstudio-githooks sync, a AGENTS.md nič neurobí, kým sa nespustí blockstudio-agents.
Aktualizácia z verzie 7.5
Požiadavky sa nemenia: PHP 8.2 alebo novší, WordPress 6.7 alebo novší.
composer require blockstudio/blockstudio
Vyrovnávacie pamäte sa obnovia raz. Identita runtime obsahuje verziu Blockstudio, takže prvá požiadavka po aktualizácii bude bez vyrovnávacej pamäte a staré objekty sa odstránia. Starú vyrovnávaciu pamäť Tailwind v wp-content/uploads/blockstudio/tailwind/cache možno odstrániť; úryvok kódu, ktorý vyhľadával jej obsah pomocou globu, má namiesto toho volať Blockstudio\Runtime_Cache::purge('tailwind').
Plochý adresár wp-content/blockstudio/cache/runtime z verzií pred 7.6 sa automaticky premenuje mimo aktívnej cesty a odstráni v ohraničených priechodoch WP-Cron. Veľké stromy starých uzamykacích súborov preto netreba odstraňovať počas nasadzovacej požiadavky.
Generované súbory majú určených vlastníkov. assets/media.json patrí do správy verzií alebo do zostavovacieho kroku. Mapa trás, doplnok advanced-cache.php a deklarácia WP_CACHE existujú iba vtedy, keď je povolené earlyServe, a hák pred potvrdením zmien iba vtedy, keď je synchronizovaný. Všetko ostatné generované sa nachádza v cache.path a možno to bezpečne odstrániť.
Nič sa neodstránilo ani nepremenovalo. bs_render_block(), bs_block(), Blockstudio\Pages a Blockstudio\Patterns zostávajú kanonickými povrchmi obsahu založeného na súboroch.
Vrátenie zmien sa vykonáva pre každú funkciu zvlášť. Vrátenie performance.profile na compat, staticPrerender.enabled na false, githooks.commit na false spolu s sync a cache.enabled na false vždy zruší jednu vrstvu.
Odporúčaný postup zavádzania:
- Nastavte
performance.profilenaspeed, potom skontrolujte výstup hlavičky, kanály a všetky doplnky závislé od oEmbed alebo XML-RPC. - Vygenerujte
assets/media.json, presuňte šablóny dobs_media_image()a potom zapniteperformance.media.lazy. - Zapnite
performance.staticPrerenders vypnutýmearlyServe, overte požiadavky pomocouwp bs prerender statusa potom zapniteearlyServe. - Spúšťajte
blockstudio-phpstan --preset theme, kým nebude bez chýb, a až potom umiestnite predvoľbu zagithooks.commit.
Kde nájdete podrobnosti
- Canvas a jeho inventár a dokumentAPI
- Vykresľovanie, UI Komponenty a UI Kompozícia
- Nastavenia a výkon
- Výkon, Ukladanie do vyrovnávacej pamäte a Statické predgenerovanie
- Tailwind CSS
- PHPStan: predvoľby, kanonický príkaz, spravovaný hák potvrdenia zmien a zmluva projektu
- Integrácia AI: index dokumentácie a celý text
- Migrácia a PHP Háky