Ugrás a tartalomhoz

Dennis · 2026. július 27.

Blockstudio 7.6

A Blockstudio 7.6 olvashatóvá és renderelhetővé teszi a projektet a PHP számára, az éles frontend alapértelmezéseit pedig áthelyezi a blockstudio.json rendszerbe: leltár API, önálló renderelés, média- és Tailwind-sablonsegédek, teljesítményprofilok, egyetlen gyorsítótárkönyvtár, statikus előrenderelés korai kiszolgálással, szigorúbb elemzési beállításkészletek, valamint generált projekt-eszközök a kódoló ügynökök számára.

A kiadás legfontosabb részét két hívás adja. A Canvas::inventory() visszaadja a projekt által regisztrált összes oldalt, blokkot, mintát, Site Editor-sablont, sablonrészt és csomagolt UI-példát. A Render::document() mindegyikhez kész HTML-t ad vissza, pontosan azokkal az eszközökkel, amelyeket a renderelés használt.

7.6.2-frissítés: A fájlból betöltött oldalak egyeztetése többé nem fut le a szokásos WordPress kérések során. A forrásmódosítások alkalmazásához futtassa a wp bs pages sync parancsot, vagy hívja meg a Blockstudio\Pages::reconcile() függvényt. A gyűjtemények útvonalkezelése és a templateFor alapértelmezései mentett futtatókörnyezeti konfigurációt használnak, a kifejezett egyeztetés pedig elkerüli a korábbi, nagy méretű, többnyelvű OR-metaadat-lekérdezést. A rövid élettartamú themeDefaults.syncPagesInDevelopment beállítás megszűnt, mivel az oldalak szinkronizálása többé nem fut le a kérési hookokból. A Pages::init() mostantól csak bootstrapelést végez; azoknak az integrációknak, amelyek force-t adtak át, a Pages::reconcile() függvényt vagy a CLI-t kell használniuk. A Canvas megnyitása továbbra is egy hitelesített, kifejezett egyeztetést indít a szerzői leltárhoz.

7.6.12 frissítés: A szerkesztői stíluslapok előtagja mostantól egyetlen átírási menetben készül el eszközönkénti SASS-fordítás helyett, így a sok blokkot tartalmazó webhelyek szerkesztőjének hideg buildje már nem kockáztatja a szerény memóriakeret kimerítését. Ha egy gyorsítótárazott, előrenderelt oldal tartalom-hash alapján azonosított Tailwind stíluslapját eltávolították, az oldal újrarenderelődik ahelyett, hogy stílusok nélkül szolgálnánk ki, mind a PHP gyorsítótáron, mind az Early Serve drop-inen keresztül. A legfelső szinten megadott blokkattribútumokat rendereléskor beolvassuk, nem dobjuk el, így a WP_Block_Type-on regisztrált séma Blockstudio a programozott írók esetén is érvényesül.

7.6.11 frissítés: A Graph-artefaktumok telepítése mostantól atomikusan lecseréli egy útvonal dokumentumát, ha az áruházban ugyanazon kulcs alatt megváltozott a másolat, az azonos dokumentumokat érintetlenül hagyja, és a Static_Prerender_Early_Serve::last_promotion() segítségével jelenti a promótált, lecserélt, kihagyott és megtartott útvonalakat.

7.6.10 frissítés: A futásidejű gyorsítótár-találatok mostantól a figyelési késleltetés alatt is észlelik az eltávolított lefordított eszközöket, a 7.6 előtti lapos futásidejű gyorsítótárakat pedig atomikusan karanténba helyezzük, majd korlátozott cron-kötegekben töröljük. A csomagolt UI-globálisok oldalanként egyszer jelennek meg. Graph módban az Early Serve az identitás- gyorsítótárból a telepített útvonaltérképen kívüli, élőben renderelt útvonalakat is ki tudja szolgálni. A Tailwind igény szerint a tartalom-hash alapú gyorsítótárfájlt tailwind.output: "link"-ként is kibocsáthatja; alapértelmezésként továbbra is a beágyazott kimenet használatos.

