
Blockstudio 7.7 voegt virtuele routes toe voor documenten zonder WordPress-bericht, verbetert gerichte prerender-builds en maakt het bewerken en renderen van bestaande blocks betrouwbaarder. Ook breidt de versie de blocktagcontroles van PHPStan uit en verbetert ze de toegankelijkheid van de meegeleverde componenten van UI.

De bestandsgerichte workflow blijft hetzelfde. Blocks worden vanuit hun templates gerenderd en bestandsgebaseerde pagina's worden gewijzigd via een expliciete synchronisatie van CLI of API. Deze release introduceert geen automatische paginasynchronisatie bij bezoekers- of beheerdersverzoeken.

In het kort:

- **Virtuele routes**: lever een componentengalerij, catalogus of ander volledig document aan zonder een bericht aan te maken of een aangepaste redirect-handler te schrijven.
- **Gerichte prerender-builds**: HTTP-builds registreren de bronbestanden die elke pagina gebruikt, zodat een latere build alleen gewijzigde routes kan renderen.
- **Cachebehoud**: houd verouderde stylesheets beschikbaar voor pagina's in de cache en inspecteer of ruim ongebruikte vermeldingen in de early-serve-map op.
- **Betrouwbaardere editor**: bij meervoudig geselecteerde blocks behouden blocks hun eigen waarden; ongedaan maken en opnieuw uitvoeren werken voor RichText- en zijbalkvelden, en overgeërfde context blijft bij het juiste block.
- **Getrouwe bestandscontent**: geneste lijsten, sectie-elementen, inline HTML, shortcodes en ge-escape-te attributen blijven behouden bij het parseren en renderen.
- **Verbeteringen voor PHPStan**: voorvoegsel-tags, aliassen, toegewezen pagina-elementen en templatevariabelen worden gecontroleerd aan de hand van de eigen definities van het project.
- **Toegankelijke UI**: bedieningselementen geven hun status correct weer, labels schakelen de juiste invoervelden in en lijsten en tabellen gebruiken een geldige HTML-structuur.
- **Vertalingen**: geïnstalleerde vertalingen van JavaScript worden geladen in de editor en het beheerdersoverzicht, ook voor veldbedieningselementen die eerder niet vertaald waren.

## Virtuele routes

Sommige pagina's komen uit gegevens in plaats van uit een bericht dat door de editor wordt beheerd. Een componentreferentie heeft bijvoorbeeld mogelijk een eigen URL en documenttitel nodig, maar geen vermelding in `wp_posts`.

Registreer dat document met `Blockstudio\Virtual_Routes`:

```php title="functions.php"
add_action('init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function () {
            get_header();
            echo bs_block([
                'name' => 'mytheme/card',
                'data' => ['heading' => 'Example card'],
            ]);
            get_footer();
        },
        ['title' => 'Component gallery']
    );
});
```

De route levert `/components/`. De callback wordt uitgevoerd in de uitvoerbuffer van Blockstudio, zodat gerenderde blocks hun stijlen, scripts, gebundelde UI-assets en Tailwind-uitvoer via de normale pipeline ontvangen. WordPress zet de overeenkomende route niet om in een 404 en verwijst deze ook niet door naar een bericht.

Stel voor een reeks URL's `prefix` in op `true` en geef een callback van `match` op. De callback ontvangt het pad onder de route en retourneert de waarde die je renderer nodig heeft. Als je `null` of `false` retourneert, wordt het verzoek overgelaten aan WordPress. Gebruik `urls` om de paden op te geven die een statische prerender-build moet opnemen. Een enkele route zonder voorvoegsel bevat standaard zijn eigen pad.

`Virtual_Routes::urls()` retourneert absolute URL's voor integraties die een sitemap samenstellen. Virtuele documenten worden niet automatisch toegevoegd aan de postsitemap van WordPress.

