Přejít k obsahu

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 sync nebo zavolejte Blockstudio\Pages::reconcile(). Směrování kolekcí a výchozí hodnoty templateFor použí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žnost themeDefaults.syncPagesInDevelopment byla 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ávaly force, musí použít Pages::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_Type i 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\Render vrací hotový HTML pro blok, kompozici nebo celý dokument.
  • Rodiny komponent UI: Blockstudio\Ui seskupuje 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ého assets/media.json.
  • Pomocné funkce pro třídy Tailwind: bs_tw_merge() a bs_tw_variants() skládají třídy v PHP a slučují je s ohledem na konflikty.
  • Výkonnostní profily: performance.profile najednou 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 čtou blockstudio.json se skutečnými typy a zobrazují chyby parsování.
  • Jeden adresář mezipaměti: všechny generované soubory jsou uloženy pod cache.path a 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-theme a wordpress-render rozšiřují blockstudio/phpstan i mimo šablony bloků.
  • Spravovaný commit hook: blockstudio-githooks sync vytváří a spravuje hook před potvrzením, který spouští nakonfigurovanou předvolbu.
  • Smlouva projektu: blockstudio-agents vytváří AGENTS.md s 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.

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

PHP
$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, null nebo "*" 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 false nenač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.

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

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

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']);

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

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

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);
}

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.

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

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

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']));

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:

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

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

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

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

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()

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:

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

znamená totéž co:

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

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 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ší.

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

  1. Nastavte performance.profile na speed a pak zkontrolujte výstup hlavičky, kanály a všechny pluginy závislé na oEmbed nebo XML-RPC.
  2. Vygenerujte assets/media.json, přesuňte šablony do bs_media_image() a pak zapněte performance.media.lazy.
  3. Povolte performance.staticPrerender s vypnutým earlyServe, ověřte požadavky pomocí wp bs prerender status a pak zapněte earlyServe.
  4. Spouštějte blockstudio-phpstan --preset theme, dokud nebude bez chyb, a teprve potom nastavte předvolbu za githooks.commit.

Kde najdete podrobnosti