Röviden:

  • Projektleltár: a Canvas::inventory() minden regisztrált rekordot visszaad a forrásaival és stabil megjelenítési sorrendjével.
  • Célzott kiválasztás: blokkok és oldalak megadásával a feltárás, szinkronizálás, renderelés és fordítás ezekre a rekordokra szűkül.
  • Önálló renderelés: a Blockstudio\Render kész HTML értéket ad vissza egy blokkhoz, kompozícióhoz vagy teljes dokumentumhoz.
  • UI komponenscsaládok: a Blockstudio\Ui a csomagolt könyvtárat komponensenként egy nyilvános családba rendezi, mindegyikhez egy példával.
  • Stabil képméretek: a bs_media_image() valós méretekkel rendereli a téma eszközeit egy generált assets/media.json alapján.
  • Tailwind osztálysegédek: a bs_tw_merge() és a bs_tw_variants() konfliktusokat kezelve fűz össze PHP-osztályokat.
  • Teljesítményprofilok: a performance.profile egyszerre bekapcsolja az éles frontend alapbeállításait; a gyermekértékek felülírják.
  • Típusos beállításelérés: a Settings::get_bool() és társai valódi típusokkal olvassák be a blockstudio.json értékeit, és jelzik a feldolgozási hibákat.
  • Egyetlen gyorsítótárkönyvtár: minden generált fájl a cache.path alatt található, futásidejű identitás szerint rendezve.
  • Statikus előrenderelés: az anonim HTML gyorsítótárazható, függőségi gráfon keresztül érvényteleníthető, és még azelőtt kiszolgálható, hogy elindulna a WordPress.
  • Elemzési presetek: a theme, a extreme-theme és a wordpress-render a blockstudio/phpstan képességeit a blokk-sablonokon túlra bővíti.
  • Kezelt commit hook: a blockstudio-githooks sync létrehozza és kezeli a beállított preseten futó pre-commit hookot.
  • Projektmegállapodás: a blockstudio-agents olyan AGENTS.md fájlt hoz létre, amely leírja, mit készítenek a projekt szerzői, milyen funkciókat engedélyeznek, és mit követel meg a preset.
  • Dokumentációs index: az AI-környezetfájl mostantól minden dokumentumot, annak célját és a hozzá tartozó azonosítókat indexeli.
  • Kanonikus blokkcímkék: egy önálló parancs az előtagos és alias rövidítéseket <bs:namespace-slug> formára írja át, próbaüzemmel.
  • Alapértelmezett kompatibilitás: a fentiek egyike sem módosít egy webhelyet, amíg nincs megadva a blockstudio.json fájlban.

Projekt olvasása és renderelése

Projektleltár

A Canvas::inventory() egyetlen egyszerű tömbként visszaad mindent, amit a projekt regisztrál, renderelés nélkül.

PHP
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}

A rekordok típus szerint csoportosulnak: pages, blocks, patterns, templates, parts és ui. A order adja az összes típus stabil megjelenítési sorrendjét, a sources minden rekordhoz hozzárendeli a forrásútvonalakat, a warnings és a errors pedig strukturált bejegyzésekként gyűjti össze a problémákat.

A blokkrekordok a id, name, title, source, path, provenance és egy renderelésre kész declaration értéket tartalmaznak. Az oldalrekordok stabil azonosítóként őrzik meg a source értékét, a renderelő sablont pedig a path tárolja.

Célzott kiválasztás

A rekordok megadása szűkíti a feldolgozást, így nincs szükség utólagos szűrésre.

PHP
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);

Ez egy blokkot és egy oldalt ad vissza. A patterns, a templates, a parts és a ui üresen tér vissza; a hozzájuk tartozó forrásokat nem olvassuk be, nem szinkronizáljuk, nem rendereljük és nem fordítjuk le.

A szabályok pontosak:

  • Típusazonosító nélkül minden típus betöltődik.
  • A true, a null vagy a "*" az adott típus összes rekordját betölti.
  • Egy karakterlánc vagy lista pontos egyezést keres az azonosító, név, slug, útvonal vagy forrásútvonal alapján.
  • Az üres karakterlánc, az üres lista vagy a false az adott típusból semmit sem tölt be.
  • Ha bármelyik típusazonosító szerepel, a kihagyott típusok változatlanok maradnak.

A már nem létező azonosítók hiba helyett a deleted alatt jelennek meg, a Canvas REST frissítési végpontja pedig ugyanezt a szabályt alkalmazza az blocks és pages paraméterekre.

