Dennis · 27. července 2026
Blockstudio 7.6
Blockstudio Verze 7.6 umožňuje číst projekt a vykreslovat jej z PHP a přesouvá výchozí nastavení produkčního frontendu do blockstudio.json: inventář API, samostatné vykreslování, pomocné funkce šablon pro média a Tailwind, výkonnostní profily, jediný adresář mezipaměti, statické předběžné vykreslování s přednostním poskytováním, přísnější předvolby analýzy a generované projektové nástroje pro programovací agenty.
Většinu funkcí této verze zajišťují dvě volání. Canvas::inventory() vrací každou stránku, blok, vzor, šablonu Editoru webu, část šablony a příklad sdruženého UI zaregistrovaný projektem. Render::document() vrací hotové HTML pro kteroukoli z nich spolu s přesně těmi prostředky, které byly při vykreslení použity.
Aktualizace 7.6.2: U stránek uložených v souborech se synchronizace už neprovádí během běžných požadavků WordPress. Při aplikování změn zdrojů spusťte
wp bs pages syncnebo zavolejteBlockstudio\Pages::reconcile(). Směrování kolekcí a výchozí hodnotytemplateForpoužívají uloženou konfiguraci běhového prostředí a výslovná synchronizace se vyhýbá předchozímu rozsáhlému vícejazyčnému dotazu OR-meta. Krátkodobá možnostthemeDefaults.syncPagesInDevelopmentbyla odstraněna, protože synchronizace stránek už neběží z háčků požadavků.Pages::init()nyní slouží pouze k zavedení; integrace, které předávalyforce, musí použítPages::reconcile()nebo CLI. Otevření Canvas stále provede jedno ověřené, výslovné synchronizování inventáře pro tvorbu obsahu.
7.6.12 aktualizace: Styly editoru se nyní opatřují prefixy v jediném průchodu přepisem místo kompilace SASS pro každý asset, takže sestavení editoru za studena na webu s mnoha bloky už nehrozí vyčerpáním omezené paměti. Předrenderovaná stránka v mezipaměti, jejíž stylesheet s hashem obsahu Tailwind byl odstraněn, se znovu vykreslí místo toho, aby se zobrazila bez stylů; platí to pro mezipaměť PHP i doplněk Early Serve. Atributy bloku zapsané na nejvyšší úrovni se při vykreslení načtou místo toho, aby se zahodily, takže se respektuje schéma Blockstudio registrované v
WP_Block_Typei u programových zapisovačů.
7.6.11 aktualizace: Instalace artefaktů grafu nyní atomicky nahrazuje dokument trasy, pokud se kopie v úložišti pod stejným klíčem změnila, identické dokumenty ponechává beze změny a prostřednictvím
Static_Prerender_Early_Serve::last_promotion()hlásí povýšené, nahrazené, přeskočené a zachované trasy.
7.6.10 aktualizace: Zásahy do runtime mezipaměti nyní rozpoznají odstraněné zkompilované assety i během prodlevy sledování změn a ploché runtime mezipaměti z verzí před 7.6 se atomicky přesunou do karantény a odstraní v omezených dávkách cron. Globální proměnné z přibaleného UI se na každé stránce vypíší jen jednou. Early Serve v režimu grafu může z identity mezipaměti obsluhovat živě vykreslené trasy mimo nasazenou mapu tras. Tailwind může volitelně vypisovat soubor mezipaměti s hashem obsahu pomocí
tailwind.output: "link"; výchozí zůstává vložený výstup.
Stručně řečeno:
- Inventář projektu:
Canvas::inventory()vrací každý registrovaný záznam včetně zdrojů a stabilního pořadí zobrazení. - Cílený výběr: zadáním bloků a stránek se hledání, synchronizace, vykreslování a kompilace omezí na tyto záznamy.
- Samostatné vykreslení:
Blockstudio\Rendervrací hotový HTML pro blok, kompozici nebo celý dokument. - Rodiny komponent UI:
Blockstudio\Uiseskupuje přibalenou knihovnu do jedné veřejné rodiny pro každou komponentu a ke každé přidává příklad. - Stabilní rozměry obrázků:
bs_media_image()vykresluje assety šablony se skutečnými rozměry z generovanéhoassets/media.json. - Pomocné funkce pro třídy Tailwind:
bs_tw_merge()abs_tw_variants()skládají třídy v PHP a slučují je s ohledem na konflikty. - Výkonnostní profily:
performance.profilenajednou zapíná výchozí nastavení produkčního frontendu; hodnoty potomků mají přednost. - Typovaný přístup k nastavení:
Settings::get_bool()a jeho související funkce čtoublockstudio.jsonse skutečnými typy a zobrazují chyby parsování. - Jeden adresář mezipaměti: všechny generované soubory jsou uloženy pod
cache.patha klíčem je identita runtime. - Statické předrenderování: anonymní HTML lze ukládat do mezipaměti, zneplatňovat pomocí grafu závislostí a obsluhovat ještě před spuštěním WordPress.
- Předvolby analýzy:
theme,extreme-themeawordpress-renderrozšiřujíblockstudio/phpstani mimo šablony bloků. - Spravovaný commit hook:
blockstudio-githooks syncvytváří a spravuje hook před potvrzením, který spouští nakonfigurovanou předvolbu. - Smlouva projektu:
blockstudio-agentsvytváříAGENTS.mds popisem toho, co autoři projektu vytvářejí, které funkce zapínají a co jejich předvolba vynucuje. - Rejstřík dokumentace: soubor kontextu pro AI nyní obsahuje rejstřík všech dokumentů, jejich účelů a identifikátorů, za které odpovídají.
- Kanonické značky bloků: samostatný příkaz přepisuje zkrácené zápisy prefixů a aliasů na
<bs:namespace-slug>; k dispozici je také zkušební spuštění. - Kompatibilita ve výchozím nastavení: žádná z výše uvedených změn se webu nedotkne, dokud ji neuvedete v
blockstudio.json.
Čtení a vykreslování projektu
Inventář projektu
Canvas::inventory() vrací vše, co projekt zaregistruje, jako jedno běžné pole, aniž by cokoli vykresloval.
use Blockstudio\Canvas;
$result = Canvas::inventory();
foreach ($result['inventory']['blocks'] as $block) {
echo $block['name'] . "\n";
}
Záznamy jsou seskupené podle typu: pages, blocks, patterns, templates, parts a ui. order určuje stabilní pořadí zobrazení napříč všemi typy, sources mapuje každý záznam na cesty ke zdrojům a warnings a errors shromažďují problémy jako strukturované položky.
Záznamy bloků obsahují id, name, title, source, path, provenance a declaration připravený k vykreslení. Záznamy stránek zachovávají source jako stabilní identitu a path jako šablonu, která stránku vykresluje.
Cílený výběr
Výběrem záznamů se práce zúží hned, místo aby se výsledky filtrovaly až dodatečně.
$changed = Canvas::inventory([
'blocks' => ['mytheme/hero'],
'pages' => ['about'],
]);
Tím se vrátí jeden blok a jedna stránka. patterns, templates, parts a ui budou prázdné a jejich zdroje se nikdy nenačtou, nesynchronizují, nevykreslí ani nezkompilují.
Pravidla jsou přesná:
- Pokud nejsou zadány žádné klíče typů, načtou se všechny typy.
true,nullnebo"*"načte všechny záznamy daného typu.- Řetězec nebo seznam přesně odpovídá ID, názvu, slugu, cestě nebo cestě ke zdroji.
- Prázdný řetězec, prázdný seznam nebo
falsenenačte žádný záznam daného typu. - Jakmile je zadán jakýkoli klíč typu, vynechané typy zůstanou beze změny.
Neexistující identifikátory se vrátí pod deleted místo toho, aby vyvolaly chybu. Stejné pravidlo platí i pro koncový bod obnovení REST v Canvasu a jeho parametry blocks a pages.
Canvas::documents() používá stejný výběr a ke každému záznamu přidává jeden vykreslený dokument. Vybrané stránky se vykreslují v obnoveném kontextu frontendu, takže podmínky dotazů, třídy body, shortcody, rozvržení, přesměrování a callbacky enqueue pracují s danou stránkou, nikoli s požadavkem, který si o ni řekl.
Samostatné vykreslení
Blockstudio\Render vrací vykreslené HTML jako řetězec pomocí stejného postupu, jaký používá frontend.
use Blockstudio\Render;
$html = Render::composition([
'root' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
'layers' => [
['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
],
]);
V základu je jeden tvar deklarace se čtyřmi klíči: name, attributes, content a children. root, data, inner, innerBlocks, layers a example jsou pohodlnější vstupní formy, které do ní Render::normalize() převádí.
Potomci se vykreslují rekurzivně a při chybném vstupu se vyvolá výjimka s názvem příslušného bloku.
Render::document() obaluje výstup do úplného samostatného dokumentu HTML.
$document = Render::document('mytheme/hero', [
'title' => 'Hero preview',
]);
echo $document['html'];
body je samotný výstup bloku, html sestavený dokument, blocks názvy bloků, které k němu přispěly, a assets rozděluje značky na head, footer, styles, scripts, modules, interactivity, ui a tailwind.
Assety jsou omezené na obsah, který se vykreslil, takže se assety určené jen pro editor nikdy neobjeví.
Render::document_from_html() obaluje výstup HTML vykreslený jinde a Render::content() vykresluje serializovaný obsah bloku bez dokumentu. Mezi dokumenty v jednom procesu PHP zavolejte Blockstudio\Batch_Render::reset(); Canvas::documents() to už dělá.
Rodiny komponent UI
Blockstudio\Ui zpřístupňuje přibalenou knihovnu UI jako samostatnou položku pro každou veřejnou komponentu, místo aby vypisovalo interní části.
Ui::inventory() vrací jednu položku pro každou rodinu včetně jejího kořenového bloku, názvu a potřebných implementačních bloků. Ui::examples() přidává pro každou rodinu deterministickou deklaraci: zachovává výchozí hodnoty, vnořuje povinné podřízené vrstvy pod jejich rodiče a tam, kde by bylo pole prázdné, vkládá stabilní ilustrační text. Tato deklarace je kanonická, takže ji lze rovnou použít v Render::document().
Canvas seskupuje položky stejně. Přibalená komponenta UI se v typu ui zobrazí jako jeden příklad pro každou rodinu a registrace implementací se v blocks nezobrazují.
Rodiny jsou navržené tak, aby se daly skládat: výběrové pole se otevírá uvnitř dialogu a jeho seznam překrývá spouštěcí prvek, nabídky a kombinovaná pole se ukotvují pomocí pevných souřadnic v okně, které zůstávají správné i při posouvání, modální okna se vrství a zavírají po jednom stisknutí Escape a každá patička kombinuje stejné zavírací tlačítko s variantou. Jak tyto styčné body fungují a jaké invarianty je udržují funkční, vysvětluje kapitola o skládání komponent; /ui/examples ukazuje jednotlivé sestavy v praxi.
Pomocné funkce šablon
Stabilní rozměry obrázků
bs_media_image() vykresluje assety šablony se skutečnou šířkou a výškou a vyhrazeným poměrem stran, takže obrázky mimo knihovnu médií už nezpůsobují poskakování rozvržení.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
]);
Výstupem je figure.blockstudio-media s vloženým aspect-ratio kolem img, které obsahuje skutečné width, height, loading a decoding. Rozměry pocházejí z vygenerovaného assets/media.json, které vytvoří Blockstudio\Media_Metadata_Builder během sestavení nebo se doplní ručně.
src přijímá relativní cestu k šabloně, absolutní cestu nebo úplnou URL; pro obrázky z knihovny médií slouží attachmentId. Pomocí eager lze vypnout líné načítání nad přehybem stránky a sources vypisuje <picture>.
Když je zapnuto performance.media.lazy, skutečné URL se přesune do data-src za správně velký zástupný prvek.
Pomocné funkce pro třídy Tailwind
bs_tw_merge() a bs_tw_variants() skládají třídy Tailwind v šablonách PHP pomocí enginu Blockstudio, který je už přibalený.
bs_tw_merge('px-2 text-sm', 'px-4') vrací text-sm px-4: konfliktní px-2 se odstraní a přednost má pozdější hodnota. Přijímá i vnořená pole hodnot tříd.
bs_tw_variants() vrací malou volatelnou funkci pro varianty komponent:
$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']);
Tím se vypíše inline-flex items-center h-12 px-6 rounded. Podporovány jsou základní třídy, varianty, výchozí varianty, složené varianty a také class nebo className předané při volání.
Konfigurace pro produkční prostředí
Výkonnostní profily
performance.profile zapíná výchozí nastavení produkčního frontendu na jednom místě.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}
Výchozí je compat a nic nemění. speed a strict zapínají stejnou sadu nastavení: odstranění výstupu generátoru, emotikonů, feedu, informací o objevování obsahu a souvisejících příspěvků z hlavičky; odstranění objevování oEmbed a skriptů hostitele; vypnutí XML-RPC, pingbacků a vzdáleného objevování editorů; odstranění obecných assetů jádra pro frontend; použití výchozího nastavení výstupu obrázků; omezení frekvence Heartbeat mimo editory; přednačítání dokumentů ze stejného původu při záměru najetí nebo zaměření; a použití načítače obrázků z Blockstudio.
Každá hodnota potomka přepíše profil, jako je tomu výše u preload.links. Jako první otestujte odstranění assetů jádra pro frontend, protože stránka, která na nich závisí, přestane správně fungovat. Runtime_Settings::current() zpřístupňuje vyřešený profil.
themeDefaults řeší dvě věci, které by jinak museli autoři šablon vytvářet ručně: titleTag a suppressDirectoryUpdates pro skrytí aktivní podřízené a nadřazené šablony ve výsledcích aktualizací.
Typovaný přístup k nastavení
Blockstudio\Settings čte konfiguraci se skutečnými typy místo toho, aby vracelo cokoli, co obsahuje 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);
}
Chybně utvořené JSON se hlásí prostřednictvím Settings::errors() místo toho, aby se použily výchozí hodnoty. Settings::get_raw() vrací jen hodnoty deklarované aktivním zdrojem, takže lze rozlišit hodnotu nastavenou na false od hodnoty, která nikdy nastavena nebyla.
Settings::fingerprint() vrací stabilní identitu efektivního nastavení a přístup znovu načte hodnoty, když se změní blockstudio.json.
Jeden adresář mezipaměti
Všechny generované soubory jsou nyní uloženy pod cache.path, jehož výchozí hodnota je wp-content/blockstudio/cache.
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
V tomto kořenovém adresáři jsou uloženy payloady sestavení, registrační data bloků, assety editoru, zkompilované Tailwind CSS, vykreslené dokumenty, fragmenty ostrovů, statické HTML, indexy grafu, fronty zahřívání i diagnostika. Relativní cesta se vyhodnocuje vůči WP_CONTENT_DIR, zatímco absolutní cesta ji nasměruje na vyhrazený svazek.
Objekty se ukládají pod aktuální síť a web a dále pod identitu runtime: otisk verzí Blockstudio, WordPress a PHP, efektivního nastavení, aktivní šablony a pluginů, zdrojů zjištěných při hledání i příslušných zdrojových souborů. Změna vstupu vytvoří nové ovlivněné objekty a staré se odstraní.
Sestavení za studena používají princip single-flight: jeden požadavek sestaví a atomicky zveřejní výsledek, zatímco ostatní čekají. Pokud se obnovení nezdaří, poslední správný objekt se dál obsluhuje a chyba zůstává viditelná. Pomocí Blockstudio\Runtime_Cache::purge('tailwind') lze vymazat jeden rozsah.
Statické předrenderování
Statické předrenderování ukládá do mezipaměti úplné anonymní dokumenty HTML a může je obsluhovat ještě před spuštěním WordPress. Ve výchozím nastavení je vypnuté.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}
Podmínky způsobilosti
Způsobilé jsou pouze úplné anonymní dokumenty HTML. Obcházejí se požadavky, které nejsou GET, řetězce dotazu, administrace, REST, Ajax, cron, feedy, vyhledávání, náhledy, požadavky s nonce, personalizované cookies a všechny cesty pod dynamicPaths. Odpověď lze zcela vyloučit pomocí značky <!-- blockstudio:no-cache -->.
Při porovnávání cest se respektují hranice, takže /account zahrnuje /account/orders, ale ne /accounting.
Režimy podpisu a grafu
invalidate určuje, jak položky vyprší. Výchozí režim signature vytvoří odpověď s klíčem identity při anonymním požadavku bez zásahu do mezipaměti a obnoví ji po změnách na úrovni webu, což vyhovuje běžnému webu.
Režim graph je určen pro výslovné nástroje sestavení a nasazení. Zaznamenává vlastní zdrojové závislosti každé stránky, takže plán znovu sestaví pouze ovlivněné 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é obsluhování
Když je zapnuto earlyServe, Blockstudio spravuje malou mapu tras pro každý web a doplněk advanced-cache.php, který před spuštěním WordPress, pluginů nebo šablony streamuje způsobilé výsledky z mezipaměti.
Nikdy nepřepisuje cizí mapu, doplněk ani deklaraci WP_CACHE. Před výměnou mapy artefakt grafu ověří každý odkazovaný soubor HTML, takže při částečně vykresleném nasazení zůstane aktivní předchozí graf. Položky ve více webech zůstávají oddělené podle hostitele, domovské cesty a ID webu.
Zahřívání a stav
Každodenní práci pokrývají tři příkazy WP-CLI:
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
status uvádí aktivní identitu, počet souborů a bajtů, záznamy grafu, stav fronty a počitadla zásahů do mezipaměti, nezasažených požadavků, sestavení a chyb pro každý rozsah.
Analýza a nástroje pro agenty
Předvolby analýzy
blockstudio/phpstan rozšiřuje analýzu bloků o tři další vrstvy a jeden příkaz, který spustí vrstvu zvolenou projektem.
| Předvolba | Co přidává |
|---|---|
base |
Stávající analýzu schématu, šablon, hooků, nastavení a API. |
theme |
Kořenové adresáře šablon, hlavičky stylů, assety, omezení selektorů, výchozí hodnoty polí a meze opakovačů. |
extreme-theme |
PHPStan max, nebezpečné PHP, escapování, Tailwind, JavaScript a kontroly Interactivity. |
wordpress-render |
Živou sondu vykreslení dodanou volajícím, která rozšiřuje extreme-theme. |
Výchozí hodnoty pocházejí z blockstudio.json, takže interaktivní spuštění, CI i hooky při potvrzení změn sdílejí jednu konfiguraci:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
vendor/bin/blockstudio-phpstan --root . -- --no-progress
Návratové kódy jsou 0 při úspěchu, 1 při diagnostických nálezech a 2 při neplatném použití. Obalovací skript skládá konfiguraci v dočasném adresáři systému, takže v projektu nezůstane vygenerovaná konfigurace, základní sada ani mezipaměť. Zároveň zvyšuje limit paměti PHPStan na 1G.
Obsahuje také poskytovatele BC Math, takže kontroly JavaScript už nepotřebují ext-bcmath.
Spravovaný commit hook
Jedno nastavení a jeden příkaz promění nakonfigurovanou předvolbu v kontrolu před potvrzením změn.
{
"githooks": {
"commit": true
}
}
vendor/bin/blockstudio-githooks sync
Synchronizace zapíše hook a záznam o vlastnictví do společného adresáře Git, nasměruje core.hooksPath do spravovaného adresáře a připojí původně nakonfigurovaný hook před potvrzením. Hook při potvrzení vyhledá kořen úložiště i projektu, takže funguje s propojenými pracovními kopiemi i cestami obsahujícími mezery.
Hook spouští pouze vendor/bin/blockstudio-phpstan; soubory nikdy neformátuje ani nepřepisuje. Nastavením commit na false a opětovnou synchronizací nebo spuštěním blockstudio-githooks remove se obnoví zaznamenaná cesta k hooku a odstraní se pouze soubory spravované pomocí Blockstudio.
Smlouva projektu
blockstudio-agents vytváří AGENTS.md, který uvádí, kde se nacházejí bloky, co v tomto projektu představuje stránku, které funkce jsou zapnuté a co analyzátor odmítne.
vendor/bin/blockstudio-agents
Dokument vychází ze skutečného projektu, nejde o předem připravenou šablonu. Šablona se záhlavím style.css, bloky a stránkami založenými na souborech tak dostane jinou smlouvu než plugin, který registruje pouze bloky. Dokument uvádí počty, adresáře, jmenné prostory a jazyky šablon nalezené skenerem. O tom, které funkce se v něm objeví, rozhoduje blockstudio.json, takže projekt bez statického předrenderování se o něm vůbec nezmiňuje.
Část o správnosti se čte přímo ze souborů pravidel vybrané předvolby, vrstvu po vrstvě, takže když předvolba získá nové pravidlo, promítne se do všech vygenerovaných smluv.
Vlastnictví funguje stejně jako u hooku při potvrzení. Soubor bez značky označující vygenerovaný obsah se odmítne přepsat, pokud --force neurčuje jinak. Oblast poznámek na konci se při opětovném generování zachová, --check vrátí kód 1, pokud je smlouva zastaralá, a --stdout ji vypíše, aniž by změnil souborový systém.
Rejstřík dokumentace
blockstudio-llm.txt nyní obsahuje rejstřík, nikoli souvislý výpis. Každý publikovaný dokument je uveden jednou, v příslušné sekci a podsekci, spolu se svou trasou, zdrojovým souborem, stručným popisem účelu a identifikátory, za které odpovídá: cestami k nastavení, názvy hooků, funkcemi a třídami PHP a pří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 přečte rejstřík, najde jediný dokument, který obsahuje identifikátor, jenž hledá, a otevře ho. Předchozí půlmegabajtové sloučení se stále vytváří a publikuje na /blockstudio-llm-full.txt; už ale není první věcí, kterou kdokoli dostane.
Kanonické značky bloků
Samostatný příkaz přepíše zkrácené zápisy prefixů a aliasů na kanonický zápis <bs:namespace-slug>, který uvádí skutečný název bloku a lze jej vyřešit i bez načteného filtru projektu.
S prefixem brand pro theme-components a prefixem ui pro bsui tento zkrácený zápis:
<brand-card>
<ui-input />
</brand-card>
znamená totéž co:
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Prefixy a přesné aliasy stále fungují a nejsou zastaralé. Příkaz nenačítá WordPress a bez --apply nic nezapisuje:
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 jmenné prostory a --known-blocks vypisuje registrované názvy bloků. Zpráva zaznamenává mapování zastaralých názvů na kanonické včetně počtu výskytů, hashů jednotlivých souborů a samostatných seznamů neznámých značek, nejednoznačných aliasů a dynamických značek. --apply odmítne zapisovat, dokud některé z nich zůstávají, pokud není předáno --allow-unresolved.
Zpracovávají se párové, vnořené i samouzavírací značky, včetně doslovných značek v řetězcích PHP. Mění se pouze názvy značek, druhé spuštění neprovede žádné změny a příklady v komentářích, blocích kódu, <pre> nebo <code> se pouze uvedou ve zprávě.
Výchozí chování
Samotná instalace verze 7.6 nic nemění.
Profil výkonu je ve výchozím nastavení compat. Výstup hlavičky, oEmbed, XML-RPC, Heartbeat, výchozí nastavení obrázků, přednačítání odkazů, líné načítání a frontendový <title> zůstávají takové, jaké je nastavily WordPress a šablona.
Zůstávají vypnuté, dokud je nepovolíte: všechny klíče performance.staticPrerender, performance.measurement, performance.media a themeDefaults, dále githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled a blockTags.enabled. Dokud je statické předběžné vykreslování vypnuté, nezapisuje žádné soubory ani neinstaluje žádný doplněk.
Canvas a Render jsou pasivní. Čtou existující registry a vykreslují pouze to, co si volající vyžádá; ani jeden nezasahuje do výstupu frontendu ani neregistruje trasy. Obrazovka správy Canvas stále vyžaduje dev.canvas.enabled a edit_posts.
Přísnější analýzu je třeba výslovně nastavit. Instalace blockstudio/phpstan povolí pouze základní rozšíření a kanonický příkaz spustí base, pokud projekt neurčí předvolbu.
Generované soubory vyžadují spuštění příslušného příkazu. githooks.commit nedělá nic, dokud se nespustí blockstudio-githooks sync, a AGENTS.md, dokud se nespustí blockstudio-agents.
Upgrade z verze 7.5
Požadavky se nemění: PHP 8.2 nebo novější, WordPress 6.7 nebo novější.
composer require blockstudio/blockstudio
Mezipaměti se obnoví jednou. Identita běhového prostředí zahrnuje verzi Blockstudio, takže první požadavek po upgradu bude studený a staré objekty se odstraní. Starou mezipaměť Tailwind v wp-content/uploads/blockstudio/tailwind/cache lze smazat; úryvek kódu, který používal glob, by měl místo toho volat Blockstudio\Runtime_Cache::purge('tailwind').
Plochý adresář wp-content/blockstudio/cache/runtime z verzí před 7.6 se automaticky přejmenuje mimo aktivní cestu a odstraní se v omezeném počtu průchodů WP-Cron. Velké stromy zastaralých zamykacích souborů proto není nutné mazat během požadavku na nasazení.
Generované soubory mají své vlastníky. assets/media.json patří do správy verzí nebo do kroku sestavení. Mapa tras, doplněk advanced-cache.php a deklarace WP_CACHE existují pouze při povoleném earlyServe a předávací háček pouze při synchronizaci. Vše ostatní generované se nachází pod cache.path a lze to bezpečně smazat.
Nic nebylo odstraněno ani přejmenováno. bs_render_block(), bs_block(), Blockstudio\Pages a Blockstudio\Patterns zůstávají kanonickými zdroji obsahu založenými na souborech.
Návrat k předchozímu stavu se provádí pro jednotlivé funkce. performance.profile zpět na compat, staticPrerender.enabled na false, githooks.commit na false spolu s sync a cache.enabled na false; každý krok vrátí jednu vrstvu.
Rozumné pořadí zavádění:
- Nastavte
performance.profilenaspeeda pak zkontrolujte výstup hlavičky, kanály a všechny pluginy závislé na oEmbed nebo XML-RPC. - Vygenerujte
assets/media.json, přesuňte šablony dobs_media_image()a pak zapněteperformance.media.lazy. - Povolte
performance.staticPrerenders vypnutýmearlyServe, ověřte požadavky pomocíwp bs prerender statusa pak zapněteearlyServe. - Spouštějte
blockstudio-phpstan --preset theme, dokud nebude bez chyb, a teprve potom nastavte předvolbu zagithooks.commit.
Kde najdete podrobnosti
- Canvas a jeho inventář a dokument API
- Vykreslování, komponenty UI a skládání UI
- Nastavení a výkon
- Výkon, ukládání do mezipaměti a statické předběžné vykreslování
- Tailwind CSS
- PHPStan: předvolby, kanonický příkaz, spravovaný předávací háček a smlouva projektu
- Integrace AI: rejstřík dokumentace a úplný text
- Migrace a PHP háčky