Volledige pagina’s, gedefinieerd in code
Templates en Markdown, met één opdracht gesynchroniseerd met WordPress.
Collecties uit bestanden
Definieer pages.json en laat Blockstudio elke bron eronder ontdekken. Geneste paden worden geneste pagina’s, standaardwaarden gelden voor de collectie en ontbrekende bovenliggende pagina’s kunnen worden aangemaakt.
Gebruik collecties voor documentatie, kennisbanken of landingspagina’s en koppel externe mappen onder een padvoorvoegsel met loader.php.
Plaats een layout.php of een rendererlayout zoals layout.tsx naast pages.json om elke pagina van de collectie in één shell te wikkelen, met blockstudio_page_tree() voor de zijbalk.
{
"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>Expliciete synchronisatie
wp bs pages sync past wijzigingen toe; ongewijzigde pagina’s kosten geen schrijfbewerkingen.
Markdown-bronnen
Gebruik index.md met frontmatter of combineer page.json met Markdown-content.
Ruwe Markdown
Markdown-bestandspagina’s zijn beschikbaar op hun URL plus .md, of op de normale URL voor Accept: text/markdown, met een canonieke link terug naar de HTML.
Collectieladers
Koppel externe documentatiemappen onder een padvoorvoegsel aan een collectie.
Sitecollecties
Een pages.json met scope site past gedeelde standaardinstellingen toe op een volledige paginaboom en geeft die weer, zonder URL’s of berichtrecords te wijzigen.
Navigatiehelpers
blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() en blockstudio_page_content() bouwen zijbalken, pagers en de hoofdinhoud.
Collecties en berichttypen
Collecties kunnen speciale hiërarchische berichttypen registreren.
Templates vergrendelen
Vergrendel pagina’s of afzonderlijke blokken met contentOnly, all of insert.
Schrijf HTML, krijg blokken
Standaardelementen zoals <h1>, <p> en <ul> worden gekoppeld aan core-blokken. Gebruik <block> voor elke andere bloknaam en elk nestingniveau.
Blockstudio parseert volledige paginalay-outs naar echte, bewerkbare WordPress-blokken.
<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>Pagina’s gerenderd door componenten
Stel render in page.json in op een item zoals page.tsx en een loader voor data.php, waarna de pagerenderer die uw thema of plugin registreert de volledige pagina tekent. Sync slaat één blockstudio/page-block op, en WordPress-content zoals een shortcode blijft op zijn plek.
Assets die de renderer teruggeeft, worden op dezelfde manier verwerkt als block-assets en maar één keer afgedrukt, zodat een vooraf gerenderde pagina ze bevat. blockstudio.dev zelf wordt opgebouwd uit componentpagina’s.
{
"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',
)
);
}
);Routes zonder bericht
Blockstudio\Virtual_Routes::register() serveert een document waar geen bericht achter zit, zoals een componentreferentie of catalogus. Met prefix en match beantwoordt één registratie een hele reeks URL’s, en door null terug te geven blijft de URL over aan WordPress.
De route wordt gerenderd in de outputbuffer van Blockstudio, zodat de blocks hun assets en Tailwind-output krijgen. Paden in urls worden toegevoegd aan statische prerender-builds, en Virtual_Routes::urls() geeft ze terug voor een 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(),
]
);
} );Synchroniseer wanneer u dat wilt
Paginabestanden worden alleen gewijzigd wanneer u daarom vraagt: WordPress. wp bs pages sync past elke gewijzigde bron toe, behoudt inhoud in blokken met een sleutel en verwijdert pagina’s waarvan de bestanden ontbreken.
Fingerprints omvatten manifesten, loaders, lay-outs en bronnen, zodat ongewijzigde pagina’s geen schrijfbewerkingen kosten. Deployments roepen Pages::reconcile() aan en leveren een machineleesbaar rapport op.
# 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']
);
}Blokken met een sleutel behouden inhoud
Voeg key toe aan een willekeurig blok. Bij de volgende synchronisatie worden templatekenmerken van blokken met een sleutel samengevoegd met bestaande gebruikerscontent, terwijl blokken zonder sleutel worden vervangen.
Pas de structuur bij deployments aan terwijl de content van klanten intact blijft.
<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"
}Templates vergrendelen en bewerkingsmodi
"all" voorkomt wijzigingen, "contentOnly" vergrendelt de structuur maar staat tekstbewerkingen toe, en "insert" staat bewerken en herordenen toe zonder elementen toe te voegen of te verwijderen.
Overschrijf elk element met blockEditingMode om een vergrendelde pagina selectief bewerkbaar te maken of één blok uit te schakelen.
<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"
}Templates voor de Site Editor uit bestanden
Voeg template.json en een template toe aan templates/, of part.json aan parts/, en uw block theme krijgt bestandsbronnen voor wp_template en wp_template_part.
Ze gebruiken dezelfde syntaxis als pagina’s. Een aanpassing in de Site Editor blijft van kracht totdat iemand deze reset; daarna wordt de bestandsbron weer gebruikt.
<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"
}Geselecteerde database-inhoud in git
wp bs content pull exporteert toegestane berichten, termen, relaties en gedeclareerde metadata naar overdraagbare bestanden, en push past ze toe op een andere omgeving. Gedeclareerde verwijzingen, bovenliggende items en termrelaties worden als stabiele UID’s overgezet.
Berichten die door page sync worden beheerd, kunnen worden gekoppeld aan includePageSyncManaged. Hun bestanden bevatten "bodyOwner": "page-sync", zodat Content Sync de metadata verplaatst terwijl page sync de inhoud behoudt.
{
"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 --yesBlokken met sleutels
Behoud gebruikerscontent terwijl templates zich ontwikkelen.
Bewerkingsmodi
Stel paginastandaarden in en overschrijf afzonderlijke elementen.
Blokkoppelingen
Koppel blokken aan berichtmeta zodat content synchronisatie overleeft.
Templates voor berichttypen
templateFor maakt een pagina de startstructuur van blocks voor elk nieuw bericht van een type.
Vastgezette bericht-ID’s
postId herstelt dezelfde ID wanneer een pagina wordt verwijderd en opnieuw wordt gesynchroniseerd, zodat menu’s en links blijven werken.
Steigers en vergrendelingen
sync: false met Pages::force_sync() maakt een pagina één keer aan die editors zelf kunnen beheren. Pages::lock() en unlock() zorgen dat één pagina niet wordt gesynchroniseerd.
Aangepaste parser-renderers
Builder- en rendererfilters zetten een blocktag om in de blockarray van een block van derden of wijzigen hoe een core-block wordt geschreven.
Elementtoewijzing
Koppel een element van HTML aan een ander block, kies het block op basis van de attributen van het element en stuur alinea-HTML door naar een inhoudsveld.
Aangepaste detectiepaden
Filters voegen roots toe voor pagina’s, patronen en Site Editor-templates, bijvoorbeeld vanuit een plugin.
Logische detectiebronnen
Previews, overlays en gegenereerde thema’s kunnen Blockstudio een samengestelde bestandsinventaris aanleveren in plaats van één themamap.
Stabiele verwijzingen
Aangegeven verwijzingen naar berichten, termen en bijlagen worden bij het ophalen draagbare UID’s en worden bij het pushen omgezet in lokale ID’s.
Status vóór het pushen
wp bs content status rapporteert elke entiteit als ongewijzigd, wordt bijgewerkt, ontbreekt in de database, conflict, vergrendeld of verweesd, en waarschuwt voor metadatatoetsen die op geheimen lijken.
Gevalideerde, afgebakende pushes
Push valideert het volledige plan voordat er iets wordt weggeschreven en slaat vergrendelde entiteiten over. –dry-run toont het plan, en –prune –yes verwijdert alleen de entiteiten uit deze contentset.
Onder versiebeheer
Houd paginabestanden bij in Git en implementeer ze in verschillende omgevingen.
PHP API
Benader programmatisch bomen, onderliggende items, metadata, synchronisatie, vergrendelingen en ID’s.
De officiële uitbreidingskit
Premium-sitetemplates, AI-systeeminstructies en een privécommunity van Discord. Eenmalige aankoop, levenslange updates.
- 500+ websitesjablonen
- Systeeminstructies voor AI
- Updates voor altijd
- Privécommunity van Discord