A Canvas::documents() ugyanazt a kiválasztást fogadja, és rekordként egy-egy renderelt dokumentumot ad hozzá. A kiválasztott oldalak visszaállított frontendkörnyezetben renderelődnek, így a lekérdezési feltételek, a törzsosztályok, a shortcode-ok, az elrendezések, az átirányítások és a sorba állítási visszahívások a kiválasztott oldalt látják, nem az azt lekérő kérést.

Önálló renderelés

A Blockstudio\Render karakterláncként adja vissza a renderelt HTML értéket, a frontendével azonos folyamaton keresztül.

PHP
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);

Az alapja egyetlen deklarációs forma négy kulccsal: name, attributes, content és children. A root, a data, a inner, a innerBlocks, a layers és a example bemeneti kényelmi formák, amelyeket a Render::normalize() egyesít vele. A gyermekelemek rekurzívan renderelődnek, a hibás bemenet pedig a problémás blokkot megnevező kivételt vált ki.

A Render::document() teljes, önálló HTML dokumentumba foglalja a kimenetet.

PHP
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];

A body maga a blokk kimenete, a html az összeállított dokumentum, a blocks a közreműködő blokkok nevei, a assets pedig a jelölést a következő részekre bontja: head, footer, styles, scripts, modules, interactivity, ui és tailwind. Az eszközök köre csak a renderelt tartalomra terjed ki, így a kizárólag a szerkesztőhöz tartozó eszközök nem jelennek meg.

A Render::document_from_html() egy máshol renderelt HTML dokumentumot foglal keretbe, a Render::content() pedig dokumentum nélkül rendereli a szerializált blokktartalmat. Egyetlen PHP folyamaton belül a dokumentumok között hívd meg a Blockstudio\Batch_Render::reset()-t; a Canvas::documents() ezt már megteszi.

UI komponenscsaládok

A Blockstudio\Ui a csomagolt UI könyvtárat nyilvános komponensenként egy bejegyzéssel teszi elérhetővé, nem a belső részek listájaként.

A Ui::inventory() családonként egy bejegyzést ad vissza a gyökérblokkjával, címével és a szükséges megvalósítási blokkokkal. A Ui::examples() családonként determinisztikus deklarációt ad hozzá: megőrzi az alapértelmezéseket, a szükséges gyermekrétegeket a szülőjük alá rendezi, az üres mezőkhöz pedig stabil szemléltető szöveget használ. Ez a deklaráció kanonikus, ezért közvetlenül bekerül a Render::document() értékbe.

A Canvas ugyanezt a csoportosítást használja. A csomagolt UI a ui típus alatt jelenik meg, családonként egy példával, a megvalósítási regisztrációk pedig kimaradnak a blocks értékből.

A családokat összeállíthatóra tervezték: a választó egy párbeszédablakon belül nyílik meg, a listája a kiváltó elem fölé rétegződik; a menük és a kombinált mezők olyan rögzített nézetport-koordinátákhoz igazodnak, amelyek görgetés közben is változatlanok maradnak; a modális ablakok egymásra rétegződnek, és egyszerre egyet zár be az Escape billentyű; minden lábléc ugyanazt a bezáró vezérlőt állítja össze egy változattal. A kapcsolódási pontok működését és a stabil működésüket biztosító invariánsokat a kompozíciókról szóló fejezet; a /ui/examples oldalon élőben tekinthetők meg a kompozíciók.

Sablonsegédek

Stabil képméretek

A bs_media_image() valós szélességgel és magassággal, valamint fenntartott képaránnyal rendereli a téma eszközeit, így a médiatárban nem szereplő képek többé nem tolják el az elrendezést.

PHP
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);

A kimenet egy figure.blockstudio-media, amely egy beágyazott aspect-ratio elemet tartalmaz egy valós width, height, loading és decoding értékkel rendelkező img körül. A méretek egy generált assets/media.json fájlból származnak, amelyet buildlépésben a Blockstudio\Media_Metadata_Builder ír meg, vagy kézzel hoznak létre.

A src relatív témaútvonalat, abszolút útvonalat vagy teljes URL címet fogad; a médiatár képeire a attachmentId használható. A eager kikapcsolja a lusta betöltést a hajtás felett, a sources pedig <picture> értéket bocsát ki.

Ha engedélyezve van a performance.media.lazy, a valódi URL a megfelelő méretű helyőrző mögé, a data-src értékbe kerül.

Tailwind osztálysegédek

A bs_tw_merge() és a bs_tw_variants() a PHP sablonokban Tailwind osztályokat állít össze azzal a motorral, amelyet a Blockstudio már tartalmaz.

