Dennis · 21. juni 2026
Blockstudio 7.4
Blockstudio 7.4 handler om at gøre filbaserede projekter mere portable. Hvor 7.2 gjorde større projekter nemmere at undersøge og distribuere, og 7.3 tilføjede et lag af UI ovenpå, fokuserer 7.4 på at flytte mere af projektet, dets sider og dets kuraterede indhold ud af databasen og over i versionsstyrede filer.
Hovedfunktionen er sidekollektioner: en måde at pege Blockstudio på en mappe med sidekilder og generere en komplet indlejret sidestruktur i WordPress ud fra den. Kilden kan være PHP, Twig, Blade, HTML, Markdown eller en betroet loader, der returnerer sider fra en anden lokal kilde.
Kort fortalt:
- Sidekollektioner:
pages.jsonkan definere et komplet sæt af indlejrede sider, standardindstillinger, adfærd for indlægstyper, layouts, loadere og kollektionsmetadata. - Markdown-sider:
index.mdfungerer som sideindhold, enten medpage.jsoneller alene med frontmatter. - Sidelayouts til frontend:
layout.phpkan indramme synkroniseret sideindhold og bruge hjælpere somblockstudio_page_tree()ogblockstudio_page_content(). - Eksterne dokumentationskilder: Kollektionsloadere kan generere sider fra lokale filer eller returnerede Markdown/HTML.
- Rå Markdown-output: Markdown-sidekilder kan leveres som
.mdeller viaAccept: text/markdown. - Brugerdefinerede indlægstyper for kollektioner: Kollektioner kan have rene URL’er, automatisk genindlæsning af omskrivningsregler, rå Markdown-ruter og migrering fra side til indlægstype uden tilpasninger på temaets side.
- Content Sync:
wp bs content pull,wp bs content pushogwp bs content statusgør det muligt at flytte indlæg, termer, relationer og erklærede metareferencer på projektets tilladelsesliste til portable filer. - Bloktag-præfikser: Projektpræfikser som
<theme-card>kan slås op på tværs af ordnede navnerum uden aliaser pr. blok. - Mere pålidelig synkronisering: Ændringer af sider registreres på tværs af manifester, loadere, layouts, metadata og kildefiler.
- Rettelser af runtime og editor: Dynamiske valgmuligheder holdes opdaterede, klasser for forespørgselsblokke bevares ved programmatisk rendering,
bsui/selectfungerer bedre i tætte formularer, RichText-egenskaber når frem til editoren, og sletning af repeaterrækker med RichText bevares nu efter lagring.
Filbaserede sider
Det meste af 7.4 bygger videre på filbaserede sider.
Sidekollektioner
Før 7.4 var filbaserede sider hovedsageligt en mappefunktion: Opret en page.json, tilføj en index.php eller index.twig, og Blockstudio synkroniserer den ene side til WordPress.
Det fungerer stadig. 7.4 tilføjer en anden tilstand til større strukturer.
Tilføj et pages.json-manifest til en mappe, så bliver 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"
}
}
Alle sidekilder i kollektionen registreres, normaliseres, synkroniseres og forbindes via sti. En side på guide/install bliver et undersiden af guide; hvis siden guide mangler, opretter Blockstudio en genereret containerside, så WordPress-hierarkiet stadig svarer til filsystemets struktur.
Kollektioner kan bruge den indbyggede indlægstype page eller deres egen indlægstype. Når en kollektion angiver en indlægstype, der endnu ikke findes, registrerer Blockstudio den fra postTypeArgs. Manifestets postType bliver også standardværdien for hver side i kollektionen, så projekter ikke behøver gentage den i defaults.
Kollektionens indlægstyper bruger kollektions-sluggen som offentlig URL-basis. En docs-kollektion slår sin rodside op på /docs/, en side med path: "getting-started" på /docs/getting-started/ og indlejrede stier under den samme basis. Dobbelte URL’er som /docs/docs/ videresendes til den kanoniske placering. Omskrivningsregler tømmes automatisk, når kollektionens routing for indlægstypen ændres, så en ny kollektion ikke kræver en manuel lagring af permalinkindstillingerne.
Det er denne funktion, der får eksterne dokumentationssider, produktmanualer, vidensbaser og sidebiblioteker til at føles naturlige i WordPress: Kilden forbliver i filer, mens resultatet stadig er reelt, redigerbart WordPress-indhold.
Markdown som sideindhold
Markdown er nu en førsteklasses sidekilde.
Standalone Markdown-sider bruger frontmatter:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
Du kan også kombinere page.json med index.md, hvis du vil dele konfiguration og indhold op i separate filer. Frontmatter i index.md kan tilsidesætte tilsvarende felter i page.json, og ukendte frontmatter-nøgler bevares som metadata.
Markdown konverteres til HTML og sendes derefter gennem den samme sideparser som skabelonerne PHP, Twig og Blade, så det endelige indhold bliver indbygget blokmarkup.
Layouts og sidehjælpere
Kollektioner kan indeholde en layout.php-fil. På frontend indrammer Blockstudio det synkroniserede sideindhold med dette layout.
<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 nye hjælpere viser kollektionen som strukturerede data:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Det giver dig de dele, du skal bruge til at bygge en komplet dokumentationsramme: navigation fra sidetræet, sidemetadata fra frontmatter og det synkroniserede WordPress-blokindhold som hovedindhold.
Loadere og rå Markdown
Kollektioner kan indeholde en betroet lokal loader.php-fil. Den kan returnere sider direkte eller angive yderligere lokale mapper, som Blockstudio skal undersøge.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
Det er nyttigt, når kilden allerede er genereret et andet sted: en mappe med pakkedokumentation, en Markdown-eksport eller et byggetrin, der returnerer en liste over sider.
Markdown-sidekilder kan også levere deres rå Markdown-kilde. Anmod om siden med suffikset .md, eller send Accept: text/markdown. Frontmatter fjernes fra svaret, så værktøjer får den læsbare dokumenttekst. Det fungerer også for kollektionens indlægstyper, herunder URL’er som /docs.md og /docs/getting-started.md.
Content Sync
7.4 introducerer også Content Sync, et WP-CLI-workflow for teams, der vil have mere af deres WordPress-projekt repræsenteret som filer.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio håndterer allerede blokke, felter, skabeloner, mønstre og filbaserede sider i dit projekt. Content Sync føjer udvalgt databaseindhold til denne filbaserede arbejdsgang: tilladte indlæg, termer, relationer og deklarerede metadata kan hentes ind i filer, gennemgås i git og overføres til et andet miljø.
Det er med vilje eksplicit. Du aktiverer det i blockstudio.json, tilføjer de indlægstyper og taksonomier, du vil administrere, til tilladelseslisten og angiver de metareferencer, der skal omskrives mellem miljøer.
Ved hentning skriver Blockstudio portable indlæg, termer, relationer og metadata på tilladelseslisten til filer i dit tema. Ved overførsel validerer systemet planen før skrivning og knytter erklærede referencer til post, term og attachment tilbage til lokale database-id’er. Det gætter ikke på, at vilkårlige heltal er id’er.
Omfanget af 7.4 er bevidst begrænset: indlæg, termer, termrelationer, metadata på tilladelseslisten, portable UID’er, vedhæftningsmanifester, prøvekørsler, håndtering af fjernelse, låste entiteter og statusrapportering. Registrering af taksonomidefinitioner, kopiering af mediefiler og omskrivning af id’er i blokmarkup er bevidst udeladt i denne første version.
Det giver teams en enkel måde at versionsstyre kurateret indhold som teammedlemmer, kundecases, lokationer, dokumentationsposter eller andre strukturerede data uden at omdanne hele produktionsdatabasen til en migrering. Funktionen er beregnet til indholdssamlinger, der stadig kan gennemgås som filer: snesevis eller hundredvis af rækker, og i nogle projekter lave tusinder, når indholdet er struktureret og ændres sjældent. Den erstatter ikke databasesikkerhedskopier, synkronisering af e-handel eller ordrer, analyser, logfiler, formularindsendelser eller andre store datamængder.
Læs dokumentationen til Content Sync
Mere pålidelig synkronisering
Blockstudio registrerer nu ændringer i sidekilder, kollektionsmanifester, loaderfiler, layoutfiler, metadata og relaterede stier. Hvis noget af dette ændres, opdateres den synkroniserede WordPress-side.
Sideprocessen håndterer også de detaljer, der gør filbaseret dokumentation praktisk i virkelige projekter:
- Markdown-sidekilder synkroniseres som indbygget blokindhold, inklusive blokattributter
- frontmatter-metadata er tilgængelige for frontend-hjælpere og layouts
- kollektionssider bevarer en stabil identitet på tværs af synkroniseringer
- indlejrede sider uden for kollektioner knyttes til deres overordnede side
- indlejrede sider uden for kollektioner kan arve den nærmeste forfader
layout.php - fjernede kollektionskilder rydder op i deres genererede WordPress-sider
- når en kollektion ændres fra
pagetil en brugerdefineret indlægstype, migreres eksisterende synkroniserede indlæg i stedet for at oprette dubletter - siderækkefølgen gemmes via
menu_order
Bloktag-præfikser
Bloktags understøtter nu konfigurerbare navnerumspræfikser. Et projekt kan registrere ét kort præfiks og lade Blockstudio finde blokken i et eller flere navnerum:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
Når dette er sat op, kan <theme-card> finde theme-components/card, <theme-button> kan falde tilbage på bsui/button, og <theme-ui-feature-matrix> kan finde theme-components/ui-feature-matrix.
Eksplicitte tag_aliases vinder stadig, når et projekt har brug for en engangstilsidesættelse. Ukendte præfikstags forbliver urørte, og de eksisterende filtre, der tillader eller afviser bloktags, gælder stadig for blokke, der findes via præfikser.
Læs dokumentationen til Block Tags
Rettelser af runtime og editor
7.4 indeholder også en række rettelser, der udsprang af brug i virkelige projekter.
- Dynamiske valgmuligheder, der udfyldes via forespørgsler, holdes opdaterede, når indlæg, termer, brugere eller relaterede metadata ændres, og
populate.fetch: true-forespørgselsvalglister henter aktuelle valgmuligheder ved tomme søgninger i editoren. - Programmatisk brug af bloktags i
core/queryogcore/commentsbevarerclassNamei den genererede wrapper-markup. - Pseudokomponenter i skabeloner bevarer camelCase-egenskaber, så egenskaber som
allowedFormatsogwithoutInteractiveFormattingnår frem til editorens komponent i stedet for at blive fjernet på forhånd. bsui/selecthåndterer valgmulighedsdata og menuer, der går ud over deres område, mere pålideligt, især i tættere editor-kontroller.blockstudio/phpstangenkender felter, der er erklæret itabs-containere, så validering af skabeloner, Twig/Blade og bloktags forstår den samme feltstruktur, som Blockstudio bruger i projekter.- Sletning af en repeaterrække med RichText bevares efter lagring. Forældede RichText-værdier kan ikke længere genskabe den slettede række.
Hvorfor denne udgivelse er vigtig
Temaet for 7.4 er portabilitet.
Sidekollektioner gør hele dokumentationswebsteder til mapper med kildefiler. Markdown-sider gør indholdet nemt at skrive og læse tilbage. Content Sync udvider den samme filbaserede model til kurateret databaseindhold, så indlæg, termer og relationer kan ligge i git og flyttes mellem miljøer. Bloktagpræfikser gør store blokbiblioteker overskuelige i skabeloner.
Blockstudio er stadig filbaseret. Blokke er stadig mapper. Sider er stadig filer. 7.4 gør det blot muligt at have mere af et projekt, dets sidestrukturer og dets kuraterede indhold i disse filer og lade det følge med.