Ga naar de inhoud

Dennis · 21 juni 2026

Blockstudio 7.4

Blockstudio 7.4 maakt projecten die op bestanden zijn gebaseerd beter overdraagbaar. Waar 7.2 grotere projecten makkelijker inspecteerbaar en verspreidbaar maakte en 7.3 daar een UI-laag aan toevoegde, richt 7.4 zich erop meer onderdelen van een project, de pagina’s en de samengestelde inhoud ervan uit de database en in bestanden onder versiebeheer te plaatsen.

De belangrijkste nieuwe functie is paginacollecties: hiermee kunt u Blockstudio naar een map met paginabronnen laten verwijzen en daaruit een complete geneste WordPress-paginstructuur genereren. De bron kan PHP, Twig, Blade, HTML of Markdown zijn, of een vertrouwde loader die pagina’s uit een andere lokale bron retourneert.

In het kort:

  • Paginacollecties: pages.json kan een complete verzameling geneste pagina’s, standaardwaarden, posttypegedrag, lay-outs, loaders en collectiemetadata definiëren.
  • Markdown-pagina’s: index.md werkt als pagina-inhoud, met page.json of op zichzelf met frontmatter.
  • Frontendpaginalay-outs: layout.php kan gesynchroniseerde pagina-inhoud omhullen en helpers zoals blockstudio_page_tree() en blockstudio_page_content() gebruiken.
  • Externe documentatiebronnen: collection-loaders kunnen pagina’s genereren op basis van lokale bestanden of geretourneerde Markdown/HTML.
  • Ruwe Markdown-uitvoer: Markdown-paginabronnen kunnen als .md of via Accept: text/markdown worden aangeboden.
  • Aangepaste posttypes voor collecties: collecties kunnen eigen nette URL’s, automatische flushes van rewrite-regels, ruwe Markdown-routes en migraties van pagina naar CPT beheren, zonder aanpassingen aan het thema.
  • Content Sync: met wp bs content pull, wp bs content push en wp bs content status kunt u posts, termen, relaties en opgegeven metaverwijzingen die op de toelatingslijst staan, omzetten naar overdraagbare bestanden.
  • Blocktagprefixen: projectprefixen zoals <theme-card> kunnen in geordende namespaces worden opgelost, zonder aliassen per block.
  • Betrouwbaardere synchronisatie: wijzigingen aan pagina’s worden gedetecteerd in manifests, loaders, lay-outs, metadata en bronbestanden.
  • Runtime- en editorverbeteringen: dynamische opties blijven actueel, queryblockclasses blijven behouden bij programmatisch renderen, bsui/select werkt beter in compacte formulieren, RichText-props bereiken de editor en het verwijderen van een repeaterrij met RichText blijft na opslaan behouden.

Paginabestanden

Het grootste deel van 7.4 bouwt voort op pagina’s op basis van bestanden.

Paginacollecties

Vóór 7.4 was het werken met pagina’s op basis van bestanden vooral een functie op mapniveau: maak een page.json aan, voeg een index.php of index.twig toe en Blockstudio synchroniseert die ene pagina met WordPress.

Dat werkt nog steeds. 7.4 voegt een tweede modus toe voor grotere structuren.

Voeg een manifest pages.json toe aan een map en die map wordt een collectie:

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
JSON
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}

Elke paginabron in de collectie wordt gevonden, genormaliseerd, gesynchroniseerd en op basis van het pad gekoppeld. Een pagina op guide/install wordt een subpagina van guide. Ontbreekt de pagina guide, dan maakt Blockstudio een gegenereerde containerpagina aan, zodat de hiërarchie van WordPress overeenkomt met de mappenstructuur.

Collecties kunnen het ingebouwde posttype page of een eigen posttype gebruiken. Als een collectie een posttype opgeeft dat nog niet bestaat, registreert Blockstudio het vanuit postTypeArgs. Het manifestveld postType wordt ook de standaardwaarde voor elke pagina in die collectie, zodat projecten het niet in defaults hoeven te herhalen.

Collectieposttypes gebruiken de collectieslug als openbare basis voor URL. Bij een collectie docs bevindt de hoofdpagina zich op /docs/; een pagina met path: "getting-started" staat op /docs/getting-started/ en geneste paden vallen onder dezelfde basis. Dubbele URL’s zoals /docs/docs/ worden doorgestuurd naar de canonieke locatie. Rewrite-regels worden automatisch geflusht wanneer de routering van collectieposttypes verandert, zodat u voor een nieuwe collectie niet handmatig de permalinkinstellingen hoeft op te slaan.