Zie [Virtuele routes](https://blockstudio.dev/nl/docs/pages-and-patterns/pages/#virtual-routes) voor de volledige API en opties.

## Preciezere prerender-builds

Builds in de grafiekmodus die zijn gerenderd via HTTP registreren nu de bestanden die elke route gebruikte: de WordPress-template, gerenderde blocktemplates en assets, definities en indelingen van bestandspagina's, en afhankelijkheden die zijn toegevoegd via `blockstudio/render/dependencies`.

Bij de volgende build vergelijkt `build_plan()` die afhankelijkheden. Als een blocktemplate verandert, worden de afhankelijke routes gemarkeerd om opnieuw te renderen, zonder dat elke niet-gerelateerde pagina opnieuw wordt opgebouwd. Wijzigingen in gedeelde configuratie zijn nog steeds van invloed op de volledige build, en nieuwe of verlopen routes worden zoals voorheen gerenderd.

Wijzigingen die alleen de database betreffen, zijn geen bestandsafhankelijkheden. Een deployment die een optie, bericht of andere databasewaarde moet overnemen, moet een build forceren of de betreffende URL's expliciet renderen.

Deze release verhelpt ook wijzigingen in buildidentiteiten tijdens de eerste render, verouderde early-serve-maps in de opcodecache en het uitsluiten van geldige URL's alleen omdat hun pad `search` of `preview` bevat. Verzoeken van Markdown met `Accept: text/markdown` omzeilen gecachte HTML, en de relevante antwoorden versturen `Vary: Accept`.

Statische prerendering respecteert nu filters die door het actieve thema zijn geregistreerd wanneer wordt bepaald of de hooks moeten worden toegevoegd. Een thema kan de functie uitschakelen zonder dat een eerdere instellingencontrole deze actief laat.

Zie [Statische prerendering](https://blockstudio.dev/nl/docs/production/static-prerendering/).

## Cachebehoud en onderhoud

Een pagina in de cache met HTML kan langer bestaan dan de runtime-identiteit waarmee de stylesheet is gecompileerd. `cache.namespaceGrace` bepaalt hoe lang verouderde namespaces beschikbaar blijven nadat de opschoning hun veroudering voor het eerst vaststelt:

```json title="blockstudio.json"
{
  "cache": {
    "namespaceGrace": 777600
  }
}
```

Dit voorbeeld bewaart verouderde bestanden negen dagen. De standaard is één dag. Momenteel actieve namespaces en namespaces die uitgerolde prerender-artefacten aanbieden, zijn beschermd tegen opschoning van verouderde bestanden.

De early-serve-map heeft ook opdrachten voor inspectie en opschoning:

```bash
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
```

Ze rapporteren en verwijderen vermeldingen voor verwijderde sites of ontbrekende mappen. Als een multisite-site wordt verwijderd, worden ook de bijbehorende vermeldingen verwijderd. Ontbrekende routedocumenten worden apart gerapporteerd, zodat niet een volledige, geldige sitevermelding wordt verwijderd.

Zie [Caching](https://blockstudio.dev/nl/docs/production/caching/) voor richtlijnen voor bewaartermijnen en [onderhoud van de map](https://blockstudio.dev/nl/docs/production/static-prerendering/#warming-maintenance-and-observability) voor de opdrachten.

## Een betrouwbaardere editor

Bewerken van een block dat samen met andere blocks is geselecteerd, werkt nu alleen dat block bij. Bij het opslaan behoudt elk block zijn eigen inhoud, sleutels, metadata en vergrendelingen, in plaats van attributen tussen geselecteerde blocks te kopiëren.

RichText-waarden staan rechtstreeks in blockattributen, zodat Gutenberg ze kan opnemen in ongedaan maken en opnieuw uitvoeren. Zijbalkvelden maken deel uit van dezelfde geschiedenis. `InnerBlocks templateLock="false"` wordt als een echte boolean doorgegeven en ontgrendelt inhoud, zelfs wanneer een buitenliggend gebied is vergrendeld.

Eerste preloads ontvangen de ID en het type van het bewerkte bericht, zodat templates bij de eerste render de juiste metadata kunnen uitlezen. Identieke child-blocks onder verschillende parents behouden afzonderlijke overgeërfde context in preloads en rendercaches. Wijzigingen in attributen of context tijdens een eerste verzoek laten het voorbeeld niet langer achterlopen.

Blockstudio plaatst ook geen verborgen render-markerelementen meer tussen blockroots. Selectors voor aangrenzende elementen, zoals `.card + .card`, zien nu dezelfde elementrelaties in de editor als op de frontend, terwijl editor- en insertervoorbeeldrenders gescheiden blijven.

## Veiliger opslag van sitebrede opties

Velden die aan opties zijn gekoppeld, bieden nog steeds sitebrede waarden, maar bij het opslaan van een bericht worden niet langer blind alle opgeslagen kopieën van die velden weggeschreven:

- Concepten, berichten in afwachting, privéberichten en ingeplande berichten schrijven geen actieve siteopties weg.
- Gepubliceerde berichten schrijven de opgegeven velden weg die in die bewerking zijn gewijzigd.
- Als alleen de titel van een oude kopie wordt opgeslagen, wordt een nieuwere sitebrede waarde niet teruggedraaid.
- Ontbrekende velden en verwijderde blocks verwijderen bestaande opties niet.
- Met een expliciete `null` wordt een optie verwijderd. Lege strings, `false`, nul en lege arrays blijven geldige waarden.

Dit is de belangrijkste gedragsverandering om bij een upgrade te controleren. Als een integratie een privébericht of concept gebruikte om een actieve optie bij te werken, schrijf die optie dan expliciet weg of gebruik in plaats daarvan een gepubliceerd configuratiebericht. De beperking tot gepubliceerde berichten is niet van invloed op opslag van berichtmeta.

Zie [Opslag](https://blockstudio.dev/nl/docs/blocks/storage/) voor alle opslagregels.

## Bestandsinhoud blijft intact

De pipeline van HTML naar blocks behoudt meer van de structuur die je hebt geschreven:

- Geneste lijsten worden innerlijke lijstblocks van hun bovenliggende item. Klassen van lijsten en items blijven behouden; gewone vlakke lijsten behouden hun eerdere uitvoer.
- `main`, `header`, `footer`, `article` en `aside` worden groepsblocks die hun element behouden in plaats van ruwe HTML die blockrendering omzeilt.
- Toegewezen richtext-paragrafen behouden inline-markup, paragrafen met alleen een afbeelding worden omgezet naar het toegewezen afbeeldingsblock en shortcode-tags behouden hun inhoud.
- Ge-escape-te attributen worden gedecodeerd en eenmaal ge-escaped, ook attributen op `InnerBlocks`, `RichText` en het element `useBlockProps`.
- Groter-dan-tekens in geciteerde attributen van zelfsluitende tags worden geaccepteerd.
- Globale attributen van HTML bereiken de root van een Blockstudio-block wanneer het block ze niet als velden declareert. `wp bs pages sync` meldt opgeslagen attributen die niet worden gerenderd.

Pagina's, patronen en templates van de Site-editor op basis van Blade worden nu gerenderd via `Blockstudio\Blade_Renderer`, met ondersteuning voor `illuminate/view` 8 tot en met 12. Alle extensiebestanden die op hetzelfde block gericht zijn, worden geregistreerd; hun prioriteit, groepsvelden en doellijsten volgen het gedocumenteerde schema.

Afhankelijkheden van geneste SCSS-bestanden worden ook bijgehouden. Als een partial die door een andere partial wordt geïmporteerd wordt bewerkt, verandert de versie van de afhankelijke stylesheet en wordt hercompilatie gestart.

## Verbeteringen voor PHPStan

Het afzonderlijk geïnstalleerde pakket `blockstudio/phpstan` breidt de validatie van blocktags uit naar voorvoegsel- en aliastags, toegewezen pagina-elementen, layouts, gebundelde UI-blocks en optioneel andere PHP-bronnen van het project. Namespace-resolutie komt overeen met de runtime, ook voor namespaces met koppeltekens, en doorgestuurde globale attributen van HTML worden geaccepteerd.

Templatevariabelen van blocks, zoals `$a`, `$block` en `$context`, worden door Blockstudio als gedefinieerd beschouwd. Veldtypen blijven behouden bij null-coalescing en `isset()` onder PHPStan 2.3, terwijl een template die zelf een `$a` toewijst het toegewezen type behoudt.

Deze wijzigingen zijn opgenomen in `blockstudio/phpstan` 0.1.9. Werk het pakket afzonderlijk van de plugin bij; het vereist PHPStan 2.1.47 of nieuwer:

```bash
composer require --dev blockstudio/phpstan:^0.1.9
```

Zie [PHPStan](https://blockstudio.dev/nl/docs/dev/phpstan/) voor configuratie en analysepresets.

## Toegankelijkheid en vertalingen

Meegeleverde triggers van UI geven hun uitgevouwen status weer op de knop zelf. Labels voor selectievakjes, schakelaars en keuzerondjes benoemen hun bedieningselementen en schakelen deze in of uit. Breadcrumbs, paginering, navigatiemenu's en tabellen voegen geen ongeldige omhullende elementen meer toe tussen lijsten of tabellen en hun kinderen.

Wachtwoordschakelaars geven hun ingedrukte status weer en hebben een groter klikgebied. Invoervelden accepteren `autocomplete` en wachtwoordinvoervelden accepteren een expliciete ID en toegankelijk label. Carrouselviewports kunnen met het toetsenbord focus krijgen en spinner- en skeletonanimaties houden rekening met voorkeuren voor minder beweging.

De editor en het beheerdersoverzicht laden geïnstalleerde vertalingen van JavaScript voor het tekstdomein `blockstudio`. Attribuutmenu's en plaatsaanduidingen, acties van codepop-ups en afbeeldings- en bestandsbadges kunnen nu worden vertaald. Strings zonder vertaling blijven in het Engels.

Zie de [UI-bibliotheek](https://blockstudio.dev/nl/ui/) en [vertalingsinstellingen](https://blockstudio.dev/nl/docs/general/getting-started/#translations).

## Documentatie en upgraden

De documentatie is uitgebreid met handleidingen voor documentatiesites, Content Sync, Site Editor-sjablonen, bloktags, eilanden, aangepaste veldtypen, implementatie, vooraf renderen, registerconfiguratie, analysetools en UI-appschermen. De ACF-migratiehandleiding weerspiegelt de huidige registratie van ACF en Block Bindings.

Voorbeelden van aangepaste populatie gebruiken nu het ondersteunde filter met één argument en een benoemde dataset. De assetdocumentatie licht de volgorde van frontend-stylesheets toe en hoe je thema-overschrijvingen na CSS blok laadt. Installaties voor bijdragers gebruiken het openbare Font Awesome-pakket zonder registergegevens.

PHP 8.2 en WordPress 6.7 blijven de minimale vereisten. Virtuele routes en de nieuwe onderhoudsopdrachten zijn beschikbaar zonder bestaande paginacollecties te wijzigen. Bekijk hierboven de opslagregels voor opties, werk het aparte pakket PHPStan bij als je het gebruikt en blijf paginasynchronisatie expliciet uitvoeren zoals voorheen.

### 7.7.1 Vervolg

De patch 7.7.1 maakt synchronisatieresultaten duidelijker en veiliger. Een samenvoeging op basis van sleutels die een bericht ongewijzigd laat, maakt geen revisie meer aan en werkt de wijzigingsdatum niet bij. Bestaande publicatiestatussen blijven behouden, vervangingen van titels en slugs die door bestanden worden beheerd, worden gemeld en vergrendelde of verwijderde pagina's worden genoemd in het CLI-rapport. Content Sync markeert de hoofdteksten die door Page Sync worden beheerd en behoudt bestaande beoordelingskopieën. De patch beschermt ook door WordPress beheerde kenmerken tegen conflicterende veld-ID's en behoudt editor-klassen die door andere filters zijn toegevoegd.
