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 syncparancsot, vagy hívja meg aBlockstudio\Pages::reconcile()függvényt. A gyűjtemények útvonalkezelése és atemplateForalapé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.syncPagesInDevelopmentbeállítás megszűnt, mivel az oldalak szinkronizálása többé nem fut le a kérési hookokból. APages::init()mostantól csak bootstrapelést végez; azoknak az integrációknak, amelyekforce-t adtak át, aPages::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\Renderkész HTML értéket ad vissza egy blokkhoz, kompozícióhoz vagy teljes dokumentumhoz. - UI komponenscsaládok: a
Blockstudio\Uia 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áltassets/media.jsonalapján. - Tailwind osztálysegédek: a
bs_tw_merge()és abs_tw_variants()konfliktusokat kezelve fűz össze PHP-osztályokat. - Teljesítményprofilok: a
performance.profileegyszerre 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 ablockstudio.jsonértékeit, és jelzik a feldolgozási hibákat. - Egyetlen gyorsítótárkönyvtár: minden generált fájl a
cache.pathalatt 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, aextreme-themeés awordpress-renderablockstudio/phpstanképességeit a blokk-sablonokon túlra bővíti. - Kezelt commit hook: a
blockstudio-githooks synclétrehozza és kezeli a beállított preseten futó pre-commit hookot. - Projektmegállapodás: a
blockstudio-agentsolyanAGENTS.mdfá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.jsonfá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.
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.
$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, anullvagy 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
falseaz 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.
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.
$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
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:
$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.
{
"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.
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.
{
"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.
{
"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.
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:
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:
{
"phpstan": {
"preset": "theme",
"roots": ["."],
"excludePaths": ["fixtures/**"],
"maxFiles": 10000
}
}
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ó.
{
"githooks": {
"commit": true
}
}
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ő.
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.
## 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:
<brand-card>
<ui-input />
</brand-card>
ugyanazt jelenti, mint:
<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:
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.
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:
- Á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. - Generálja le a
assets/media.json-t, helyezze át a sablonokat abs_media_image()alá, majd kapcsolja be aperformance.media.lazy-t. - Engedélyezze a
performance.staticPrerender-t kikapcsoltearlyServemellett, ellenőrizze a találatokat awp bs prerender statussegítségével, majd kapcsolja be aearlyServe-t. - Futtassa a
blockstudio-phpstan --preset theme-t, amíg tiszta nem lesz, és csak ezután helyezzen bármilyen előbeállítást agithooks.commitmögé.
Hol találhatók a részletek
- Canvas és annak leltára, valamint a dokumentum API
- Megjelenítés, UI komponensek és a UI kompozíció
- Beállítások és teljesítmény
- Teljesítmény, gyorsítótárazás és statikus előrenderelés
- Tailwind CSS
- PHPStan: előbeállítások, kanonikus parancs, kezelt commit hook és a projekt szerződése
- AI-integráció: a dokumentációs index és a teljes szöveg
- Migráció és PHP hookok