# 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.

[Paginacollecties](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

```
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

## 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.

[Referentie voor paginasyntaxis](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/)

index.php

```
<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.

[Componentpagina’s](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/#component-pages)

pages/legal-notice/page.json

```
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}
```

## 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.

[Virtuele routes](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/#virtual-routes)

functions.php

```
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.

[Synchronisatiegedrag](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/#sync-behavior)

Terminal

```
# 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
```

## 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.

[Blokken met sleutels](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/#keyed-block-merging)

index.php

```
<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>
```

## 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.

[Templates vergrendelen](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/#template-lock)

index.php

```
<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>
```

## 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.

[Sitetemplates](https://blockstudio.dev/nl/docs/pages-and-patterns/site-templates/)

templates/front-page/index.php

```
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />
```

## 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.

[Contentsynchronisatie](https://blockstudio.dev/nl/docs/content-sync/)

blockstudio.json

```
{
  "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"
  }
}
```

## Blokken 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.

Plus

## 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

[Neem Plus](https://blockstudio.dev/nl/plus/)
