Dennis · 10 Απριλίου 2026
Blockstudio 7.2
Το Blockstudio 7.2 επεκτείνει το πλαίσιο σε δύο κατευθύνσεις ταυτόχρονα.
Η πρώτη αφορά την ορατότητα και τη ροή εργασίας μέσα σε ένα έργο: μια νέα επισκόπηση διαχείρισης, ένα πρόγραμμα περιήγησης βάσεων δεδομένων, ένα πρόγραμμα περιήγησης μητρώου διαχείρισης και προοίμια SCSS για κοινόχρηστη ρύθμιση του Sass.
Η δεύτερη αφορά το οικοσύστημα γύρω από το Blockstudio: ένα CLI μητρώου για τη διανομή blocks (όπως το shadcn για το WordPress) και μια επέκταση PHPStan που προσφέρει στα πρότυπα, τις ετικέτες block, τα db.php, rpc.php, cron.php και τα σχετικά αρχεία σχήματος ασφάλεια τύπων τύπου TypeScript.
Και οι δύο κατευθύνσεις εξυπηρετούν τον ίδιο σκοπό: να διευκολύνουν την κατανόηση, την επέκταση και την κοινή χρήση μεγαλύτερων έργων Blockstudio.
Εμπειρία διαχείρισης
Δύο προσθήκες διευκολύνουν την πλοήγηση σε ένα μεγαλύτερο έργο μέσα στο wp-admin.
Επισκόπηση διαχείρισης
Το Blockstudio περιλαμβάνει πλέον οθόνη διαχείρισης στη διαδρομή Εργαλεία > Blockstudio. Παρέχει ένα ενιαίο σημείο για να ελέγχετε όσα έχει καταχωρίσει το σύστημα από το σύστημα αρχείων.
Η επισκόπηση περιλαμβάνει ειδικές καρτέλες για:
- Blocks
- Επεκτάσεις
- Πεδία
- Σελίδες
- Σχήματα
Παράλληλα με την επισκόπηση, η περιοχή διαχείρισης περιλαμβάνει πλέον ειδική ενότητα Βάσεις δεδομένων. Εμφανίζει κάθε καταχωρισμένο σχήμα Blockstudio\Db και σας επιτρέπει να ελέγχετε πραγματικές εγγραφές απευθείας μέσα στο wp-admin.
Αντί για ένα προσαρμοσμένο πλέγμα πλαισίων, η οθόνη χρησιμοποιεί τους εγγενείς πίνακες DataViews του WordPress. Έτσι η UI παραμένει εναρμονισμένη με το wp-admin και πρακτική όταν ένα έργο έχει δεκάδες ή εκατοντάδες καταχωρίσεις.
Σε μια μικρή εγκατάσταση, μπορείτε να κρατάτε στο μυαλό σας την κατάσταση χρόνου εκτέλεσης. Σε μια μεγαλύτερη βάση κώδικα, αυτό παύει να λειτουργεί. Αρχίζετε να αναρωτιέστε:
- Ποια blocks είναι πράγματι καταχωρισμένα αυτή τη στιγμή;
- Ποιες επεκτάσεις στοχεύουν το
core/*και ποιες μεμονωμένα blocks; - Ποιες σελίδες είναι συγχρονισμένες και σε ποιους τύπους δημοσίευσης ανήκουν;
- Ποια επαναχρησιμοποιήσιμα πεδία υπάρχουν σε αυτό το έργο;
- Ποια σχήματα είναι καταχωρισμένα και ποιο σύστημα αποθήκευσης χρησιμοποιούν;
Μέχρι τώρα, η απάντηση απαιτούσε κάποιον συνδυασμό περιήγησης σε φακέλους, ανοίγματος αρχείων JSON και παρακολούθησης του PHP. Η επισκόπηση τα συγκεντρώνει σε μια πραγματική οθόνη διαχείρισης.
Κάθε καρτέλα έχει σχεδιαστεί για να απαντά σε διαφορετικά ερωτήματα:
- Blocks: εμφανίζουν τους καταχωρισμένους τύπους block, τη λειτουργία απόδοσης, την έκδοση API και τον αριθμό γνωρισμάτων
- Επεκτάσεις: εμφανίζουν τα blocks που στοχεύουν, καθώς και την προτεραιότητα και τις λεπτομέρειες απόδοσης
- Πεδία: παρέχουν μια γρήγορη καταγραφή των επαναχρησιμοποιήσιμων ορισμών προσαρμοσμένων πεδίων
- Σελίδες: εμφανίζουν συγχρονισμένες σελίδες βάσει αρχείων, με τύπο δημοσίευσης, κατάσταση, μηχανή προτύπων και κατάσταση συγχρονισμού
- Σχήματα: παρουσιάζουν τα καταχωρισμένα σχήματα αποθήκευσης μαζί με το σύστημα αποθήκευσης, τον αριθμό πεδίων και το πεδίο δυνατοτήτων
Η περιήγηση στη βάση δεδομένων διατηρείται σκόπιμα ξεχωριστά από το αρχικό payload της επισκόπησης. Αντί να σειριοποιεί κάθε εγγραφή κατά τη φόρτωση της σελίδας, αρχικά εντοπίζει μόνο τα διαθέσιμα σχήματα και ανακτά εγγραφές κατ’ απαίτηση, όταν ανοίγετε μια καρτέλα βάσης δεδομένων. Έτσι, η διαχείριση παραμένει χρήσιμη ακόμη κι όταν ένα έργο έχει μεγαλύτερα σύνολα δεδομένων πίσω από το db.php.
Αυτή η πρώτη έκδοση εστιάζει σκόπιμα σε καταχωρίσεις που βασίζονται σε σχήματα. Δεν είναι σελίδα ρυθμίσεων. Είναι σελίδα επιθεώρησης.
Αν δεν το θέλετε καθόλου, απενεργοποιήστε το πλήρως:
add_filter('blockstudio/admin/enabled', '__return_false');
Περιήγηση στο μητρώο διαχείρισης
Δίπλα στην επισκόπηση υπάρχει μια δεύτερη καρτέλα: Μητρώο. Είναι μια διεπαφή περιήγησης στα απομακρυσμένα μητρώα μπλοκ που έχουν ρυθμιστεί στο blocks.json του θέματός σας και σας επιτρέπει να εισάγετε μπλοκ απευθείας από τη διαχείριση του WordPress, χωρίς να αγγίξετε κάποιο CLI.
{
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json",
"private": {
"url": "https://api.example.com/registry.json",
"headers": {
"Authorization": "Bearer ${REGISTRY_TOKEN}"
}
}
}
}
Η διεπαφή ανακτά κάθε ρυθμισμένο μητρώο, εμφανίζει όλα τα διαθέσιμα μπλοκ και δείχνει αν έχουν ήδη εγκατασταθεί τοπικά ή αν είναι διαθέσιμα για εισαγωγή. Κάθε γραμμή έχει κουμπί «Εισαγωγή», που κατεβάζει τα αρχεία του μπλοκ στον ρυθμισμένο κατάλογο του θέματός σας. Για τα ήδη εγκατεστημένα μπλοκ εμφανίζεται αντί γι’ αυτό κουμπί «Επανεισαγωγή».
Υποστηρίζονται μητρώα με έλεγχο ταυτότητας μέσω της μορφής αντικειμένου με headers, συμπεριλαμβανομένης της αντικατάστασης μεταβλητών ${ENV_VAR}, ώστε τα διακριτικά πρόσβασης να μην καταλήγουν ποτέ στον έλεγχο εκδόσεων.
Έτσι, η περιήγηση και η χρήση μητρώων γίνονται βασικό μέρος της εμπειρίας διαχείρισης και όχι απλώς μια ροή εργασίας CLI.
Μητρώο CLI
Το άλλο μέρος της ιστορίας των μητρώων είναι ένα αυτόνομο CLI: blockstudio/registry.
Είναι ένα εργαλείο τύπου shadcn για μπλοκ WordPress. Χωρίς πακέτο npm και χωρίς βήμα κατασκευής. Εκτελείτε μια εντολή, ο πηγαίος κώδικας του μπλοκ αντιγράφεται στο έργο σας και αποκτάτε πλήρη κυριότητα.
npx blockstudio init
npx blockstudio add ui/tabs
Το CLI λειτουργεί με κάθε τύπο μπλοκ: μπλοκ Blockstudio, έξοδο @wordpress/create-block και απλά μπλοκ PHP. Το μητρώο δεν ενδιαφέρεται για το περιεχόμενο του φακέλου. Διαβάζει τη λίστα αρχείων από το registry.json και αντιγράφει ακριβώς αυτά τα αρχεία.
Οι δημιουργοί μπλοκ δημοσιεύουν ένα registry.json σε οποιοδήποτε URL (ακατέργαστο περιεχόμενο GitHub, S3, προσαρμοσμένος διακομιστής), όπου παραθέτουν τα διαθέσιμα μπλοκ μαζί με μεταδεδομένα, εξαρτήσεις και λίστες αρχείων. Οι χρήστες προσθέτουν το URL στο blocks.json τους και ανακτούν μπλοκ με βάση το όνομά τους.
Το CLI υποστηρίζει:
- Επίλυση εξαρτήσεων: τα μπλοκ μπορούν να δηλώνουν εξαρτήσεις από άλλα μπλοκ, οι οποίες επιλύονται αυτόματα με εντοπισμό κύκλων
- Διαχείριση διενέξεων μεταξύ πολλών μητρώων: όταν το ίδιο όνομα μπλοκ υπάρχει σε πολλά μητρώα, το CLI σάς ζητά να επιλέξετε ένα
- Μητρώα με έλεγχο ταυτότητας: διακριτικά bearer, βασικός έλεγχος ταυτότητας και προσαρμοσμένες κεφαλίδες με αντικατάσταση μεταβλητών περιβάλλοντος
- Διαδραστικό TUI: υλοποιημένο με Ink, με ενδείξεις φόρτωσης, προτροπές επιλογής και ενδείξεις προόδου
- Μη διαδραστική λειτουργία: σημαία
--yesκαι αυτόματη εναλλακτική λειτουργία για CI/ροές μέσω σωλήνα - Αναζήτηση και λίστα: περιήγηση στα μητρώα από τη γραμμή εντολών
Το πακέτο περιλαμβάνει 130 δοκιμές που καλύπτουν σχήματα, επίλυση εξαρτήσεων, ανάκτηση HTTP, εγγραφή αρχείων, όλες τις ροές εντολών και το διαδραστικό Ink UI.
Πλήρης τεκμηρίωση στο blockstudio.dev/registry.
Επέκταση PHPStan
Η άλλη σημαντική προσθήκη είναι το blockstudio/phpstan: μια επέκταση PHPStan που προσφέρει στους χρήστες Blockstudio τον τύπο ασφάλειας που περιμένουν οι προγραμματιστές TypeScript.
composer require --dev blockstudio/phpstan
Η επέκταση διαβάζει τα πραγματικά σχήματα του έργου σας κατά την ανάλυση και επιστρέφει τους τύπους που προκύπτουν στο PHPStan. Πλέον καλύπτει πρότυπα PHP, Twig, Blade, ετικέτες μπλοκ, τυποποιημένες εγγραφές βάσης δεδομένων, διαδρομές ρυθμίσεων, ονόματα hook και επικύρωση σχημάτων στα block.json, field.json, JSON επέκτασης, page.json, db.php, rpc.php, cron.php και blockstudio.json.
Πρότυπα μπλοκ με ασφάλεια τύπων
Οι προσπελάσεις πεδίων στο $a επικυρώνονται με βάση το αντίστοιχο 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"?
Εγγραφές βάσης δεδομένων με ασφάλεια τύπων
Το Db::get() επιστρέφει ένα τυποποιημένο στιγμιότυπο με βάση το σχήμα db.php. Η δομή της εγγραφής δημιουργείται από τα πραγματικά πεδία:
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}
Επικύρωση σχήματος
Τα μη έγκυρα αρχεία σχήματος εντοπίζονται κατά την ανάλυση: block.json, field.json, επέκταση JSON, page.json, db.php, rpc.php, cron.php και blockstudio.json. Αναφέρονται ονόματα που λείπουν, λανθασμένοι τύποι πεδίων, κακοσχηματισμένοι ορισμοί και παρωχημένες συντομεύσεις boolean ("tailwind": true αντί για το ένθετο αντικείμενο), μαζί με την ακριβή γραμμή του αρχείου πηγαίου κώδικα.
Επικύρωση διαδρομών ρυθμίσεων
Οι κλήσεις Settings::get() επικυρώνονται με βάση το γνωστό σχήμα ρυθμίσεων:
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"?
Επικύρωση ονομάτων hook
Το ίδιο ισχύει για τα ονόματα hook φίλτρων και ενεργειών:
add_filter('blockstudio/render', $cb); // OK
add_filter('blockstudio/rendrr', $cb); // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
Η επέκταση περιλαμβάνει επίσης αρχεία stub για ολόκληρο το δημόσιο API του Blockstudio: Db, Settings, Field_Registry, Build και καθολικές βοηθητικές συναρτήσεις. Έχετε αυτόματη συμπλήρωση και έλεγχο τύπων για όλα τα API του Blockstudio, χωρίς να χρειάζεστε τον πηγαίο κώδικα του πρόσθετου στον υπολογιστή ανάπτυξης.
Ευκολίες για τη δημιουργία
Δύο μικρότερες διευκολύνσεις για τη δημιουργία συμπληρώνουν την έκδοση.
Καθολικά προοίμια SCSS
Το Blockstudio υποστήριζε ήδη μεταγλώττιση SCSS, αλλά υπήρχε ένα ενοχλητικό σημείο τριβής: η κοινή ρύθμιση Sass.
Αν θέλατε να έχετε πρόσβαση σε ένα κοινό σύνολο μεταβλητών, συναρτήσεων ή mixin, έπρεπε να τις εισάγετε σε κάθε αρχείο SCSS. Αυτό γίνεται γρήγορα επαναλαμβανόμενο, ιδίως σε μεγαλύτερα συστήματα σχεδίασης ή εργαλειοθήκες Sass όπως το Bootstrap.
Η έκδοση 7.2 προσθέτει ένα hook προοιμίου ακριβώς γι’ αυτό:
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Σε συνδυασμό με το υπάρχον φίλτρο blockstudio/assets/process/scss/import_paths, ορίζετε μία φορά ένα κοινό περιβάλλον Sass και είναι διαθέσιμο σε κάθε μεταγλωττισμένο αρχείο.
Έτσι, το φύλλο στυλ ενός μπλοκ μπορεί να εστιάζει στα πραγματικά στυλ που χρειάζεται:
.hero {
@include media-breakpoint-up(lg) {
padding: 4rem;
}
}
Χωρίς επαναλαμβανόμενες εισαγωγές σε κάθε στοιχείο μπλοκ. Δεν πρόκειται για ειδική «υποστήριξη Bootstrap». Είναι ένα γενικό hook για κοινό Sass σε όλο το έργο, είτε προέρχεται από το Bootstrap είτε από τη δική σας εσωτερική εργαλειοθήκη.
Ορισμοί μπλοκ εγγενείς στο PHP API
Η έκδοση 7.2 προσθέτει επίσης μια προαιρετική σύνταξη εγγενή στο PHP για τα API μπλοκ πλήρους στοίβας. Οι πίνακες παραμένουν η προεπιλογή και υποστηρίζονται πλήρως. Δεν αντικαταστάθηκε τίποτα. Αν όμως προτιμάτε ονομασμένα ορίσματα, enum και attributes αντί για ένθετους πίνακες ρυθμίσεων, μπορείτε πλέον να επιλέξετε αυτό το στυλ.
Για rpc.php, επιστρέψτε ένα αντικείμενο με μεθόδους που έχουν attributes:
<?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, η ίδια ιδέα λειτουργεί με #[Cron]:
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;
return new class {
#[Cron(schedule: Schedule::Hourly)]
public function heartbeat(): void {
}
};
Και για db.php, υπάρχει πλέον ένα μικρό επίπεδο builder:
<?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),
],
);
Έτσι επιτυγχάνεται καλύτερη ισορροπία σε μεγαλύτερες βάσεις κώδικα. Διατηρείτε την απλότητα της μορφής πίνακα όταν τη χρειάζεστε και μπορείτε να μεταβείτε σε ένα πιο εύκολα εξερευνήσιμο περιβάλλον PHP, όταν ένα μπλοκ αποκτήσει περισσότερα από λίγα πεδία ή endpoint.
Γιατί κυκλοφορούν μαζί αυτές οι λειτουργίες
Η επισκόπηση διαχείρισης, η περιήγηση μητρώων, το CLI μητρώου και η επέκταση PHPStan απαντούν όλα στο ίδιο ερώτημα: πώς διατηρείτε ένα έργο Blockstudio κατανοητό καθώς μεγαλώνει;
Τα εργαλεία διαχείρισης απαντούν σε επίπεδο έργου: εικόνα του τι είναι καταχωρισμένο, δυνατότητα εισαγωγής μπλοκ από μητρώα και λιγότερες εικασίες.
Το CLI απαντά σε επίπεδο οικοσυστήματος: προσφέρει έναν τρόπο κοινής χρήσης μπλοκ μεταξύ έργων και ομάδων, χωρίς να τα συσκευάζετε σε πακέτα npm ή να παλεύετε με συστήματα κατασκευής.
Η επέκταση PHPStan απαντά σε επίπεδο κώδικα: εντοπίζει λανθασμένες προσπελάσεις πεδίων, τυπογραφικά λάθη σε σχήματα και κατεστραμμένα callback hook πριν προκαλέσουν σφάλματα κατά την εκτέλεση.
Αυτή είναι γενικά η κατεύθυνση της έκδοσης 7.2: λιγότερες εικασίες, λιγότερες επαναλήψεις, καλύτερη ορατότητα και πλέον πραγματική ασφάλεια τύπων.
Διορθώσεις σφαλμάτων
- Πεδίο κλάσεων: τα προσαρμοσμένα ονόματα κλάσεων που πληκτρολογούσε ο χρήστης απορρίπτονταν σιωπηρά όταν έφευγε από το πεδίο, επειδή ο επικυρωτής δεχόταν μόνο κλάσεις από την προκαθορισμένη λίστα Tailwind/ρυθμίσεων. Τώρα δέχεται κάθε μη κενή συμβολοσειρά.
- Πεδίο attributes: η αφαίρεση ενός ζεύγους attribute άφηνε καταχωρίσεις
nullστα αποθηκευμένα δεδομένα. Το lodashunset()(που μηδενίζει τα στοιχεία πινάκων) αντικαταστάθηκε από τοsplice()(που τα αφαιρεί). - Συμπιεστής CSS: ο συμπιεστής TailwindPHP αφαιρούσε κενά γύρω από το
+μέσα σεcalc()καιclamp(), παράγοντας μη έγκυρο CSS όπως τοcalc(1rem+0.5vw). Διορθώθηκε στο upstream του TailwindPHP v1.3.1 με διάσχιση χαρακτήρων που λαμβάνει υπόψη το βάθος και αφαιρεί κενά γύρω από συνδυαστές επιλογέων μόνο όταν το βάθος των παρενθέσεων είναι 0. - Προεπισκόπηση εισαγωγέα μπλοκ: το
$isPreviewήταν πάνταfalseστην προεπισκόπηση του εισαγωγέα μπλοκ, επειδή η λειτουργία απόδοσης δεν περιλαμβανόταν στο κλειδί κατακερματισμού της προσωρινής μνήμης απόδοσης. Οι αποδόσεις του επεξεργαστή και της προεπισκόπησης έχουν πλέον ξεχωριστές καταχωρίσεις στην προσωρινή μνήμη. - Ένθετο πρότυπο InnerBlocks: το στοιχείο
<InnerBlocks template="..."/>αφαιρούσε το 3ο στοιχείο (τα θυγατρικά στοιχεία) από πλειάδες προτύπου όπως το['core/group', {}, [['core/paragraph']]], δημιουργώντας κενά μπλοκ κοντέινερ. Πλέον διατηρεί τα ένθετα θυγατρικά στοιχεία.