# Statické, kdykoli je to možné

Předrenderované stránky a výchozí nastavení pro produkci se nastavují v blockstudio.json.

## Předrenderujte anonymní stránky

Statické předgenerování je ve výchozím nastavení vypnuté. Zapnutím `performance.staticPrerender` a Blockstudio se uloží každý kompletní dokument HTML, který obdrží anonymní návštěvník, a dalšímu anonymnímu návštěvníkovi se odešle jeho kopie.

Požadavky, které musí být zpracovány živě, se cache vůbec nedotknou: požadavky jiné než GET, řetězce dotazu, administrace, REST, Ajax, cron, kanály, vyhledávání, náhledy, stránky s nonce, všechny cesty pod `dynamicPaths` a přihlášení návštěvníci, pokud není zapnuté `serveLoggedIn`.

[Předběžné statické vykreslování](https://blockstudio.dev/cs/docs/production/static-prerendering/)

blockstudio.json

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

## Ve výchozím nastavení vypnuto

Nic se nezmění, dokud blockstudio.json funkci nepojmenuje.

## Dynamické cesty

Dynamická cesta /account zahrnuje /account/orders, ale ne /accounting.

## Značka pro vyřazení z cache

Komentář blockstudio:no-cache zajistí, že se žádná odpověď neuloží do cache.

## Přihlášení návštěvníci

Se zapnutým serveLoggedIn se jim zobrazí uložené stránky; jejich vlastní stránky se nikdy neukládají.

## [Vlastní obejití](https://blockstudio.dev/cs/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

Filtr static_prerender/request_bypass vyřadí z uložených stránek každý požadavek, který určíte, například požadavek se souborem cookie košíku.

## Fronta přednačítání

Trvalá fronta znovu vykresluje zastaralé stránky v nastaveném intervalu.

## [Trasy s nízkou návštěvností](https://blockstudio.dev/cs/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Trasy mimo nasazenou mapu se také obsluhují přednostně, jakmile je WordPress vykreslí a uloží.

## Kontrola stylopisu

Uložená stránka, jejíž odkazovaný stylopis Tailwind chybí, se vykreslí znovu a nikdy se neposkytne bez stylů.

## Odesláno před spuštěním WordPress

Když je zapnuté `earlyServe`, Blockstudio nainstaluje drop-in `advanced-cache.php`, který odešle uloženou stránku ještě před načtením WordPress, pluginů nebo šablony. Nikdy nepřepíše drop-in, mapu tras ani řádek `WP_CACHE`, který nevytvořil.

Tento web ho používá. Dne 8. října odpovídaly stránky blockstudio.dev hodnotou `x-blockstudio-static-prerender: HIT-EARLY` v hlavičce, kterou odesílá drop-in; 2026.

[Včasné odeslání](https://blockstudio.dev/cs/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Terminál

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

## Aktuální po každé změně

Výchozí režim `signature` naplní cache při prvním požadavku anonymního návštěvníka a po změnách na úrovni webu ji obnoví. Uložení nebo smazání příspěvku vymaže daný příspěvek a úvodní stránku, případně zařadí jejich nové vykreslení do fronty, pokud je zapnuté přednačítání.

Režim `graph` je určený pro nástroje nasazení. Zaznamenává soubory načtené každou stránkou, takže sestavení znovu vykreslí jen trasy, jejichž soubory se změnily, a poté aktivuje novou sadu jako jediný artefakt. Pokud některý odkazovaný soubor neprojde ověřením, předchozí artefakt zůstane aktivní.

Při instalaci artefaktu se porovnají bajty a změněné dokumenty se atomicky vymění. `last_promotion()` uvádí počet tras, které byly povýšeny, nahrazeny, přeskočeny nebo ponechány, takže nasazení může tento údaj zaznamenat a porovnat ID aktivního sestavení.

[Režimy podpisu a grafu](https://blockstudio.dev/cs/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']));
```

## Za CDN

Hlavička předvykreslení už uvádí, které odpovědi lze bezpečně sdílet. Namapujte `HIT` a `HIT-EARLY` na dobu platnosti `Cache-Control` na původním serveru, ukládejte do mezipaměti pouze odpovědi, které ji obsahují, a obejděte edge pro soubory cookie `wordpress_logged_in_`, `wp-postpass_` a `comment_author_email_`, váš `dynamicPaths`, `wp-admin` a `wp-json`.

Stránky uložené v mezipaměti na edge dál odkazují na stylopis s hashem obsahu, se kterým byly vykresleny. Nastavte `cache.namespaceGrace` na nejdelší dobu, po kterou může taková kopie existovat, a zastaralé stylopisy zůstanou na disku až do jejího uplynutí.

[Nastavení CDN](https://blockstudio.dev/cs/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;
}
```

## Jeden živý blok na stránce z mezipaměti

Nastavte `blockstudio.island` na `dynamic` a stránka z mezipaměti ponese zástupný symbol místo bloku. Prohlížeč shromáždí všechny dynamické ostrovy na stránce a v jednom dávkovém požadavku načte jejich fragmenty; každý bude podepsaný názvem bloku a jeho atributy ze seznamu povolených.

`hydrate` ponechá na stránce celé HTML a odešle pouze událost připojení. Dynamické ostrovy mohou počkat, až budou viditelné, obnovit se při vyvolání události okna a ukládat fragmenty do mezipaměti pro jednotlivé uživatele nebo globálně.

[Blokové ostrůvky](https://blockstudio.dev/cs/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"
      }
    }
  }
}
```

## Zjistěte, kam se poděl čas vykreslování

Přidejte `?blockstudio-perf` do libovolného frontendového URL a panel zobrazí časy vykreslování jednotlivých bloků, počty volání a fáze transformace, šablony a komponent. Stejné časové údaje se posílají v hlavičkách `Server-Timing`, které fungují i tehdy, když CDN ukládá HTML do mezipaměti.

Výstup uvidí pouze přihlášení uživatelé s `edit_posts`; při všech ostatních požadavcích se profiler vypne na `init`. `performance.measurement` přidává hlavičky s hashem profilu a konfigurace a `Performance_Measurement::snapshot()` API.

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

blockstudio.json

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

## Jediný přepínač pro výchozí nastavení produkce

Nastavení `performance.profile` na `speed` odstraní z hlavičky informace o generátoru, emoji, kanálech a objevování, vypne objevování oEmbed, zakáže XML-RPC a pingbacky, odstraní obecné prostředky jádra pro frontend, omezí Heartbeat mimo editory a při najetí nebo zaměření přednačte odkazy na stejné doméně.

Výchozí hodnota je `compat` a nic nemění. Každá podřízená hodnota přepíše profil, takže si můžete ponechat jedno chování a ostatní převzít z profilu.

[Výkonnostní profily](https://blockstudio.dev/cs/docs/production/performance/#performance-profiles)

blockstudio.json

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

## Obrázky, které si zachovají své místo

Obrázky šablony jsou mimo knihovnu médií, takže WordPress nezná jejich rozměry. `bs_media_image()` načte skutečné rozměry z vygenerovaného `assets/media.json` a vyhradí místo podle poměru stran ještě před načtením souboru.

Zapněte `performance.media.lazy` a skutečné URL se načte až za zástupným prvkem se správnými rozměry, jakmile se obrázek přiblíží k oblasti zobrazení.

[Média](https://blockstudio.dev/cs/docs/production/media/)

index.php

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

## [Jeden adresář cache](https://blockstudio.dev/cs/docs/production/caching/)

Každý vygenerovaný soubor je uložen pod cache.path a jeho klíčem je identifikátor prostředí.

## [Sestavení probíhá jen jednou](https://blockstudio.dev/cs/docs/production/caching/#concurrency-and-retention)

Jeden požadavek vytvoří klíč pro studenou mezipaměť. Ostatní čekají, znovu použijí poslední správnou datovou část nebo dostanou 503 s hlavičkou Retry-After.

## Datové části vhodné pro OPcache

Malé datové části mezipaměti jsou prostá pole PHP, která může OPcache znovu použít ze sdílené paměti. Větší zůstávají komprimované.

## [Mezipaměť vykreslení](https://blockstudio.dev/cs/docs/production/performance/#render-cache)

Tag bloku bez uzavírací značky se stejnými atributy se vykreslí jednou za požadavek. Při opakování se použije výsledek z paměti.

## Sloučená aktualizace možností

Dávka zápisů obsahu, například při importu, se sloučí do jediné aktualizace naplněných možností polí v mezipaměti.

## Mezipaměti pro více tenantů

Filtry cache/site_key použijte pro vlastní hranici tenantů a cache/context pro varianty stejného webu za běhu.

## [Zkompilované prostředky v mezipaměti](https://blockstudio.dev/cs/docs/general/settings/#assets)

Když je assets.output nastaveno na cache, zkompilované prostředky opustí strom bloků, takže je lze nasadit z neměnného checkoutu.

## Rozdělená sestavení

Static_Prerender_Batch_Renderer rozdělí sestavení na stabilní části N/TOTAL a volající může vypočítat stejné rozdělení.

## [Vložit malé stylopisy přímo do stránky](https://blockstudio.dev/cs/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit vkládá nejmenší stylopisy bloků přímo do stránky v rámci limitu bajtů a ve stejném pořadí kaskády.

## [Stylopisy bloků CSS jako poslední v head](https://blockstudio.dev/cs/docs/blocks/assets/registering/#load-order)

Stylopisy bloků CSS se přidávají těsně před uzavírací tag head, za stylopisy motivu a pluginů.

## [Vynechat nepoužité prostředky](https://blockstudio.dev/cs/docs/blocks/assets/registering/#disable-enqueuing)

Šablona, která nic nevrací, nezařadí žádné prostředky. Hodnota assets.enqueue false vám předá všechny prostředky.

## [Příkazy pro mezipaměť](https://blockstudio.dev/cs/docs/dev/cli/)

Příkazy wp bs cache status, cleanup a clear prohlížejí, vyprazdňují a pročišťují běhovou mezipaměť. Příkaz wp bs prerender purge odstraní uložené stránky.

## Čisté odebrání

wp bs teardown odstraní pouze stav, za který odpovídá tato instalace.

## Háčky pro výsledek

cache/outcome a static_prerender/outcome zaznamenávají zásahy, sestavení, neúspěšná hledání a chyby do vašich metrik.

## [Háčky pro chyby](https://blockstudio.dev/cs/docs/blocks/hooks/php/#error-handling)

error/logged a error/exception předávají Blockstudio chyby externímu loggeru nebo nástroji pro sledování.

## [Dávkové vykreslování](https://blockstudio.dev/cs/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset() mezi dokumenty v jednom procesu čistí stav požadavku. render/dependencies vypisuje soubory jednotlivých bloků.

Plus

## Oficiální sada rozšíření

Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.

- 500+ šablon webů
- Systémové instrukce AI
- Doživotní aktualizace
- Soukromá komunita Discord

[Získat Plus](https://blockstudio.dev/cs/plus/)
