Dennis · 14 oktober 2026
Blockstudio 7.7
Blockstudio 7.7 lägger till virtuella rutter för dokument utan ett WordPress-inlägg, förbättrar riktade förhandsrenderingsbyggen och gör det tillförlitligare att redigera och rendera befintliga block. Dessutom utökas PHPStans kontroller av blocktaggar och tillgängligheten förbättras i de medföljande komponenterna från UI.
Det filbaserade arbetsflödet förblir detsamma. Block renderas från sina mallar och filbaserade sidor ändras genom en uttrycklig synkronisering av CLI eller API. Den här versionen introducerar ingen automatisk synkronisering av sidor vid besökar- eller adminförfrågningar.
Kortversionen:
- Virtuella rutter: visa ett komponentgalleri, en katalog eller ett annat komplett dokument utan att skapa ett inlägg eller skriva en egen omdirigeringshanterare.
- Riktade förhandsrenderingsbyggen: byggen i läget HTTP registrerar vilka källfiler varje sida använder, så att ett senare bygge endast kan rendera berörda rutter.
- Cachebevarande: behåll gamla stilmallar tillgängliga för cachade sidor och granska eller rensa oanvända poster i kartan för tidig visning.
- Tillförlitligare redigering: flermarkerade block behåller sina egna värden, ångra och gör om fungerar för RichText- och sidofältsfält, och ärvd kontext förblir kopplad till rätt block.
- Bibehållen filstruktur: nästlade listor, sektionsindelande element, inline-HTML, kortkoder och escapade attribut bevaras vid parsning och rendering.
- Förbättringar i PHPStan: prefix-taggar, alias, mappade sidelement och mallvariabler kontrolleras mot projektets egna definitioner.
- Tillgängligt UI: kontroller visar sitt tillstånd korrekt, etiketter växlar rätt indatafält och list- och tabellkomponenter använder giltig struktur för HTML.
- Översättningar: installerade översättningar för JavaScript läses in i redigeraren och adminöversikten, även fältkontroller som tidigare saknade översättning.
Virtuella rutter
Vissa sidor kommer från data i stället för ett inlägg som ägs av redigeraren. En komponentreferens kan till exempel behöva ett eget URL och en dokumenttitel, men ingen post i wp_posts.
Registrera dokumentet med Blockstudio\Virtual_Routes:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
Rutten visar /components/. Callbacken körs i Blockstudios utdatabuffert, så renderade block får sina stilmallar, skript, medföljande UI-resurser och Tailwind-utdata via den vanliga bearbetningskedjan. WordPress gör inte den matchade rutten till ett 404 och omdirigerar den inte till ett inlägg.
För en grupp URL:er anger du prefix som true och tillhandahåller en callback för match. Callbacken tar emot sökvägen under rutten och returnerar värdet som din renderare behöver. Om null eller false returneras lämnas begäran till WordPress. Använd urls för att lista sökvägarna som ett statiskt förhandsrenderingsbygge ska ta med. En enskild rutt utan prefix tar med sin egen sökväg som standard.
Virtual_Routes::urls() returnerar absoluta URL:er för integrationer som bygger en webbplatskarta. Virtuella dokument läggs inte automatiskt till i WordPresss webbplatskarta för inlägg.
Se Virtuella rutter för den fullständiga API och alternativen.
Mer precisa förhandsrenderingsbyggen
Byggen i graf-läge som renderats över HTTP registrerar nu vilka filer varje rutt använde: mallen WordPress, renderade blockmallar och resurser, definitioner och layouter för filbaserade sidor samt beroenden som lagts till genom blockstudio/render/dependencies.
Vid nästa bygge jämför build_plan() dessa beroenden. Om en blockmall ändras markeras dess beroende rutter för rendering, utan att alla orelaterade sidor byggs om. Ändringar i delad konfiguration påverkar fortfarande hela bygget, och nya eller utgångna rutter renderas som tidigare.
Ändringar som enbart görs i databasen är inte filberoenden. Om en driftsättning behöver hämta ett alternativ, ett inlägg eller ett annat datab värde måste ett bygge tvingas fram eller de berörda URL:erna renderas uttryckligen.
Versionen åtgärdar också att byggidentiteter ändras under den första renderingen, inaktuella tidiga visningskartor cachade av opcode-cache och att giltiga URL:er utesluts enbart för att deras sökväg innehåller search eller preview. Markdown-begäranden som använder Accept: text/markdown kringgår cachad HTML, och relevanta svar skickar Vary: Accept.
Statisk förhandsrendering följer nu filter som registrerats av det aktiva temat när den avgör om dess hooks ska kopplas in. Ett tema kan stänga av funktionen utan att en tidigare inställningskontroll lämnar den aktiv.
Cachebevarande och underhåll
En cachad sida med HTML kan leva längre än körtidsidentiteten som kompilerade dess stilmall. cache.namespaceGrace styr hur länge gamla namnrymder förblir tillgängliga efter att rensningen först upptäckt att de tagits ur bruk:
{
"cache": {
"namespaceGrace": 777600
}
}
Det här exemplet behåller gamla filer i nio dagar. Standardvärdet är en dag. Aktiva namnrymder och namnrymder som används av driftsatta förhandsrenderingsartefakter skyddas från rensning av gamla filer.
Kartan för tidig visning har också kommandon för granskning och rensning:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
De rapporterar och tar bort poster för borttagna webbplatser eller saknade kataloger. När en webbplats i en multisite-installation tas bort raderas även dess poster. Saknade ruttdokument rapporteras separat i stället för att leda till att en hel, giltig webbplatspost tas bort.
Se Cachelagring för vägledning om bevarande och underhåll av kartan för kommandona.
En tillförlitligare redigerare
Redigering av ett flermarkerat block uppdaterar nu endast det blocket. När du sparar behåller varje block sitt eget innehåll, sina nycklar, metadata och lås i stället för att attribut kopieras mellan markerade block.
RichText-värden lagras direkt i blockattributen, så Gutenberg kan ta med dem i ångra och göra om. Sidofältsfält ingår i samma historik. InnerBlocks templateLock="false" skickas som ett riktigt booleskt värde och låser upp innehållet även när ett yttre område är låst.
Inledande förhandsinläsningar får ID och typ för det redigerade inlägget, så att mallar kan läsa rätt metadata redan vid den första renderingen. Identiska underordnade block under olika överordnade block behåller separat ärvd kontext i förhandsinläsningar och renderingscachar. Ändringar av attribut eller kontext under en inledande begäran gör inte längre att förhandsvisningen hamnar efter.
Blockstudio slutar också infoga dolda renderingsmarkörelement mellan blockrötter. Väljaruttryck för intilliggande syskon, till exempel .card + .card, ser nu samma elementrelationer i redigeraren som i frontend, medan förhandsrenderingar i redigeraren och infogaren förblir separata.
Säkrare lagring av alternativ för hela webbplatsen
Fält som bygger på alternativ ger fortfarande värden för hela webbplatsen, men när ett inlägg sparas skrivs inte längre varje sparad kopia av dessa fält blint:
- Utkast, väntande, privata och schemalagda sparningar skriver inte till aktiva webbplatsalternativ.
- Publicerade sparningar skriver de angivna fält som ändrades i redigeringen.
- En sparning där endast titeln ändras återställer inte ett nyare värde för hela webbplatsen från en gammal kopia.
- Saknade fält och borttagna block raderar inte befintliga alternativ.
- Ett uttryckligt
nulltar bort ett alternativ. Tomma strängar,false, noll och tomma arrayer förblir giltiga värden.
Detta är den viktigaste beteendeförändringen att kontrollera vid uppgradering. Om en integration använde ett privat inlägg eller utkast för att uppdatera ett aktivt alternativ ska alternativet skrivas uttryckligen eller ett publicerat konfigurationsinlägg användas i stället. Lagring av postmeta påverkas inte av kravet på publicering.
Se Lagring för alla sparregler.
Filinnehållet förblir intakt
Pipelinen från HTML till block bevarar mer av strukturen du skrev:
- Nästlade listor blir inre listblock i sitt överordnade objekt. Klasser för listor och objekt bevaras; vanliga platta listor behåller sitt tidigare utdata.
main,header,footer,articleochasideblir gruppblock som bevarar sitt element i stället för rå HTML som kringgår blockrenderingen.- Mappade RichText-stycken behåller inline-markup, stycken som enbart innehåller bilder löses upp till det mappade bildblocket och kortkodstaggar behåller sitt innehåll.
- Escapade attribut avkodas och escapats en gång, även attribut på
InnerBlocks,RichTextoch elementetuseBlockProps. - Större-än-tecken i citerade attribut för självstängande taggar godtas.
- Globala attribut för HTML förs vidare till roten i ett Blockstudio-block när blocket inte deklarerar dem som fält.
wp bs pages syncrapporterar lagrade attribut som inte renderas.
Sidor, mönster och mallar för Webbplatsredigeraren som bygger på Blade renderas nu genom Blockstudio\Blade_Renderer och stöder illuminate/view 8 till 12. Tilläggsfiler som riktar sig till samma block registreras alla, och deras prioritet, gruppfält och mållistor följer det dokumenterade schemat.
Även nästlade beroenden av SCSS spåras. Om en delmall som importeras av en annan delmall redigeras ändras den beroende stilmallens version och omkompilering utlöses.
Förbättringar i PHPStan
Det separat installerade paketet blockstudio/phpstan utökar valideringen av blocktaggar till prefix- och aliastaggar, mappade sidelement, layouter, medföljande UI-block och, valfritt, andra källor för PHP i projektet. Namnrymdsupplösningen överensstämmer med körtiden, även för namnrymder med bindestreck, och vidarebefordrade globala attribut för HTML godtas.
Mallvariabler för block som $a, $block och $context behandlas som definierade av Blockstudio. Fälttyper bevaras genom null-koalescering och isset() under PHPStan 2.3, medan en mall som tilldelar ett eget $a behåller den tilldelade typen.
Dessa ändringar ingår i blockstudio/phpstan 0.1.9. Uppdatera paketet separat från tillägget; det kräver PHPStan 2.1.47 eller senare:
composer require --dev blockstudio/phpstan:^0.1.9
Se PHPStan för konfiguration och analysförinställningar.
Tillgänglighet och översättningar
Knappar för UI i de medföljande komponenterna visar nu sitt utökade läge på den faktiska knappen. Etiketter för kryssrutor, växlar och alternativknappar namnger och aktiverar sina kontroller. Brödsmulor, paginering, navigeringsmenyer och tabeller infogar inte längre ogiltiga omslutande element mellan listor eller tabeller och deras underordnade element.
Växlar för lösenord visar sitt nedtryckta läge och har en större klickyta. Inmatningsfält godtar autocomplete, och lösenordsfält godtar ett uttryckligt ID och en tillgänglig etikett. Karusellens visningsytor kan nås med tangentbordets fokus, och animeringar för laddningsindikatorer och skelett respekterar inställningar för minskad rörelse.
Redigeraren och adminöversikten läser in installerade översättningar för JavaScript för textdomänen blockstudio. Attributmenyer och platshållare, åtgärder i kodpopupen samt märken för bilder och filer kan nu översättas. Strängar utan översättning visas fortfarande på engelska.
Se biblioteket UI och översättningsinställningarna.
Dokumentation och uppgradering
Dokumentationen kompletteras med guider för dokumentationswebbplatser, Content Sync, Site Editor-mallar, blocktaggar, islands, anpassade fälttyper, driftsättning, förhandsrendering, registerkonfiguration, analysverktyg och UI appskärmar. ACF-migreringsguiden återspeglar aktuell ACF-registrering och Block Bindings.
Exemplen på anpassad populate använder nu det filter som stöds med ett argument och ett namngivet dataset. Tillgångsdokumentationen förklarar ordningen på formatmallar i frontend och hur du laddar temats åsidosättningar efter block-CSS. Bidragsgivare installerar nu det offentliga Font Awesome-paketet utan autentiseringsuppgifter för register.
PHP 8.2 och WordPress 6.7 är fortfarande minimikraven. Virtuella rutter och de nya underhållskommandona är tillgängliga utan att befintliga sidkollektioner ändras. Granska reglerna för att spara alternativlagring ovan, uppdatera det separata PHPStan-paketet om du använder det och fortsätt att köra sidsynkronisering uttryckligen som förut.
7.7.1 Uppföljning
7.7.1-patchen gör synkroniseringsresultaten tydligare och säkrare. En nyckelbaserad sammanfogning som lämnar ett inlägg oförändrat skapar inte längre en revision eller uppdaterar dess ändringstid. Befintliga publiceringsstatusar bevaras, ersättningar av titlar och sluggar som ägs av filer rapporteras, och låsta eller borttagna sidor anges i rapporten CLI. Content Sync markerar kroppar som ägs av Page Sync och behåller befintliga granskningskopior. Patchen skyddar också attribut som ägs av WordPress från motstridiga fält-ID:n och bevarar redigerarklasser som lagts till av andra filter.