Dennis · 2026. július 23.
Blockstudio 7.5
Blockstudio A 7.5 teljessé teszi az Blockstudio fájlközpontú munkafolyamatát: egyéni mezőtípusokkal, fájlalapú Site Editor-sablonokkal, blokk-szigetekkel, Storh adatbázis-tárolással, logikai felderítési forrásokkal, összeállítható blokkcímkékkel, valamint gyorsabb telepítési és futásidejű útvonalakkal.
Az újrahasználható egyéni mezőkkel a projektek egyszer definiálhatnak egy meglévő mezőkből álló csoportot, majd újra felhasználhatják azt az type: "custom/{name}" segítségével. Az egyéni mezőtípusok más problémát oldanak meg: lehetővé teszik, hogy egy téma vagy bővítmény új, névtérrel ellátott mezőtípust regisztráljon, saját szerkesztői vezérlőt adjon hozzá, az értéket pedig szokásos Blockstudio adatként tárolja.
Röviden:
- Logikai felderítési források: a futtatókörnyezetek összeállított logikai témakészletet biztosíthatnak, beleértve a származási adatokat és a gyorsítótár-azonosítót, miközben a Blockstudio továbbra is felel a felderítésért, a testvérfájlok feloldásáért, a generált eszközökért, a Canvasért és a Tailwind működéséért.
- PHP mezőtípus-nyilvántartás: a témák és bővítmények névterezett mezőtípusokat regisztrálhatnak, például a
acme/dimensionstípust abs_register_field_type()segítségével vagy ablockstudio/field_typesszűrővel. - Szerkesztői vezérlők nyilvántartása: az egyéni szerkesztői szkriptek meghívhatják a
window.blockstudio.registerFieldType()függvényt, és megjeleníthetik a megfelelő React vezérlőt a szokásos Blockstudio mező UI felületén. - Strukturált értékek: az egyéni mezők karakterláncokat, számokat, logikai értékeket, tömböket vagy objektumokat tárolhatnak anélkül, hogy az objektumértékeket a választómezők normalizálásán keresztül alakítanák át.
- Tárolási támogatás: a bejegyzés-metaadatokat és beállításokat használó egyéni mezők megadhatják az értékük típusát és a REST sémát, beleértve az objektum- és tömbértékeket.
- Natív integráció: az egyéni mezőtípusok csoportokban, füleken, ismétlőkben, újrafelhasználható egyéni mezőkben, sablonokban és bővítménysablon-útvonalakon is működnek.
- Site Editor-sablonok: a témák a
template.json,part.jsonés Blockstudio sablonfájlokból határozhatnak megwp_templateéswp_template_partforrásokat. - Blokk-szigetek: a blokkok először gyorsítótárazásra alkalmas vázat jeleníthetnek meg, majd az oldal betöltése után betölthetik vagy kötegelt kéréssel lekérhetik a kérésre szabott töredékeket.
- Storh adatbázistárolás: a
bs.dbindexelt, rekordonkénti fájltárolót használhat a feltöltések között, megőrizve a nyilvános egész számú azonosítókat és lehetővé téve a JSONC-ről Storh-re történő migrációt a WP-CLI segítségével. - Elemző és bsui-fejlesztések: a leképezett richtext-bekezdésekhez kevesebb egyéni elemzőkapcsolat szükséges, a
InnerBlockstokenizáltallowedBlocks-t használhat, a beágyazottbs_render_block()kimenete megegyezik a frontend megjelenítésével a szerkesztő előnézetében, absui/buttonpedig ikonokat és könnyebben használható stílusozási kapcsolódási pontokat kap. - Összeállítható blokkcímkék: az előtagcímkék egy másik előtagon keresztül is feloldhatók (
<theme-ui-input>→bsui/input), az előtag- és aliassz címkék pedig a blokk-sablon kimenetében is megjelennek, nem csak az oldal tartalmában. - Gépfüggetlen, biztonságos buildgyorsítótárak: a futtatókörnyezet és a szerkesztő gyorsítótárai mostantól alapértelmezés szerint a feltöltéseken kívül találhatók, helyük konfigurálható, az elavult bejegyzések pedig törlődnek, így a hosszú ideig futó projektek nem halmoznak fel gyorsítótárfájlokat.
- Az oldalak fokozatos egyeztetése: a telepítőeszközök egyeztethetik a fájlokból származó oldalak teljes készletét, kihagyhatják a változatlan bejegyzéseket, pontosan jelenthetik a módosításokat, és az aktiválás után elmenthetik az ellenőrzött forrásazonosságot.
- Gyorsabb meleg renderelés: az érvényes futtatókörnyezeti gyorsítótárak még a felderítés előtt betöltődnek, az egyidejű hideg kérések egyetlen atomi eredményt tesznek közzé, a Tailwind pedig a webhely méretéhez igazodó gyorsítótárat tart fenn, újrafelhasználható fordítóállapottal.
- Biztonságos kötegelt renderelés: az exportálók az egyes dokumentumok között visszaállíthatják a kéréshez kötött renderelési állapotot a felderítés újjáépítése nélkül, és a blokkok renderelése közben összegyűjthetik a forrásfüggőségeket.
Új funkciók
A 7.5 a felderítés, a sablonok és a tárolás számos új képességét hozza el.
Logikai felderítési források
A Blockstudio általában a téma fizikai könyvtáraiból deríti fel a fájlokat. A 7.5 egy alacsonyabb szintű API forrást ad azoknak a futtatókörnyezeteknek, amelyek átfedésekből, előnézetekből, generált fájlokból, távoli csatolásokból vagy más összeállított készletekből építenek fel egy témát.
Az integráció megadhatja a végleges logikai fájlfát, miközben a Blockstudio továbbra is felel a blokkok, mezők, oldalak, minták, Site Editor, Canvas, eszközök és a Tailwind működéséért:
use Blockstudio\Inventory_Discovery_Source;
add_filter(
'blockstudio/discovery/sources',
function (array $sources, string $context): array {
if ('blocks' !== $context) {
return $sources;
}
return [
new Inventory_Discovery_Source(
'preview:feature-card',
'/runtime-preview/feature-card/blockstudio',
[
'card/block.json' => [
'path' => '/theme/blockstudio/card/block.json',
'provenance' => ['layer' => 'parent'],
],
'card/index.php' => [
'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
'provenance' => ['layer' => 'preview'],
],
],
'preview-fingerprint'
),
];
},
10,
2
);
A logikai útvonalak akkor is stabilak maradnak, ha a testvérfájlok különböző fizikai gyökérkönyvtárakból származnak. A forrásazonosítók és ujjlenyomatok részt vesznek a futtatókörnyezet és a Tailwind gyorsítótár-azonosítóinak képzésében, a figyelt bemenetek érvénytelenítik ezeket, a származási adatok pedig meghatározzák, hová írhatók a generált fájlok. A normál témák alapértelmezett fájlrendszer-forrása változatlan marad.
Fájlból betöltött Site Editor-sablonok
Az oldalak és a minták már lehetővé teszik a csapatok számára, hogy a tartalmi struktúrákat fájlokban tárolják. A 7.5 ezt a modellt magára a Site Editorra is kiterjeszti.
theme/
templates/
front-page/
template.json
index.php
parts/
header/
part.json
index.php
{
"slug": "front-page",
"title": "Front Page"
}
<div class="site-shell">
<block name="core/template-part" slug="header" />
<main>
<h1>Welcome</h1>
<block name="core/post-content" />
</main>
</div>
A Blockstudio az oldalak és minták feldolgozásához használt elemzővel fordítja le a forrást, majd normál Site Editor-sablonként vagy sablonrészként teszi elérhetővé a WordPress számára. A Site Editor megjeleníti a sablont, a frontend renderelheti, a WordPress pedig továbbra is kezeli a testreszabásokat.
Ez utóbbi fontos. A fájlból betöltött sablonok jelentik a forrás tartalékát. Ha a felhasználó sablont ment a Site Editorban, a WordPress létrehozza a szokásos wp_template vagy wp_template_part adatbázis-testreszabást, és ez a változat élvez elsőbbséget. Állítsa vissza a testreszabást, és ismét a legújabb fájlforrás válik láthatóvá.
Fokozatos oldaldeployolás
A fájlból betöltött oldalak a 7.5-ben egy deployolási egyeztetési API funkcióval bővültek. A 7.6.2 verziótól kezdve a kifejezett API és wp bs pages sync az egyetlen szinkronizálási belépési pont; a szokásos kérések soha nem alkalmaznak forrásmódosításokat:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
A folyamat felderíti a kívánt oldalak teljes készletét, összehasonlítja a tartalmat és a szinkronizáló motor ujjlenyomatait, majd jelentést készít a létrehozott, frissített, változatlan, eltávolított és sikertelen oldalakról. Az azonos ujjlenyomatú oldalaknál nem történik bejegyzés- vagy bejegyzés-metaadat-írás. A hiányzó, kezelt oldalak eltávolítására csak akkor kerül sor, ha a felderítés hibamentesen befejeződött.
Az egyeztetés determinisztikus forrásazonosságot ad vissza, de önmagában nem jelöl sikeresnek egy deployolást. A deployoló eszközök csak az egyező fájlok és útvonalak aktiválása és ellenőrzése után mentik el ezt az azonosságot. A szokásos WP-CLI bootstrapelés a gyorsítótárazott gyűjtemény-bejegyzéstípusokat és átírásokat regisztrálja, anélkül hogy minden oldalt felderítene és szinkronizálna.
Blokk-szigetek
A legtöbb Blockstudio blokk szerveroldalon renderelődik. Ez jól illik a WordPress használatához, de ismert gyorsítótárazási problémát okoz: egyetlen személyre szabott blokk miatt az egész oldal gyorsítótárazása nehézzé válhat.
A blokk-szigetek blokkszinten választják szét ezt a határt.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
A dinamikus sziget az első válaszban csak egy gyorsítótárazásra alkalmas helyőrzőt renderel. Ezután a böngésző egyetlen kötegelt kérést küld az oldal összes megjelenítésre kész dinamikus szigetéért, a Blockstudio pedig a látogató valódi kérési környezetében rendereli ezeket a töredékeket.
Így a teljes oldal gyorsítótára tárolhatja az oldal vázát, miközben a kosár darabszáma, a fiókvezérlők, az engedélyekhez kötött UI és a többi felhasználónként eltérő elem továbbra is naprakész marad.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
A már gyorsítótárazásra alkalmas HTML elemeket renderelő, és csupán frontendcsatlakozási jelzést igénylő blokkokhoz használjon hidratált szigetet:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
A hidratált szigetek nem indítanak REST kérést. A szokásos módon renderelődnek, majd blockstudio:island:hydrate eseményt kapnak a frontenden.
A dinamikus szigetek a programozott renderelési útvonalakon keresztül is működnek:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
Blokkcímkéken keresztül is:
<bs:acme-cart-count product-id="42" />
A végpont szándékosan szűk hatókörű. Csak olyan regisztrált Blockstudio blokkokat renderel, amelyek dinamikusak, és kifejezetten dinamikus szigetként vannak megjelölve. A rendszer a blokk sémája és a sziget engedélyezési listája alapján szűri az attribútumokat, és minden jelölőhöz az adatot kiszolgáló WordPress webhely által generált aláírás tartozik.
Storh adatbázistárolás
A Blockstudio adatbázisrétege már támogatja a táblákat, a SQLite, a JSONC, a bejegyzés-metaadatokat és az egyéni bejegyzéstípusokat. A 7.5 hozzáadja a storage: "storh" lehetőséget azoknak a projekteknek, amelyek biztonságosabb párhuzamos írásokat és sémából származtatott indexeket kínáló, fájlalapú tárolót szeretnének, de nem akarják az aktív rekordokat a blokkforrásfájlok mellett tárolni.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
A Storh rekordjai a feltöltések között találhatók:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
A nyilvános API változatlan marad. A bs.db(), a REST és a Db::get() továbbra is egész számú id értékeket ad vissza. Belsőleg a Blockstudio ezeket az azonosítókat a Storh UUIDv7 dokumentumazonosítóira képezi le, ezért a meglévő klienskódot nem kell módosítani.
A rendszer minden deklarált séma-mezőt indexel az egyenlőségi szűrőkhöz, a numerikus és dátumszerű mezők kapnak tartományindexeket, a kifejezett egyediségi jelzéseket pedig továbbítja. A JSONC seedfájlokkal indult projektekben az új CLI migráció a helyén hagyja a forrásfájlt, és egy azzal egyenértékű Storh tárolót ír:
wp bs db migrate my-theme/app subscribers --to=storh
Így a JSONC egyértelműbben használható egyszerű, verziókezelőbe helyezhető seed- és konfigurációs formátumként, míg a Storh válik a módosítható éles adatok jobb alapértelmezett fájlalapú háttértárává.
Elemző- és bsui-fejlesztések
A 7.5 kisebb fejlesztéseket is tartalmaz, amelyek akkor válnak fontossá, amikor egy projekt egyre inkább fájlból betöltött sablonokra és csomagolt UI-ra támaszkodik.
Az elemleképezés most már egyéni builder nélkül is kezeli a gyakori richtext-bekezdés esetét. Ha a <p> egy regisztrált, nem alaprendszerbeli Blockstudio blokkra képez le, amelynek van content richtext-attribútuma, az egyszerű belső szöveg erre az attribútumra másolódik. A beágyazott címkék és a leképezett gyermekelemek továbbra is belső blokkokként dolgozódnak fel.
A InnerBlocks mostantól tokenizált allowedBlocks-t is elfogad a sablonokban:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
A támogatott tokenek: namespace/*, category:<slug> és @theme. Ezek a szerveren bővülnek ki, mielőtt a szerkesztő megkapná a sablont, így a frontend renderelési útvonala változatlan marad.
A programozott beágyazások is kiszámíthatóbban működnek. A bs_render_block() és a bs_block() mostantól a frontenden feloldott HTML formájában jeleníti meg a beágyazott blokkokat akkor is, ha egy másik blokk szerkesztői előnézetéből hívják meg őket. Így a beágyazott blokkok nem szivárogtatnak nyers <RichText /> vagy <InnerBlocks /> pszeudokomponenseket az előnézeti jelölésbe.
A csomagolt UI esetében a bsui/button mostantól támogatja az icon attribútumot és a iconPosition-t. A csomagolt bsui/* belső stílusok egy @layer bsui kaszkádrétegben jelennek meg, a gombváltozatok pedig a blockstudio/ui/button/variants-style és a meglévő blockstudio/blocks/attributes szűrő segítségével bővíthetők.
A blokkcímkék további módokon is összeállíthatók. Egy előtag egy másik előtagon keresztül is feloldható, így a ui névtér-előtagra épülő theme projektelőtaggal rendelkező <theme-ui-input /> feloldása bsui/input lesz. A regisztrált előtag- és aliassz címkék mostantól a blokk-sablonok kimenetében is megjelennek, nem csak az oldal tartalmában, így a sablon közvetlenül kiírhatja őket a bs_render_block() meghívása helyett.
A blockstudio/block_tags/builders segítségével regisztrált egyéni blokképítők következetesen részt vesznek a címkék és a leképezett elemek feldolgozásában is. A kifejezett renderelőszűrők ezt követően továbbra is lefutnak, és felülbírálhatják a builder eredményét.
Gyorsabb meleg kérések és exportok
A futtatókörnyezet és a szerkesztő gyorsítótárai mostantól alapértelmezés szerint a wp-content/blockstudio/cache helyen találhatók a feltöltések helyett. A hely módosítható a cache.path vagy a blockstudio/cache/dir segítségével, így a tartós gyorsítótárazás azokon a tárhelyeken is elérhető, ahol a feltöltések alatt tiltják a PHP tartalmakat. A futtatókörnyezeti, szerkesztői eszköz- és Tailwind gyorsítótárakból is automatikusan törlődnek az elavult bejegyzések, így a hosszú ideig futó projektek nem halmoznak fel korlátlan számú gyorsítótárfájlt a lemezen.
A frontenden érkező meleg kérések mostantól az adatforrások felépítése előtt betöltik az érvényes futtatókörnyezeti nyilvántartást. Ezzel elmarad a források rekurzív felderítése, a blokkok felépítése, a mezők feldolgozása és a gyorsítótárkulcsokat alkotó fák ismételt bejárása. Az éles és staging kérések alapértelmezés szerint 20 másodpercig megbíznak az ellenőrzött figyelési pillanatképekben, a helyi és fejlesztői környezetek viszont továbbra is minden kérésnél ellenőriznek.
A hideg gyorsítótár létrehozása egyszerre csak egy kéréssel történik. Egy kérés felépíti és atomi módon közzéteszi a hasznos adatot, miközben a párhuzamos kérések megvárják az eredményt. A Tailwind mostantól alapértelmezés szerint legfeljebb 1,000 lefordított bejegyzést tárol 30 napig, és újrafelhasználja a fordító előmelegített felépítési állapotát, így a webhely méretéhez igazodó útvonalkészlet nem forgatja folyamatosan a túl kicsi gyorsítótárat.
A hosszú ideig futó exportálók a dokumentumok között meghívhatják a Blockstudio\Batch_Render::reset() függvényt. Ez törli a kéréshez kötött számlálókat, eszközöket, szigeteket, elrendezéseket és a Tailwind generálását a felderítés újjáépítése nélkül. A blockstudio/render/dependencies szűrő minden renderelt blokk által használt sablon- és eszközútvonalakat elérhetővé teszi a függőségi gráfok számára.
Megbízhatóság és kompatibilitás
Több javítás teszi teljessé a kiadást:
- A
blockstudio/blocks/attributessegítségével módosított meződefiníciók mostantól a rendereléskori választóérték-ellenőrzést is vezérlik a szerkesztői séma mellett. A típusos numerikus és logikai választóértékek is következetesen oldódnak fel. - A szerkesztői blokkburkolók ugyanazokat a generált osztályokat használják, mint a frontend renderelések, a Canvas pedig az új
blockstudio/editor/canvas/body_classszűrővel átmásolhatja a beállított frontend body osztályokat. - A Content Sync a romboló írások előtt ellenőrzi a teljes forrástervet, a törlési műveleteket a beállított tartalomkészleten belül tartja, és jelenti a fájlírási hibákat anélkül, hogy előreléptetné az adott elem szinkronizálási állapotát.
- Az aktív vagy szülőtémákban található, szimbolikus hivatkozáson keresztül elérhető Composer csomagok a nyilvános téma URL könyvtárából érik el a szerkesztő eszközeit.
- A kulcsalapú, fájlból betöltött oldalak megőrzik a szerkesztő által kezelt Blockstudio mezőértékeket, szinkronizáláskor migrálják a korábbi beágyazott kulcsstruktúrát, és a numerikus nullát is érvényes kulcsként fogadják el.
- A dinamikus szigetek a kérésszűrők előtt ellenőrzik az aláírásokat, figyelmen kívül hagyják az aláíratlan kérési környezetet, visszaállítják az azonos eredetű bejelentkezett látogatókat, és elkerülik az anonim felhasználók közötti gyorsítótár-ütközéseket.
- A nyers Markdown oldalak végpontjai mostantól figyelembe veszik a bejegyzések láthatóságát és a jelszavas védelmet.
- A szerkesztői vezérlők megbízhatóbban kezelik az üres feltételeket, a jelölőnégyzetek összeset váltó értékeit, az aszinkron választófrissítéseket, a dinamikus renderelési sorrendet, valamint az ismétlők RichText- és WYSIWYG-állapotát.
Egyéni mezőtípusok
További részletek a fent bemutatott egyéni mezőtípusokról.
Miért érdemes egyéni mezőtípusokat használni?
A Blockstudio-nek alapértelmezés szerint is hasznosnak kell lennie, a valódi projekteknek azonban gyakran saját szakterületükre szabott vezérlőkre van szükségük: térköz-tokeneket választó mezőkre, a dizájnrendszer színszerepeit kezelő vezérlőkre, reszponzív méretekre, ikonforrásokra, termékválasztókra vagy strukturált értékre leképeződő szerkesztői vezérlőkre.
A 7.5 előtt ezek a projektek vagy több beépített mezőt kombinálhattak, vagy saját változatra ágaztathatták a szerkesztőt. A 7.5 egy támogatott köztes lehetőséget kínál: a mező életciklusát a Blockstudio kezeli, a vezérlőt pedig a projekt.
add_action('init', function () {
wp_register_script(
'acme-field-dimensions',
get_stylesheet_directory_uri() . '/fields/dimensions.js',
['blockstudio-blocks', 'wp-components', 'wp-element'],
'1.0.0',
true
);
bs_register_field_type('acme/dimensions', [
'attribute' => 'object',
'default' => [],
'editor_script' => 'acme-field-dimensions',
'storage' => [
'type' => 'object',
'rest_schema' => [
'type' => 'object',
'additionalProperties' => ['type' => 'string'],
],
],
]);
});
const { createElement: el } = wp.element;
const { TextControl } = wp.components;
window.blockstudio.registerFieldType('acme/dimensions', {
component(props) {
const value =
props.value &&
typeof props.value === 'object' &&
!Array.isArray(props.value)
? props.value
: {};
const sides = props.sides || ['top', 'right', 'bottom', 'left'];
return el(
'div',
{},
sides.map((side) =>
el(TextControl, {
key: side,
label: side,
value: value[side] || '',
onChange(nextValue) {
props.onChange({
...value,
[side]: nextValue,
});
},
}),
),
);
},
});
Ezután a mező natív mezőként használható a block.json rendszerben:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Szokásos sablonértékek
A mentett érték a többi Blockstudio attribútumhoz hasonlóan elérhető a PHP, a Twig és a Blade helyeken.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
Ugyanezek az objektumútvonalak a bővítménysablonokban is működnek:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Kompatibilitási megjegyzések
A meglévő beépített mezőtípusok változatlanok maradnak. A meglévő custom/{name} újrafelhasználható mezőcsoportok sem változnak. Az egyéni mezőtípusok nevének kisbetűsnek és névterezettnek kell lennie, például acme/dimensions; a custom/ és a blockstudio/ névterek fenntartottak.
Ha a PHP regisztrál egy mezőtípust, de a hozzá tartozó szerkesztői szkript nem regisztrálja a megfelelő vezérlőt, a Blockstudio megőrzi a mentett értéket, és nem szerkeszthető értesítést jelenít meg a szerkesztőben. Ha egy mezőtípus nincs regisztrálva a PHP rendszerben, a Blockstudio kihagyja azt a generált WordPress attribútumokból.
7.5.1 karbantartási frissítés
A 7.5.1 megszüntet egy figyelmeztetést, amely akkor jelent meg, amikor a rendszer a többszörös kiválasztás értékeit renderelésre készítette elő tömbből karakterlánccá alakítva. A mentett és renderelt értékek eddig is helyesek voltak, de a hibakeresési naplók minden mező renderelésekor kaphattak egy figyelmeztetést.
A kísérő blockstudio/phpstan v0.1.7 frissítés a névtelen csoportokba ágyazott mezőket is felismeri a PHP, a Twig, a Blade és a kikövetkeztetett sablonattribútum-struktúrák esetén. A meglévő projektek a csomag javítását a composer update blockstudio/phpstan segítségével kaphatják meg.