Dennis · 23. juli 2026
Blockstudio 7.5
Blockstudio 7.5 fuldender Blockstudios filbaserede workflow: brugerdefinerede felttyper, filbaserede Site Editor-skabeloner, blokøer, Storh-datalagring, logiske opdagelseskilder, sammensættelige bloktags samt hurtigere udrulning og runtime-stier.
Genbrugelige brugerdefinerede felter gør det allerede muligt for projekter at definere en gruppe eksisterende felter én gang og genbruge den med type: "custom/{name}". Brugerdefinerede felttyper løser et andet problem. De gør det muligt for et tema eller plugin at registrere en ny navnerumsafgrænset felttype, levere sin egen editor-kontrol og gemme værdien som almindelige Blockstudio-data.
Kort fortalt:
- Logiske discovery-kilder: runtimes kan levere en sammensat logisk temainventarliste, inklusive proveniens og cacheidentitet, mens Blockstudio stadig ejer discovery, søgning efter søskendefiler, genererede aktiver, Canvas og Tailwind-adfærd.
- PHP-felttyperegister: temaer og plugins kan registrere navnerumsopdelte felttyper såsom
acme/dimensionsmedbs_register_field_type()eller filteretblockstudio/field_types. - Register over editorstyring: tilpassede editorscripts kan kalde
window.blockstudio.registerFieldType()og gengive den tilsvarende React-styring i det normale Blockstudio-felt UI. - Strukturerede værdier: tilpassede felter kan gemme strenge, tal, booleske værdier, arrays eller objekter uden at tvinge objektværdier gennem normalisering af valgfelt.
- Lagerunderstøttelse: postmeta og tilpassede felter baseret på indstillinger kan angive deres værditype og REST-skema, inklusive objekt- og arrayværdier.
- Indbygget integration: tilpassede felttyper fungerer i grupper, faner, gentagere, genanvendelige tilpassede felter, skabeloner og udvidelsesskabelonstier.
- Site Editor-skabeloner: temaer kan definere
wp_template– ogwp_template_part-kilder fratemplate.json,part.jsonog Blockstudio-skabelonfiler. - Block islands: blokke kan først gengive en cache-sikker skal og derefter hydrere eller hente forespørgselsspecifikke fragmenter samlet, efter siden er indlæst.
- Storh-databaseopbevaring:
bs.dbkan bruge et indekseret fillager med én post pr. fil i uploads, hvor offentlige heltals-id’er bevares, og migrering fra JSONC til Storh sker via WP-CLI. - Forbedringer af parser og bsui: tilknyttede richtext-afsnit kræver mindre tilpasset parserkode,
InnerBlockskan bruge tokeniseretallowedBlocks, indlejretbs_render_block()-output stemmer overens med frontend-gengivelsen i editorforhåndsvisninger, ogbsui/buttonfår ikoner og nemmere stylinghooks. - Sammensættelige bloktags: præfikstags kan opløses gennem et andet præfiks (
<theme-ui-input>tilbsui/input), og præfiks- og aliastags gengives i blokskabelonoutput, ikke kun i sideindhold. - Værtsikre buildcacher: runtime- og editorcacher placeres nu som standard uden for uploads, understøtter konfigurerbare placeringer og fjerner forældede poster, så langvarige projekter ikke ophober cachefiler.
- Inkrementel sideafstemning: udrulningsværktøjer kan afstemme hele fillageret af sider, springe uændrede indlæg over, rapportere præcist, hvad der er ændret, og gemme en verificeret kildeidentitet efter aktivering.
- Hurtigere gengivelse ved varme caches: gyldige runtimecacher hydreres før discovery, samtidige kolde forespørgsler udgiver ét atomisk resultat, og Tailwind bevarer en cache på størrelse med sitet med genanvendelig compilertilstand.
- Sikker batchgengivelse: eksportværktøjer kan nulstille forespørgselsspecifik gengivelsestilstand mellem dokumenter uden at genopbygge discovery og indsamle kildeafhængigheder, mens blokke gengives.
Nye funktioner
7.5 introducerer en bred vifte af nye funktioner inden for discovery, skabeloner og lager.
Logiske discovery-kilder
Blockstudio finder normalt filer i fysiske temamapper. 7.5 tilføjer en kilde på lavere niveau, API, til runtimes, der sammensætter et tema fra overlejringer, forhåndsvisninger, genererede filer, eksterne mounts eller andre sammensatte fillagre.
En integration kan levere et endeligt logisk filtræ, mens Blockstudio fortsat ejer adfærden for blokke, felter, sider, mønstre, Site Editor, Canvas, aktiver og 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
);
Logiske stier forbliver stabile, selv når søskendefiler kommer fra forskellige fysiske rødder. Kilde-id’er og fingeraftryk indgår i runtime- og Tailwind-cacheidentiteter, ændringer i overvågede input invaliderer dem, og proveniens bestemmer, hvor genererede filer må skrives. Standardkilden fra filsystemet er uændret for normale temaer.
Filbaserede Site Editor-skabeloner
Sider og mønstre lader allerede teams gemme indholdsstrukturer i filer. 7.5 udvider denne model til selve Site Editor.
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 kompilerer kilden med den samme parser, som bruges til sider og mønstre, og gør derefter resultatet tilgængeligt for WordPress som en almindelig Site Editor-skabelon eller skabelondel. Site Editor viser skabelonen, frontend kan gengive den, og WordPress ejer stadig tilpasningerne.
Det sidste er vigtigt. Filbaserede skabeloner er reservekilden. Hvis en bruger gemmer en skabelon i Site Editor, opretter WordPress den normale wp_template– eller wp_template_part-databasetilpasning, og den version får forrang. Nulstil tilpasningen, og den nyeste filkilde bliver synlig igen.
Inkrementel sideudrulning
Filbaserede sider fik en afstemnings-API til udrulning i 7.5. Fra 7.6.2 er de eksplicitte API og wp bs pages sync de eneste indgange til synkronisering; almindelige forespørgsler anvender aldrig kildeændringer:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
Kørslen finder hele det ønskede sideinventar, sammenligner indhold og synkroniseringsmotorens fingeraftryk og rapporterer oprettede, opdaterede, uændrede, fjernede og mislykkede sider. Sider med ens fingeraftryk medfører ingen skrivninger til post eller postmeta. Manglende administrerede sider fjernes kun, når discovery er fuldført uden fejl.
Afstemningen returnerer en deterministisk kildeidentitet, men markerer ikke en udrulning som vellykket. Udrulningsværktøjer gemmer kun denne identitet, når de tilsvarende filer og ruter er aktive og verificerede. Almindelig bootstrap af WP-CLI registrerer cachelagrede samlingsindlægstyper og omskrivningsregler uden at finde og synkronisere hver side.
Block islands
De fleste Blockstudio-blokke gengives på serveren. Det passer godt til WordPress, men skaber et velkendt cacheproblem: Én personaliseret blok kan gøre hele siden vanskelig at cache.
Block islands deler denne grænse på blokniveau.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
En dynamisk island gengiver kun en cache-sikker pladsholder i det første svar. Browseren sender derefter én samlet forespørgsel for alle dynamiske islands, der er klar på siden, og Blockstudio gengiver disse fragmenter i den besøgendes faktiske forespørgselskontekst.
Det betyder, at en fuld sidecache kan gemme sideskallen, mens antal varer i kurven, kontostyring, tilladelsesbeskyttede UI eller andre brugerspecifikke dele stadig er opdaterede.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
Brug en hydreret island til blokke, der allerede gengiver cache-sikker HTML og kun behøver et signal om montering i frontend:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
Hydrerede islands sender ikke en REST-forespørgsel. De gengives normalt og modtager en blockstudio:island:hydrate-hændelse i frontend.
Dynamiske islands fungerer også via de programmatisk gengivelsesstier:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
Og via bloktags:
<bs:acme-cart-count product-id="42" />
Endpointet er bevidst afgrænset. Det gengiver kun registrerede Blockstudio-blokke, der er dynamiske og udtrykkeligt markeret som dynamiske islands. Attributter filtreres efter blokkens skema og island-tilladelseslisten, og hver markør har en signatur genereret af det WordPress-site, der leverer indholdet.
Storh-databaseopbevaring
Blockstudios databaselag understøtter allerede tabeller, SQLite, JSONC, postmeta og tilpassede indlægstyper. 7.5 tilføjer storage: "storh" til projekter, der ønsker et filbaseret lager med sikrere samtidige skrivninger og skemaafledte indekser, men ikke vil have aktive poster gemt sammen med kildefiler til blokke.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
Storh-poster ligger i uploads:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
Det offentlige API forbliver uændret. bs.db(), REST og Db::get() returnerer stadig heltalsværdier af typen id. Internt knytter Blockstudio disse id’er til Storhs dokument-id’er af typen UUIDv7, så eksisterende klientkode ikke behøver at blive ændret.
Alle deklarerede skemafelter indekseres til lighedsfiltre, numeriske og datolignende felter får områdeindekser, og eksplicitte hints om unikke værdier videreføres. For projekter, der begyndte med JSONC-seedfiler, bevarer den nye migrering CLI kildefilen på plads og skriver et tilsvarende Storh-lager:
wp bs db migrate my-theme/app subscribers --to=storh
Det giver JSONC en tydeligere rolle som et enkelt seed- og konfigurationsformat, der kan committes, mens Storh bliver det bedre standardfilbaserede backend til skrivbare produktionsdata.
Forbedringer af parser og bsui
7.5 finpudser også mindre dele, der typisk bliver relevante, når et projekt i højere grad bruger filbaserede skabeloner og bundlet UI.
Tilknytning af elementer kan nu håndtere det almindelige tilfælde med richtext-afsnit uden en tilpasset builder. Hvis <p> knyttes til en registreret ikke-kerne-Blockstudio-blok med en richtext-attribut af typen content, kopieres enkel indre tekst til attributten. Indlejrede tags og tilknyttede underelementer parses fortsat som indre blokke.
InnerBlocks accepterer tokeniseret allowedBlocks i skabeloner:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Understøttede tokens er namespace/*, category:<slug> og @theme. De udvides på serveren, før editoren modtager skabelonen, så frontendens gengivelsessti forbliver uændret.
Programmatisk indlejring er også mere forudsigelig. bs_render_block() og bs_block() gengiver nu indlejrede blokke som frontendopløste HTML, også når de kaldes fra forhåndsvisningen i en anden blok. Det betyder, at indlejrede blokke ikke lækker rå <RichText />– eller <InnerBlocks />-pseudokomponenter ind i forhåndsvisningsmarkup.
For bundlet UI understøtter bsui/button nu en icon-attribut og iconPosition. Bundtede inline-typografier fra bsui/* udskrives i et kaskadelag af typen @layer bsui, og knapvarianter kan udvides med blockstudio/ui/button/variants-style samt det eksisterende filter blockstudio/blocks/attributes.
Bloktags kan også sammensættes yderligere. Et præfiks kan opløses gennem et andet præfiks, så <theme-ui-input /> med projektpræfikset theme over navnerumspræfikset ui opløses til bsui/input. Registrerede præfiks- og aliastags gengives nu også i blokskabelonoutput, ikke kun i sideindhold, så en skabelon kan udsende dem direkte i stedet for at kalde bs_render_block().
Tilpassede blokbyggere, der er registreret via blockstudio/block_tags/builders, indgår også konsekvent i parsing af tags og tilknyttede elementer. Eksplicitte rendererfiltre køres stadig bagefter og kan tilsidesætte builderen.
Hurtigere varme forespørgsler og eksporter
Runtime- og editorcacher placeres nu som standard i wp-content/blockstudio/cache i stedet for uploads. Placeringen kan ændres via cache.path eller blockstudio/cache/dir, så vedvarende caching fortsat er muligt på værter, der blokerer PHP-payloads i uploads. Runtime-, editoraktiv- og Tailwind-cacher rydder også automatisk op i forældede poster, så langvarige projekter ikke længere ophober ubegrænsede mængder cachefiler på disken.
Varme frontendforespørgsler hydraterer nu et gyldigt runtime-register, før discovery-kilder oprettes. Det springer rekursiv kildesøgning, blokoprettelse, feltparsing og gentagne gennemgange af træer til cache-nøgler over. Produktions- og stagingforespørgsler stoler som standard på et valideret øjebliksbillede af overvågningen i 20 sekunder, mens lokale udviklingsmiljøer stadig kontrolleres ved hver forespørgsel.
Oprettelse af kold cache sker kun én gang ad gangen. Én forespørgsel bygger og udgiver payloaden atomisk, mens samtidige forespørgsler venter på resultatet. Tailwind bevarer nu op til 1,000 kompilerede poster i 30 dage som standard og genbruger varm compilertilstand, så et rutesæt på størrelse med sitet ikke længere skifter konstant gennem en lille cache.
Eksportværktøjer, der kører længe, kan kalde Blockstudio\Batch_Render::reset() mellem dokumenter. Det rydder forespørgselsspecifikke tællere, aktiver, islands, layouts og Tailwind-generering uden at genopbygge discovery. Filteret blockstudio/render/dependencies viser skabelon- og aktivstierne, som hver gengivet blok bruger, til afhængighedsgrafer.
Pålidelighed og kompatibilitet
Flere rettelser fuldender udgivelsen:
- Feltdefinitioner, der ændres via
blockstudio/blocks/attributes, styrer nu validering af indstillinger ved gengivelse såvel som editorskemaet. Typede numeriske og booleske indstillingsværdier opløses også konsekvent. - Editorens blokwrappere bruger de samme genererede klasser som frontendgengivelser, og Canvas kan kopiere de konfigurerede frontend-bodyklasser via det nye filter
blockstudio/editor/canvas/body_class. - Content Sync validerer hele kildeplanen før destruktive skrivninger, holder oprydningshandlinger inden for det konfigurerede indholdssæt og rapporterer fejl ved fils skrivning uden at fremrykke synkroniseringstilstanden for den pågældende enhed.
- Composer-pakker, der er bundtet i aktive temaer eller overordnede temaer med symlinks, finder editoraktiver via det offentlige temaprefix URL.
- Nøglebaserede filsider bevarer Blockstudio-feltværdier, som editoren ejer, migrerer den ældre indlejrede nøgleform ved synkronisering og accepterer numerisk nul som en gyldig nøgle.
- Dynamiske islands verificerer signaturer før filtre på forespørgselsattributter, ignorerer usigneret forespørgselskontekst, gendanner besøgende, der er logget ind fra samme oprindelse, og undgår cachekollisioner mellem anonyme brugere.
- Rå Markdown-sideendpoints respekterer nu indlægs synlighed og adgangskodebeskyttelse.
- Editorstyringer håndterer tomme betingelser, værdier til slå-alt-til/fra for afkrydsningsfelter, asynkrone opdateringer af indstillinger, dynamisk gengivelsesrækkefølge samt RichText- og WYSIWYG-tilstand i gentagere mere pålideligt.
Tilpassede felttyper
Mere om de tilpassede felttyper, der blev introduceret ovenfor.
Hvorfor tilpassede felttyper?
Blockstudio skal være nyttigt direkte fra start, men virkelige projekter har ofte brug for domænespecifikke styringer: vælgere til afstandstokens, farveroller fra designsystemer, responsive dimensioner, ikonbaser, produktvælgere eller redaktionelle styringer, der knyttes til en struktureret værdi.
Før 7.5 kunne disse projekter enten sammensætte flere indbyggede felter eller forgrene editoren. 7.5 giver dem en understøttet mellemvej: Blockstudio ejer feltets livscyklus, og projektet ejer styringen.
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,
});
},
}),
),
);
},
});
Derefter kan feltet bruges i block.json som et indbygget felt:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Almindelige skabelonværdier
Den gemte værdi er tilgængelig i PHP, Twig og Blade som enhver anden Blockstudio-attribut.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
De samme objektstier fungerer også i udvidelsesskabeloner:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Kompatibilitetsnoter
Eksisterende indbyggede felttyper er uændrede. Eksisterende genanvendelige feltgrupper i custom/{name} er også uændrede. Navne på tilpassede felttyper skal være med små bogstaver og have et navnerum, f.eks. acme/dimensions; navnerummene custom/ og blockstudio/ er fortsat reserverede.
Hvis PHP registrerer en felttype, men dens editorscript ikke registrerer den tilsvarende styring, bevarer Blockstudio den gemte værdi og viser en meddelelse i editoren, som ikke kan redigeres. Hvis en felttype ikke er registreret i PHP, udelader Blockstudio den fra genererede WordPress-attributter.
7.5.1-vedligeholdelsesopdatering
7.5.1 fjerner en advarsel om konvertering fra array til streng, der blev udløst under klargøring af værdier til flere valg til gengivelse. De gemte og gengivne værdier var allerede korrekte, men fejllogs kunne modtage én advarsel for hver feltgengivelse.
Den tilhørende blockstudio/phpstan-v0.1.7-opdatering genkender også felter, der er indlejret i anonyme grupper på tværs af PHP, Twig, Blade og udledte skabelonattributformer. Eksisterende projekter kan få denne pakkerettelse med composer update blockstudio/phpstan.