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.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>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
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
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.
# 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 teardowncurl -sI https://blockstudio.dev/ | grep -i x-blockstudio
# x-blockstudio-static-prerender: HIT-EARLYNa 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.
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']));use Blockstudio\Static_Prerender_Early_Serve;
use Blockstudio\Static_Prerender_Runtime;
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
$counts = Static_Prerender_Early_Serve::last_promotion();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.
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;
}{
"cache": {
"namespaceGrace": 777600
},
"tailwind": {
"enabled": true,
"output": "link"
}
}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.
{
"name": "acme/cart-count",
"title": "Cart count",
"blockstudio": {
"island": {
"mode": "dynamic",
"attributes": ["productId"],
"loading": "visible",
"event": "cart:updated",
"cache": {
"ttl": 60,
"per": "user"
}
}
}
}<div class="cart-count-placeholder">
Loading cart...
</div>window.dispatchEvent(new Event('cart:updated'));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.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();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.
{
"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.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}Eén cachedirectory
Elk gegenereerd bestand staat onder cache.path en is gekoppeld aan een runtime-identiteit.
Builds met één gelijktijdige uitvoering
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
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
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
assets.inlineLimit plaatst de kleinste blokstylesheets inline binnen een bytebudget, in dezelfde cascadevolgorde.
Blok-CSS als laatste in de head
Blok-CSS wordt vlak voor de afsluitende head-tag toegevoegd, na de stylesheets van het thema en de plug-ins.
Ongebruikte assets overslaan
Een template die niets teruggeeft, laadt geen assets. Met assets.enqueue false regel je alle assets zelf.
Cacheopdrachten
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
error/logged en error/exception sturen Blockstudio-fouten door naar een externe logger of tracker.
Batchrendering
Batch_Render::reset() wist de requeststatus tussen documenten in één proces. render/dependencies vermeldt de bestanden van elk block.
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