Dennis · 21 juni 2026
Blockstudio 7.4
Blockstudio 7.4 handlar om att göra filbaserade projekt mer portabla. I 7.2 blev det enklare att granska och distribuera större projekt, och 7.3 lade till ett lager av UI ovanpå. 7.4 fokuserar på att flytta mer av ett projekt, dess sidor och dess utvalda innehåll från databasen till versionshanterade filer.
Den främsta nyheten är sidkollektioner: ett sätt att ange en mapp med sidkällor för Blockstudio och skapa en komplett nästlad WordPress-sidstruktur utifrån den. Källan kan vara PHP, Twig, Blade, HTML, Markdown eller en betrodd laddare som hämtar sidor från en annan lokal källa.
Kortversionen:
- Sidkollektioner:
pages.jsonkan definiera en komplett uppsättning nästlade sidor, standardvärden, beteende för inläggstyper, layouter, laddare och kollektionsmetadata. - Markdown-sidor:
index.mdfungerar som sidinnehåll, antingen medpage.jsoneller på egen hand med frontmatter. - Sidlayouter för frontend:
layout.phpkan omsluta synkroniserat sidinnehåll och använda hjälpfunktioner somblockstudio_page_tree()ochblockstudio_page_content(). - Externa dokumentationskällor: kollektionsladdare kan skapa sidor från lokala filer eller returnerade Markdown/HTML.
- Rå Markdown-utdata: Markdown-sidkällor kan visas som
.mdeller viaAccept: text/markdown. - Anpassade inläggstyper för kollektioner: kollektioner kan ha rena URL:er, automatisk uppdatering av omskrivningsregler, råa Markdown-rutter och migrering från sidor till anpassade inläggstyper utan kringlösningar i temat.
- Content Sync:
wp bs content pull,wp bs content pushochwp bs content statusgör att tillåtelselistebaserade inlägg, termer, relationer och deklarerade metareferenser i projektet kan hanteras i portabla filer. - Blocktaggsprefix: projektprefix som
<theme-card>kan lösas i ordnade namnrymder utan alias per block. - Tillförlitligare synkronisering: sidändringar upptäcks i manifest, laddare, layouter, metadata och källfiler.
- Korrigeringar i körning och redigerare: dynamiska alternativ hålls uppdaterade, klassnamn för frågeblock bevaras vid programmatisk rendering,
bsui/selectfungerar bättre i täta formulär, RichText-egenskaper når redigeraren och radering av upprepade rader med RichText finns kvar efter att ändringarna sparats.
Filbaserade sidor
Det mesta i 7.4 bygger vidare på filbaserade sidor.
Sidkollektioner
Före 7.4 var filbaserade sidor mest en funktion på mappnivå: skapa en page.json, lägg till en index.php eller index.twig, så synkroniserar Blockstudio den sidan till WordPress.
Det fungerar fortfarande. I 7.4 tillkommer ett andra läge för större strukturer.
Lägg till ett pages.json-manifest i en mapp, så blir mappen en kollektion:
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"postTypeArgs": {
"label": "Docs",
"rewrite": {
"slug": "docs"
},
"supports": ["title", "editor", "page-attributes"]
},
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}
Varje sidkälla i kollektionen hittas, normaliseras, synkroniseras och länkas efter sökväg. En sida på guide/install blir en undersida till guide. Om sidan guide saknas skapar Blockstudio en genererad behållarsida så att hierarkin i WordPress fortfarande motsvarar filsystemets struktur.
Kollektioner kan använda den inbyggda inläggstypen page eller en egen inläggstyp. När en kollektion anger en inläggstyp som ännu inte finns registrerar Blockstudio den från postTypeArgs. Manifestet postType blir också standard för varje sida i kollektionen, så projekt behöver inte ange det på nytt i defaults.
Inläggstyper för kollektioner använder kollektionens slug som offentlig bas för URL. En kollektion av typen docs hittar sin rotsida på /docs/, en sida med path: "getting-started" på /docs/getting-started/ och nästlade sökvägar under samma bas. Dubblerade URL:er som /docs/docs/ omdirigeras till den kanoniska platsen. Omskrivningsregler uppdateras automatiskt när routningen för kollektionens inläggstyp ändras, så en ny kollektion kräver ingen manuell sparning av permalänkar.
Det här är det som får extern dokumentation, produktmanualer, kunskapsbaser och sidbibliotek att fungera naturligt i WordPress: källan ligger kvar i filer, men resultatet är fortfarande verkligt redigerbart WordPress-innehåll.
Markdown som sidinnehåll
Markdown är nu en förstklassig sidkälla.
Fristående Markdown-sidor använder frontmatter:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
Du kan också kombinera page.json med index.md när du vill dela upp konfiguration och innehåll mellan filer. Frontmatter i index.md kan åsidosätta matchande fält i page.json, och okända frontmatter-nycklar bevaras som metadata.
Markdown konverteras till HTML och skickas sedan genom samma sidparser som mallarna PHP, Twig och Blade, så att det slutliga innehållet blir inbyggd blockmarkering.
Layouter och sidohjälpare
Kollektioner kan innehålla en layout.php-fil. I frontend omsluter Blockstudio det synkroniserade sidinnehållet med den layouten.
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>
De nya hjälpfunktionerna visar kollektionen som strukturerade data:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Då får du byggstenarna för att skapa ett komplett dokumentationsskal: navigering från sidträdet, sidmetadata från frontmatter och det synkroniserade WordPress-blockinnehållet som huvudyta.
Laddare och rå Markdown
Kollektioner kan innehålla en betrodd lokal loader.php-fil. Den kan returnera sidor direkt eller ange ytterligare lokala kataloger som Blockstudio ska genomsöka.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
Det är användbart när källan redan genereras någon annanstans: en dokumentationsmapp för ett paket, en Markdown-export eller ett byggsteg som returnerar en lista med sidor.
Markdown-sidkällor kan också visa sin råa Markdown-källa. Begär sidan med suffixet .md eller skicka Accept: text/markdown. Frontmatter tas bort från svaret, så att verktyg får dokumentets läsbara brödtext. Det fungerar även för kollektionsinläggstyper, inklusive URL:er som /docs.md och /docs/getting-started.md.
Content Sync
I 7.4 introduceras även Content Sync, ett WP-CLI-arbetsflöde för team som vill representera mer av sitt WordPress-projekt som filer.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio hanterar redan block, fält, mallar, mönster och filbaserade sidor i projektet. Content Sync lägger till utvalt databasinnehåll i det filbaserade arbetsflödet: inlägg, termer, relationer och deklarerad metadata på tillåtelselistor kan hämtas till filer, granskas i git och skickas till en annan miljö.
Funktionen är avsiktligt explicit. Du aktiverar den i blockstudio.json, lägger till de inläggstyper och taxonomier du vill hantera på tillåtelselistor och deklarerar de metareferenser som ska skrivas om mellan miljöer.
Vid hämtning skriver Blockstudio portabla inlägg, termer, relationer och tillåtelselistebaserad metadata till filer i temat. Vid skickning valideras planen före skrivning, och deklarerade referenser till post, term och attachment löses tillbaka till lokala databas-ID:n. Funktionen gissar inte att godtyckliga heltal är ID:n.
Omfattningen för 7.4 är avsiktligt begränsad: inlägg, termer, termrelationer, tillåtelselistebaserad metadata, portabla UID:n, bilagemanifest, torrkörningar, hantering av rensning, låsta entiteter och statusrapportering. Insamling av taxonomidefinitioner, kopiering av mediebinarier och omskrivning av ID:n i blockmarkering ingår avsiktligt inte i den första versionen.
Det ger teamen ett enkelt sätt att versionshantera utvalt innehåll som teammedlemmar, fallstudier, platser, dokumentationsposter eller andra strukturerade poster utan att göra hela produktionsdatabasen till en migrering. Funktionen är avsedd för innehållsuppsättningar som fortfarande går att granska som filer: dussintals eller hundratals rader, och i vissa projekt några tusen när innehållet är strukturerat och ändras sällan. Den ersätter inte säkerhetskopior av databaser, synkronisering av e-handel och beställningar, analys, loggar, formulärinskick eller andra stora datamängder.
Läs dokumentationen för Content Sync
Tillförlitligare synkronisering
Blockstudio upptäcker nu ändringar i sidkällor, kollektionsmanifest, laddarfiler, layoutfiler, metadata och relaterade sökvägar. Om något av detta ändras uppdateras den synkroniserade WordPress-sidan.
Sidflödet hanterar också detaljerna som gör filbaserad dokumentation praktisk i verkliga projekt:
- Markdown-sidkällor synkroniseras som inbyggt blockinnehåll, inklusive blockattribut
- frontmatter-metadata är tillgängliga för hjälpfunktioner och layouter i frontend
- kollektionssidor behåller en stabil identitet mellan synkroniseringar
- nästlade sidor som inte tillhör en kollektion länkas till sin överordnade sida
- nästlade sidor som inte tillhör en kollektion kan ärva närmaste överordnade
layout.php - borttagna kollektionskällor tar bort sina genererade WordPress-sidor
- om en kollektion ändras från
pagetill en anpassad inläggstyp migreras befintliga synkroniserade inlägg i stället för att skapa dubbletter - sidordningen sparas via
menu_order
Blocktaggsprefix
Blocktaggar stöder nu konfigurerbara namnrymdsprefix. Ett projekt kan registrera ett kort prefix och låta Blockstudio lösa blocktaggen i en eller flera namnrymder:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
När det är på plats kan <theme-card> lösas till theme-components/card, <theme-button> falla tillbaka på bsui/button och <theme-ui-feature-matrix> lösas till theme-components/ui-feature-matrix.
Explicita tag_aliases gäller fortfarande när ett projekt behöver en engångsåsidosättning. Taggar med okända prefix lämnas orörda, och de befintliga filtren för tillåtna och nekade blocktaggar gäller fortfarande för block som löses via prefix.
Läs dokumentationen för Block Tags
Korrigeringar i körning och redigerare
7.4 innehåller också flera korrigeringar som bygger på erfarenheter från verkliga projekt.
- Alternativ som fylls i dynamiskt via frågor hålls uppdaterade när inlägg, termer, användare eller relaterad metadata ändras, och
populate.fetch: true-frågeval hämtar aktuella alternativ vid tomma sökningar i redigeraren. - Programmässiga blocktaggar
core/queryochcore/commentsbevararclassNamei den genererade omslagsmarkeringen. - Pseudokomponenter i mallar bevarar egenskaper i camelCase, så att egenskaper som
allowedFormatsochwithoutInteractiveFormattingnår redigerarens komponent i stället för att tas bort dessförinnan. bsui/selecthanterar alternativdata och överflödande menyer mer tillförlitligt, särskilt i tätare redigerarkontroller.blockstudio/phpstankänner igen fält som deklarerats inutitabs-behållare, så att validering av mallar, Twig/Blade och blocktaggar förstår samma fältstruktur som Blockstudio använder i projekt.- Radering av en upprepad rad med RichText finns kvar efter att ändringarna sparats. Inaktuella RichText-värden kan inte längre återställa den raderade raden.
Därför är den här versionen viktig
Temat för 7.4 är portabilitet.
Sidkollektioner gör att hela dokumentationswebbplatser kan bestå av mappar med källfiler. Sidor i Markdown gör innehållet enkelt att skriva och läsa tillbaka. Content Sync utökar samma filbaserade modell till utvalt databasinnehåll, så att inlägg, termer och relationer kan finnas i git och flyttas mellan miljöer. Blocktaggsprefix gör stora blockbibliotek mer lättlästa i mallar.
Blockstudio är fortfarande filbaserat. Block är fortfarande mappar. Sidor är fortfarande filer. I 7.4 kan helt enkelt mer av ett projekt, dess sidstrukturer och utvalda innehåll, finnas i filerna och följa med dem.