Dennis · 2026. április 10.
Blockstudio 7.2
A Blockstudio 7.2 két irányban is bővíti a keretrendszert.
Az első a láthatóság és a munkafolyamat egyetlen projekten belül: új adminisztrációs áttekintés, adatbázis-böngésző, adminisztrációs nyilvántartás-böngésző és SCSS előbeállítások a megosztott Sass beállításához.
A második a Blockstudio körüli ökoszisztéma: egy blokkok terjesztésére szolgáló nyilvántartás-CLI (a shadcn mintájára, WordPress-hez), valamint egy PHPStan kiterjesztés, amely TypeScript-szerű típusbiztonságot biztosít a sablonokhoz, blokkcímkékhez, db.php, rpc.php, cron.php és a kapcsolódó sém fájlokhoz.
Mindkét irány ugyanazt a célt szolgálja: megkönnyíteni a nagyobb Blockstudio projektek átlátását, továbbfejlesztését és megosztását.
Adminisztrációs felület
Két újdonság könnyíti meg a nagyobb projektek áttekintését a wp-adminon belül.
Adminisztrációs áttekintés
A Blockstudio mostantól a Eszközök > Blockstudio alatt adminisztrációs képernyőt biztosít. Egyetlen helyen tekintheti meg, mit regisztrált a rendszer a fájlrendszerből.
Az áttekintés külön lapokat tartalmaz a következőkhöz:
- Blokkok
- Kiterjesztések
- Mezők
- Oldalak
- Sémák
Az áttekintés mellett az adminisztrációs felület egy külön Adatbázisok részt is kapott. Itt minden regisztrált Blockstudio\Db séma listázható, és a tényleges rekordok közvetlenül a wp-adminban tekinthetők meg.
Egyéni panelrács helyett a képernyő natív WordPress DataViews táblázatokat használ. Így az UI összhangban marad a wp-adminnal, és több tucat vagy akár több száz regisztráció esetén is praktikus.
Kisebb telepítésnél fejben tarthatja a rendszer aktuális állapotát. Egy nagyobb kódbázisnál ez már nem működik. Ilyenkor ilyen kérdések merülnek fel:
- Jelenleg mely blokkok vannak ténylegesen regisztrálva?
- Mely kiterjesztések vonatkoznak a
core/*egészére, és melyek egyes blokkokra? - Mely oldalak vannak szinkronizálva, és melyik bejegyzéstípushoz tartoznak?
- Milyen újrafelhasználható mezők vannak a projektben?
- Mely sémák vannak regisztrálva, és milyen tárolási hátteret használnak?
Eddig erre csak mappák átnézésével, JSON fájlok megnyitásával és a PHP lépéseinek követésével lehetett választ kapni. Az áttekintés mindezt tényleges adminisztrációs felületté alakítja.
Az egyes lapok különböző kérdések megválaszolására szolgálnak:
- Blokkok: a regisztrált blokktípusok, megjelenítési mód, a API verziója és az attribútumok száma
- Kiterjesztések: a célzott blokkok, a prioritás és a megjelenítési részletek
- Mezők: az újrafelhasználható egyéni meződefiníciók gyors áttekintése
- Oldalak: a fájlalapú, szinkronizált oldalak bejegyzéstípussal, állapottal, sablonmotorral és szinkronizálási állapottal
- Sémák: a regisztrált tárolási sémák háttere, mezőinek száma és jogosultsági köre
Az adatbázis-böngésző szándékosan különálló az áttekintés kezdeti adatcsomagjától. Az oldal betöltésekor nem szerializál minden sort: először csak az elérhető sémákat tölti be, a rekordokat pedig igény szerint kéri le, amikor megnyit egy adatbázisfület. Így az adminfelület nagyobb adathalmazokkal rendelkező projektek esetén is használható marad a db.php mögött.
Ez az első verzió szándékosan a sémára épülő regisztrációkra összpontosít. Ez nem beállítási oldal, hanem ellenőrző oldal.
Ha egyáltalán nincs rá szüksége, teljesen letilthatja:
add_filter('blockstudio/admin/enabled', '__return_false');
Adminisztrációs regisztrációs böngésző
Az áttekintés mellett egy második fül is található: Registry. Ez a téma blocks.json fájljában beállított távoli blokkregiszterek böngészője, amely lehetővé teszi, hogy közvetlenül az WordPress adminfelületéről importáljon blokkokat egy CLI érintése nélkül.
{
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json",
"private": {
"url": "https://api.example.com/registry.json",
"headers": {
"Authorization": "Bearer ${REGISTRY_TOKEN}"
}
}
}
}
A böngésző lekéri az összes beállított regisztert, felsorolja az elérhető blokkokat, és jelzi, hogy azok már telepítve vannak-e helyben, vagy importálhatók. Minden sorban található egy Import gomb, amely letölti a blokkfájlokat a téma beállított könyvtárába. A már telepített blokkoknál ehelyett Újraimportálás gomb jelenik meg.
A hitelesített regiszterek is támogatottak a headers mezőt tartalmazó objektumformátummal, beleértve a ${ENV_VAR} behelyettesítését is, így a tokenek sosem kerülnek verziókezelésbe.
Így a regiszterek böngészése és használata az adminfelület szerves részévé válik, nem csupán egy CLI munkafolyamat.
Registry CLI
A regiszterek másik fontos eleme az önálló CLI: blockstudio/registry.
Ez egy shadcn-stílusú eszköz WordPress blokkokhoz. Nincs szükség npm csomagra vagy buildlépésre. Futtat egy parancsot, a blokk forráskódja bemásolódik a projektjébe, és teljes egészében az Öné lesz.
npx blockstudio init
npx blockstudio add ui/tabs
A CLI bármilyen blokktípussal működik: Blockstudio blokkokkal, @wordpress/create-block kimenettel és egyszerű PHP blokkokkal. A regisztert nem érdekli, mi van a mappában. Beolvassa a fájlmanifestet innen: registry.json, és pontosan azokat a fájlokat másolja át.
A blokk szerzői bármely URL helyen közzétehetnek egy registry.json-t (GitHub nyers tartalmat, S3-t vagy egy egyéni szervert), amely metaadatokkal, függőségekkel és fájllistákkal együtt felsorolja az elérhető blokkokat. A felhasználók hozzáadják a URL-t a blocks.json-jukhoz, majd név alapján letöltik a blokkokat.
A CLI a következőket támogatja:
- Függőségek feloldása: a blokkok más blokkoktól való függőségeket adhatnak meg, amelyeket a rendszer automatikusan old fel, a körkörös függőségek felismerésével
- Több regiszter közötti ütközések kezelése: ha ugyanaz a blokknév több regiszterben is megtalálható, a CLI felszólítja, hogy válasszon egyet
- Hitelesített regiszterek: bearer tokenek, alapvető hitelesítés és egyéni fejlécek környezeti változók behelyettesítésével
- Interaktív TUI: Ink használatával készült, pörgő jelzőkkel, választási lehetőségekkel és folyamatjelzőkkel
- Nem interaktív mód:
--yesjelző és automatikus tartalékmegoldás CI vagy csővezeték esetén - Keresés és listázás: regiszterek böngészése parancssorból
A csomag 130 tesztet tartalmaz a sémák, a függőségek feloldása, a HTTP lekérése, a fájlírás, az összes parancsfolyamat és az interaktív Ink UI ellenőrzésére.
A teljes dokumentáció itt található: blockstudio.dev/registry.
PHPStan-bővítmény
A másik nagy újdonság a blockstudio/phpstan: egy PHPStan-bővítmény, amely a Blockstudio felhasználóinak azt a típusbiztonságot nyújtja, amelyet a TypeScript fejlesztői elvárnak.
composer require --dev blockstudio/phpstan
A bővítmény elemzéskor beolvassa a projekt tényleges sémáit, és az így kapott típusokat visszaadja a PHPStan számára. Ez már lefedi a PHP sablonokat, a Twig-t, a Blade-t, a blokkcímkéket, a típusos adatbázis-rekordokat, a beállítási útvonalakat, a hookneveket, valamint a sémaellenőrzést a következőkben: block.json, field.json, bővítmény-JSON, page.json, db.php, rpc.php, cron.php és blockstudio.json.
Típusbiztos blokksablonok
A $a mezőeléréseit a kapcsolódó block.json alapján ellenőrzi a rendszer:
<?php
/** @var array<string, mixed> $a */
echo $a['title']; // OK
echo $a['cta']['href']; // OK
echo $a['typo']; // ERROR: Field "typo" does not exist in block.json (block: hero). Did you mean "title"?
Típusbiztos adatbázis-rekordok
A Db::get() a db.php séma alapján típusos példányt ad vissza. A rekord szerkezete a tényleges mezőkből épül fel:
return [
'storage' => 'table',
'fields' => [
'email' => ['type' => 'string', 'required' => true],
'name' => ['type' => 'string'],
],
];
$db = Db::get('mytheme/subscribers');
$record = $db->create(['email' => 'a@b.com']);
echo $record['email']; // PHPStan: string
echo $record['name']; // PHPStan: string|null
echo $record['typo']; // ERROR: Offset 'typo' does not exist on array{id: int, email: string, name: string|null}
Sémaellenőrzés
Az érvénytelen sémafájlokat már elemzéskor felismeri a rendszer: block.json, field.json, bővítmény-JSON, page.json, db.php, rpc.php, cron.php és blockstudio.json. A rendszer jelzi a hiányzó neveket, a hibás mezőtípusokat, a rosszul formázott definíciókat és az elavult rövid logikai értékeket ("tailwind": true a beágyazott objektum helyett), mindig megadva a forrásfájl pontos sorszámát.
Beállítási útvonalak ellenőrzése
A Settings::get() hívásokat a rendszer az ismert beállítási séma alapján ellenőrzi:
Settings::get('tailwind/enabled'); // OK, returns bool
Settings::get('tailwind/enabld'); // ERROR: Settings path "tailwind/enabld" is not a known Blockstudio setting. Did you mean "tailwind/enabled"?
Hooknevek ellenőrzése
Ugyanez vonatkozik a filter- és action-hookok nevére is:
add_filter('blockstudio/render', $cb); // OK
add_filter('blockstudio/rendrr', $cb); // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
A bővítmény a teljes Blockstudio nyilvános API-jához is biztosít stubokat: Db, Settings, Field_Registry, Build és globális segédfüggvények. Minden Blockstudio API-hoz kap automatikus kiegészítést és típusellenőrzést anélkül, hogy a fejlesztői gépén szükség lenne a bővítmény forráskódjára.
Kényelmesebb fejlesztés
A kiadást két kisebb, fejlesztést megkönnyítő újdonság teszi teljessé.
Globális SCSS előtöltések
A Blockstudio már támogatta a SCSS fordítását, de volt egy bosszantó akadály: a megosztott Sass beállítása.
Ha hozzá akart férni egy közös változó-, függvény- vagy mixinkészlethez, minden SCSS fájlba importálnia kellett őket. Ez hamar ismétlődővé válik, különösen nagyobb dizájnrendszerek vagy olyan Sass eszközkészletek esetén, mint a Bootstrap.
A 7.2 pontosan erre ad egy előtöltési hookot:
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
A meglévő blockstudio/assets/process/scss/import_paths szűrővel együtt egyszer definiálhat egy megosztott Sass felületet, amely minden lefordított fájlban elérhető.
Így a blokk stíluslapja a ténylegesen szükséges stílusokra összpontosíthat:
.hero {
@include media-breakpoint-up(lg) {
padding: 4rem;
}
}
Nem kell minden blokk erőforrásában újra importálni. Ez nem különleges módú „Bootstrap-támogatás”, hanem egy általános hook a projekt egészében megosztott Sass használatához, akár Bootstrap biztosítja, akár a saját belső eszközkészlete.
PHP-natív blokk-API-definíciók
A 7.2 egy opcionális, PHP-natív szintaxist is bevezet a teljes stacket lefedő blokk-API-khoz. A tömbök továbbra is az alapértelmezett és teljes mértékben támogatott formátumot jelentik. Semmit sem váltottunk le. Ha viszont a beágyazott konfigurációs tömbök helyett inkább elnevezett argumentumokat, enumokat és attribútumokat használna, mostantól ezt a stílust is választhatja.
A rpc.php esetében attribútumokkal ellátott metódusokat tartalmazó objektumot adjon vissza:
<?php
use Blockstudio\Attributes\Rpc;
use Blockstudio\Rpc\Access;
use Blockstudio\Rpc\Method;
return new class {
#[Rpc(access: Access::Session)]
public function subscribe(array $params): array {
return ['success' => true];
}
#[Rpc(name: 'status', methods: [Method::Get, Method::Post])]
public function getStatus(array $params): array {
return ['status' => 'ok'];
}
};
A cron.php esetében ugyanez a megközelítés a #[Cron] használatával működik:
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;
return new class {
#[Cron(schedule: Schedule::Hourly)]
public function heartbeat(): void {
}
};
A db.php esetében mostantól egy egyszerű builderréteg is rendelkezésre áll:
<?php
use Blockstudio\Db\Field;
use Blockstudio\Db\Schema;
use Blockstudio\Db\Storage;
return Schema::make(
storage: Storage::Table,
fields: [
'email' => Field::string(required: true, format: 'email'),
'active' => Field::boolean(default: false),
],
);
Ez jobb egyensúlyt teremt a nagyobb kódbázisokban. Ha szeretné, megtarthatja a tömbformátum egyszerűségét, de választhat egy könnyebben felfedezhető PHP felületet is, amikor egy blokk néhány mezőnél vagy végpontnál összetettebbé válik.
Miért jelentek meg együtt ezek az újdonságok?
Az adminisztrációs áttekintés, a regiszterböngésző, a regiszter-CLI és a PHPStan-bővítmény ugyanarra a kérdésre ad választ: hogyan tartható áttekinthető egy Blockstudio projekt, miközben növekszik?
Az adminisztrációs eszközök projektszinten segítenek: láthatóvá teszik, mi van regisztrálva, lehetővé teszik blokkok importálását a regiszterekből, és csökkentik a találgatást.
A CLI ökoszisztéma-szinten ad választ: lehetővé teszi a blokkok projektek és csapatok közötti megosztását anélkül, hogy npm csomagokba kellene őket foglalni, vagy a buildrendszerekkel kellene küzdeni.
A PHPStan-bővítmény kódszinten segít: már futás előtt felismeri a hibás mezőeléréseket, a sémák elgépeléseit és a hibás hook-visszahívásokat.
Általánosságban ez a 7.2 iránya: kevesebb találgatás és ismétlődés, jobb átláthatóság, valamint most már tényleges típusbiztonság.
Hibajavítások
- Classes mező: a felhasználó által megadott egyéni osztálynevek elmosáskor észrevétlenül elvesztek, mert az ellenőrző csak az előre meghatározott Tailwind/beállításlistából fogadott el osztályokat. Mostantól bármilyen nem üres karakterláncot elfogad.
- Attributes mező: egy attribútumpár eltávolításakor
nullbejegyzések maradtak a mentett adatokban. A lodashunset()helyettsplice()használatára tértünk át, amely eltávolítja az elemeket a tömbből. - CSS minifier: a TailwindPHP minifier eltávolította a szóközöket a
+körül acalc()ésclamp()elemekben, így érvénytelen CSS keletkezett, példáulcalc(1rem+0.5vw). A hibát a TailwindPHP v1.3.1 javította: mélységérzékeny karakterbejárással csak a 0 zárójelmélységen lévő szelektorkombinátorok körüli szóközöket távolítja el. - Blokkbeszúró előnézete: a
$isPreviewmindigfalsevolt a Blokkbeszúró előnézetében, mert a renderelési gyorsítótár kulcsának hash-e nem tartalmazta a renderelési módot. A szerkesztő és az előnézet renderelése most külön gyorsítótár-bejegyzéseket kap. - Beágyazott InnerBlocks-sablon: a
<InnerBlocks template="..."/>komponens elhagyta a sablon-tuple-ök 3. elemét (a gyermekeket), például a['core/group', {}, [['core/paragraph']]]esetében, így üres tárolóblokkok jöttek létre. Mostantól megőrzi a beágyazott gyermekeket.