Ugrás a tartalomhoz

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:

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

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

Shell
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: --yes jelző é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.

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

PHP
return [
  'storage' => 'table',
  'fields' => [
    'email' => ['type' => 'string', 'required' => true],
    'name'  => ['type' => 'string'],
  ],
];
PHP
$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:

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

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

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

Scss
.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
<?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
<?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
<?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 null bejegyzések maradtak a mentett adatokban. A lodash unset() helyett splice() 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 a calc() és clamp() elemekben, így érvénytelen CSS keletkezett, például calc(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 $isPreview mindig false volt 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.