Dennis · 10. april 2026
Blockstudio 7.2
Blockstudio 7.2 razširja ogrodje v dveh smereh hkrati.
Prva smer je preglednost in potek dela znotraj posameznega projekta: nov pregled skrbniškega vmesnika, brskalnik podatkovnih zbirk, brskalnik registra skrbniškega vmesnika in uvodne datoteke SCSS za skupno nastavitev Sass.
Druga smer je ekosistem okrog Blockstudio: register CLI za distribucijo blokov (kot shadcn za WordPress) in razširitev PHPStan, ki predlogam, oznakam blokov, db.php, rpc.php, cron.php ter povezanim datotekam sheme prinaša tipsko varnost v slogu TypeScript.
Obe smeri se osredotočata na isto: olajšati razumevanje, nadgrajevanje in deljenje večjih projektov Blockstudio.
Skrbniški vmesnik
Dodatka olajšata krmarjenje po večjem projektu v skrbniškem vmesniku wp-admin.
Pregled skrbniškega vmesnika
Blockstudio zdaj vključuje skrbniški zaslon v razdelku Orodja > Blockstudio. Omogoča pregled, kaj je sistem registriral iz datotečnega sistema, na enem mestu.
Pregled vključuje namenske zavihke za:
- Bloki
- Razširitve
- Polja
- Strani
- Sheme
Poleg tega pregleda skrbniško območje zdaj vključuje namenski razdelek Podatkovne zbirke. V njem so navedene vse registrirane sheme Blockstudio\Db, dejanske zapise pa lahko pregledate neposredno v wp-admin.
Namesto lastne mreže plošč zaslon uporablja izvorne tabele DataViews WordPress. Tako ostane UI usklajen s skrbniškim vmesnikom wp-admin, rešitev pa je uporabna tudi, ko ima projekt več deset ali sto registracij.
Pri majhni namestitvi si lahko izvajalno stanje zapomnite. Pri večji kodni zbirki to ni več mogoče. Začnete si postavljati vprašanja, kot so:
- Kateri bloki so trenutno dejansko registrirani?
- Katere razširitve ciljajo na
core/*in katere na posamezne bloke? - Katere strani so sinhronizirane in katerim vrstam objav pripadajo?
- Katera polja za večkratno uporabo so na voljo v tem projektu?
- Katere sheme so registrirane in katero zaledje za shranjevanje uporabljajo?
Doslej je bilo treba za odgovor prebirati mape in datoteke JSON ter slediti izvajalnemu okolju PHP. Pregled te informacije zdaj prikazuje neposredno v skrbniškem vmesniku.
Vsak zavihek je zasnovan tako, da odgovarja na drugačna vprašanja:
- Bloki prikazujejo registrirane vrste blokov, način upodabljanja, različico API in število atributov
- Razširitve prikazujejo ciljne bloke, njihovo prednostno raven in podrobnosti upodabljanja
- Polja omogočajo hiter pregled definicij polj po meri za večkratno uporabo
- Strani prikazujejo sinhronizirane strani iz datotek, skupaj z vrsto objave, stanjem, pogonom predlog in stanjem sinhronizacije
- Sheme prikazujejo registrirane sheme shrambe, njihovo zaledje, število polj in obseg zmogljivosti
Brskalnik zbirk podatkov je namenoma ločen od začetnega preglednega tovora. Namesto da bi ob nalaganju strani serializiral vsako vrstico, vnaprej lokalizira le razpoložljive sheme, zapise pa pridobi na zahtevo, ko odprete zavihek zbirke podatkov. Tako skrbniški vmesnik ostane uporaben tudi pri projektih z večjimi nabori podatkov za db.php.
Ta prva različica je namenoma osredotočena na registracije, podprte s shemami. To ni stran z nastavitvami. To je stran za pregled.
Če ga sploh ne želite, ga v celoti onemogočite:
add_filter('blockstudio/admin/enabled', '__return_false');
Brskalnik skrbniškega registra
Ob pregledu je še en zavihek: Register. Gre za brskalnik oddaljenih registrov blokov, nastavljenih v blocks.json vaše teme, ki vam omogoča uvoz blokov neposredno iz skrbniškega vmesnika WordPress, ne da bi se dotaknili datoteke CLI.
{
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json",
"private": {
"url": "https://api.example.com/registry.json",
"headers": {
"Authorization": "Bearer ${REGISTRY_TOKEN}"
}
}
}
}
Brskalnik pridobi vsak nastavljen register, prikaže vse razpoložljive bloke ter pokaže, ali so že nameščeni lokalno ali jih je mogoče uvoziti. Vsaka vrstica ima gumb »Uvozi«, ki prenese datoteke bloka v nastavljeni imenik vaše teme. Za že nameščene bloke se namesto tega prikaže gumb »Znova uvozi«.
Podprti so tudi registri z avtentikacijo prek oblike objekta z headers, vključno z interpolacijo ${ENV_VAR}, tako da žetoni nikoli ne končajo v sistemu za nadzor različic.
Tako je brskanje po registrih in njihova uporaba polnopravna izkušnja v skrbniškem vmesniku, ne zgolj potek dela prek CLI.
Register CLI
Druga polovica zgodbe o registrih je samostojen CLI: blockstudio/registry.
To je orodje v slogu shadcn za bloke WordPress. Brez paketa npm in brez koraka gradnje. Zaženete ukaz, izvorna koda bloka se kopira v vaš projekt in je v celoti vaša.
npx blockstudio init
npx blockstudio add ui/tabs
CLI deluje z vsemi vrstami blokov: bloki Blockstudio, izhod @wordpress/create-block in navadni bloki PHP. Registru ni mar, kaj je v mapi. Prebere manifest datotek iz registry.json in kopira natanko te datoteke.
Avtorji blokov objavijo registry.json na poljubnem URL (GitHub surova vsebina, S3 ali strežnik po meri), ki navaja razpoložljive bloke z metapodatki, odvisnostmi in seznami datotek. Uporabniki dodajo URL v svoj blocks.json in pridobijo bloke po imenu.
CLI podpira:
- Razreševanje odvisnosti: bloki lahko navedejo odvisnosti od drugih blokov, ki se samodejno razrešijo z zaznavanjem ciklov
- Obravnava konfliktov med več registri: ko se isto ime bloka pojavi v več registrih, vas CLI pozove, da izberete enega
- Registri z avtentikacijo: žetone bearer, osnovno avtentikacijo in glave po meri z interpolacijo spremenljivk okolja
- Interaktivni TUI: zgrajen z Ink, s kazalniki dejavnosti, pozivi za izbiro in kazalniki napredka
- Neinteraktivni način: zastavica
--yesin samodejni nadomestni način za CI oziroma preusmerjene tokove - Iskanje in seznam: brskanje po registrih iz ukazne vrstice
Paket vključuje teste 130, ki pokrivajo sheme, razreševanje odvisnosti, pridobivanje HTTP, zapisovanje datotek, vse poteke ukazov in interaktivni UI v Ink.
Celotna dokumentacija je na voljo na Dokumentacija/registryblockstudio.dev.
Razširitev PHPStan
Druga velika novost je blockstudio/phpstan: razširitev PHPStan, ki uporabnikom Blockstudio zagotavlja varnost tipov, kakršno pričakujejo razvijalci TypeScript.
composer require --dev blockstudio/phpstan
Razširitev med analizo prebere dejanske sheme vašega projekta in dobljene tipe posreduje nazaj v PHPStan. Zdaj to zajema predloge PHP, Twig, Blade, oznake blokov, tipizirane zapise zbirk podatkov, poti nastavitev, imena kavljev in preverjanje shem v block.json, field.json, razširitvi JSON, page.json, db.php, rpc.php, cron.php in blockstudio.json.
Predloge blokov z varnostjo tipov
Dostopi do polj na $a se preverjajo glede na sorodni block.json:
<?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"?
Zapisi zbirk podatkov z varnostjo tipov
Db::get() vrne tipiziran primerek na podlagi vaše sheme db.php. Oblika zapisa je sestavljena iz dejanskih polj:
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}
Preverjanje shem
Neveljavne datoteke shem se zaznajo med analizo: block.json, field.json, razširitev JSON, page.json, db.php, rpc.php, cron.php in blockstudio.json. Manjkajoča imena, napačni tipi polj, nepravilno oblikovane definicije in zastarele skrajšane logične vrednosti ("tailwind": true namesto ugnezdenega objekta) so vse prijavljene z natančno številko vrstice v izvorni datoteki.
Preverjanje poti nastavitev
Klici Settings::get() se preverjajo glede na znano shemo nastavitev:
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"?
Preverjanje imen kavljev
Enako velja za imena kavljev filtrov in dejanj:
add_filter('blockstudio/render', $cb); // OK
add_filter('blockstudio/rendrr', $cb); // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
Razširitev vključuje tudi nadomestne definicije za celoten javni Blockstudio API: Db, Settings, Field_Registry, Build in globalne pomočnike. Za vse API-je Blockstudio dobite samodokončanje in preverjanje tipov, ne da bi na svojem razvojnem računalniku potrebovali izvorno kodo vtičnika.
Pripomočki za avtorje
Izdajo dopolnjujeta dva manjša pripomočka za avtorje.
Globalni uvodni bloki SCSS
Blockstudio je že podpiral prevajanje SCSS, vendar je ostalo eno nadležno ozko grlo: skupna nastavitev Sass.
Če ste želeli dostop do nabora skupnih spremenljivk, funkcij ali mešanic, ste jih morali uvoziti v vsako datoteko SCSS. To hitro postane ponavljajoče, zlasti pri večjih oblikovalskih sistemih ali zbirkah orodij Sass, kot je Bootstrap.
Različica 7.2 dodaja kljuko za uvodni blok, namenjeno prav temu:
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
V kombinaciji z obstoječim filtrom blockstudio/assets/process/scss/import_paths enkrat določite skupno površino Sass, ki je nato na voljo vsem prevedenim datotekam.
Slogovna datoteka bloka se lahko osredotoča na sloge, ki jih dejansko potrebuje:
.hero {
@include media-breakpoint-up(lg) {
padding: 4rem;
}
}
Brez ponavljajočih se uvozov v vseh datotekah sredstev blokov. To ni »podpora za Bootstrap« kot poseben način. Gre za splošno kljuko za skupni Sass v projektu, ne glede na to, ali prihaja iz Bootstrap ali vašega lastnega internega nabora orodij.
Definicije blokov, izvorno za PHP API
Različica 7.2 dodaja tudi izbirno sintakso, izvorno za PHP, za API-je blokov za celoten sklad. Polja ostajajo privzeta in v celoti podprta. Nič ni bilo zamenjano. Če pa imate raje poimenovane argumente, naštete vrednosti in atribute kot ugnezdena polja nastavitev, se zdaj lahko odločite za ta slog.
Za rpc.php vrnite objekt z metodami, opremljenimi z atributi:
<?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'];
}
};
Za cron.php enaka zamisel deluje z #[Cron]:
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;
return new class {
#[Cron(schedule: Schedule::Hourly)]
public function heartbeat(): void {
}
};
Za db.php je zdaj na voljo tudi preprosta plast za sestavljanje:
<?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),
],
);
To zagotavlja boljše ravnovesje za večje kodne zbirke. Po želji ohranite preprostost oblike polj, ko pa blok preraste nekaj polj ali končnih točk, lahko preklopite na bolj pregledno površino PHP.
Zakaj so te novosti izdane skupaj
Skrbniški pregled, brskalnik registrov, register CLI in razširitev PHPStan so odgovori na isto vprašanje: kako ohraniti razumljivost projekta Blockstudio, ko raste?
Skrbniška orodja odgovarjajo na ravni projekta: pregled nad tem, kaj je registrirano, možnost pridobivanja blokov iz registrov in manj ugibanja.
CLI odgovarja na ravni ekosistema: omogoča skupno rabo blokov med projekti in ekipami, ne da bi jih združevali v pakete npm ali se borili s sistemi za gradnjo.
Razširitev PHPStan odgovarja na ravni kode: napačne dostope do polj, tipkarske napake v shemah in pokvarjene povratne klice kavljev zazna, še preden pridejo do izvajanja.
To je splošna usmeritev različice 7.2: manj ugibanja, manj ponavljanja, boljši pregled in zdaj tudi prava varnost tipov.
Popravki napak
- Polje »Classes«: uporabniško vnesena imena razredov so bila ob izgubi fokusa tiho zavržena, ker je validator sprejemal le razrede s seznama Tailwind/nastavitev. Zdaj sprejme vsak neprazen niz.
- Polje »Attributes«: odstranitev para atributov je v shranjenih podatkih pustila vnose
null. lodashunset()(ki elemente polja nastavi na null) smo zamenjali zsplice()(ki jih odstrani). - Minifikator CSS: minifikator TailwindPHP je odstranil presledke okoli
+znotrajcalc()inclamp(), zaradi česar je nastal neveljaven CSS, kot jecalc(1rem+0.5vw). Napaka je bila odpravljena v izvorni kodi TailwindPHP v1.3.1 z obhodom znakov, ki upošteva globino in odstrani le presledke okoli kombinatorjev izbirnikov pri globini oklepajev 0. - Predogled vstavljalnika blokov:
$isPreviewje bil v predogledu vstavljalnika blokov vednofalse, ker predpomnilniški ključ zgoščene vrednosti za upodabljanje ni vključeval načina upodabljanja. Upodobitve v urejevalniku in predogledu imajo zdaj ločene vnose v predpomnilniku. - Ugnezdena predloga InnerBlocks: komponenta
<InnerBlocks template="..."/>je iz trojčkov predlog, kot je['core/group', {}, [['core/paragraph']]], izpustila tretji element (otroke), zaradi česar so nastali prazni bloki vsebnikov. Zdaj ohranja ugnezdene otroke.