A bs_tw_merge('px-2 text-sm', 'px-4') a text-sm px-4 értéket adja vissza: az ütköző px-2 kiesik, a későbbi érték pedig érvényesül. Egymásba ágyazott, osztályértékeket tartalmazó tömbök is használhatók.

A bs_tw_variants() egy kis, meghívható függvényt ad vissza a komponensváltozatokhoz:

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

Ez inline-flex items-center h-12 px-6 rounded értéket ír ki. Támogatottak az alap osztályok, a változatok, az alapértelmezett változatok, az összetett változatok, valamint a hívásonkénti class vagy className.

Éles környezeti konfiguráció

Teljesítményprofilok

A performance.profile egyetlen helyen bekapcsolja az éles frontend alapértelmezett beállításait.

JSON
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

A compat az alapértelmezett, és nem módosít semmit. A speed és a strict ugyanazt a készletet engedélyezi: eltávolítja a fejlécből a generátort, az emojikat, a feedet, a felfedezési adatokat és a szomszédos bejegyzések kimenetét; elhagyja az oEmbed-felfedezést és a tárhely szkriptjeit; letiltja a XML–RPC értékeket, a pingbackeket és a távoli szerkesztő felderítését; eltávolítja az általános core frontend-eszközöket; alkalmazza a képkimenet alapértelmezéseit; az editorokon kívül korlátozza a Heartbeatet; előre betölti a webhelyen belüli dokumentumokat rámutatáskor vagy fókuszálási szándék esetén; és a Blockstudio képbetöltőjét használja.

Minden gyermekérték felülírja a profilbeállítást, ahogy fent a preload.links is. Elsőként a core frontend-eszközök eltávolítását érdemes tesztelni, mert látható hibát okoz, ha egy oldal ezekre támaszkodik. A Runtime_Settings::current() megjeleníti a feloldott profilt.

A themeDefaults két olyan feladatot lát el, amelyet a témák egyébként maguk oldanak meg: titleTag és suppressDirectoryUpdates elrejti az aktív gyermek- és szülőtémát a frissítési találatok közül.

Típusos beállításelérés

A Blockstudio\Settings valódi típusokkal olvassa be a konfigurációt, ahelyett, hogy azt adná vissza, amit a JSON tárolt.

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

A hibás JSON feldolgozását a Settings::errors() jelzi, ahelyett, hogy alapértelmezett értékeket adna vissza. A Settings::get_raw() csak azt adja vissza, amit az aktív forrás deklarált, így megkülönböztethető a false értékre állított érték attól, amelyet sosem állítottak be.

A Settings::fingerprint() stabil identitást ad az érvényes beállításokhoz, az elérés pedig újratölt, ha megváltozik a blockstudio.json.

Egyetlen gyorsítótárkönyvtár

Mostantól minden generált fájl a cache.path alatt található, amelynek alapértelmezett értéke wp-content/blockstudio/cache.

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

A build adatai, a blokkregisztrációs adatok, a szerkesztő eszközei, a lefordított Tailwind CSS, a renderelt dokumentumok, a szigettöredékek, a statikus HTML fájlok, a gráfindexek, a várósorok és a diagnosztikai adatok mind ebben a gyökérkönyvtárban találhatók. Relatív útvonal esetén az alap WP_CONTENT_DIR, abszolút útvonallal pedig külön kötet adható meg.

Az objektumokat az aktuális hálózat és webhely, majd a futásidejű identitás szerint tároljuk. Ez a Blockstudio, a WordPress és a PHP verzióinak, az érvényes beállításoknak, az aktív témának és bővítményeknek, a feltárási forrásoknak, valamint az érintett forrásfájloknak az ujjlenyomata. Ha egy bemenet megváltozik, az érintett objektumok újak lesznek, a régieket pedig eltávolítjuk.

A hideg buildek egyszerre csak egyszer futnak le: egy kérés felépíti és atomikusan közzéteszi az eredményt, a többi pedig várakozik. Sikertelen frissítéskor továbbra is az utolsó jó objektumot szolgáljuk ki, miközben a hiba megfigyelhető marad; a Blockstudio\Runtime_Cache::purge('tailwind') pedig egyetlen hatókört töröl.

Statikus előrenderelés

