Pāriet uz saturu

Dennis · 2026. gada 10. aprīlis

Blockstudio 7.2

Blockstudio 7.2 paplašina ietvaru divos virzienos vienlaikus.

Pirmais virziens ir pārskatāmība un darbplūsma vienā projektā: jauns administrēšanas pārskats, datubāzu pārlūks, administrēšanas reģistra pārlūks un SCSS priekšiestatījumi koplietotai Sass iestatīšanai.

Otrais virziens ir ekosistēma ap Blockstudio: reģistrs CLI bloku izplatīšanai (līdzīgi kā shadcn priekš WordPress) un PHPStan paplašinājums, kas nodrošina TypeScript raksturīgo tipdrošību veidnēs, bloku tagos, db.php, rpc.php, cron.php un saistītajos shēmu failos.

Abu virzienu mērķis ir viens: atvieglot lielāku Blockstudio projektu izpratni, pilnveidošanu un kopīgošanu.

Administrēšanas vide

Divi jaunumi atvieglo navigāciju lielākā projektā wp-admin vidē.

Administrēšanas pārskats

Blockstudio tagad ietver administrēšanas ekrānu sadaļā Rīki > Blockstudio. Tas sniedz vienu vietu, kur pārbaudīt, ko sistēma ir reģistrējusi no failu sistēmas.

Pārskatā ir atsevišķas cilnes:

  • Bloki
  • Paplašinājumi
  • Lauki
  • Lapas
  • Shēmas

Līdztekus pārskatam administrēšanas apgabalā tagad ir arī atsevišķa sadaļa Datubāzes. Tajā uzskaitītas visas reģistrētās Blockstudio\Db shēmas, un tajā var pārbaudīt ierakstus tieši wp-admin vidē.

Tā vietā, lai veidotu pielāgotu paneļu režģi, ekrānā tiek izmantotas WordPress DataViews tabulas. Tādējādi UI saskan ar wp-admin vidi, un tas ir praktiski arī projektos ar desmitiem vai simtiem reģistrāciju.

