Dennis · 23 juli 2026
Blockstudio 7.5
Blockstudio 7.5 fullbordar Blockstudios filbaserade arbetsflöde med anpassade fälttyper, filbaserade mallar för Site Editor, blocköar, Storh-databaslagring, logiska upptäcktskällor, komponerbara blocktaggar och snabbare vägar för driftsättning och körning.
Återanvändbara anpassade fält låter redan projekt definiera en grupp befintliga fält en gång och återanvända den med type: "custom/{name}". Anpassade fälttyper löser ett annat problem. De låter ett tema eller plugin registrera en ny fälttyp med namnrymd, tillhandahålla ett eget redigerarkontrollelement och lagra värdet som vanliga Blockstudio-data.
Kortversionen:
- Logiska upptäcktskällor: körmiljöer kan tillhandahålla ett sammansatt logiskt temainnehåll, inklusive ursprung och cacheidentitet, medan Blockstudio ansvarar för upptäckt, lösning av syskonfiler, genererade resurser, Canvas och beteendet hos Tailwind.
- PHP fälttypsregister: teman och tillägg kan registrera namngivna fälttyper, till exempel
acme/dimensionsmedbs_register_field_type()eller filtretblockstudio/field_types. - Register för redigerarkontroller: anpassade redigerarskript kan anropa
window.blockstudio.registerFieldType()och visa motsvarande React-kontroll i det vanliga fältet Blockstudio UI. - Strukturerade värden: anpassade fält kan lagra strängar, tal, booleska värden, arrayer eller objekt utan att objektvärden omvandlas genom normalisering av alternativfält.
- Lagringsstöd: anpassade fält för inläggsmetadata och alternativ kan ange sin värdetyp och sitt REST-schema, inklusive objekt- och arrayvärden.
- Inbyggd integrering: anpassade fälttyper fungerar i grupper, flikar, upprepningsfält, återanvändbara anpassade fält, mallar och tilläggens mallsökvägar.
- Site Editor-mallar: teman kan definiera
wp_template– ochwp_template_part-källor från mallfilernatemplate.json,part.jsonoch Blockstudio. - Blocköar: block kan först rendera ett cachningssäkert skal och sedan hydrera eller hämta begärandespecifika fragment i en samlad begäran efter att sidan har lästs in.
- Storh databaslagring:
bs.dbkan använda ett indexerat fillager med en fil per post i uppladdningsmappen, med publika heltals-ID:n bevarade och migrering från JSONC till Storh via WP-CLI. - Förbättringar av parser och bsui: mappade richtext-stycken kräver mindre anpassad parserkod,
InnerBlockskan använda tokeniseradallowedBlocks, nästladbs_render_block()-utdata motsvarar frontend-renderingen i förhandsvisningar i redigeraren, ochbsui/buttonfår ikoner samt enklare möjligheter till anpassad stil. - Sammansättningsbara blocktaggar: prefixtaggar kan lösas via ett annat prefix (
<theme-ui-input>tillbsui/input), och prefix- och aliastaggar renderas i blockmallar, inte bara i sidinnehåll. - Värdsäkra byggcachar: körmiljö- och redigerarcachar sparas nu som standard utanför uppladdningsmappen, har konfigurerbara platser och rensar gamla poster så att långlivade projekt inte samlar på sig cachefiler.
- Inkrementell sidsynkronisering: driftsättningsverktyg kan stämma av hela fillagerbaserade sidinventeringen, hoppa över oförändrade inlägg, rapportera exakt vad som ändrats och spara en verifierad källidentitet efter aktivering.
- Snabbare varm rendering: giltiga körmiljöcachar hydreras före upptäckt, samtidiga kalla begäranden publicerar ett atomiskt resultat och Tailwind behåller en cache i webbplatsstorlek med återanvändbart kompilatortillstånd.
- Säker batchrendering: exportverktyg kan återställa begärandespecifikt renderingtillstånd mellan dokument utan att bygga om upptäckten, och samla in källberoenden medan block renderas.
Nya funktioner
7.5 introducerar en bred uppsättning nya funktioner för upptäckt, mallar och lagring.
Logiska upptäcktskällor
Blockstudio hittar normalt filer i fysiska temakataloger. I 7.5 tillkommer den lågnivåkälla API för körmiljöer som sätter samman ett tema av överlägg, förhandsvisningar, genererade filer, fjärrmonterade filsystem eller andra sammansatta innehållsförteckningar.
En integrering kan tillhandahålla ett färdigt logiskt filträd medan Blockstudio fortsatt ansvarar för block, fält, sidor, mönster, Site Editor, Canvas, resurser och beteendet hos 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
);
Logiska sökvägar förblir stabila även när syskonfiler kommer från olika fysiska rötter. Käll-ID:n och fingeravtryck används för körmiljöns och Tailwind cacheidentiteter, bevakade indata gör att cacharna ogiltigförklaras vid ändringar och ursprungsinformationen styr var genererade filer får skrivas. Standardkällan för filsystemet är oförändrad för vanliga teman.
Fillagrade Site Editor-mallar
Team kan redan spara innehållsstrukturer som filer med sidor och mönster. I 7.5 utvidgas den modellen till själva 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 kompilerar källan med samma parser som används för sidor och mönster och gör sedan resultatet tillgängligt för WordPress som en vanlig Site Editor-mall eller malldel. Mallen visas i Site Editor, kan renderas i frontend och WordPress fortsätter att hantera anpassningar.
Den sista delen är viktig. Fillagrade mallar fungerar som reservkälla. Om en användare sparar en mall i Site Editor skapar WordPress den vanliga databasanpassningen wp_template eller wp_template_part, och den versionen används. Återställ anpassningen så visas den senaste filkällan igen.
Inkrementell driftsättning av sidor
Fillagrade sidor fick en avstämningsfunktion för driftsättning API i 7.5. Från och med 7.6.2 är den uttryckliga API och wp bs pages sync de enda ingångarna för synkronisering; vanliga begäranden tillämpar aldrig källändringar:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
Genomgången hittar hela den önskade sidinventeringen, jämför innehåll och synkmotorns fingeravtryck och rapporterar skapade, uppdaterade, oförändrade, borttagna och misslyckade sidor. För sidor med identiska fingeravtryck görs inga ändringar i inlägg eller inläggsmetadata. Saknade hanterade sidor rensas bort först när upptäckten har slutförts utan fel.
Avstämningen returnerar en deterministisk källidentitet men markerar inte driftsättningen som lyckad. Driftsättningsverktygen sparar identiteten först när motsvarande filer och rutter är aktiva och verifierade. Den vanliga initieringen av WP-CLI registrerar cachade samlingsinläggstyper och omskrivningsregler utan att upptäcka och synkronisera varje sida.
Blocköar
De flesta Blockstudio-block renderas på servern. Det passar bra för WordPress, men skapar ett välbekant cachningsproblem: ett enda personanpassat block kan göra hela sidan svår att cacha.
Blocköar delar upp den gränsen på blocknivå.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
En dynamisk ö renderar bara en cachningssäker platshållare i det första svaret. Webbläsaren skickar sedan en enda samlad begäran för alla dynamiska öar som är klara på sidan, och Blockstudio renderar fragmenten i besökarens faktiska begärandekontext.
Det innebär att en helsidescache kan lagra sidans skal medan varukorgens antal, kontroller för kontot, behörighetsstyrda UI och andra delar som är specifika för varje användare ändå hålls uppdaterade.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
För block som redan renderar cachningssäker HTML och bara behöver en monteringssignal i frontend, använder du en hydrerad ö:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
Hydrerade öar gör ingen begäran till REST. De renderas normalt och får en blockstudio:island:hydrate-händelse i frontend.
Dynamiska öar fungerar även via programmatiska renderingssökvägar:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
Och via blocktaggar:
<bs:acme-cart-count product-id="42" />
Slutpunkten är avsiktligt begränsad. Den renderar endast registrerade Blockstudio-block som är dynamiska och uttryckligen markerade som dynamiska öar. Attribut filtreras mot blockschemat och öarnas tillåtelselista, och varje markör har en signatur som genererats av webbplatsen WordPress som hanterar begäran.
Databaslagring i Storh
Blockstudios databaslager stöder redan tabeller, SQLite, JSONC, inläggsmetadata och anpassade inläggstyper. I 7.5 tillkommer storage: "storh" för projekt som vill ha fillagring med säkrare samtidiga skrivningar och schemahärledda index, men inte vill spara aktiva poster bredvid blockens källfiler.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
Storh-poster lagras i uppladdningsmappen:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
Den publika API förblir oförändrad. bs.db(), REST och Db::get() returnerar fortfarande heltalsvärden i id. Internt mappar Blockstudio dessa ID:n till Storhs dokument-ID:n i UUIDv7, så befintlig klientkod behöver inte ändras.
Alla deklarerade schemafält indexeras för likhetsfilter, numeriska och datumliknande fält får intervallindex och uttryckliga unika attribut förs vidare. För projekt som startade med JSONC-seedfiler behåller den nya migreringen CLI källfilen på plats och skriver ett likvärdigt Storh-lager:
wp bs db migrate my-theme/app subscribers --to=storh
Det ger JSONC en tydligare roll som ett enkelt seed- och konfigurationsformat som går att versionshantera, medan Storh blir ett bättre standardval för skrivbara produktionsdata.
Förbättringar av parser och bsui
7.5 finslipar också mindre detaljer som ofta blir synliga när ett projekt i högre grad förlitar sig på fillagrade mallar och paketerade UI.
Elementmappning kan nu hantera det vanliga fallet med richtext-stycken utan en anpassad byggare. Om <p> mappas till ett registrerat block som inte är kärnfunktionalitet i Blockstudio och har ett richtext-attribut content, kopieras enkel brödtext till det attributet. Nästlade taggar och mappade underordnade element parsas fortfarande som inre block.
InnerBlocks stöder tokeniserad allowedBlocks i mallar:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Tokenen som stöds är namespace/*, category:<slug> och @theme. De expanderas på servern innan redigeraren får mallen, så renderingssökvägen i frontend förblir oförändrad.
Programmatiska inbäddningar är också mer förutsägbara. bs_render_block() och bs_block() renderar nu inbäddade block som HTML som löses i frontend, även när de anropas inifrån ett annat blocks förhandsvisning i redigeraren. Det innebär att nästlade block inte läcker råa <RichText />– eller <InnerBlocks />-pseudokomponenter till förhandsvisningens markup.
För paketerade UI stöder bsui/button nu ett attribut för icon och iconPosition. Paketerade inline-stilar i bsui/* avges i ett @layer bsui-kaskadlager, och knappvarianter kan utökas med blockstudio/ui/button/variants-style samt det befintliga filtret blockstudio/blocks/attributes.
Blocktaggar kan också kombineras på fler sätt. Ett prefix kan lösas via ett annat prefix, så <theme-ui-input /> med projektprefixet theme ovanpå namnrymdsprefixet ui löses till bsui/input. Registrerade prefix- och aliastaggar renderas nu även i blockmallars utdata, inte bara i sidinnehåll, så en mall kan visa dem direkt i stället för att anropa bs_render_block().
Anpassade blockbyggare som registrerats via blockstudio/block_tags/builders deltar nu också konsekvent i parsning av taggar och mappade element. Uttryckliga rendererfilter körs fortfarande efteråt och kan åsidosätta byggaren.
Snabbare varma begäranden och exporter
Körmiljö- och redigerarcachar sparas nu som standard i wp-content/blockstudio/cache i stället för i uppladdningsmappen. Platsen kan ändras via cache.path eller blockstudio/cache/dir, vilket gör beständig cachning tillgänglig på värdar som blockerar PHP-nyttolaster i uppladdningsmappen. Körmiljö-, redigerarresurs- och Tailwind-cachar rensar också gamla poster automatiskt, så långlivade projekt inte längre samlar på sig obegränsat med cachefiler på disken.
Varma frontendbegäranden hydratiserar nu ett giltigt körmiljöregister innan upptäcktskällor skapas. Det hoppar över rekursiv källupptäckt, blockkonstruktion, fältparsning och upprepade genomgångar av trädet för cachenycklar. Begäranden i produktions- och stagingmiljöer förlitar sig som standard på en validerad bevakningsögonblicksbild i 20 sekunder, medan lokala miljöer och utvecklingsmiljöer fortfarande kontrolleras vid varje begäran.
Skapandet av en kall cache samordnas så att bara en begäran bygger den. Den begäran skapar och publicerar nyttolasten atomiskt medan samtidiga begäranden väntar på resultatet. Tailwind behåller nu som standard upp till 1,000 kompilerade poster i 30 dagar och återanvänder tillstånd från varm kompilatorkonstruktion, så att en uppsättning rutter i webbplatsstorlek inte längre ständigt ersätter poster i en liten cache.
Långlivade exportverktyg kan anropa Blockstudio\Batch_Render::reset() mellan dokument. Det rensar begärandespecifika räknare, resurser, öar, layouter och genereringen av Tailwind utan att bygga om upptäckten. Filtret blockstudio/render/dependencies visar mall- och resurssökvägarna som används av varje renderat block för beroendegrafer.
Tillförlitlighet och kompatibilitet
Flera korrigeringar kompletterar versionen:
- Fältdefinitioner som ändras via
blockstudio/blocks/attributesstyr nu validering av alternativ vid rendering, liksom redigerarens schema. Typade numeriska och booleska alternativvärden hanteras också konsekvent. - Blockomslag i redigeraren använder samma genererade klasser som frontend-renderingar, och Canvas kan kopiera de konfigurerade body-klasserna från frontend via det nya filtret
blockstudio/editor/canvas/body_class. - Content Sync validerar hela källplanen före destruktiva skrivningar, begränsar rensningsåtgärder till det konfigurerade innehållsurvalet och rapporterar filskrivningsfel utan att uppdatera synkroniseringstillståndet för den posten.
- Composer-paket som ingår i aktiva teman eller överordnade teman via symboliska länkar hittar redigerarresurser i det publika temats URL.
- Nycklade fillagrade sidor bevarar värden i fältet Blockstudio som redigeraren äger, migrerar det äldre nästlade nyckelformatet vid synkronisering och godtar numerisk nolla som en giltig nyckel.
- Dynamiska öar verifierar signaturer innan attributfilter för begäran körs, ignorerar osignerad begärandekontext, återställer inloggade besökare från samma ursprung och undviker cachningskollisioner för anonyma användare.
- Råa Markdown-slutpunkter för sidor respekterar nu inläggens synlighet och lösenordsskydd.
- Redigerarkontroller hanterar tomma villkor, växla-alla-värden för kryssrutor, asynkrona uppdateringar av alternativ, dynamisk renderingsordning samt RichText- och WYSIWYG-tillstånd i upprepningsfält på ett tillförlitligare sätt.
Anpassade fälttyper
Mer om de anpassade fälttyperna som introducerades ovan.
Varför anpassade fälttyper?
Blockstudio ska vara användbart direkt, men verkliga projekt behöver ofta domänspecifika kontroller: väljare för avståndstoken, färgroller för designsystem, responsiva mått, ikonresurser, produktväljare eller redaktionella kontroller som mappar till ett strukturerat värde.
Före 7.5 kunde projekten antingen kombinera flera inbyggda fält eller skapa en egen variant av redigeraren. I 7.5 får de ett stödd alternativ däremellan: Blockstudio hanterar fältets livscykel och projektet ansvarar för kontrollen.
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,
});
},
}),
),
);
},
});
Därefter kan fältet användas i block.json precis som ett inbyggt fält:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Vanliga mallvärden
Det sparade värdet är tillgängligt i PHP, Twig och Blade precis som alla andra attribut för Blockstudio.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
Samma objektsökvägar fungerar även i tilläggsmallar:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Kompatibilitetsinformation
Befintliga inbyggda fälttyper är oförändrade. Befintliga återanvändbara fältgrupper i custom/{name} är också oförändrade. Namn på anpassade fälttyper måste vara gemener och ha en namnrymd, till exempel acme/dimensions. Namnrymderna custom/ och blockstudio/ är reserverade.
Om PHP registrerar en fälttyp men dess redigerarskript inte registrerar motsvarande kontroll, behåller Blockstudio det sparade värdet och visar ett meddelande i redigeraren om att fältet inte kan redigeras. Om en fälttyp inte har registrerats i PHP utelämnar Blockstudio den från genererade WordPress-attribut.
Underhållsuppdatering av 7.5.1
7.5.1 tar bort en varning om konvertering från array till sträng som visades när flera val förbereddes för rendering. De sparade och renderade värdena var redan korrekta, men felsökningsloggar kunde få en varning för varje fältrendering.
Den tillhörande uppdateringen blockstudio/phpstan v0.1.7 känner också igen fält inuti namnlösa grupper i PHP, Twig, Blade och härledda mallattributstrukturer. Befintliga projekt kan få paketkorrigeringen med composer update blockstudio/phpstan.