A statikus előrenderelés teljes, anonim HTML dokumentumokat gyorsítótáraz, és még a WordPress elindulása előtt ki tudja szolgálni őket. Alapértelmezés szerint ki van kapcsolva.

JSON
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Jogosultsági feltételek

Csak a teljes, anonim HTML dokumentumok jogosultak. A nem GET-kérések, a lekérdezési karakterláncok, az adminisztrációs felület, a REST, az Ajax, a cron, a feedek, a keresés, az előnézetek, a nonce-ot tartalmazó kérések, a személyre szabott sütik és a dynamicPaths alatti útvonalak megkerülik a gyorsítótárat. Egy válasz a <!-- blockstudio:no-cache --> jelölővel teljesen kiiratkozhat.

Az útvonalillesztés figyelembe veszi a határokat, ezért a /account illeszkedik a /account/orders útvonalra, de a /accounting útvonalra nem.

Aláírási és gráfmódok

A invalidate határozza meg a bejegyzések lejáratát. Az alapértelmezett signature mód névtelen gyorsítótárhiány esetén az identitáskulccsal ellátott választ tölti fel, és a webhely szintű változások után új identitást hoz létre; ez egy átlagos webhelyhez megfelelő.

A graph módot kifejezetten buildelésre és telepítésre szolgáló eszközökhöz tervezték. Rögzíti az egyes oldalak saját forrásfüggőségeit, így egy terv csak az érintett URL-eket építi újra.

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

Korai kiszolgálás

Ha engedélyezve van a earlyServe, a Blockstudio minden webhelyhez egy kis útvonaltérképet és egy advanced-cache.php drop-int kezel, amely még a WordPress, a bővítmények vagy a téma indulása előtt streameli a jogosult találatokat.

Soha nem ír felül más által létrehozott térképet, drop-int vagy WP_CACHE deklarációt. A gráf-artefaktum ellenőrzi az összes hivatkozott HTML fájlt a térkép lecserélése előtt, így egy részben renderelt telepítés esetén az előző gráf marad aktív. A többhelyes bejegyzéseket a gazdagép, az alapútvonal és a webhelyazonosító szerint elkülönítjük.

Előmelegítés és állapot

Három WP-CLI parancs fedi le a mindennapi használatot:

Shell
wp bs prerender warm
wp bs prerender status
wp bs prerender purge

A status jelenti az aktív identitást, a fájlok és bájtok számát, a gráfrekordokat, a várólista állapotát, valamint a hatókörönkénti találatok, hiányok, buildek és hibák számlálóit.

Elemzési és ügynökeszközök

Elemzési presetek

A blockstudio/phpstan a blokkelemzés fölé három réteget ad, valamint egy parancsot, amely a projekt által kiválasztott réteget futtatja.

Preset Mit ad hozzá
base A meglévő séma-, sablon-, hook-, beállítás- és API-elemzést.
theme Témagyökerek, stílusfejlécek, eszközök, szelektorkörök, mezőalapértékek és ismétlőhatárok.
extreme-theme PHPStan max, nem biztonságos PHP, escape-elés, Tailwind, JavaScript és Interactivity-ellenőrzések.
wordpress-render A hívó által megadott élő renderelési próba a extreme-theme fölött.

Az alapértékek a blockstudio.json-ból származnak, így az interaktív futtatások, a CI és a commit hookok ugyanazt a konfigurációt használják:

JSON
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
Shell
vendor/bin/blockstudio-phpstan --root . -- --no-progress

Kilépési kódok: 0 siker esetén, 1 diagnosztikai üzenetek esetén, 2 pedig érvénytelen használatkor. A wrapper a konfigurációt a rendszer ideiglenes könyvtárában állítja össze, így nem kerül generált konfiguráció, alapállapot vagy gyorsítótár a projektbe, és a PHPStan memóriakorlátját 1G-ra emeli.

A csomag egy BC Math-szolgáltatót is tartalmaz, így a JavaScript ellenőrzésekhez már nincs szükség a ext-bcmath használatára.

Kezelt commit hook

Egy beállítással és egy paranccsal a konfigurált preset commitkapuvá alakítható.

JSON
{
  "githooks": {
    "commit": true
  }
}
Shell
vendor/bin/blockstudio-githooks sync

A szinkronizálás a hookot és a tulajdonosi rekordot a Git közös könyvtárába írja, a core.hooksPath útvonalát a kezelt könyvtárra állítja, és láncba fűzi a korábban beállított pre-commit hookot. A hook commitkor oldja fel a tároló és a projekt gyökérkönyvtárát, így a csatolt checkoutok és a szóközt tartalmazó útvonalak is működnek.

