Dennis · 10 kwietnia 2026
Blockstudio 7.2
Blockstudio 7.2 rozwija framework w dwóch kierunkach jednocześnie.
Pierwszy dotyczy widoczności i przepływu pracy w ramach jednego projektu: nowy przegląd administracyjny, przeglądarka bazy danych, przeglądarka rejestru administracyjnego oraz SCSS preludia do współdzielonej konfiguracji Sass.
Drugi dotyczy ekosystemu wokół Blockstudio: rejestru CLI do dystrybucji bloków (jak shadcn dla WordPress) oraz rozszerzenia PHPStan, które zapewnia szablonom, tagom bloków, db.php, rpc.php, cron.php i powiązanym plikom schematów bezpieczeństwo typów znane z TypeScript.
Oba kierunki mają wspólny cel: ułatwić analizowanie większych projektów Blockstudio, ich rozwijanie i udostępnianie.
Obsługa administracyjna
Dwa dodatki ułatwiają poruszanie się po większym projekcie w panelu administracyjnym.
Przegląd administracyjny
Blockstudio zawiera teraz ekran administracyjny dostępny w menu Narzędzia > Blockstudio. To jedno miejsce, w którym można sprawdzić, co system zarejestrował w systemie plików.
Przegląd zawiera osobne karty dla:
- Bloki
- Rozszerzenia
- Pola
- Strony
- Schematy
Obok przeglądu w obszarze administracyjnym pojawiła się osobna sekcja Bazy danych. Zawiera listę wszystkich zarejestrowanych schematów Blockstudio\Db i umożliwia przeglądanie rzeczywistych rekordów bezpośrednio w panelu administracyjnym.
Zamiast tworzyć własną siatkę paneli, ekran korzysta z natywnych tabel DataViews WordPress. Dzięki temu UI jest spójny z panelem administracyjnym i praktyczny w projektach z dziesiątkami lub setkami rejestracji.
Przy małej instalacji możesz pamiętać stan środowiska wykonawczego. W większej bazie kodu przestaje to działać. Pojawiają się pytania takie jak:
- Które bloki są obecnie zarejestrowane?
- Które rozszerzenia dotyczą
core/*, a które poszczególnych bloków? - Które strony są synchronizowane i do jakich typów wpisów należą?
- Jakie pola wielokrotnego użytku istnieją w tym projekcie?
- Które schematy są zarejestrowane i z jakiego zaplecza pamięci masowej korzystają?
Do tej pory odpowiedź wymagała jakiejś kombinacji przeglądania folderów, otwierania plików JSON i analizowania PHP. Przegląd zamienia to w rzeczywisty panel administracyjny.
Każda karta odpowiada na inne pytania:
- Bloki pokazują zarejestrowane typy bloków, tryb renderowania, wersję API i liczbę atrybutów
- Rozszerzenia pokazują, których bloków dotyczą, a także priorytet i szczegóły renderowania
- Pola zapewniają szybki przegląd definicji wielokrotnego użytku pól własnych
- Strony pokazują synchronizowane strony oparte na plikach, wraz z typem wpisu, statusem, silnikiem szablonów i stanem synchronizacji
- Schematy pokazują zarejestrowane schematy pamięci masowej wraz z zapleczem, liczbą pól i zakresem uprawnień
Przeglądarka baz danych jest celowo oddzielona od początkowego ładunku przeglądu. Zamiast serializować każdy wiersz przy ładowaniu strony, na początku lokalizuje tylko dostępne schematy i pobiera rekordy na żądanie po otwarciu karty bazy danych. Dzięki temu panel administracyjny pozostaje użyteczny nawet wtedy, gdy projekt zawiera większe zbiory danych za db.php.
Ta pierwsza wersja celowo koncentruje się na rejestracjach opartych na schematach. To nie jest strona ustawień. To strona inspekcji.
Jeśli w ogóle tego nie chcesz, całkowicie to wyłącz:
add_filter('blockstudio/admin/enabled', '__return_false');
Przeglądarka rejestru w panelu administracyjnym
Obok przeglądu znajduje się druga karta: Rejestr. To przeglądarka zdalnych rejestrów bloków skonfigurowanych w blocks.json motywu. Umożliwia importowanie bloków bezpośrednio z panelu administracyjnego WordPress bez dotykania CLI.
{
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json",
"private": {
"url": "https://api.example.com/registry.json",
"headers": {
"Authorization": "Bearer ${REGISTRY_TOKEN}"
}
}
}
}
Przeglądarka pobiera dane z każdego skonfigurowanego rejestru, wyświetla wszystkie dostępne bloki i pokazuje, czy dany blok jest już zainstalowany lokalnie, czy można go zaimportować. Każdy wiersz ma przycisk Importuj, który pobiera pliki bloku do skonfigurowanego katalogu motywu. Zamiast niego przy już zainstalowanych blokach pojawia się przycisk Importuj ponownie.
Obsługiwane są uwierzytelnione rejestry w formacie obiektu z headers, w tym interpolacja ${ENV_VAR}, dzięki czemu tokeny nigdy nie trafiają do kontroli wersji.
Dzięki temu przeglądanie rejestrów i korzystanie z nich staje się pełnoprawną funkcją panelu administracyjnego, a nie tylko przepływem pracy CLI.
Rejestr CLI
Drugą częścią rozwiązania dla rejestrów jest samodzielny CLI: blockstudio/registry.
To narzędzie w stylu shadcn do WordPress bloków. Bez pakietu npm i bez etapu kompilacji. Uruchamiasz polecenie, kod źródłowy bloku zostaje skopiowany do projektu i staje się w pełni Twoją własnością.
npx blockstudio init
npx blockstudio add ui/tabs
CLI działa z dowolnym typem bloku: blokami Blockstudio, wynikiem @wordpress/create-block i zwykłymi blokami PHP. Rejestr nie interesuje się zawartością folderu. Odczytuje manifest plików z registry.json i kopiuje dokładnie te pliki.
Autorzy bloków publikują registry.json pod dowolnym adresem URL (surowa treść GitHub, S3 lub własny serwer), wymieniając dostępne bloki wraz z metadanymi, zależnościami i listami plików. Użytkownicy dodają URL do swojego blocks.json i pobierają bloki według nazwy.
CLI obsługuje:
- Rozwiązywanie zależności: bloki mogą deklarować zależności od innych bloków, które są rozwiązywane automatycznie z wykrywaniem cykli
- Obsługa konfliktów między wieloma rejestrami: gdy ta sama nazwa bloku występuje w kilku rejestrach, CLI prosi o wybranie jednego z nich
- Uwierzytelnione rejestry: tokeny bearer, uwierzytelnianie podstawowe i niestandardowe nagłówki z interpolacją zmiennych środowiskowych
- Interaktywny TUI: zbudowany przy użyciu Ink, ze wskaźnikami postępu, monitami wyboru i paskami postępu
- Tryb nieinteraktywny: flaga
--yesi automatyczne przejście awaryjne dla CI lub potoków - Wyszukiwanie i listowanie: przeglądaj rejestry z wiersza poleceń
Pakiet zawiera 130 testów obejmujących schematy, rozwiązywanie zależności, pobieranie HTTP, zapisywanie plików, przebieg każdego polecenia i interaktywne UI Ink.
Pełna dokumentacja: blockstudio.dev/registry.
Rozszerzenie PHPStan
Drugim dużym dodatkiem jest blockstudio/phpstan: rozszerzenie PHPStan, które zapewnia użytkownikom Blockstudio bezpieczeństwo typów oczekiwane przez programistów TypeScript.
composer require --dev blockstudio/phpstan
Rozszerzenie odczytuje rzeczywiste schematy projektu podczas analizy i przekazuje wynikające z nich typy do PHPStan. Obsługuje teraz szablony PHP, Twig, Blade, znaczniki bloków, typowane rekordy bazy danych, ścieżki ustawień, nazwy hooków i walidację schematów w block.json, field.json, rozszerzeniu JSON, page.json, db.php, rpc.php, cron.php i blockstudio.json.
Bezpieczne typowo szablony bloków
Dostęp do pól w $a jest sprawdzany względem sąsiedniego 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"?
Bezpieczne typowo rekordy bazy danych
Db::get() zwraca typowaną instancję na podstawie schematu db.php. Struktura rekordu jest tworzona na podstawie rzeczywistych pól:
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}
Walidacja schematów
Nieprawidłowe pliki schematów są wykrywane podczas analizy: block.json, field.json, rozszerzenie JSON, page.json, db.php, rpc.php, cron.php i blockstudio.json. Brakujące nazwy, nieprawidłowe typy pól, błędne definicje i przestarzałe skrócone wartości logiczne ("tailwind": true zamiast zagnieżdżonego obiektu) są zgłaszane wraz z dokładnym numerem wiersza w pliku źródłowym.
Walidacja ścieżek ustawień
Wywołania Settings::get() są sprawdzane względem znanego schematu ustawień:
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"?
Walidacja nazw hooków
To samo dotyczy nazw hooków filtrów i akcji:
add_filter('blockstudio/render', $cb); // OK
add_filter('blockstudio/rendrr', $cb); // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
Rozszerzenie zawiera też definicje zastępcze dla całego publicznego interfejsu Blockstudio API: Db, Settings, Field_Registry, Build i funkcji globalnych. Zyskujesz autouzupełnianie i sprawdzanie typów dla wszystkich interfejsów API Blockstudio bez konieczności posiadania źródeł wtyczki na komputerze programistycznym.
Ułatwienia podczas tworzenia
Dwa mniejsze ułatwienia podczas tworzenia dopełniają to wydanie.
Globalne preambuły SCSS
Blockstudio obsługiwało już kompilację SCSS, ale pozostawał jeden uciążliwy problem: współdzielona konfiguracja Sass.
Jeśli chcesz korzystać ze wspólnego zestawu zmiennych, funkcji lub mixinów, musisz importować je w każdym pliku SCSS. Szybko staje się to powtarzalne, zwłaszcza w większych systemach projektowych lub zestawach narzędzi Sass, takich jak Bootstrap.
Wersja 7.2 dodaje hook preambuły, który rozwiązuje ten problem:
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
W połączeniu z istniejącym filtrem blockstudio/assets/process/scss/import_paths definiujesz wspólną warstwę Sass tylko raz, a jest ona dostępna w każdym skompilowanym pliku.
Arkusz stylów bloku może skupiać się na rzeczywistych potrzebnych mu stylach:
.hero {
@include media-breakpoint-up(lg) {
padding: 4rem;
}
}
Koniec z powtarzaniem importów w każdym zasobie bloku. To nie jest „obsługa Bootstrap” w trybie specjalnym. To ogólny hook do współdzielenia Sass w projekcie, niezależnie od tego, czy pochodzą z Bootstrap, czy z wewnętrznego zestawu narzędzi.
Definicje bloków PHP-native API
Wersja 7.2 dodaje też opcjonalną składnię natywną dla PHP pełnostosowych interfejsów API bloków. Tablice pozostają domyślnym i w pełni obsługiwanym formatem. Niczego nie zastąpiono. Jeśli jednak wolisz nazwane argumenty, typy wyliczeniowe i atrybuty zamiast zagnieżdżonych tablic konfiguracji, możesz teraz wybrać ten styl.
W przypadku rpc.php zwróć obiekt z metodami opatrzonymi atrybutami:
<?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'];
}
};
W przypadku cron.php ta sama koncepcja działa z #[Cron]:
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;
return new class {
#[Cron(schedule: Schedule::Hourly)]
public function heartbeat(): void {
}
};
A w przypadku db.php dostępna jest teraz niewielka warstwa konstruktora:
<?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 lepsza równowaga dla większych baz kodu. Gdy chcesz, zachowujesz prostotę formatu tablicowego, a gdy blok rozrasta się ponad kilka pól lub punktów końcowych, możesz przejść na bardziej przejrzysty interfejs PHP.
Dlaczego te elementy pojawiają się razem
Przegląd w panelu administracyjnym, przeglądarka rejestru, rejestr CLI i rozszerzenie PHPStan odpowiadają na to samo pytanie: jak zachować czytelność projektu Blockstudio w miarę jego rozwoju?
Narzędzia administracyjne odpowiadają na to pytanie na poziomie projektu: zapewniają wgląd w to, co jest zarejestrowane, umożliwiają pobieranie bloków z rejestrów i ograniczają zgadywanie.
CLI odpowiada na to pytanie na poziomie ekosystemu: umożliwia udostępnianie bloków między projektami i zespołami bez pakowania ich w pakiety npm i zmagania się z systemami kompilacji.
Rozszerzenie PHPStan odpowiada na to pytanie na poziomie kodu: wykrywa błędny dostęp do pól, literówki w schematach i nieprawidłowe wywołania zwrotne hooków, zanim trafią do środowiska wykonawczego.
Taki jest ogólny kierunek wersji 7.2: mniej zgadywania i powtórzeń, lepszy wgląd i wreszcie rzeczywiste bezpieczeństwo typów.
Poprawki błędów
- Pole Classes: niestandardowe nazwy klas wpisane przez użytkownika znikały po utracie fokusu, ponieważ walidator akceptował tylko klasy z predefiniowanej listy Tailwind/ustawień. Teraz akceptuje dowolny niepusty ciąg znaków.
- Pole Attributes: po usunięciu pary atrybutów w zapisanych danych pozostawały wpisy
null. Zastąpiono lodashunset()(które zeruje elementy tablicy) przezsplice()(które je usuwa). - Minifikator CSS: minifikator TailwindPHP usuwał białe znaki wokół
+wcalc()iclamp(), tworząc nieprawidłowe CSS, takie jakcalc(1rem+0.5vw). Problem naprawiono w upstream TailwindPHP v1.3.1, stosując analizę znak po znaku uwzględniającą głębokość, która usuwa białe znaki wokół kombinatorów selektorów tylko na poziomie nawiasów równym 0. - Podgląd w Block Inserter:
$isPreviewbyło zawszefalsew podglądzie Block Inserter, ponieważ pamięć podręczna renderowania nie uwzględniała trybu renderowania w kluczu skrótu. Renderowanie w edytorze i podglądzie tworzy teraz osobne wpisy pamięci podręcznej. - Zagnieżdżony szablon InnerBlocks: komponent
<InnerBlocks template="..."/>pomijał trzeci element (elementy potomne) w krotkach szablonu, takich jak['core/group', {}, [['core/paragraph']]], tworząc puste bloki kontenerów. Teraz zachowuje zagnieżdżone elementy potomne.