Hierdoor voelen externe documentatie, producthandleidingen, kennisbanken en paginabibliotheken in WordPress vanzelfsprekend aan: de bron blijft in bestanden staan, maar het resultaat is nog steeds echte bewerkbare WordPress-inhoud.

Markdown als pagina-inhoud

Markdown is nu een volwaardige paginabron.

Zelfstandige Markdown-pagina’s gebruiken frontmatter:

Markdown
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.

U kunt page.json ook combineren met index.md wanneer u configuratie en inhoud over meerdere bestanden wilt verdelen. Frontmatter in index.md kan overeenkomende velden in page.json overschrijven, en onbekende frontmatter-sleutels blijven behouden als metadata.

Markdown wordt omgezet naar HTML en vervolgens door dezelfde paginaparser verwerkt als templates van PHP, Twig en Blade, zodat de uiteindelijke inhoud native block-markup is.

Lay-outs en paginhelpers

Collecties kunnen een bestand layout.php bevatten. Aan de frontend omhult Blockstudio de gesynchroniseerde pagina-inhoud met die lay-out.

PHP
<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 nieuwe helpers bieden de collectie aan als gestructureerde gegevens:

PHP
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();

Zo krijgt u de bouwstenen om een volledige documentatieschil te maken: navigatie op basis van de paginaboom, paginametadata uit frontmatter en gesynchroniseerde WordPress-blockinhoud als hoofdweergave.

Loaders en ruwe Markdown

Collecties kunnen een vertrouwd lokaal loader.php-bestand bevatten. Dat kan rechtstreeks pagina’s retourneren of Blockstudio verwijzen naar extra lokale mappen om te doorzoeken.

PHP
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];

Dit is handig wanneer de bron al ergens anders wordt gegenereerd: een map met pakketdocumentatie, een Markdown-export of een buildstap die een lijst met pagina’s retourneert.

Markdown-paginabronnen kunnen ook hun ruwe Markdown-bron aanbieden. Vraag de pagina op met het achtervoegsel .md of verstuur Accept: text/markdown. Frontmatter wordt uit het antwoord verwijderd, zodat tools de leesbare documentinhoud krijgen. Dit werkt ook voor collectieposttypes, waaronder URL’s zoals /docs.md en /docs/getting-started.md.

Lees de documentatie over pagina’s

Content Sync

7.4 introduceert ook Content Sync, een WP-CLI-workflow voor teams die meer van hun WordPress-project als bestanden willen vastleggen.

Shell
wp bs content pull
wp bs content push --dry-run
wp bs content status

Blockstudio bewaart blocks, velden, templates, patronen en pagina’s op basis van bestanden al in uw project. Content Sync voegt geselecteerde database-inhoud toe aan die bestandsgerichte workflow: posts, termen, relaties en opgegeven metadata die op de toelatingslijst staan, kunnen naar bestanden worden geëxporteerd, in git worden beoordeeld en naar een andere omgeving worden gepusht.

De werking is bewust expliciet. U schakelt deze in via blockstudio.json, zet de posttypes en taxonomieën die u wilt beheren op de toelatingslijst en geeft aan welke metaverwijzingen tussen omgevingen moeten worden herschreven.

Bij het ophalen schrijft Blockstudio overdraagbare posts, termen, relaties en metadata die op de toelatingslijst staan naar bestanden in uw thema. Bij het pushen controleert deze het plan voordat er iets wordt weggeschreven en koppelt opgegeven verwijzingen naar post, term en attachment terug aan lokale database-ID’s. Willekeurige gehele getallen worden niet zomaar als ID’s beschouwd.

De reikwijdte van 7.4 is bewust beperkt: posts, termen, termrelaties, metadata op de toelatingslijst, overdraagbare UID’s, bijlagemanifests, dry runs, afhandeling van verwijderen, vergrendelde entiteiten en statusrapportage. Het vastleggen van taxonomiedefinities, kopiëren van mediabestanden en herschrijven van ID’s in block-markup zijn bewust buiten deze eerste versie gehouden.

Zo kunnen teams samengestelde inhoud zoals teamleden, casestudy’s, locaties, documentatie-items of andere gestructureerde gegevensversies beheren zonder de volledige productiedatabase tot een migratie te maken. De functie is bedoeld voor inhoud die nog goed als bestanden te beoordelen is: tientallen of honderden records, en in sommige projecten een paar duizend als de inhoud gestructureerd en weinig veranderlijk is. Deze vervangt geen databaseback-ups, synchronisatie van e-commerce- en bestelgegevens, analytics, logs, formulierinzendingen of andere gegevens met een hoog volume.