A hook csak a vendor/bin/blockstudio-phpstan parancsot futtatja, mást nem; soha nem formázza át és nem írja át a fájlokat. Ha a commit értékét false-ra állítod, majd újra szinkronizálsz, vagy futtatod a blockstudio-githooks remove parancsot, visszaállítja a rögzített hook útvonalát, és csak a Blockstudio által kezelt fájlokat törli.

Projektmegállapodás

A blockstudio-agents létrehoz egy AGENTS.md fájlt, amely leírja, hol találhatók a blokkok, mit jelent az oldal ebben a projektben, mely funkciók vannak engedélyezve, és mit utasít el az elemző.

Shell
vendor/bin/blockstudio-agents

A dokumentum levezetett, nem sablon alapján készül. Egy style.css fejléccel, blokkokkal és fájlalapú oldalakkal rendelkező téma más megállapodást kap, mint egy olyan bővítmény, amely csak blokkokat regisztrál; a megállapodás tartalmazza a beolvasó által talált darabszámokat, könyvtárakat, névtereket és sablonnyelveket. A blockstudio.json határozza meg, mely funkciók jelennek meg, ezért a statikus előrenderelést nem használó projektekben annak említése sem szerepel.

A helyességi szakasz a kiválasztott preset saját szabályfájljaiból épül fel, rétegenként, ezért ha a preset új szabályt kap, az minden generált megállapodásban megjelenik.

A tulajdonjog kezelése a commit hookéhoz hasonló. Ha egy fájlból hiányzik a generált jelölő, a rendszer megtagadja a lecserélését, kivéve ha a --force másként rendelkezik; a végén található megjegyzésrész megmarad újrageneráláskor; a --check 1 értékkel lép ki, ha a megállapodás elavult; a --stdout pedig a fájlrendszer érintése nélkül írja ki.

Dokumentációs index

A blockstudio-llm.txt mostantól index, nem összefűzött dokumentum. Minden közzétett dokumentum egyszer jelenik meg, a saját szakaszában és alszakaszában, az útvonalával, a forrásfájljával, egysoros leírásával és a hozzá tartozó azonosítókkal: beállítási útvonalak, hooknevek, PHP függvények és osztályok, valamint parancsok.

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

Az ügynök beolvassa az indexet, megkeresi azt az egy dokumentumot, amelyhez az őt érdeklő azonosító tartozik, majd megnyitja azt. A korábbi, fél megabájtos összefűzött fájl továbbra is létrejön és közzétételre kerül itt: /blockstudio-llm-full.txt; már nem ezt kapja meg elsőként mindenki.

Kanonikus blokkcímkék

Egy önálló parancs a prefix- és aliasrövidítéseket a kanonikus <bs:namespace-slug> alakra írja át, amely rögzíti a valódi blokknevet, és betöltött projekt szűrő nélkül is feloldható.

brand előtaggal a theme-components esetén, és ui előtaggal a bsui esetén ez a rövidítés:

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

ugyanazt jelenti, mint:

HTML
<bs:theme-components-card>
  <bs:bsui-input />
</bs:theme-components-card>

Az előtagok és a pontos aliasok továbbra is működnek, és nincsenek elavultnak nyilvánítva. A parancs nem tölti be a WordPress-t, és --apply nélkül nem ír semmit:

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

A --prefix-map minden előtagot hozzárendel a névtereihez, a --known-blocks pedig felsorolja a regisztrált blokkneveket. A jelentés rögzíti a régi és kanonikus alakok közötti leképezéseket az előfordulások számával, a fájlonkénti hash-ekkel, valamint az ismeretlen címkék, a kétértelmű aliasok és a dinamikus címkék külön listáival. A --apply nem hajlandó írni, amíg bármelyik ilyen eset fennáll, kivéve ha meg van adva a --allow-unresolved.

A páros, egymásba ágyazott és önlezáró jelöléseket is kezeli, beleértve a karakterláncokban szereplő szó szerinti címkéket is: PHP. Csak a címkenevek változnak, a második futtatás nem eredményez módosításokat, a megjegyzésekben, kódblokkokban, <pre>-ben vagy <code>-ben szereplő példák pedig csak a jelentésben jelennek meg.

