Hele sider defineret i kode
Skabeloner og Markdown, synkroniseret med WordPress med én kommando.
Samlinger fra filer
Definér pages.json, og lad Blockstudio finde alle kilder nedenunder. Indlejrede stier bliver til indlejrede sider, standardindstillinger gælder for samlingen, og manglende overordnede sider kan oprettes automatisk.
Brug samlinger til dokumentation, vidensbaser eller landingssider, og tilknyt eksterne mapper under et stipræfiks med loader.php.
Placér en layout.php eller et renderer-layout som layout.tsx ved siden af pages.json for at indpakke hver side i samlingen i én skal med blockstudio_page_tree() til sidepanelet.
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}---
title: Installation
order: 10
---
# Installation
Install Blockstudio from this Markdown page.<?php $current = blockstudio_current_page(); ?>
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<?php $is_current = ($item['post_id'] ?? null) === ($current['post_id'] ?? null); ?>
<a
href="<?php echo esc_url($item['permalink'] ?? '#'); ?>"
<?php echo $is_current ? 'aria-current="page"' : ''; ?>
>
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>Eksplicit synkronisering
wp bs pages sync anvender ændringer; uændrede sider kræver ingen skrivninger.
Markdown-kilder
Brug index.md med frontmatter, eller kombinér page.json med indholdet fra Markdown.
Rå Markdown
Markdown-filsider vises på deres URL plus .md eller på den normale URL ved Accept: text/markdown, med et canonical-link tilbage til HTML.
Samlingsloadere
Tilknyt eksterne dokumentationsmapper til en samling under et stipræfiks.
Webstedssamlinger
En pages.json med scope site anvender fælles standardværdier på et helt sidetræ og viser det som en liste uden at ændre URL’er eller indlægsrækker.
Navigationshjælpere
blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() og blockstudio_page_content() opbygger sidepaneler, sidevælgere og brødteksten.
Samlinger og indlægstyper
Samlinger kan registrere dedikerede hierarkiske indlægstyper.
Låsning af skabeloner
Lås sider eller enkelte blokke med contentOnly, all eller insert.
Skriv HTML, få blokke
Standardelementer som <h1>, <p> og <ul> knyttes til kerneblokke. Brug <block> til alle andre bloknavne og indlejringsniveauer.
Blockstudio fortolker komplette sidelayouts til rigtige, redigerbare WordPress-blokke.
<div>
<h1 blockEditingMode="contentOnly">About Us</h1>
<p>We build tools for WordPress developers.</p>
<img src="/team.jpg" alt="Our team" />
</div>
<block name="core/columns">
<block name="core/column"><h2>Our Mission</h2></block>
<block name="core/column"><h2>Our Stack</h2></block>
</block>Sider gengivet af komponenter
Angiv render i page.json til et indgangspunkt som page.tsx og en data.php-loader, så gengiveren for siden, som dit tema eller plugin registrerer, tegner hele siden. Sync gemmer én blockstudio/page-blok, og WordPress-indhold som en shortcode forbliver i sin plads.
Aktiver, som gengiveren returnerer, behandles på samme måde som blokaktiver og udskrives én gang, så en forhåndsgengivet side medbringer dem. blockstudio.dev selv bygges af komponentsider.
{
"name": "legal-notice",
"title": "Legal Notice",
"slug": "legal-notice",
"postStatus": "publish",
"render": { "entry": "page.tsx", "data": "data.php" }
}add_action(
'blockstudio/pages/renderers',
static function (): void {
Blockstudio\Page_Renderers::register(
'react',
array(
'extensions' => array( 'tsx' ),
'layouts' => array( 'layout.tsx' ),
'render' => 'my_theme_render_page',
)
);
}
);Ruter uden et indlæg
Blockstudio\Virtual_Routes::register() leverer et dokument uden et tilknyttet indlæg, f.eks. en komponentreference eller et katalog. Med prefix og match kan én registrering håndtere en hel gruppe URL’er, og returnering af null overlader URL til WordPress.
Ruten gengives i Blockstudios outputbuffer, så dens blokke får deres aktiver og Tailwind-output. Stier i urls indgår i statiske prerender-builds, og Virtual_Routes::urls() returnerer dem til et sitemap.
add_action( 'init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function ( $component, string $rest ) {
get_header();
echo my_component_page( $component );
get_footer();
},
[
'prefix' => true,
'match' => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
'title' => fn ( $component ) => my_component_title( $component ),
'urls' => fn () => my_component_paths(),
]
);
} );Synkronisér, når du siger til
Sidefiler ændres kun, når du beder om det: WordPress. wp bs pages sync anvender alle ændrede kilder, bevarer redigerbart indhold med nøgler og fjerner sider, hvis filer mangler.
Fingeraftryk dækker manifests, loaders, layouts og kilder, så uændrede sider ikke kræver nogen skrivninger. Udrulninger kalder Pages::reconcile() og får en maskinlæsbar rapport.
# Apply changed sources, keep keyed edits
wp bs pages sync
# Replace managed content from the files
wp bs pages sync --authoritative
# Compare every page and report as JSON
wp bs pages sync --full --format=json$report = Blockstudio\Pages::reconcile();
if (0 === $report['failed']) {
// Once the release is live and verified:
Blockstudio\Pages::store_successful_source_identity(
$report['sourceIdentity']
);
}Blokke med nøgler bevarer indhold
Tilføj key til en blok. Ved næste synkronisering flettes skabelonattributter med eksisterende brugerindhold for blokke med nøgler, mens blokke uden nøgler erstattes.
Udvikl strukturen på tværs af udrulninger, mens kundernes indhold bevares.
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
<h2>Welcome to our company</h2>
<p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
<block name="core/column"><h3>Our Team</h3></block>
</block>{
"name": "about",
"title": "About Us",
"slug": "about",
"templateLock": "contentOnly"
}Låsning af skabeloner og redigeringstilstande
"all" forhindrer ændringer, "contentOnly" låser strukturen, men tillader tekstredigering, og "insert" tillader redigering og omarrangering uden at tilføje eller fjerne.
Tilsidesæt ethvert element med blockEditingMode for at gøre en låst side selektivt redigerbar eller deaktivere en enkelt blok.
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
<p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
<h2>Customizable Section</h2>
</block>{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"templateLock": "contentOnly",
"blockEditingMode": "contentOnly"
}Skabeloner til webstedseditoren fra filer
Tilføj template.json og en skabelon til templates/, eller part.json til parts/, så får dit bloktema filbaserede kilder til wp_template og wp_template_part.
De bruger samme syntaks som sider. En tilpasning i webstedseditoren har stadig forrang, indtil nogen nulstiller den; derefter træder filkilden i kraft igen.
<block name="core/template-part" slug="header" />
<div>
<h1>Welcome</h1>
<block name="core/post-content" />
</div>
<block name="core/template-part" slug="footer" />{
"slug": "front-page",
"title": "Front Page",
"description": "Homepage template"
}{
"slug": "header",
"title": "Header",
"area": "header"
}Udvalgt databaseindhold i git
wp bs content pull eksporterer tilladte indlæg, termer, relationer og deklarerede metadata til portérbare filer, og push anvender dem i et andet miljø. Deklarerede referencer, forældre og termrelationer overføres som stabile UID’er.
Indlæg, der administreres af sidesynkronisering, kan kombineres med includePageSyncManaged. Deres filer indeholder "bodyOwner": "page-sync", så Content Sync flytter metadataene, mens sidesynkroniseringen bevarer indholdet.
{
"content": {
"enabled": true,
"id": "default",
"path": "content",
"postTypes": ["team_member"],
"taxonomies": ["category"],
"meta": {
"include": ["_my_*"],
"references": {
"_thumbnail_id": { "kind": "attachment" },
"_related_posts": { "kind": "post", "path": "*" }
}
},
"media": "manifest"
}
}wp bs content pull --dry-run
wp bs content pull
wp bs content status
wp bs content push --dry-run
wp bs content push --prune --yesNøglede blokke
Bevar brugerindhold, mens skabeloner udvikles.
Redigeringstilstande
Angiv sidestandarder, og tilsidesæt enkelte elementer.
Blokbindinger
Forbind blokke med indlægsmetadata, så indholdet bevares ved synkronisering.
Skabeloner til indlægstyper
templateFor gør en side til startstrukturen for alle nye indlæg af en type.
Fastgjorte indlægs-id’er
postId genbruger det samme ID, når en side slettes og synkroniseres igen, så menuer og links fortsat virker.
Stilladser og låse
sync: false sammen med Pages::force_sync() opretter en side én gang, som redaktører selv administrerer. Pages::lock() og unlock() forhindrer én side i at blive synkroniseret.
Brugerdefinerede parser-gengivere
Builder- og renderer-filtre omdanner et bloktag til blokarrayet for en tredjepartsblok eller ændrer, hvordan en kerneblok skrives.
Elementtilknytning
Tilknyt et HTML-element til en anden blok, vælg blokken ud fra elementets attributter, og send afsnittets HTML til et indholdsfelt.
Brugerdefinerede registreringsstier
Filtre tilføjer rødder for sider, mønstre og Site Editor-skabeloner, f.eks. fra et plugin.
Logiske registreringskilder
Forhåndsvisninger, overlays og genererede temaer kan give Blockstudio en sammensat filoversigt i stedet for én temamappe.
Stabile referencer
Erklærede referencer til indlæg, termer og vedhæftninger bliver til flytbare UID’er ved hentning og opløses til lokale ID’er ved afsendelse.
Status før afsendelse
wp bs content status rapporterer hver enhed som uændret, ville blive opdateret, mangler i databasen, konflikt, låst eller forældreløs og advarer om metanøgler, der ligner hemmeligheder.
Validerede afsendelser med afgrænset omfang
Push validerer hele planen, før den skriver, og springer låste enheder over. –dry-run viser planen, og –prune –yes fjerner kun enheder fra dette indholdssæt.
Versionsstyret
Spor sidefiler i Git, og udrul dem på tværs af miljøer.
PHP API
Tilgå træer, undersider, metadata, synkronisering, låsning og id’er programmatisk.
Det officielle udvidelsessæt
Premiumskabeloner til websteder, AI-systeminstruktioner og et privat Discord-fællesskab. Engangskøb med opdateringer hele livet.
- 500+ hjemmesideskabeloner
- AI-systeminstruktioner
- Opdateringer hele livet
- Privat Discord-fællesskab