Lees de documentatie over Content Sync

Betrouwbaardere synchronisatie

Blockstudio detecteert nu wijzigingen in paginabronnen, collectiemanifests, loaderbestanden, lay-outbestanden, metadata en gerelateerde paden. Bij wijzigingen aan een van deze onderdelen wordt de gesynchroniseerde pagina WordPress bijgewerkt.

De paginapijplijn verwerkt ook de details die documentatie op basis van bestanden praktisch maken in echte projecten:

  • Paginabronnen van Markdown worden als native block-inhoud gesynchroniseerd, inclusief blockattributen
  • Frontmatter-metadata is beschikbaar voor frontendhelpers en lay-outs
  • Collectiepagina’s behouden hun vaste identiteit tussen synchronisaties
  • Geneste pagina’s die niet tot een collectie behoren, worden aan hun bovenliggende pagina gekoppeld
  • Geneste pagina’s die niet tot een collectie behoren, kunnen de dichtstbijzijnde layout.php van een bovenliggende pagina overnemen
  • Verwijderde collectiebronnen ruimen de gegenereerde pagina’s WordPress op
  • Wanneer een collectie verandert van page naar een aangepast posttype, worden bestaande gesynchroniseerde posts gemigreerd in plaats van gedupliceerd
  • De paginavolgorde wordt bewaard via menu_order

Blocktagprefixen

Blocktags ondersteunen nu instelbare namespaceprefixen. Een project kan één korte prefix registreren en Blockstudio het block in een of meer namespaces laten vinden:

PHP
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});

Zo kan <theme-card> worden opgelost naar theme-components/card, kan <theme-button> terugvallen op bsui/button en kan <theme-ui-feature-matrix> worden opgelost naar theme-components/ui-feature-matrix.

Expliciete tag_aliases-waarden blijven voorrang houden wanneer een project een eenmalige override nodig heeft. Tags met onbekende prefixen blijven ongewijzigd, en de bestaande filters voor toestaan en weigeren van blocktags blijven ook van toepassing op blocks die via prefixen worden opgelost.

Lees de documentatie over Block Tags

Runtime- en editorverbeteringen

7.4 bevat ook een aantal verbeteringen die voortkomen uit het gebruik in echte projecten.

  • Opties die dynamisch met query’s worden gevuld, blijven actueel wanneer posts, termen, gebruikers of gerelateerde metadata veranderen. Bovendien halen populate.fetch: true-queryselecties actuele opties op bij lege zoekopdrachten in de editor.
  • Programmatisch gegenereerde blocktags voor core/query en core/comments behouden className in de gegenereerde wrapper-markup.
  • Pseudocomponenten van templates behouden props in camelCase, zodat props zoals allowedFormats en withoutInteractiveFormatting de editorcomponent bereiken in plaats van vooraf te worden verwijderd.
  • bsui/select verwerkt optiegegevens en overlopende menu’s betrouwbaarder, vooral in compactere editorbesturingselementen.
  • blockstudio/phpstan herkent velden die zijn gedeclareerd in tabs-containers, zodat validatie van templates, Twig/Blade en blocktags dezelfde veldstructuur begrijpt die Blockstudio in projecten gebruikt.
  • Het verwijderen van een repeaterrij met RichText blijft na opslaan behouden. Verouderde RichText-waarden kunnen de verwijderde rij niet meer terugzetten.

Waarom deze release belangrijk is

Het thema van 7.4 is overdraagbaarheid.

Met paginacollecties worden volledige documentatiesites mappen met bronbestanden. Pagina’s van Markdown maken die inhoud eenvoudig om te schrijven en weer uit te lezen. Content Sync breidt hetzelfde bestandsgerichte model uit naar samengestelde database-inhoud, zodat posts, termen en relaties in git kunnen staan en tussen omgevingen kunnen worden verplaatst. Blocktagprefixen houden grote blockbibliotheken leesbaar in templates.

Blockstudio is nog steeds op bestanden gebaseerd. Blocks zijn nog steeds mappen. Pagina’s zijn nog steeds bestanden. Met 7.4 kunnen meer onderdelen van een project, de paginstructuren en de samengestelde inhoud ervan, in die bestanden staan en ermee worden overgedragen.