Alapértelmezett működés

A 7.6 telepítése önmagában semmit sem változtat.

A teljesítményprofil alapértelmezése: compat. A fejléc kimenete, az oEmbed, a XML-RPC, a Heartbeat, a képek alapértelmezései, a hivatkozások előbetöltése, a lusta betöltés és a frontend <title> beállításai olyanok maradnak, ahogy a WordPress és a téma meghagyta őket.

Ezek kikapcsolva maradnak, amíg nem engedélyezi őket: minden performance.staticPrerender, performance.measurement, performance.media és themeDefaults kulcs, továbbá a githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled és blockTags.enabled. Kikapcsolt állapotban a statikus előrenderelés nem ír fájlokat és nem telepít drop-in fájlt.

A Canvas és a Render passzív. Beolvassák a meglévő regisztereket, és csak azt jelenítik meg, amit a hívó kér; egyik sem kapcsolódik be a frontend kimenetébe, és útvonalakat sem regisztrál. A Canvas adminisztrációs képernyőjéhez továbbra is szükséges a dev.canvas.enabled és a edit_posts.

Szigorúbb elemzéshez név szerint kell megadni. A blockstudio/phpstan telepítése csak az alapbővítményt engedélyezi, a kanonikus parancs pedig a base beállítást futtatja, hacsak a projekt nem nevez meg egy előbeállítást.

A generált fájlok létrehozásához futtatni kell a hozzájuk tartozó parancsot. A githooks.commit nem csinál semmit, amíg nem fut le a blockstudio-githooks sync, ahogy a AGENTS.md sem, amíg le nem fut a blockstudio-agents.

Frissítés 7.5-ről

A követelmények nem változtak: PHP 8.2 vagy újabb, WordPress 6.7 vagy újabb.

Shell
composer require blockstudio/blockstudio

A gyorsítótárak egyszer épülnek újra. A futásidejű identitás része a Blockstudio verziója, ezért a frissítés utáni első kérés hidegindítású, a régi objektumok pedig törlődnek. A régi Tailwind gyorsítótár törölhető innen: wp-content/uploads/blockstudio/tailwind/cache; az ezt glob mintával beolvasó kódrészlet helyette a Blockstudio\Runtime_Cache::purge('tailwind') függvényt hívja.

A 7.6 előtti, lapos wp-content/blockstudio/cache/runtime könyvtár automatikusan kikerül az aktív útvonalból, majd korlátozott WP-Cron műveletek távolítják el. Így a régi, nagyméretű zárolásifájl-fákat nem kell egy telepítési kérés során törölni.

A generált fájloknak van felelősük. A assets/media.json verziókezelőbe vagy egy buildlépésbe tartozik. Az útvonaltérkép, a advanced-cache.php drop-in fájl és a WP_CACHE deklaráció csak akkor létezik, ha a earlyServe engedélyezve van; az előzetes commit hook pedig csak szinkronizált állapotban. Minden más generált fájl a cache.path alatt található, és biztonságosan törölhető.

Semmit sem távolítottak el és semmit sem neveztek át. A bs_render_block(), a bs_block(), a Blockstudio\Pages és a Blockstudio\Patterns továbbra is a fájlalapú tartalom kanonikus felületei.

A visszaállítás funkciónként történik. A performance.profile visszaállítása erre: compat; a staticPrerender.enabled visszaállítása erre: false; a githooks.commit visszaállítása erre: false egy sync mellett; valamint a cache.enabled visszaállítása erre: false egy-egy réteget von vissza.

Egy ésszerű bevezetési sorrend:

  1. Állítsa a performance.profile értékét erre: speed, majd ellenőrizze a fejléc kimenetét, a feedeket és minden olyan bővítményt, amely az oEmbedre vagy a XML-RPC funkcióra támaszkodik.
  2. Generálja le a assets/media.json-t, helyezze át a sablonokat a bs_media_image() alá, majd kapcsolja be a performance.media.lazy-t.
  3. Engedélyezze a performance.staticPrerender-t kikapcsolt earlyServe mellett, ellenőrizze a találatokat a wp bs prerender status segítségével, majd kapcsolja be a earlyServe-t.
  4. Futtassa a blockstudio-phpstan --preset theme-t, amíg tiszta nem lesz, és csak ezután helyezzen bármilyen előbeállítást a githooks.commit mögé.

Hol találhatók a részletek