Dennis · 14. oktober 2026
Blockstudio 7.7
Blockstudio 7.7 tilføjer virtuelle ruter til dokumenter uden et WordPress-indlæg, forbedrer målrettede forhåndsgenereringer og gør redigering og rendering af eksisterende blokke mere pålidelig. Desuden udvides PHPStans kontrol af bloktags, og tilgængeligheden forbedres i de medfølgende UI-komponenter.
Den filbaserede arbejdsgang er uændret. Blokke gengives fra deres skabeloner, og filbaserede sider ændres gennem en eksplicit synkronisering med CLI eller API. Denne udgivelse indfører ikke automatisk sidesynkronisering ved besøgs- eller adminanmodninger.
Kort fortalt:
- Virtuelle ruter: Vis et komponentgalleri, katalog eller et andet komplet dokument uden at oprette et indlæg eller skrive en brugerdefineret omdirigeringshandler.
- Målrettede forhåndsgenereringer: Bygninger i HTTP-tilstand registrerer de kildefiler, hver side bruger, så en senere bygning kun kan rendere berørte ruter.
- Cacheopbevaring: Behold udfasede stylesheets til cachede sider, og gennemse eller ryd ubrugte poster i early-serve-kortet.
- Mere pålidelig editor: Flereselekterede blokke beholder deres egne værdier, fortryd og gentag fungerer for RichText- og sidepanelfelter, og nedarvet kontekst forbliver hos den rette blok.
- Bevarelse af filindhold: Indlejrede lister, sektionselementer, inline-HTML, shortcodes og escapede attributter bevares ved parsing og rendering.
- Forbedringer af PHPStan: Præfikstags, aliaser, tilknyttede sideelementer og skabelonvariabler kontrolleres mod projektets egne definitioner.
- Tilgængelige UI: Kontrolelementer viser deres tilstand korrekt, etiketter aktiverer det rette input, og liste- og tabelkomponenter bruger gyldig HTML-struktur.
- Oversættelser: Installerede JavaScript-oversættelser indlæses i editoren og adminoversigten, også for tidligere uoversatte feltkontroller.
Virtuelle ruter
Nogle sider kommer fra data i stedet for et indlæg, der ejes af editoren. En komponentreference kan for eksempel have brug for sin egen URL og dokumenttitel, men ikke en post i wp_posts.
Registrér 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']
);
});
Ruten viser /components/. Dens callback kører i Blockstudios outputbuffer, så renderede blokke modtager deres styles, scripts, medfølgende UI-aktiver og Tailwind-output gennem den normale pipeline. WordPress gør ikke den matchede rute til en 404 eller omdirigerer den til et indlæg.
For en gruppe URL’er skal prefix sættes til true, og en match-callback angives. Callbacken modtager stien under ruten og returnerer den værdi, rendereren har brug for. Hvis den returnerer null eller false, overlades anmodningen til WordPress. Brug urls til at angive de stier, en statisk forhåndsgenerering skal omfatte. En enkelt rute uden præfiks medtager som standard sin egen sti.
Virtual_Routes::urls() returnerer absolutte URL’er til integrationer, der sammensætter et sitemap. Virtuelle dokumenter føjes ikke automatisk til WordPresss indlægssitemap.
Se Virtuelle ruter for den fulde API og valgmuligheder.
Mere præcise forhåndsgenereringer
Grafbaserede bygninger, der er gengivet over HTTP, registrerer nu de filer, hver rute brugte: skabelonen WordPress, renderede blokskabeloner og aktiver, definitioner og layouts til filbaserede sider samt afhængigheder tilføjet via blockstudio/render/dependencies.
Ved næste bygning sammenligner build_plan() disse afhængigheder. Hvis en blokskabelon ændres, markeres dens afhængige ruter til rendering, uden at alle uvedkommende sider bygges igen. Ændringer i delt konfiguration påvirker stadig hele bygningen, og nye eller udløbne ruter gengives som før.
Ændringer, der kun sker i databasen, er ikke filafhængigheder. En implementering, der skal hente en indstilling, et indlæg eller en anden databaseværdi, skal fremtvinge en bygning eller rendere de berørte URL’er eksplicit.
Udgivelsen retter også ændringer i byggeidentiteter under den første rendering, forældede early-serve-kort cachet af opcode-cachen og gyldige URL’er, der blev udelukket alene, fordi deres sti indeholder search eller preview. Markdown-anmodninger med Accept: text/markdown omgår cachet HTML, og de relevante svar sender Vary: Accept.
Statisk forhåndsgenerering respekterer nu filtre, der er registreret af det aktive tema, når det afgøres, om dens hooks skal tilknyttes. Et tema kan deaktivere funktionen, uden at et tidligere opslag af indstillingerne efterlader den aktiv.
Se Statisk forhåndsgenerering.
Cacheopbevaring og vedligeholdelse
En cachet HTML-side kan eksistere længere end runtime-identiteten, der kompilerede dens stylesheet. cache.namespaceGrace styrer, hvor længe udfasede namespaces forbliver tilgængelige, efter oprydningen først opdager, at de er udfaset:
{
"cache": {
"namespaceGrace": 777600
}
}
Dette eksempel beholder udfasede filer i ni dage. Standardværdien er én dag. Aktive namespaces og namespaces, der leverer implementerede forhåndsgenereringsartefakter, er beskyttet mod oprydning af udfasede elementer.
Early-serve-kortet har også kommandoer til kontrol og oprydning:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
De rapporterer og fjerner poster for slettede websteder eller manglende mapper. Sletning af et multisite-websted fjerner også dets poster. Manglende rutendokumenter rapporteres separat, så en hel gyldig webstedspost ikke fjernes.
Se Caching for vejledning om opbevaring og vedligeholdelse af kortet for kommandoerne.
En mere pålidelig editor
Redigering af en flereselekteret blok opdaterer nu kun den pågældende blok. Ved lagring bevares hver blok med sit eget indhold, sine egne nøgler, metadata og låse, i stedet for at kopiere attributter mellem valgte blokke.
RichText-værdier ligger direkte i blokattributter, så Gutenberg kan medtage dem i fortryd og gentag. Sidepanelfelter indgår i den samme historik. InnerBlocks templateLock="false" sendes som en reel boolesk værdi og låser indhold op, selv når et ydre område er låst.
Indledende forhåndsindlæsninger modtager ID’et og typen for det redigerede indlæg, så skabeloner kan læse de korrekte metadata ved første rendering. Identiske underordnede blokke under forskellige overordnede blokke beholder adskilt nedarvet kontekst i forhåndsindlæsninger og renderingscacher. Attribut- eller kontekstændringer under en indledende anmodning efterlader ikke længere forhåndsvisningen bagefter.
Blockstudio holder også op med at indsætte skjulte renderingsmarkørelementer mellem blokrødder. Søskenvælgere som .card + .card ser nu de samme elementrelationer i editoren som på frontend, mens forhåndsvisninger af rendering i editoren og indsætteren fortsat er adskilte.
Sikrere lagring af indstillinger på hele webstedet
Felter, der bruger indstillinger, leverer stadig værdier for hele webstedet, men lagring af et indlæg skriver ikke længere ukritisk alle gemte kopier af disse felter:
- Lagring som kladde, afventende, privat eller planlagt skriver ikke aktive webstedsindstillinger.
- Lagring af offentliggjorte indlæg skriver de angivne felter, der blev ændret i den pågældende redigering.
- Lagring af en gammel kopi med kun titelændringer ruller ikke en nyere værdi for hele webstedet tilbage.
- Manglende felter og fjernede blokke sletter ikke eksisterende indstillinger.
- En eksplicit
nullfjerner en indstilling. Tomme strenge,false, nul og tomme arrays forbliver gyldige værdier.
Dette er den vigtigste adfærdsændring at kontrollere ved opgradering. Hvis en integration brugte et privat indlæg eller en kladde til at opdatere en aktiv indstilling, skal indstillingen skrives eksplicit, eller der skal bruges et offentliggjort konfigurationsindlæg i stedet. Begrænsningen til offentliggjorte indlæg påvirker ikke lagring af indlægsmetadata.
Se Lagring for de fulde regler for lagring.
Filindhold bevares
Pipelinen fra HTML til blokke bevarer mere af den struktur, du skrev:
- Indlejrede lister bliver til indre listeblokke under deres overordnede element. Listeklasser og elementklasser bevares; almindelige flade lister får samme output som før.
main,header,footer,articleogasidebliver til gruppeblokke, der bevarer deres element i stedet for rå HTML, som omgår blokrendering.- Tilknyttede richtext-afsnit bevarer inline-markup, afsnit med kun billeder opløses til den tilknyttede billedblok, og shortcode-tags bevarer deres indhold.
- Escapede attributter afkodes og escapes én gang, også attributter på
InnerBlocks,RichTextog elementetuseBlockProps. - Større-end-tegn i citerede attributter på selvafsluttende tags accepteres.
- Globale HTML-attributter overføres til roden af en Blockstudio-blok, når blokken ikke erklærer dem som felter.
wp bs pages syncrapporterer lagrede attributter, der ikke gengives.
Sider, mønstre og Site Editor-skabeloner baseret på Blade gengives nu via Blockstudio\Blade_Renderer, som understøtter illuminate/view 8 til 12. Udvidelsesfiler, der retter sig mod den samme blok, registreres alle, og deres prioritet, gruppefelter og mållister følger det dokumenterede skema.
Også indlejrede SCSS-afhængigheder spores. Hvis en partial, der importeres af en anden partial, redigeres, ændres versionsnummeret for det afhængige stylesheet, og genkompilering udløses.
Forbedringer af PHPStan
Den separat installerede blockstudio/phpstan-pakke udvider validering af bloktags til præfiks- og aliastags, tilknyttede sideelementer, layouts, medfølgende UI-blokke og eventuelt andre projektkilder til PHP. Namespace-opløsning svarer til runtime, også for namespaces med bindestreger, og videresendte globale HTML-attributter accepteres.
Variabler i blokskabeloner, såsom $a, $block og $context, behandles som defineret af Blockstudio. Felttyper bevares gennem null-coalescing og isset() under PHPStan 2.3, mens en skabelon, der tildeler sin egen $a, beholder den tildelte type.
Disse ændringer udgives i blockstudio/phpstan 0.1.9. Opdatér pakken separat fra plugin’et; den kræver PHPStan 2.1.47 eller nyere:
composer require --dev blockstudio/phpstan:^0.1.9
Se PHPStan for konfiguration og analyseforudindstillinger.
Tilgængelighed og oversættelser
Udløsere i de medfølgende UI viser deres udvidede tilstand på selve knappen. Etiketter til afkrydsningsfelter, kontakter og radioknapper navngiver og aktiverer deres kontroller. Brødkrummer, sideinddeling, navigationsmenuer og tabeller indsætter ikke længere ugyldige omsluttende elementer mellem lister eller tabeller og deres børn.
Adgangskodeskift viser deres trykkede tilstand og har et større klikområde. Inputs accepterer autocomplete, og adgangskodeinputs accepterer et eksplicit ID og en tilgængelig etiket. Karruselvisningsområder kan fokuseres med tastaturet, og animationer for indlæsningsindikatorer og skeletter respekterer indstillinger for reduceret bevægelse.
Editoren og adminoversigten indlæser installerede JavaScript-oversættelser for tekstområdet blockstudio. Attributmenuer og pladsholdere, handlinger i kodepop op-vinduer samt billed- og filbadges kan nu oversættes. Strenge uden en oversættelse forbliver på engelsk.
Se UI-biblioteket og opsætning af oversættelser.
Dokumentation og opgradering
Dokumentationen tilføjer vejledninger om dokumentationswebsteder, Content Sync, skabeloner til Site Editor, bloktags, islands, brugerdefinerede felttyper, udrulning, prerendering, registeropsætning, analyseværktøjer og UI appskærme. ACF-migreringsvejledningen afspejler den aktuelle registrering af ACF og Block Bindings.
Eksempler på brugerdefineret udfyldning bruger nu det understøttede filter med navngivne datasæt og ét argument. Assetdokumentationen forklarer rækkefølgen af stylesheets på frontend og hvordan temaoverrides indlæses efter blokken CSS. Bidragyderinstallationer bruger den offentlige Font Awesome-pakke uden legitimationsoplysninger til registre.
PHP 8.2 og WordPress 6.7 er fortsat minimumskravene. Virtuelle ruter og de nye vedligeholdelseskommandoer er tilgængelige uden at ændre eksisterende sidesamlinger. Gennemgå reglerne for lagring af indstillinger ovenfor, opdater den separate pakke PHPStan, hvis du bruger den, og fortsæt med at køre sidesynkronisering eksplicit som før.
7.7.1 Opfølgning
7.7.1-rettelsen gør synkroniseringsresultaterne tydeligere og sikrere. En nøglebaseret sammenfletning, der lader et indlæg være uændret, opretter ikke længere en revision eller opdaterer dets ændringstidspunkt. Eksisterende udgivelsesstatusser bevares, udskiftninger af titler og slugs, der ejes af filen, rapporteres, og låste eller fjernede sider nævnes i rapporten CLI. Content Sync markerer Page Sync-ejede indholdstekster og bevarer eksisterende gennemgangskopier. Rettelsen beskytter også attributter, der ejes af WordPress, mod modstridende felt-id’er og bevarer editor-klasser, der er tilføjet af andre filtre.