Dennis · 23. julij 2026
Blockstudio 7.5
Blockstudio Različica 7.5 dopolnjuje potek dela Blockstudio, ki daje prednost datotekam: vrste polj po meri, predloge Site Editor na podlagi datotek, otočki blokov, shranjevanje zbirke podatkov Storh, logični viri odkrivanja, sestavljive oznake blokov ter hitrejše poti uvajanja in izvajanja.
Polja po meri za večkratno uporabo že omogočajo, da projekti enkrat določijo skupino obstoječih polj in jo znova uporabijo z type: "custom/{name}". Vrste polj po meri rešujejo drug problem. Omogočajo temi ali vtičniku, da registrira novo vrsto polja z imenskim prostorom, zagotovi lasten kontrolni element urejevalnika in shrani vrednost kot običajne podatke Blockstudio.
Na kratko:
- Logični viri odkrivanja: izvajalna okolja lahko zagotovijo sestavljen logični inventar tem, vključno s podatki o izvoru in identiteto predpomnilnika, medtem ko Blockstudio ohrani odgovornost za odkrivanje, razreševanje sosednjih datotek, ustvarjena sredstva, Canvas in vedenje Tailwind.
- Register vrst polj PHP: teme in vtičniki lahko registrirajo imenske prostore za vrste polj, kot je
acme/dimensionszbs_register_field_type()ali filtromblockstudio/field_types. - Register kontrolnikov urejevalnika: skripte urejevalnika po meri lahko pokličejo
window.blockstudio.registerFieldType()in izrišejo ustrezni kontrolnik React v običajnem polju Blockstudio UI. - Strukturirane vrednosti: polja po meri lahko shranjujejo nize, števila, logične vrednosti, polja ali objekte, ne da bi se vrednosti objektov pretvorile z normalizacijo polj z možnostmi.
- Podpora za shranjevanje: metapodatki objav in polja po meri, ki uporabljajo možnosti, lahko določijo vrsto vrednosti in shemo REST, vključno z vrednostmi objektov in polj.
- Izvorna integracija: vrste polj po meri delujejo znotraj skupin, zavihkov, ponavljalnikov, polj po meri za večkratno uporabo, predlog in poti predlog razširitev.
- Predloge urejevalnika spletnega mesta: teme lahko določijo vire
wp_templateinwp_template_partiz datotek predlogtemplate.json,part.jsonin Blockstudio. - Otočki blokov: bloki lahko najprej izrišejo lupino, varno za predpomnjenje, nato pa po nalaganju strani hidrirajo ali paketno pridobijo fragmente, specifične za zahtevo.
- Shramba zbirke podatkov Storh:
bs.dblahko uporablja indeksirano shrambo z eno datoteko na zapis v mapi uploads, pri čemer ohrani javne celoštevilske ID-je in omogoča migracijo iz JSONC v Storh prek WP-CLI. - Izboljšave razčlenjevalnika in bsui: preslikani odstavki richtext potrebujejo manj kode za povezavo z razčlenjevalnikom,
InnerBlockslahko uporablja tokeniziraniallowedBlocks, izhod ugnezdenegabs_render_block()se v predogledih urejevalnika ujema z izrisom na sprednjem delu,bsui/buttonpa ponuja ikone in enostavnejše možnosti za oblikovanje. - Sestavljive oznake blokov: predpone se lahko razrešijo prek druge predpone (
<theme-ui-input>vbsui/input), oznake s predponami in vzdevki pa se izrišejo tudi v izhodu predlog blokov, ne le v vsebini strani. - Predpomnilniki gradnje, varni za gostitelja: predpomnilniki izvajalnega okolja in urejevalnika so zdaj privzeto zunaj mape uploads, podpirajo nastavljive lokacije in odstranjujejo zastarele vnose, zato se v dolgotrajnih projektih ne kopičijo datoteke predpomnilnika.
- Inkrementalno usklajevanje strani: orodja za uvajanje lahko uskladijo celoten inventar strani iz datotek, preskočijo nespremenjene objave, natančno poročajo o spremembah in po aktivaciji shranijo preverjeno identiteto vira.
- Hitrejše izrisovanje s toplim predpomnilnikom: veljavni predpomnilniki izvajalnega okolja se naložijo pred odkrivanjem, sočasne hladne zahteve objavijo en sam atomski rezultat, Tailwind pa ohrani predpomnilnik velikosti spletnega mesta z vnovično uporabljivim stanjem prevajalnika.
- Varno paketno izrisovanje: izvozniki lahko med dokumenti ponastavijo stanje izrisovanja, vezano na zahtevo, ne da bi znova gradili odkrivanje, in med izrisovanjem blokov zbirajo odvisnosti od virov.
Nove funkcije
Različica 7.5 prinaša obsežen nabor novih zmogljivosti za odkrivanje, predloge in shranjevanje.
Logični viri odkrivanja
Blockstudio običajno odkriva datoteke v fizičnih imenikih tem. Različica 7.5 dodaja nižjenivojski vir API za izvajalna okolja, ki sestavljajo temo iz prekrivnih plasti, predogledov, ustvarjenih datotek, oddaljenih priklopov ali drugih sestavljenih inventarjev.
Integracija lahko zagotovi končno logično drevo datotek, medtem ko Blockstudio ohrani odgovornost za bloke, polja, strani, vzorce, urejevalnik spletnega mesta, Canvas, sredstva in vedenje Tailwind:
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
);
Logične poti ostanejo stabilne, tudi ko sosednje datoteke izvirajo iz različnih fizičnih korenov. ID-ji virov in prstni odtisi določajo identitete predpomnilnikov izvajalnega okolja in Tailwind, spremljani vhodi pa jih razveljavijo, spremembe izvora pa določajo, kam je mogoče zapisati ustvarjene datoteke. Privzeti vir datotečnega sistema za običajne teme ostaja nespremenjen.
Predloge urejevalnika spletnega mesta iz datotek
Ekipe lahko strukture vsebine že hranijo v datotekah s stranmi in vzorci. Različica 7.5 ta model razširja na sam urejevalnik spletnega mesta.
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 izvor prevede z istim razčlenjevalnikom kot strani in vzorce, nato pa rezultat predstavi WordPress kot običajno predlogo ali del predloge urejevalnika spletnega mesta. Urejevalnik spletnega mesta prikaže predlogo, sprednji del jo lahko izriše, prilagoditve pa so še vedno v domeni WordPress.
Ta zadnji del je pomemben. Predloge iz datotek so rezervni vir. Če uporabnik shrani predlogo v urejevalniku spletnega mesta, WordPress ustvari običajno prilagoditev zbirke podatkov wp_template ali wp_template_part in ta različica ima prednost. Ko prilagoditev ponastavite, je znova vidna najnovejša različica iz datoteke.
Inkrementalno uvajanje strani
Strani iz datotek so v različici 7.5 dobile opravilo za usklajevanje uvajanja API. Od 7.6.2 sta edini vstopni točki za sinhronizacijo ta izrecna API in wp bs pages sync; običajne zahteve nikoli ne uveljavljajo sprememb virov:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
Postopek odkrije celoten želeni inventar strani, primerja vsebino in prstne odtise mehanizma za sinhronizacijo ter poroča o ustvarjenih, posodobljenih, nespremenjenih, odstranjenih in neuspešnih straneh. Pri straneh z enakimi prstnimi odtisi ne pride do zapisov objav ali metapodatkov objav. Manjkajoče upravljane strani se odstranijo šele, ko je odkrivanje uspešno končano brez napak.
Usklajevanje vrne deterministično identiteto vira, vendar uvajanja ne označi kot uspešnega. Orodja za uvajanje to identiteto shranijo šele, ko so ustrezne datoteke in poti aktivne in preverjene. Običajna inicializacija WP-CLI registrira predpomnjene vrste objav za zbirke in pravila za prepisovanje, ne da bi odkrivala in sinhronizirala vsako stran.
Otočki blokov
Večina blokov Blockstudio se izriše na strežniku. To je primerno za WordPress, vendar povzroči znano težavo s predpomnjenjem: en prilagojen blok lahko oteži predpomnjenje celotne strani.
Otočki blokov to mejo razdelijo na ravni bloka.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
Dinamični otoček v prvem odgovoru izriše samo nadomestni element, varen za predpomnjenje. Brskalnik nato pošlje eno združeno zahtevo za vse pripravljene dinamične otočke na strani, Blockstudio pa te fragmente izriše v dejanskem kontekstu zahteve obiskovalca.
To pomeni, da lahko celoten predpomnilnik strani shrani lupino strani, medtem ko število izdelkov v košarici, kontrolniki računa, UI z omejitvami dovoljenj in drugi elementi za posameznega uporabnika ostanejo posodobljeni.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
Za bloke, ki že izrisujejo HTML, varne za predpomnjenje, in potrebujejo samo signal za namestitev na sprednjem delu, uporabite hidrirani otoček:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
Hidrirani otočki ne ustvarijo zahteve REST. Izrišejo se običajno in na sprednjem delu prejmejo dogodek blockstudio:island:hydrate.
Dinamični otočki delujejo tudi prek programskih poti za izrisovanje:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
Tudi prek oznak blokov:
<bs:acme-cart-count product-id="42" />
Končna točka je namenoma omejena. Izriše samo registrirane bloke Blockstudio, ki so dinamični in izrecno označeni kot dinamični otočki. Atributi so filtrirani glede na shemo bloka in seznam dovoljenih otočkov, vsak označevalnik pa vsebuje podpis, ki ga ustvari strežna stran WordPress.
Shramba zbirke podatkov Storh
Plast zbirke podatkov Blockstudio že podpira tabele, SQLite, JSONC, metapodatke objav in vrste objav po meri. Različica 7.5 dodaja storage: "storh" za projekte, ki želijo shrambo iz datotek z varnejšim sočasnim zapisovanjem in indeksi, izpeljanimi iz sheme, vendar ne želijo živih zapisov shranjevati ob izvornih datotekah blokov.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
Zapisi Storh so shranjeni v mapi uploads:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
Javni API ostaja nespremenjen. bs.db(), REST in Db::get() še vedno vrnejo celoštevilske vrednosti id. Interno Blockstudio preslika te ID-je v ID-je dokumentov UUIDv7 v Storh, zato obstoječe odjemalske kode ni treba spreminjati.
Za enakostne filtre se indeksira vsako polje, določeno v shemi; številska polja in polja, podobna datumskim, dobijo indekse za obsege, izrecni namigi za enoličnost pa se posredujejo naprej. Za projekte, ki so začeli z začetnimi datotekami JSONC, nova migracija CLI ohrani izvorno datoteko in zapiše enakovredno shrambo Storh:
wp bs db migrate my-theme/app subscribers --to=storh
Tako dobi JSONC jasnejšo vlogo preprostega formata za začetne podatke ali konfiguracijo, ki ga je mogoče vključiti v sistem za nadzor različic, medtem ko Storh postane primernejša privzeta datotečna zaledna rešitev za zapisljive produkcijske podatke.
Izboljšave razčlenjevalnika in bsui
Različica 7.5 dopolnjuje tudi manjše podrobnosti, ki pridejo do izraza, ko projekt začne intenzivneje uporabljati predloge iz datotek in pakirane UI.
Preslikava elementov zdaj obravnava pogost primer odstavka richtext brez gradnika po meri. Če <p> preslika v registriran blok Blockstudio, ki ni del jedra in ima atribut richtext content, se preprosto notranje besedilo kopira v ta atribut. Ugnezdene oznake in preslikani podrejeni elementi se še naprej razčlenjujejo kot notranji bloki.
InnerBlocks v predlogah sprejema tokenizirani allowedBlocks:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Podprti žetoni so namespace/*, category:<slug> in @theme. Razširijo se na strežniku, preden predlogo prejme urejevalnik, zato pot izrisovanja na sprednjem delu ostane nespremenjena.
Programski vdelani elementi so zdaj tudi bolj predvidljivi. bs_render_block() in bs_block() zdaj izrisujeta vdelane bloke kot HTML, razrešene na sprednjem delu, tudi če sta poklicana znotraj predogleda drugega bloka v urejevalniku. To pomeni, da ugnezdeni bloki v označevalni kodi predogleda ne razkrijejo surovih psevdo-komponent <RichText /> ali <InnerBlocks />.
Za pakirani UI bsui/button zdaj podpira atribut icon in iconPosition. Pakirani vgrajeni slogi bsui/* se oddajo v kaskadni plasti @layer bsui, različice gumbov pa je mogoče razširiti z blockstudio/ui/button/variants-style in obstoječim filtrom blockstudio/blocks/attributes.
Oznake blokov so zdaj še bolj sestavljive. Predpona se lahko razreši prek druge predpone, zato se <theme-ui-input /> s projektno predpono theme nad imenskim prostorom predpone ui razreši v bsui/input. Registrirane oznake s predponami in vzdevki se zdaj izrišejo tudi v izhodu predlog blokov, ne le v vsebini strani, zato jih lahko predloga izpiše neposredno, namesto da pokliče bs_render_block().
Gradniki blokov po meri, registrirani prek blockstudio/block_tags/builders, zdaj dosledno sodelujejo tudi pri razčlenjevanju oznak in preslikanih elementov. Izrecni filtri izrisovalnika se še vedno izvedejo pozneje in lahko preglasijo gradnik.
Hitrejše zahteve s toplim predpomnilnikom in izvozi
Predpomnilnika izvajalnega okolja in urejevalnika sta zdaj privzeto v wp-content/blockstudio/cache namesto v mapi uploads. Lokacijo je mogoče spremeniti prek cache.path ali blockstudio/cache/dir, zato je trajno predpomnjenje na voljo tudi pri gostiteljih, ki blokirajo vsebine PHP v mapi uploads. Predpomnilniki izvajalnega okolja, sredstev urejevalnika in Tailwind tudi samodejno odstranjujejo zastarele vnose, zato se na disku v dolgotrajnih projektih datoteke predpomnilnika ne kopičijo brez omejitev.
Zahteve za sprednji del s toplim predpomnilnikom zdaj naložijo veljavni register izvajalnega okolja, še preden ustvarijo vire odkrivanja. S tem se preskočijo rekurzivno odkrivanje virov, ustvarjanje blokov, razčlenjevanje polj in ponavljajoči se sprehodi po drevesu za ključe predpomnilnika. Zahteve v produkcijskih in uprizoritvenih okoljih privzeto 20 sekund zaupajo preverjenemu posnetku spremljanja, medtem ko lokalna in razvojna okolja preverjajo ob vsaki zahtevi.
Ustvarjanje hladnega predpomnilnika se izvede samo enkrat. Ena zahteva zgradi in atomsko objavi vsebino, sočasne zahteve pa počakajo na dokončani rezultat. Tailwind zdaj privzeto hrani do 1,000 prevedenih vnosov 30 dni in znova uporablja toplo stanje ustvarjanja prevajalnika, zato nabor poti velikosti spletnega mesta ne povzroča več stalnega kroženja skozi majhen predpomnilnik.
Dolgotrajni izvozniki lahko med dokumenti pokličejo Blockstudio\Batch_Render::reset(). S tem počistijo števce, sredstva, otočke, postavitve in ustvarjanje Tailwind, vezane na zahtevo, ne da bi znova gradili odkrivanje. Filter blockstudio/render/dependencies razkrije poti predlog in sredstev, ki jih je uporabil vsak izrisani blok, za grafe odvisnosti.
Zanesljivost in združljivost
Izdajo dopolnjuje več popravkov:
- Definicije polj, spremenjene prek
blockstudio/blocks/attributes, zdaj določajo preverjanje možnosti med izrisovanjem in shemo urejevalnika. Tudi številske vrednosti in vrednosti logičnih možnosti se zdaj razrešujejo dosledno. - Ovoji blokov v urejevalniku uporabljajo iste ustvarjene razrede kot izris na sprednjem delu, Canvas pa lahko s filtrom
blockstudio/editor/canvas/body_classkopira nastavljene razrede telesa iz sprednjega dela. - Content Sync preveri celoten načrt virov pred uničujočimi zapisi, operacije čiščenja omeji na nastavljeni nabor vsebine in poroča o napakah pri zapisovanju datotek, ne da bi posodobil stanje sinhronizacije za to entiteto.
- Paketi Composer, vključeni v teme, aktivne prek simbolnih povezav, ali njihove nadrejene teme, zdaj razrešujejo sredstva urejevalnika iz javnega URL teme.
- Strani iz datotek s ključi ohranijo vrednosti polj Blockstudio, ki jih upravlja urejevalnik, pri sinhronizaciji preselijo starejšo ugnezdeno obliko ključa in sprejmejo številsko ničlo kot veljaven ključ.
- Dinamični otočki preverijo podpise pred filtri atributov zahtev, prezrejo nepodpisani kontekst zahteve, obnovijo obiskovalce, prijavljene z istega izvora, in se izognejo trkom v predpomnilniku za anonimne uporabnike.
- Končne točke surovih strani Markdown zdaj upoštevajo vidnost objav in zaščito z geslom.
- Kontrolniki urejevalnika zanesljiveje obravnavajo prazne pogoje, vrednosti za vklop ali izklop vseh potrditvenih polj, asinhrono osveževanje možnosti, dinamični vrstni red izrisovanja ter stanje RichText ali WYSIWYG v ponavljalnikih.
Vrste polj po meri
Več o vrstah polj po meri, predstavljenih zgoraj.
Zakaj vrste polj po meri?
Blockstudio bi moral biti uporaben že takoj po namestitvi, vendar pravi projekti pogosto potrebujejo kontrolnike za določeno področje: izbirnike žetonov za razmike, barvne vloge iz sistema oblikovanja, odzivne mere, vire ikon, izbirnike izdelkov ali uredniške kontrolnike, ki preslikajo strukturirano vrednost.
Pred različico 7.5 so ti projekti lahko sestavili več vgrajenih polj ali razcepili urejevalnik. Različica 7.5 ponuja podprto vmesno možnost: Blockstudio upravlja življenjski cikel polja, projekt pa kontrolnik.
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,
});
},
}),
),
);
},
});
Nato lahko polje uporabljate v block.json kot izvorno polje:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Običajne vrednosti predlog
Shranjena vrednost je na voljo v PHP, Twig in Blade kot vsak drug atribut Blockstudio.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
Iste poti do objektov delujejo tudi v predlogah razširitev:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Opombe o združljivosti
Obstoječe vgrajene vrste polj ostajajo nespremenjene. Enako velja za obstoječe skupine polj custom/{name} za večkratno uporabo. Imena vrst polj po meri morajo biti zapisane z malimi črkami in imenskim prostorom, na primer acme/dimensions; imenska prostora custom/ in blockstudio/ ostajata rezervirana.
Če PHP registrira vrsto polja, vendar njen skript urejevalnika ne registrira ustreznega kontrolnika, Blockstudio ohrani shranjeno vrednost in v urejevalniku prikaže obvestilo, ki ga ni mogoče urejati. Če vrsta polja ni registrirana v PHP, jo Blockstudio izpusti iz ustvarjenih atributov WordPress.
Vzdrževalna posodobitev 7.5.1
7.5.1 odstrani opozorilo o pretvorbi polja v niz, ki se je pojavilo med pripravo več izbranih vrednosti za izris. Shranjene in izrisane vrednosti so bile že pravilne, vendar se je lahko v dnevnikih za odpravljanje napak ob vsakem izrisu polja pojavilo eno opozorilo.
Spremljevalna posodobitev blockstudio/phpstan v0.1.7 prepozna tudi polja, ugnezdena v anonimne skupine, v PHP, Twig, Blade in izpeljanih oblikah atributov predlog. Obstoječi projekti lahko ta popravek paketa dobijo z composer update blockstudio/phpstan.