Nelielā instalācijā varat paturēt izpildlaika stāvokli prātā. Lielākā koda bāzē tas vairs nedarbojas. Rodas tādi jautājumi kā:

  • Kuri bloki pašlaik ir reģistrēti?
  • Kuri paplašinājumi ir paredzēti core/*, bet kuri — atsevišķiem blokiem?
  • Kuras lapas ir sinhronizētas, un kuriem ierakstu veidiem tās pieder?
  • Kādi atkārtoti izmantojami lauki ir šajā projektā?
  • Kuras shēmas ir reģistrētas, un kādu krātuves aizmugursistēmu tās izmanto?

Līdz šim atbildi varēja atrast, pārlūkojot mapes, atverot JSON failus un izsekojot PHP darbību. Pārskats to pārvērš par atsevišķu administrēšanas saskarni.

Katra cilne ir veidota, lai palīdzētu atbildēt uz dažādiem jautājumiem:

  • Bloki parāda reģistrētos bloku tipus, renderēšanas režīmu, API versiju un atribūtu skaitu
  • Paplašinājumi parāda, kuriem blokiem tie ir paredzēti, kā arī prioritāti un renderēšanas informāciju
  • Lauki sniedz ātru pārskatu par atkārtoti izmantojamām pielāgotu lauku definīcijām
  • Lapas parāda sinhronizētas, no failiem veidotas lapas, to ieraksta tipu, statusu, veidņu dzinēju un sinhronizācijas stāvokli
  • Shēmas parāda reģistrētās krātuves shēmas, to aizmugursistēmu, lauku skaitu un iespēju tvērumu

Datu bāzes pārlūks ir apzināti nodalīts no sākotnējās pārskata ielādes datiem. Tā vietā, lai lapas ielādes laikā serializētu visas rindas, tas sākumā tikai ielādē pieejamo shēmu nosaukumus un izgūst ierakstus pēc pieprasījuma, kad atverat datu bāzes cilni. Tādējādi administrēšanas sadaļa ir noderīga arī tad, ja projektā ir lielākas datu kopas aiz db.php.

Šī pirmā versija ir apzināti vērsta uz shēmās balstītām reģistrācijām. Tā nav iestatījumu lapa. Tā ir pārbaudes lapa.

Ja nevēlaties to izmantot, pilnībā atspējojiet:

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

Administrēšanas reģistru pārlūks

Līdzās pārskatam ir otra cilne: Reģistrs. Tas ir pārlūks attāliem bloku reģistriem, kas konfigurēti jūsu tēmas blocks.json, un ļauj importēt blokus tieši no WordPress administrēšanas sadaļas, nepieskaroties CLI.

JSON
{
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json",
    "private": {
      "url": "https://api.example.com/registry.json",
      "headers": {
        "Authorization": "Bearer ${REGISTRY_TOKEN}"
      }
    }
  }
}

Pārlūks izgūst katru konfigurēto reģistru, uzskaita visus pieejamos blokus un parāda, vai tie jau ir instalēti lokāli vai ir pieejami importēšanai. Katrā rindā ir poga Importēt, kas lejupielādē bloka failus jūsu tēmā konfigurētajā direktorijā. Jau instalētiem blokiem tās vietā ir poga Importēt atkārtoti.

Tiek atbalstīti autentificēti reģistri, izmantojot objektu formātu ar headers, tostarp ${ENV_VAR} interpolāciju, lai pilnvaras nenonāktu versiju kontrolē.

Tādējādi reģistru pārlūkošana un izmantošana kļūst par pilnvērtīgu administrēšanas pieredzi, nevis tikai CLI darba plūsmu.

Reģistra CLI

Otra reģistru stāsta daļa ir atsevišķs CLI: blockstudio/registry.

Tas ir shadcn tipa rīks WordPress blokiem. Nav npm pakotnes un nav jāveic būvēšana. Jūs palaižat komandu, bloka pirmkods tiek nokopēts jūsu projektā, un tas pilnībā pieder jums.

Apvalks
npx blockstudio init
npx blockstudio add ui/tabs

CLI darbojas ar jebkura veida blokiem: Blockstudio blokiem, @wordpress/create-block izvadi un parastiem PHP blokiem. Reģistram nav svarīgi, kas atrodas mapē. Tas nolasa failu manifestu no registry.json un nokopē tieši tajā norādītos failus.

Bloku autori publicē registry.json jebkurā URL (GitHub neapstrādātā saturā, S3 vai pielāgotā serverī), kurā uzskaitīti pieejamie bloki, to metadati, atkarības un failu saraksti. Lietotāji pievieno URL savam blocks.json un iegūst blokus pēc nosaukuma.

CLI atbalsta:

  • Atkarību atrisināšana: bloki var deklarēt atkarības no citiem blokiem, kas tiek atrisinātas automātiski, nosakot ciklus
  • Konfliktu risināšana vairākos reģistros: ja vienāds bloka nosaukums ir vairākos reģistros, CLI piedāvā izvēlēties vienu
  • Autentificēti reģistri: nesēja pilnvaras, pamata autentifikācija un pielāgotas galvenes ar vides mainīgo interpolāciju
  • Interaktīva TUI: veidota ar Ink, ar ielādes indikatoriem, izvēles uzvednēm un progresa rādītājiem
  • Neinteraktīvs režīms: karodziņš --yes un automātiska pāreja, palaižot CI vidē vai izmantojot konveijeru
  • Meklēšana un uzskaitīšana: pārlūkojiet reģistrus komandrindā

Pakotnē ir 130 testi, kas aptver shēmas, atkarību atrisināšanu, HTTP datu izgūšanu, failu rakstīšanu, visu komandu darbību un interaktīvo Ink UI.

Pilna dokumentācija: blockstudio.dev/registry.

PHPStan paplašinājums

Otrs lielais papildinājums ir blockstudio/phpstan: PHPStan paplašinājums, kas Blockstudio lietotājiem nodrošina tādu tipu drošību, kādu sagaida TypeScript izstrādātāji.

Apvalks
composer require --dev blockstudio/phpstan

Paplašinājums analīzes laikā nolasa jūsu projekta faktiskās shēmas un nodod iegūtos tipus atpakaļ uz PHPStan. Tagad tas aptver PHP veidnes, Twig, Blade, bloku tagus, tipizētus datu bāzes ierakstus, iestatījumu ceļus, āķu nosaukumus un shēmu validāciju block.json, field.json, paplašinājuma JSON, page.json, db.php, rpc.php, cron.php un blockstudio.json.

Bloku veidnes ar tipu drošību

Lauku piekļuves $a tiek validētas pret blakus esošo block.json:

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"?

Datu bāzes ieraksti ar tipu drošību

Db::get() atgriež tipizētu instanci, kas balstīta uz jūsu db.php shēmu. Ieraksta struktūra tiek veidota no faktiskajiem laukiem:

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}

Shēmas validācija

Nederīgi shēmu faili tiek atklāti analīzes laikā: block.json, field.json, paplašinājuma JSON, page.json, db.php, rpc.php, cron.php un blockstudio.json. Tiek ziņots par trūkstošiem nosaukumiem, nepareiziem lauku tipiem, kļūdainām definīcijām, novecojušām saīsinātām Būla vērtībām ("tailwind": true ligzdotā objekta vietā), norādot precīzu rindu avota failā.

Iestatījumu ceļu validācija

Settings::get() izsaukumi tiek validēti pret zināmo iestatījumu shēmu:

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"?

Āķu nosaukumu validācija

Tas pats attiecas uz filtru un darbību āķu nosaukumiem:

PHP
add_filter('blockstudio/render', $cb);  // OK
add_filter('blockstudio/rendrr', $cb);  // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?

Paplašinājumā ir arī iekļautas stublāju deklarācijas visai Blockstudio publiskajai API saskarnei: Db, Settings, Field_Registry, Build un globālajām palīgfunkcijām. Varat izmantot automātisko pabeigšanu un tipu pārbaudi visām Blockstudio API, bez spraudņa pirmkoda savā izstrādes datorā.

Ērtāka izstrāde

Izlaidumu papildina divi mazāki izstrādes atvieglojumi.

Globālie SCSS priekšteksti

Blockstudio jau atbalstīja SCSS kompilēšanu, taču bija viens kaitinošs šķērslis: koplietojamās Sass konfigurēšana.

Ja vēlējāties piekļuvi kopīgam mainīgo, funkciju vai miksinu kopumam, tie bija jāimportē katrā SCSS failā. Tas ātri kļūst vienmuļi, īpaši lielākās dizaina sistēmās vai Sass rīku komplektos, piemēram, Bootstrap.

Versijā 7.2 tam pievienots priekšteksta āķis:

PHP
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);

Apvienojot ar esošo blockstudio/assets/process/scss/import_paths filtru, koplietojamo Sass vidi definējat vienreiz, un tā ir pieejama katram kompilētajam failam.

Bloka stilu lapā var koncentrēties uz vajadzīgajiem stiliem:

Scss
.hero {
  @include media-breakpoint-up(lg) {
    padding: 4rem;
  }
}

Vairs nav jāatkārto importi katrā bloka resursā. Tā nav īpašā režīma “Bootstrap atbalsts”. Tas ir vispārīgs āķis koplietojamām Sass visā projektā — neatkarīgi no tā, vai tās nāk no Bootstrap vai jūsu iekšējā rīku komplekta.

PHP dzimtā bloku API definēšana

Versijā 7.2 pievienota arī izvēles sintakse, kas ir PHP dzimtā un paredzēta pilna steka bloku API. Masīvi joprojām ir noklusējuma variants un tiek pilnībā atbalstīti. Nekas nav aizstāts. Taču, ja dodat priekšroku nosauktiem argumentiem, enum tipiem un atribūtiem, nevis ligzdotiem konfigurācijas masīviem, tagad varat izvēlēties šo stilu.

rpc.php gadījumā atgrieziet objektu ar metodēm, kam pievienoti atribūti:

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'];
    }
};

cron.php gadījumā tā pati pieeja darbojas ar #[Cron]:

PHP
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;

return new class {
    #[Cron(schedule: Schedule::Hourly)]
    public function heartbeat(): void {
    }
};

Savukārt db.php gadījumā tagad ir pieejams neliels būvētāja slānis:

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),
    ],
);

Lielākām kodu bāzēm tas nodrošina labāku līdzsvaru. Kad vēlaties, varat saglabāt masīvu formāta vienkāršību, bet, blokam pārsniedzot dažus laukus vai galapunktus, pāriet uz pārskatāmāku PHP saskarni.

Kāpēc šie papildinājumi izlaisti kopā

Administrēšanas pārskats, reģistru pārlūks, reģistra CLI un PHPStan paplašinājums atbild uz vienu un to pašu jautājumu: kā saglabāt Blockstudio projekta pārskatāmību, tam augot?

Administrēšanas rīki palīdz to panākt projekta līmenī: sniedz pārskatu par reģistrēto, ļauj pievienot blokus no reģistriem un samazina minēšanu.

CLI palīdz to panākt ekosistēmas līmenī: ļauj koplietot blokus starp projektiem un komandām, neiekļaujot tos npm pakotnēs un necīnoties ar būvēšanas sistēmām.

PHPStan paplašinājums palīdz to panākt koda līmenī: atklāj nepareizu piekļuvi laukiem, kļūdas shēmās un bojātus āķu atzvanus, pirms tie nonāk izpildes vidē.

Tāds kopumā ir 7.2 virziens: mazāk minēšanas un atkārtošanās, labāka pārskatāmība un tagad arī tipu drošība.

Kļūdu labojumi

  • Lauku klases: lietotāja ievadītie pielāgotie klašu nosaukumi pēc fokusa zaudēšanas tika klusi atmesti, jo validētājs pieņēma tikai klases no iepriekš definētā Tailwind/iestatījumu saraksta. Tagad tiek pieņemta jebkura virkne, kas nav tukša.
  • Atribūtu lauks: noņemot atribūtu pāri, saglabātajos datos palika null ieraksti. Lodash unset() (kas masīva elementus aizstāj ar null vērtībām) tika nomainīts pret splice() (kas tos noņem).
  • CSS minifikators: TailwindPHP minifikators noņēma atstarpes ap +, kas atrodas calc() un clamp(), radot nederīgus CSS, piemēram, calc(1rem+0.5vw). Labojums veikts augšupējā projektā TailwindPHP v1.3.1, izmantojot dziļumu ņemošu vērā rakstzīmju apstrādi, kas noņem atstarpes ap atlasītāju kombinatoriem tikai tad, ja iekavu dziļums ir 0.
  • Bloku ievietotāja priekšskatījums: bloku ievietotāja priekšskatījumā $isPreview vienmēr bija false, jo renderēšanas kešatmiņas jaucējatslēgā nebija iekļauts renderēšanas režīms. Redaktora un priekšskatījuma renderējumi tagad tiek glabāti atsevišķos kešatmiņas ierakstos.
  • Ligzdota InnerBlocks veidne: komponents <InnerBlocks template="..."/> no veidņu kortežiem, piemēram, ['core/group', {}, [['core/paragraph']]], izmeta trešo elementu (bērnelementus), tādējādi konteineru bloki bija tukši. Tagad ligzdotie bērnelementi tiek saglabāti.