# Statisch waar het kan

Vooraf gerenderde pagina’s en standaardinstellingen voor productie, ingesteld in blockstudio.json.

## Prerender anonieme pagina’s

Statische prerendering is standaard uitgeschakeld. Schakel `performance.staticPrerender` in, waarna Blockstudio elk volledig HTML-document opslaat dat een anonieme bezoeker ontvangt en de volgende anonieme bezoeker de opgeslagen kopie serveert.

Verzoeken die live moeten blijven, raken deze nooit: niet-GET-verzoeken, querystrings, beheerpagina’s, REST, Ajax, cron, feeds, zoeken, previews, pagina’s met een nonce, elk pad onder `dynamicPaths` en ingelogde bezoekers, tenzij `serveLoggedIn` is ingeschakeld.

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

blockstudio.json

```
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

## Standaard uitgeschakeld

Er verandert niets totdat blockstudio.json de functie opgeeft.

## Dynamische paden

Een dynamisch pad van /account omvat /account/orders, maar niet /accounting.

## Marker voor uitsluiting

Een blockstudio:no-cache-commentaar houdt elk antwoord buiten de cache.

## Ingelogde bezoekers

Met serveLoggedIn kunnen ze opgeslagen pagina’s bekijken; hun eigen pagina’s worden nooit opgeslagen.

## [Aangepaste omzeiling](https://blockstudio.dev/nl/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

Met het filter static_prerender/request_bypass blijven alle verzoeken die je opgeeft, zoals een verzoek met een winkelwagen-cookie, buiten opgeslagen pagina’s.

## Opwarmwachtrij

Een duurzame wachtrij rendert verouderde pagina’s opnieuw op het interval dat u instelt.

## [Long-tailroutes](https://blockstudio.dev/nl/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Ook routes buiten de geïmplementeerde kaart worden vroegtijdig geserveerd, zodra WordPress ze heeft gerenderd en opgeslagen.

## Stylesheetcontrole

Een opgeslagen pagina waarvan de gekoppelde Tailwind-stylesheet ontbreekt, wordt opnieuw gerenderd en nooit onopgemaakt geserveerd.

## Wordt geserveerd voordat WordPress start

Als `earlyServe` is ingeschakeld, installeert Blockstudio een drop-in voor `advanced-cache.php` die een opgeslagen pagina streamt voordat WordPress, plugins of het thema worden geladen. Het overschrijft nooit een drop-in, routemap of `WP_CACHE`-regel die het niet zelf heeft geschreven.

Deze site voert het uit. Op 8 oktober 2026 antwoordden blockstudio.dev pagina’s met `x-blockstudio-static-prerender: HIT-EARLY`, de header die de drop-in verstuurt.

[Vroeg serveren](https://blockstudio.dev/nl/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Terminal

```
# Identity, files, queue, and hit/miss counters
wp bs prerender status

# Re-render stale entries now
wp bs prerender warm

# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run

# Remove the drop-in and map this install owns
wp bs teardown
```

## Na elke wijziging weer actueel

De standaardmodus `signature` vult de cache bij een misser van een anonieme bezoeker en ververst die na wijzigingen op siteniveau. Bij het opslaan of verwijderen van een bericht worden dat bericht en de voorpagina gewist, of in de wachtrij geplaatst om opnieuw te renderen wanneer opwarmen is ingeschakeld.

De modus `graph` is bedoeld voor implementatietools. De modus registreert welke bestanden elke pagina heeft gelezen, zodat een build alleen de routes opnieuw rendert waarvan bestanden zijn gewijzigd, en activeert daarna de nieuwe set als één artefact. Als een bestand waarnaar wordt verwezen de validatie niet doorstaat, blijft het vorige artefact actief.

Bij het installeren van een artefact worden bytes vergeleken en gewijzigde documenten atomair omgewisseld. `last_promotion()` meldt hoeveel routes zijn gepromoveerd, vervangen, overgeslagen of behouden, zodat een implementatie dit kan loggen en de actieve build-ID kan vergelijken.

[Handtekening- en graafmodi](https://blockstudio.dev/nl/docs/production/static-prerendering/#signature-and-graph-modes)

deploy.php

```
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
  $result = render_with_dependencies($url);

  Static_Prerender_Runtime::persist_built_response(
    $url,
    $result['html'],
    $result['files'],
    $result['virtualHashes']
  );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
