Dennis · 2026. gada 23. jūlijs
Blockstudio 7.5
Blockstudio 7.5 papildina Blockstudio failu prioritātes darbplūsmu ar pielāgotu lauku tipiem, failos glabātām Site Editor veidnēm, bloku salām, Storh datubāzes krātuvi, loģiskiem atklāšanas avotiem, kombinējamiem bloku tagiem un ātrākiem izvietošanas un izpildlaika ceļiem.
Atkārtoti izmantojami pielāgoti lauki jau ļauj projektiem vienreiz definēt esošu lauku grupu un atkārtoti izmantot to ar type: "custom/{name}". Pielāgotu lauku tipi risina citu problēmu. Tie ļauj tēmai vai spraudnim reģistrēt jaunu nosaukumvietā ievietotu lauka tipu, nodrošināt tam savu redaktora vadīklu un saglabāt vērtību kā parastus Blockstudio datus.
Īsumā:
- Loģiskie atklāšanas avoti: izpildvides var nodrošināt apvienotu loģisko motīva inventāru, tostarp izcelsmes informāciju un kešatmiņas identitāti, kamēr Blockstudio pārziņā paliek atklāšana, blakusfailu atrisināšana, ģenerētie resursi, Canvas un Tailwind darbība.
- PHP lauku tipu reģistrs: motīvi un spraudņi var reģistrēt nosaukumvietām piesaistītus lauku tipus, piemēram,
acme/dimensionsarbs_register_field_type()vai filtrublockstudio/field_types. - Redaktora vadīklu reģistrs: pielāgoti redaktora skripti var izsaukt
window.blockstudio.registerFieldType()un attēlot atbilstošo React vadīklu parastajā Blockstudio lauka UI. - Strukturētas vērtības: pielāgotos laukos var saglabāt virknes, skaitļus, Būla vērtības, masīvus vai objektus, nepārveidojot objektu vērtības, izmantojot opciju lauku normalizāciju.
- Atmiņas atbalsts: ierakstu metadatos un opcijās balstīti pielāgotie lauki var norādīt savu vērtības tipu un REST shēmu, tostarp objektu un masīvu vērtības.
- Integrācija ar vietējo funkcionalitāti: pielāgotie lauku tipi darbojas grupās, cilnēs, atkārtotājos, atkārtoti izmantojamos pielāgotos laukos, veidnēs un paplašinājumu veidņu ceļos.
- Vietnes redaktora veidnes: motīvi var definēt
wp_templateunwp_template_partavotus notemplate.json,part.jsonun Blockstudio veidņu failiem. - Bloku salas: bloki vispirms var attēlot kešatmiņai drošu apvalku un pēc lapas ielādes veikt specifisku fragmentu hidratēšanu vai pakešveida iegūšanu.
- Storh datubāzes krātuve:
bs.dbvar izmantot indeksētu, augšupielāžu mapē glabātu failu krātuvi ar vienu ierakstu katrā failā, saglabājot publiskos veselo skaitļu ID un nodrošinot migrāciju no JSONC uz Storh, izmantojot WP-CLI. - Parsētāja un bsui uzlabojumi: kartētām bagātināta teksta rindkopām vajag mazāk pielāgotas parsētāja loģikas,
InnerBlocksvar izmantot tokenizētuallowedBlocks, ligzdotābs_render_block()izvade redaktora priekšskatījumos atbilst priekšgala attēlojumam, unbsui/buttoniegūst ikonas un ērtākus stila pielāgošanas āķus. - Saliekami bloku tagi: prefiksu tagus var atrisināt, izmantojot citu prefiksu (
<theme-ui-input>uzbsui/input), un prefiksu un aizstājvārdu tagi tiek attēloti bloku veidņu izvadē, ne tikai lapas saturā. - Resursdatoram drošas būvējumu kešatmiņas: izpildvides un redaktora kešatmiņas pēc noklusējuma atrodas ārpus augšupielāžu mapes, atbalsta konfigurējamas atrašanās vietas un dzēš novecojušos ierakstus, lai ilgstoši darbojošos projektos neuzkrātos kešatmiņas faili.
- Pakāpeniska lapu saskaņošana: izvietošanas rīki var saskaņot pilnu failos glabāto lapu inventāru, izlaist nemainītas ziņas, precīzi ziņot par izmaiņām un pēc aktivizēšanas saglabāt pārbaudītu avota identitāti.
- Ātrāka iesildītu lapu attēlošana: derīgas izpildvides kešatmiņas tiek ielādētas pirms atklāšanas, vienlaicīgi aukstie pieprasījumi publicē vienu atomāru rezultātu, un Tailwind uztur vietnes lieluma kešatmiņu ar atkārtoti izmantojamu kompilatora stāvokli.
- Droša pakešveida attēlošana: eksportētāji var atiestatīt pieprasījuma darbības jomas attēlošanas stāvokli starp dokumentiem, nepārbūvējot atklāšanas datus, un apkopot avotu atkarības bloku attēlošanas laikā.
Jaunās funkcijas
7.5 piedāvā plašu jaunu iespēju klāstu atklāšanā, veidnēs un krātuvē.
Loģiskie atklāšanas avoti
Blockstudio parasti atklāj failus fiziskajās motīvu mapēs. Versijā 7.5 pievienots zemāka līmeņa avots API izpildvidēm, kas veido motīvu no pārklājumiem, priekšskatījumiem, ģenerētiem failiem, attālināti pievienotām mapēm vai cita apvienota inventāra.
Integrācija var nodrošināt galīgo loģisko failu koku, kamēr Blockstudio pārziņā paliek bloku, lauku, lapu, rakstu paraugu, vietnes redaktora, Canvas, resursu un Tailwind darbība:
use Blockstudio\Inventory_Discovery_Source;
add_filter(
'blockstudio/discovery/sources',
function (array $sources, string $context): array {
if ('blocks' !== $context) {
return $sources;
}
return [
new Inventory_Discovery_Source(
'preview:feature-card',
'/runtime-preview/feature-card/blockstudio',
[
'card/block.json' => [
'path' => '/theme/blockstudio/card/block.json',
'provenance' => ['layer' => 'parent'],
],
'card/index.php' => [
'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
'provenance' => ['layer' => 'preview'],
],
],
'preview-fingerprint'
),
];
},
10,
2
);
Loģiskie ceļi paliek nemainīgi pat tad, ja blakusfaili atrodas dažādās fiziskajās saknes mapēs. Avotu ID un kontrolsummas veido izpildvides un Tailwind kešatmiņas identitātes, pārraugāmās ievades padara tās nederīgas, ja tajās notiek izmaiņas, bet izcelsmes informācija nosaka, kur drīkst rakstīt ģenerētos failus. Parastiem motīviem noklusējuma failu sistēmas avots paliek nemainīgs.
Vietnes redaktora veidnes no failiem
Lapas un rakstu paraugi jau ļauj komandām glabāt satura struktūras failos. Versijā 7.5 šis modelis attiecināts arī uz pašu vietnes redaktoru.
theme/
templates/
front-page/
template.json
index.php
parts/
header/
part.json
index.php
{
"slug": "front-page",
"title": "Front Page"
}
<div class="site-shell">
<block name="core/template-part" slug="header" />
<main>
<h1>Welcome</h1>
<block name="core/post-content" />
</main>
</div>
Blockstudio parsē avotu ar to pašu parsētāju, ko izmanto lapām un rakstu paraugiem, un pēc tam nodod rezultātu WordPress kā parastu vietnes redaktora veidni vai veidnes daļu. Vietnes redaktors atpazīst šo veidni, priekšgals var to attēlot, un pielāgojumi joprojām ir WordPress pārziņā.
Pēdējā daļa ir svarīga. Veidnes no failiem kalpo kā avota rezerves variants. Ja lietotājs saglabā veidni vietnes redaktorā, WordPress izveido parasto wp_template vai wp_template_part datubāzes pielāgojumu, un priekšroka tiek dota šai versijai. Atiestatiet pielāgojumu, un atkal būs redzams jaunākais avota fails.
Pakāpeniska lapu izvietošana
Failos glabātajām lapām versijā 7.5 pievienota izvietošanas saskaņošanas API. Sākot ar 7.6.2, šī skaidri izsaucamā API un wp bs pages sync ir vienīgie sinhronizācijas sākumpunkti; parastie pieprasījumi avota izmaiņas nepiemēro:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
Šī darbība atklāj visu paredzēto lapu inventāru, salīdzina satura un sinhronizācijas dzinēja kontrolsummas un ziņo par izveidotajām, atjauninātajām, nemainītajām, noņemtajām un kļūdaini apstrādātajām lapām. Lapām ar vienādām kontrolsummām netiek rakstīts ne ziņas saturs, ne ziņas metadati. Trūkstošās pārvaldītās lapas tiek dzēstas tikai pēc tam, kad inventāra atklāšana pabeigta bez kļūdām.
Saskaņošana atgriež deterministisku avota identitāti, bet neatzīmē izvietošanu kā veiksmīgu. Izvietošanas rīki saglabā šo identitāti tikai pēc tam, kad atbilstošie faili un maršruti ir aktivizēti un pārbaudīti. Parastā WP-CLI inicializē kešotās kolekciju ziņu tipu un pārrakstīšanas kārtulu reģistrāciju, neatklājot un nesinhronizējot visas lapas.
Bloku salas
Lielākā daļa Blockstudio bloku tiek attēloti servera pusē. Tas ir piemēroti WordPress, taču rada pazīstamu kešatmiņas problēmu: viens personalizēts bloks var apgrūtināt visas lapas kešošanu.
Bloku salas šo robežu sadala bloku līmenī.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
Dinamiskā sala pirmajā atbildē attēlo tikai kešatmiņai drošu vietturi. Pēc tam pārlūkprogramma nosūta vienu pakešveida pieprasījumu par visām lapā gatavajām dinamiskajām salām, un Blockstudio attēlo šos fragmentus apmeklētāja faktiskā pieprasījuma kontekstā.
Tādējādi pilnas lapas kešatmiņā var saglabāt lapas apvalku, kamēr iepirkumu groza skaits, konta vadīklas, atļaujās balstītais UI un citi konkrētam lietotājam paredzētie elementi paliek aktuāli.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
Blokiem, kas jau attēlo kešatmiņai drošu HTML un kuriem vajadzīgs tikai priekšgala montāžas signāls, izmantojiet hidratētu salu:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
Hidratētās salas neveic REST pieprasījumu. Tās tiek attēlotas kā parasti un priekšgalā saņem notikumu blockstudio:island:hydrate.
Dinamiskās salas darbojas arī ar programmatiskiem attēlošanas ceļiem:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
Un arī ar bloku tagiem:
<bs:acme-cart-count product-id="42" />
Galapunkta darbības joma ir apzināti šaura. Tas attēlo tikai reģistrētus Blockstudio blokus, kas ir dinamiski un skaidri atzīmēti kā dinamiskas salas. Atribūti tiek filtrēti atbilstoši bloka shēmai un salu atļauto vērtību sarakstam, un katrā marķierī ir paraksts, ko ģenerējusi apkalpojošā WordPress vietne.
Storh datubāzes krātuve
Blockstudio datubāzes slānis jau atbalsta tabulas, SQLite, JSONC, ziņu metadatus un pielāgotus ziņu tipus. Versijā 7.5 pievienota storage: "storh" projektiem, kuri vēlas failos balstītu krātuvi ar drošāku vienlaicīgu rakstīšanu un no shēmas atvasinātiem indeksiem, bet nevēlas aktīvos ierakstus saglabāt līdzās bloku avota failiem.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
Storh ieraksti atrodas augšupielāžu mapē:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
Publiskā API paliek nemainīga. bs.db(), REST un Db::get() joprojām atgriež veselu skaitļu id vērtības. Iekšēji Blockstudio sasaista šos ID ar Storh dokumentu ID formātā UUIDv7, tāpēc esošais klienta kods nav jāmaina.
Katrs deklarētais shēmas lauks tiek indeksēts vienādības filtriem; skaitliskajiem un datuma tipa laukiem tiek izveidoti diapazona indeksi, un tiek nodoti arī skaidri norādītie unikalitātes nosacījumi. Projektiem, kas sāka ar JSONC sākuma failiem, jaunā migrācija CLI atstāj avota failu vietā un izveido līdzvērtīgu Storh krātuvi:
wp bs db migrate my-theme/app subscribers --to=storh
Tādējādi JSONC kļūst par skaidrāku, vienkāršu sākuma un konfigurācijas formātu, ko var iekļaut versiju pārvaldībā, savukārt Storh kļūst par labāko noklusējuma failu aizmugursistēmu maināmiem produkcijas datiem.
Parsētāja un bsui uzlabojumi
Versijā 7.5 ir arī vairāki mazāki uzlabojumi, kas noder, projektos plašāk izmantojot failos glabātas veidnes un komplektētus UI.
Elementu kartēšana tagad spēj apstrādāt ierasto bagātināta teksta rindkopas gadījumu bez pielāgota veidotāja. Ja <p> tiek kartēts uz reģistrētu bloku, kas nav pamatbloks Blockstudio, ar bagātināta teksta atribūtu content, vienkāršais iekšējais teksts tiek kopēts šajā atribūtā. Ligzdotie tagi un kartētie pakārtotie elementi joprojām tiek parsēti kā iekšējie bloki.
InnerBlocks veidnēs pieņem tokenizētu allowedBlocks:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Atbalstītie tokeni ir namespace/*, category:<slug> un @theme. Tie tiek izvērsti serverī, pirms veidne tiek nodota redaktoram, tāpēc priekšgala attēlošanas ceļš paliek nemainīgs.
Arī programmatiskās iegultnes tagad darbojas paredzamāk. bs_render_block() un bs_block() tagad attēlo iegultos blokus kā priekšgalā atrisinātus HTML, pat ja tos izsauc cita bloka redaktora priekšskatījumā. Tādējādi ligzdotie bloki priekšskatījuma marķējumā neatklāj neapstrādātas <RichText /> vai <InnerBlocks /> pseidokomponentes.
Komplektētiem UI bsui/button tagad atbalsta atribūtu icon un iconPosition. Komplektētie bsui/* iekļautie stili tiek izvadīti @layer bsui kaskādes slānī, un pogu variantus var paplašināt ar blockstudio/ui/button/variants-style un esošo filtru blockstudio/blocks/attributes.
Bloku tagus var kombinēt arī sarežģītāk. Prefiksu var atrisināt, izmantojot citu prefiksu, tāpēc theme projekta prefikss ar ui nosaukumvietas prefiksu atrisina <theme-ui-input /> bsui/input. Reģistrētie prefiksu un aizstājvārdu tagi tagad tiek attēloti arī bloku veidņu izvadē, ne tikai lapas saturā, tāpēc veidne var tos izvadīt tieši, nevis izsaukt bs_render_block().
Pielāgoti bloku veidotāji, kas reģistrēti, izmantojot blockstudio/block_tags/builders, tagad arī konsekventi piedalās tagu un kartēto elementu parsēšanā. Pēc tam joprojām tiek izpildīti skaidri norādītie attēlotāja filtri, kas var aizstāt veidotāju.
Ātrāki iesildīti pieprasījumi un eksportēšana
Izpildvides un redaktora kešatmiņas pēc noklusējuma tagad atrodas wp-content/blockstudio/cache, nevis augšupielāžu mapē. Atrašanās vietu var mainīt, izmantojot cache.path vai blockstudio/cache/dir, tādējādi saglabājot pastāvīgo kešošanu resursdatoros, kas bloķē PHP datnes augšupielāžu mapē. Izpildvides, redaktora resursu un Tailwind kešatmiņas arī automātiski dzēš novecojušos ierakstus, tāpēc ilgstoši darbojošos projektos diskā vairs neuzkrājas neierobežots skaits kešatmiņas failu.
Iesildīti priekšgala pieprasījumi tagad ielādē derīgu izpildvides reģistru pirms atklāšanas avotu izveides. Tādējādi tiek izlaista rekursīva avotu atklāšana, bloku veidošana, lauku parsēšana un atkārtota kešatmiņas atslēgu koku caurskate. Pēc noklusējuma produkcijas un testēšanas pieprasījumi 20 sekundes uzticas pārbaudītam pārraudzības momentuzņēmumam, bet lokālās un izstrādes vides joprojām pārbauda katrā pieprasījumā.
Aukstās kešatmiņas izveide notiek tikai vienā pieprasījumā vienlaikus. Viens pieprasījums izveido un atomāri publicē datni, kamēr pārējie gaida gatavo rezultātu. Tailwind tagad pēc noklusējuma 30 dienas saglabā līdz 1,000 kompilētiem ierakstiem un atkārtoti izmanto iesildītu kompilatora izveides stāvokli, tāpēc maršrutu kopa visas vietnes mērogā vairs nepārtraukti nemaina nelielu kešatmiņu.
Eksportētāji ar ilgu darbības laiku starp dokumentiem var izsaukt Blockstudio\Batch_Render::reset(). Tas notīra pieprasījuma darbības jomas skaitītājus, resursus, salas, izkārtojumus un Tailwind ģenerēšanu, nepārbūvējot atklāšanas datus. Filtrs blockstudio/render/dependencies atklāj katra attēlotā bloka izmantotos veidņu un resursu ceļus, lai veidotu atkarību grafus.
Uzticamība un saderība
Šo laidienu papildina vairāki labojumi:
- Lauku definīcijas, kas mainītas, izmantojot
blockstudio/blocks/attributes, tagad nosaka gan opciju validāciju attēlošanas laikā, gan redaktora shēmu. Tipizētas skaitliskas un Būla opciju vērtības arī tiek atrisinātas konsekventi. - Redaktora bloku ietvari izmanto tās pašas ģenerētās klases, ko priekšgala attēlojumi, un Canvas var kopēt konfigurētās priekšgala pamatdaļas klases, izmantojot jauno filtru
blockstudio/editor/canvas/body_class. - Satura sinhronizācija pirms destruktīvām rakstīšanas darbībām validē visu avota plānu, dzēšanas darbības ierobežo ar konfigurēto satura kopu un ziņo par failu rakstīšanas kļūmēm, nemainot attiecīgās vienības sinhronizācijas stāvokli.
- Composer pakotnes, kas iekļautas simbolsaitēs aktīvajos vai vecākvecāka motīvos, redaktora resursus atrisina no publiskā motīva URL.
- Ar atslēgām identificētas failu lapas saglabā redaktora pārvaldītās Blockstudio lauku vērtības, sinhronizācijas laikā migrē vecāko ligzdotās atslēgas formu un pieņem nulli kā derīgu skaitlisku atslēgu.
- Dinamiskās salas pārbauda parakstus pirms pieprasījuma atribūtu filtriem, ignorē neparakstītu pieprasījuma kontekstu, atjauno vienas izcelsmes pieteikušos apmeklētāju sesijas un novērš anonīmu lietotāju kešatmiņas sadursmes.
- Neapstrādāti Markdown lapu galapunkti tagad ievēro ziņu redzamības iestatījumus un aizsardzību ar paroli.
- Redaktora vadīklas uzticamāk apstrādā tukšus nosacījumus, izvēles rūtiņu vērtības visu opciju pārslēgšanai, asinhronu opciju atsvaidzināšanu, dinamisku attēlošanas secību un atkārtotāju bagātināta teksta vai WYSIWYG stāvokli.
Pielāgoti lauku tipi
Papildinformācija par iepriekš ieviestajiem pielāgotajiem lauku tipiem.
Kāpēc vajadzīgi pielāgoti lauku tipi?
Blockstudio jau sākotnēji jābūt noderīgam, taču reālos projektos bieži vajadzīgas konkrētajai jomai pielāgotas vadīklas: atstarpju tokenu atlasītāji, dizaina sistēmas krāsu lomas, adaptīvi izmēri, ikonu avoti, produktu atlasītāji vai redakcionālas vadīklas, kas veido strukturētu vērtību.
Pirms versijas 7.5 šādos projektos varēja apvienot vairākus iebūvētos laukus vai izveidot redaktora atzarojumu. Versija 7.5 piedāvā atbalstītu vidusceļu: Blockstudio pārvalda lauka dzīves ciklu, bet projekts — vadīklu.
add_action('init', function () {
wp_register_script(
'acme-field-dimensions',
get_stylesheet_directory_uri() . '/fields/dimensions.js',
['blockstudio-blocks', 'wp-components', 'wp-element'],
'1.0.0',
true
);
bs_register_field_type('acme/dimensions', [
'attribute' => 'object',
'default' => [],
'editor_script' => 'acme-field-dimensions',
'storage' => [
'type' => 'object',
'rest_schema' => [
'type' => 'object',
'additionalProperties' => ['type' => 'string'],
],
],
]);
});
const { createElement: el } = wp.element;
const { TextControl } = wp.components;
window.blockstudio.registerFieldType('acme/dimensions', {
component(props) {
const value =
props.value &&
typeof props.value === 'object' &&
!Array.isArray(props.value)
? props.value
: {};
const sides = props.sides || ['top', 'right', 'bottom', 'left'];
return el(
'div',
{},
sides.map((side) =>
el(TextControl, {
key: side,
label: side,
value: value[side] || '',
onChange(nextValue) {
props.onChange({
...value,
[side]: nextValue,
});
},
}),
),
);
},
});
Pēc tam lauku var izmantot block.json tāpat kā vietējo lauku:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Parastās veidņu vērtības
Saglabātā vērtība ir pieejama PHP, Twig un Blade tāpat kā jebkurš cits Blockstudio atribūts.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
Tie paši objektu ceļi darbojas arī paplašinājumu veidnēs:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Saderības piezīmes
Esošie iebūvētie lauku tipi paliek nemainīgi. Arī esošās custom/{name} atkārtoti izmantojamās lauku grupas paliek nemainīgas. Pielāgoto lauku tipu nosaukumiem jābūt ar mazajiem burtiem un piesaistītiem nosaukumvietai, piemēram, acme/dimensions; nosaukumvietas custom/ un blockstudio/ ir rezervētas.
Ja PHP reģistrē lauka tipu, bet tā redaktora skripts nereģistrē atbilstošo vadīklu, Blockstudio saglabā vērtību un redaktorā parāda paziņojumu, ka to nevar rediģēt. Ja lauka tips nav reģistrēts PHP, Blockstudio to neiekļauj ģenerētajos WordPress atribūtos.
7.5.1 uzturēšanas atjauninājums
7.5.1 novērš brīdinājumu par masīva pārvēršanu virknē, kas tika parādīts, sagatavojot vairāku vērtību atlasītāju attēlošanai. Saglabātās un attēlotās vērtības jau bija pareizas, taču atkļūdošanas žurnālos varēja parādīties viens brīdinājums par katru lauka attēlojumu.
Papildinošais blockstudio/phpstan v0.1.7 atjauninājums arī atpazīst laukus, kas ligzdoti anonīmās grupās, un secina atribūtu formas no veidnēm PHP, Twig un Blade. Esošie projekti šo pakotnes labojumu var saņemt ar composer update blockstudio/phpstan.