```

## Achter een CDN

De prerender-header geeft al aan welke reacties veilig gedeeld kunnen worden. Koppel `HIT` en `HIT-EARLY` aan een `Cache-Control`-levensduur bij de origin, cache alleen wat er een heeft en omzeil de edge voor de cookies `wordpress_logged_in_`, `wp-postpass_` en `comment_author_email_`, je `dynamicPaths`, `wp-admin` en `wp-json`.

Pagina’s die aan de edge zijn gecachet, blijven de stylesheet met de content-hash gebruiken waarmee ze zijn gerenderd. Stel `cache.namespaceGrace` in op de langste tijd dat zo’n kopie kan bestaan; verwijderde stylesheets blijven op schijf staan totdat die tijd is verstreken.

[CDN instellen](https://blockstudio.dev/nl/guides/static-prerendering/#putting-a-cdn-in-front)

nginx.conf

```
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
  "~^HIT"  "public, s-maxage=604800";
  default  "";
}

location ~ \.php$ {
  include fastcgi_params;
  fastcgi_pass unix:/run/php/php-fpm.sock;
  add_header Cache-Control $edge_cache_control;
}
```

## Eén live blok op een gecachete pagina

Stel `blockstudio.island` in op `dynamic`; de gecachete pagina bevat dan een tijdelijke aanduiding in plaats van het blok. De browser verzamelt alle dynamische eilanden op de pagina en haalt hun fragmenten op in één gebundeld verzoek, elk ondertekend met de bloknaam en de toegestane attributen.

`hydrate` behoudt de volledige HTML op de pagina en verstuurt alleen een mount-gebeurtenis. Dynamische eilanden kunnen wachten tot ze zichtbaar zijn, vernieuwen wanneer een venstergebeurtenis plaatsvindt en fragmenten per gebruiker of globaal cachen.

[Blokeilanden](https://blockstudio.dev/nl/docs/blocks/islands/)

block.json

```
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}
```

## Bekijk waar de rendertijd naartoe gaat

Voeg `?blockstudio-perf` toe aan een willekeurige frontend-URL en een paneel toont de rendertijden per blok, het aantal aanroepen en de fasen voor transformatie, template en component. Dezelfde timings worden meegestuurd als `Server-Timing`-headers, die ook werken wanneer een CDN de HTML cachet.

Alleen ingelogde gebruikers met `edit_posts` zien de uitvoer; bij alle andere verzoeken schakelt `init` de profiler uit. `performance.measurement` voegt headers met de profiel- en configuratiehash toe, plus een `Performance_Measurement::snapshot()` API.

[Profiler](https://blockstudio.dev/nl/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## Eén schakelaar voor standaardinstellingen in productie

Met `performance.profile` ingesteld op `speed` worden generator-, emoji-, feed- en discovery-uitvoer uit de head verwijderd, wordt oEmbed-discovery uitgeschakeld, worden XML-RPC en pingbacks uitgeschakeld, worden algemene core-assets voor de frontend verwijderd, wordt Heartbeat buiten editors beperkt en worden links van dezelfde oorsprong vooraf opgehaald bij hover of focus.

De standaardwaarde is `compat`, die niets verandert. Elke onderliggende waarde overschrijft het profiel, zodat u één gedrag kunt behouden en de rest kunt overnemen.

[Prestatieprofielen](https://blockstudio.dev/nl/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

## Afbeeldingen die hun ruimte behouden

Thema-afbeeldingen staan buiten de mediabibliotheek, dus WordPress kent hun afmetingen niet. `bs_media_image()` leest de werkelijke afmetingen uit een gegenereerde `assets/media.json` en reserveert de beeldverhouding voordat het bestand wordt geladen.

Schakel `performance.media.lazy` in en de echte URL blijft achter een placeholder met de juiste afmetingen wachten totdat de afbeelding bijna in beeld komt.

[Media](https://blockstudio.dev/nl/docs/production/media/)

index.php

```
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);
```

## [Eén cachedirectory](https://blockstudio.dev/nl/docs/production/caching/)

Elk gegenereerd bestand staat onder cache.path en is gekoppeld aan een runtime-identiteit.

## [Builds met één gelijktijdige uitvoering](https://blockstudio.dev/nl/docs/production/caching/#concurrency-and-retention)

Eén verzoek bouwt een koude cachesleutel op. Andere verzoeken wachten, hergebruiken de laatst bekende goede payload of krijgen een 503 met Retry-After.

## Payloads die geschikt zijn voor OPcache

Kleine cachepayloads zijn gewone PHP-arrays die OPcache vanuit gedeeld geheugen kan hergebruiken. Grotere payloads blijven gecomprimeerd.

## [Rendercache](https://blockstudio.dev/nl/docs/production/performance/#render-cache)

Een zelfsluitende bloktag met dezelfde attributen wordt eenmaal per verzoek gerenderd. Herhalingen komen uit het geheugen.

## Keuzes in één keer vernieuwen

Een reeks contentupdates, zoals bij een import, leidt tot één vernieuwing van gecachete, ingevulde veldkeuzes.

## Caches voor meerdere tenants

Gebruik cache/site_key voor je eigen tenantgrens en cache/context voor runtimevarianten van dezelfde site.

## [Gecompileerde assets in de cache](https://blockstudio.dev/nl/docs/general/settings/#assets)

Als assets.output is ingesteld op cache, staan gecompileerde assets buiten de blokstructuur, zodat je vanuit een onveranderlijke checkout kunt implementeren.

## Builds in shards

Static_Prerender_Batch_Renderer splitst een build op in stabiele shards N/TOTAL; een aanroeper kan dezelfde partitie berekenen.

## [Kleine stylesheets inline plaatsen](https://blockstudio.dev/nl/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit plaatst de kleinste blokstylesheets inline binnen een bytebudget, in dezelfde cascadevolgorde.

## [Blok-CSS als laatste in de head](https://blockstudio.dev/nl/docs/blocks/assets/registering/#load-order)

Blok-CSS wordt vlak voor de afsluitende head-tag toegevoegd, na de stylesheets van het thema en de plug-ins.

## [Ongebruikte assets overslaan](https://blockstudio.dev/nl/docs/blocks/assets/registering/#disable-enqueuing)

Een template die niets teruggeeft, laadt geen assets. Met assets.enqueue false regel je alle assets zelf.

## [Cacheopdrachten](https://blockstudio.dev/nl/docs/dev/cli/)

Met wp bs cache status, cleanup en clear kun je de runtimecache bekijken, leegmaken en wissen. Met wp bs prerender purge verwijder je opgeslagen pagina’s.

## Schone verwijdering

wp bs teardown verwijdert alleen de status die bij deze installatie hoort.

## Hooks voor resultaten

cache/outcome en static_prerender/outcome melden hits, builds, misses en failures aan uw metrics.

## [Fout-hooks](https://blockstudio.dev/nl/docs/blocks/hooks/php/#error-handling)

error/logged en error/exception sturen Blockstudio-fouten door naar een externe logger of tracker.

## [Batchrendering](https://blockstudio.dev/nl/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset() wist de requeststatus tussen documenten in één proces. render/dependencies vermeldt de bestanden van elk block.

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/)
