Přejít k obsahu

Dennis · 23. července 2026

Blockstudio 7.5

Blockstudio Verze 7.5 završuje souborově orientovaný pracovní postup Blockstudio: přináší vlastní typy polí, šablony Site Editoru uložené v souborech, ostrovy bloků, úložiště databáze Storh, logické zdroje objevování, kombinovatelné značky bloků a rychlejší nasazování i běhové prostředí.

Opakovaně použitelná vlastní pole už projektům umožňují jednou definovat skupinu existujících polí a znovu ji používat s type: "custom/{name}". Vlastní typy polí řeší jiný problém. Umožňují motivu nebo pluginu zaregistrovat nový typ pole s vlastním jmenným prostorem, poskytnout mu vlastní ovládací prvek editoru a ukládat hodnotu jako běžná data Blockstudio.

Stručně řečeno:

  • Logické zdroje pro vyhledávání: běhová prostředí mohou poskytnout složený logický inventář motivu včetně původu a identity mezipaměti, zatímco Blockstudio zajišťuje vyhledávání, určování souvisejících souborů, generované prostředky, Canvas a chování Tailwind.
  • Registr typů polí PHP: motivy a pluginy mohou registrovat typy polí s oborovým názvem, například acme/dimensions pomocí bs_register_field_type() nebo filtru blockstudio/field_types.
  • Registr ovládacích prvků editoru: vlastní skripty editoru mohou volat window.blockstudio.registerFieldType() a vykreslit odpovídající ovládací prvek React v běžném poli Blockstudio UI.
  • Strukturované hodnoty: vlastní pole mohou ukládat řetězce, čísla, booleovské hodnoty, pole nebo objekty, aniž by se hodnoty objektů převáděly normalizací polí s možnostmi.
  • Podpora úložiště: vlastní pole v metadatech příspěvků a pole ukládaná v možnostech mohou deklarovat typ hodnoty a schéma REST, včetně hodnot objektů a polí.
  • Nativní integrace: vlastní typy polí fungují uvnitř skupin, karet, opakovačů, znovupoužitelných vlastních polí, šablon a cest k šablonám rozšíření.
  • Šablony Editoru webu: motivy mohou definovat zdroje wp_template a wp_template_part z šablonových souborů template.json, part.json a Blockstudio.
  • Blokové ostrovy: bloky mohou nejprve vykreslit skořápku bezpečnou pro mezipaměť a po načtení stránky následně načíst potřebné části nebo je načíst hromadně.
  • Ukládání databáze Storh: bs.db může používat indexované úložiště se samostatným souborem pro každý záznam v adresáři uploads, přičemž zachová veřejná celočíselná ID a umožní migraci z JSONC na Storh pomocí WP-CLI.
  • Vylepšení parseru a bsui: mapované odstavce richtext vyžadují méně vlastní logiky parseru, InnerBlocks může používat tokenizované allowedBlocks, výstup vnořeného bs_render_block() odpovídá vykreslení na frontendu v náhledech editoru a bsui/button nabízí ikony a snazší možnosti stylování.
  • Kombinovatelné značky bloků: značky s prefixem lze rozlišovat přes jiný prefix (<theme-ui-input> na bsui/input) a značky s prefixy i aliasy se vykreslují ve výstupu šablon bloků, nejen v obsahu stránky.
  • Mezipaměti sestavení bezpečné pro hostitele: mezipaměti běhového prostředí a editoru se nyní ve výchozím nastavení ukládají mimo uploads, podporují nastavitelné umístění a odstraňují zastaralé položky, takže se v dlouhodobých projektech nehromadí soubory mezipaměti.
  • Inkrementální synchronizace stránek: nástroje pro nasazení mohou synchronizovat úplný inventář stránek ze souborů, přeskočit nezměněné příspěvky, přesně hlásit změny a po aktivaci uložit ověřenou identitu zdroje.
  • Rychlejší vykreslování při zahřáté mezipaměti: platné mezipaměti běhového prostředí se načítají ještě před vyhledáváním, souběžné požadavky při prázdné mezipaměti zveřejní jediný atomický výsledek a Tailwind udržuje mezipaměť velikosti webu se znovupoužitelným stavem kompilátoru.
  • Bezpečné hromadné vykreslování: exportéry mohou mezi dokumenty resetovat stav vykreslování vázaný na požadavek, aniž by znovu sestavovaly vyhledávání, a během vykreslování bloků shromažďovat závislosti zdrojů.

Nové funkce

Verze 7.5 přináší řadu nových možností v oblasti vyhledávání, šablon a úložišť.

Logické zdroje pro vyhledávání

Blockstudio obvykle vyhledává soubory ve fyzických adresářích motivu. Verze 7.5 přidává zdroj nižší úrovně API pro běhová prostředí, která skládají motiv z překryvných vrstev, náhledů, generovaných souborů, vzdálených připojení nebo jiných složených inventářů.

Integrace může poskytnout konečný logický strom souborů, zatímco Blockstudio si ponechává odpovědnost za chování bloků, polí, stránek, vzorů, Editoru webu, Canvas, prostředků a Tailwind:

PHP
use Blockstudio\Inventory_Discovery_Source;

add_filter(
    'blockstudio/discovery/sources',
    function (array $sources, string $context): array {
        if ('blocks' !== $context) {
            return $sources;
        }

        return [
            new Inventory_Discovery_Source(
                'preview:feature-card',
                '/runtime-preview/feature-card/blockstudio',
                [
                    'card/block.json' => [
                        'path' => '/theme/blockstudio/card/block.json',
                        'provenance' => ['layer' => 'parent'],
                    ],
                    'card/index.php' => [
                        'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
                        'provenance' => ['layer' => 'preview'],
                    ],
                ],
                'preview-fingerprint'
            ),
        ];
    },
    10,
    2
);

Logické cesty zůstávají stabilní, i když související soubory pocházejí z různých fyzických kořenových adresářů. ID zdrojů a otisky prstů určují identity mezipaměti běhového prostředí a Tailwind, sledované vstupy ji zneplatňují a původ určuje, kam lze zapisovat generované soubory. Výchozí zdroj souborového systému se u běžných motivů nemění.

Šablony Editoru webu uložené v souborech

Stránky a vzory už umožňují týmům uchovávat struktury obsahu v souborech. Verze 7.5 tento přístup rozšiřuje i na samotný Editor webu.

Text
theme/
  templates/
    front-page/
      template.json
      index.php
  parts/
    header/
      part.json
      index.php
JSON
{
  "slug": "front-page",
  "title": "Front Page"
}
PHP
<div class="site-shell">
  <block name="core/template-part" slug="header" />

  <main>
    <h1>Welcome</h1>
    <block name="core/post-content" />
  </main>
</div>

Blockstudio zkompiluje zdroj pomocí stejného parseru jako stránky a vzory a poté výsledek zpřístupní WordPress jako běžnou šablonu nebo část šablony Editoru webu. Editor webu šablonu zobrazí, frontend ji může vykreslit a WordPress nadále spravuje vlastní úpravy.

Tato poslední část je důležitá. Šablony uložené v souborech slouží jako záložní zdroj. Pokud uživatel uloží šablonu v Editoru webu, WordPress vytvoří běžnou úpravu v databázi typu wp_template nebo wp_template_part, která má přednost. Po resetování úpravy se znovu zobrazí nejnovější verze ze souboru.

Inkrementální nasazování stránek

Stránky uložené v souborech získaly ve verzi 7.5 funkci synchronizace nasazení API. Od 7.6.2 jsou jedinými vstupními body pro synchronizaci výslovné volání API a wp bs pages sync; běžné požadavky změny zdrojů nikdy neaplikují:

PHP
$report = Blockstudio\Pages::reconcile([
  'authoritative' => true,
  'plan_valid' => true,
  'source' => [
    'commit' => $commit,
    'dirtyHash' => $dirtyHash,
  ],
]);

Proces zjistí úplný požadovaný inventář stránek, porovná otisky prstů obsahu a synchronizačního modulu a nahlásí vytvořené, aktualizované, nezměněné, odebrané a neúspěšné stránky. U stránek se shodnými otisky se nezapisují příspěvky ani metadata příspěvků. Chybějící spravované stránky se odstraní pouze tehdy, když vyhledávání proběhne bez chyb.

Synchronizace vrací deterministickou identitu zdroje, ale neoznačuje nasazení za úspěšné. Nástroje pro nasazení tuto identitu ukládají až poté, co jsou odpovídající soubory a trasy aktivní a ověřené. Běžné zavedení WP-CLI registruje typy příspěvků kolekcí a pravidla přepisování z mezipaměti, aniž by vyhledávalo a synchronizovalo každou stránku.

Blokové ostrovy

Většina bloků Blockstudio se vykresluje na serveru. To se dobře hodí pro WordPress, ale přináší známý problém s ukládáním do mezipaměti: kvůli jedinému personalizovanému bloku může být obtížné ukládat do mezipaměti celou stránku.

Blokové ostrovy rozdělují tuto hranici na úrovni bloků.

JSON
{
  "name": "acme/cart-count",
  "blockstudio": {
    "island": "dynamic"
  }
}

Dynamický ostrov vykreslí v první odpovědi pouze zástupný prvek bezpečný pro mezipaměť. Prohlížeč pak odešle jeden hromadný požadavek pro všechny připravené dynamické ostrovy na stránce a Blockstudio vykreslí tyto části v kontextu skutečného požadavku návštěvníka.

Celou stránku tak lze uložit do mezipaměti spolu se skořápkou stránky, zatímco počet položek v košíku, ovládací prvky účtu, UI omezené oprávněními i další části pro jednotlivé uživatele zůstávají aktuální.

PHP
<div class="cart-count-placeholder">Loading cart...</div>
PHP
<div class="cart-count">
  <?php echo esc_html(acme_cart_count()); ?>
</div>

U bloků, které už vykreslují obsah HTML bezpečný pro mezipaměť a potřebují pouze signál pro připojení na frontendu, použijte hydratovaný ostrov:

JSON
{
  "name": "acme/tabs",
  "blockstudio": {
    "island": "hydrate"
  }
}

Hydratované ostrovy nevytvářejí požadavek REST. Vykreslí se běžným způsobem a na frontendu obdrží událost blockstudio:island:hydrate.

Dynamické ostrovy fungují také prostřednictvím programového vykreslování:

PHP
bs_render_block([
  'name' => 'acme/cart-count',
  'data' => ['productId' => 42],
]);

A také prostřednictvím značek bloků:

HTML
<bs:acme-cart-count product-id="42" />

Koncový bod má záměrně úzce vymezenou funkci. Vykresluje pouze registrované bloky Blockstudio, které jsou dynamické a výslovně označené jako dynamické ostrovy. Atributy se filtrují podle schématu bloku a seznamu povolených atributů ostrova a každý zástupný prvek obsahuje podpis vytvořený obsluhujícím webem WordPress.

Ukládání databáze Storh

Databázová vrstva Blockstudio už podporuje tabulky, SQLite, JSONC, metadata příspěvků a vlastní typy příspěvků. Verze 7.5 přidává storage: "storh" pro projekty, které chtějí úložiště založené na souborech s bezpečnějšími souběžnými zápisy a indexy odvozenými ze schématu, ale nechtějí ukládat živé záznamy vedle zdrojových souborů bloků.

PHP
return [
    'storage' => 'storh',
    'fields'  => [
        'title'  => ['type' => 'string', 'required' => true],
        'status' => ['type' => 'string'],
        'count'  => ['type' => 'integer'],
    ],
];

Záznamy Storh se ukládají do uploads:

Text
wp-content/uploads/blockstudio/db/my-theme-my-block/default/

Veřejné API zůstává beze změny. bs.db(), REST a Db::get() stále vracejí celočíselné hodnoty id. Uvnitř Blockstudio mapuje tato ID na ID dokumentů Storh typu UUIDv7, takže stávající kód klienta není třeba měnit.

Každé pole deklarované ve schématu se indexuje pro filtry rovnosti, číselná pole a pole s daty získávají rozsahové indexy a explicitní požadavky na jedinečnost se předávají dál. U projektů, které začaly se seed soubory JSONC, nová migrace CLI ponechá zdrojový soubor na místě a zapíše ekvivalentní úložiště Storh:

Shell
wp bs db migrate my-theme/app subscribers --to=storh

Díky tomu má JSONC jasnější úlohu jednoduchého seed a konfiguračního formátu vhodného pro verzování, zatímco Storh se stává lepším výchozím souborovým backendem pro zapisovatelná produkční data.

Vylepšení parseru a bsui

Verze 7.5 přidává také menší úpravy, které se hodí, když projekt začne více spoléhat na šablony uložené v souborech a sdružené UI.

Mapování prvků nyní zvládá běžný případ odstavce richtext bez vlastního builderu. Pokud <p> mapuje na registrovaný blok Blockstudio, který není součástí jádra a má atribut richtext content, jednoduchý vnitřní text se zkopíruje do tohoto atributu. Vnořené značky a mapované podřízené prvky se nadále parsují jako vnitřní bloky.

InnerBlocks přijímá v šablonách tokenizované allowedBlocks:

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
  'core/paragraph',
  'category:content',
  'bsui/field',
])); ?>" />

Podporované tokeny jsou namespace/*, category:<slug> a @theme. Rozbalí se na serveru před předáním šablony editoru, takže cesta vykreslování na frontendu zůstává beze změny.

Programové vložené bloky se nyní vykreslují předvídatelněji. bs_render_block() a bs_block() nyní vykreslují vložené bloky jako komponenty HTML rozlišené na frontendu, i když jsou volány z náhledu editoru jiného bloku. Vnořené bloky tak do značek náhledu nepropouštějí surové pseudo komponenty <RichText /> ani <InnerBlocks />.

U sdruženého UI nyní bsui/button podporuje atribut icon a iconPosition. Vložené styly sdruženého bsui/* se vydávají ve vrstvě kaskády @layer bsui a varianty tlačítek lze rozšířit pomocí blockstudio/ui/button/variants-style a stávajícího filtru blockstudio/blocks/attributes.

Značky bloků lze kombinovat i dále. Prefix lze rozlišit přes jiný prefix, takže <theme-ui-input /> s projektovým prefixem theme nad jmenným prostorem prefixu ui se rozliší jako bsui/input. Registrované značky s prefixy i aliasy se nyní vykreslují také ve výstupu šablon bloků, nejen v obsahu stránek, takže je šablona může vykreslit přímo místo volání bs_render_block().

Vlastní buildery bloků registrované přes blockstudio/block_tags/builders se nyní jednotně zapojují do parsování značek a mapovaných prvků. Poté se stále spouštějí výslovné filtry vykreslování, které mohou builder přepsat.

Rychlejší požadavky při zahřáté mezipaměti a exporty

Mezipaměti běhového prostředí a editoru se nyní ve výchozím nastavení ukládají do wp-content/blockstudio/cache místo do uploads. Umístění lze změnit pomocí cache.path nebo blockstudio/cache/dir, takže trvalé ukládání do mezipaměti zůstává dostupné i na hostitelích, kteří blokují PHP v adresáři uploads. Mezipaměti běhového prostředí, prostředků editoru a Tailwind také automaticky odstraňují zastaralé položky, takže se na disku v dlouhodobých projektech nehromadí neomezené množství souborů mezipaměti.

Požadavky na frontend při zahřáté mezipaměti nyní načítají platný registr běhového prostředí ještě před sestavením zdrojů pro vyhledávání. Tím se vynechá rekurzivní procházení zdrojů, sestavování bloků, parsování polí a opakované procházení stromů klíčů mezipaměti. Produkční a testovací prostředí ve výchozím nastavení 20 sekund důvěřují ověřenému snímku sledovaných souborů, zatímco místní a vývojová prostředí kontrolují stav při každém požadavku.

Vytváření prázdné mezipaměti probíhá pouze jednou. Jeden požadavek sestaví a atomicky zveřejní obsah, zatímco souběžné požadavky čekají na dokončení. Tailwind nyní ve výchozím nastavení uchovává až 1,000 zkompilovaných položek po dobu 30 dní a znovu používá zahřátý stav sestavení kompilátoru, takže soubor tras velikosti celého webu už neustále nevytlačuje obsah z malé mezipaměti.

Dlouhodobě běžící exportéry mohou mezi dokumenty volat Blockstudio\Batch_Render::reset(). Tím se vymažou počítadla, prostředky, ostrovy, rozvržení a generování Tailwind vázané na požadavek, aniž by se znovu sestavovalo vyhledávání. Filtr blockstudio/render/dependencies zpřístupňuje cesty k šablonám a prostředkům použitým každým vykresleným blokem pro sestavení grafů závislostí.

Spolehlivost a kompatibilita

Vydání doplňuje několik oprav:

  • Definice polí změněné přes blockstudio/blocks/attributes nyní určují také ověřování možností při vykreslování, stejně jako schéma editoru. Typované číselné a booleovské hodnoty možností se také vyhodnocují jednotně.
  • Obaly bloků editoru používají stejné generované třídy jako vykreslení na frontendu a Canvas může pomocí nového filtru blockstudio/editor/canvas/body_class zkopírovat nastavené třídy těla stránky z frontendu.
  • Synchronizace obsahu ověřuje celý plán zdrojů před destruktivními zápisy, omezuje operace čištění na nakonfigurovanou sadu obsahu a hlásí chyby při zápisu souborů, aniž by posunula stav synchronizace dané entity.
  • Balíčky Composer sdružené v aktivních motivech nebo nadřazených motivech připojených symbolickým odkazem nyní načítají prostředky editoru z veřejného URL motivu.
  • U stránek ze souborů s klíči se zachovávají hodnoty polí Blockstudio spravované editorem, při synchronizaci se migruje starší vnořený tvar klíčů a jako platný klíč se přijímá číselná nula.
  • Dynamické ostrovy ověřují podpisy před filtry atributů požadavku, ignorují nepodepsaný kontext požadavku, obnovují přihlášené návštěvníky stejného původu a zabraňují kolizím mezipaměti pro nepřihlášené uživatele.
  • Koncové body stránek Markdown nyní respektují viditelnost příspěvků a ochranu heslem.
  • Ovládací prvky editoru spolehlivěji zpracovávají prázdné podmínky, hodnoty přepínače zaškrtnutí všech polí, asynchronní obnovování možností, dynamické pořadí vykreslování a stav RichText nebo WYSIWYG v opakovačích.

Vlastní typy polí

Další informace o výše představených vlastních typech polí.

Proč vlastní typy polí?

Blockstudio má být užitečný ihned po instalaci, ale skutečné projekty často potřebují ovládací prvky pro konkrétní oblast: výběr tokenů rozestupů, barevné role designového systému, responzivní rozměry, zdroje ikon, výběr produktů nebo redakční ovládací prvky, které mapují strukturovanou hodnotu.

Před verzí 7.5 mohly tyto projekty buď kombinovat několik vestavěných polí, nebo upravit editor. Verze 7.5 nabízí podporovanou střední cestu: Blockstudio spravuje životní cyklus pole a projekt jeho ovládací prvek.

PHP
add_action('init', function () {
    wp_register_script(
        'acme-field-dimensions',
        get_stylesheet_directory_uri() . '/fields/dimensions.js',
        ['blockstudio-blocks', 'wp-components', 'wp-element'],
        '1.0.0',
        true
    );

    bs_register_field_type('acme/dimensions', [
        'attribute'     => 'object',
        'default'       => [],
        'editor_script' => 'acme-field-dimensions',
        'storage'       => [
            'type'        => 'object',
            'rest_schema' => [
                'type'                 => 'object',
                'additionalProperties' => ['type' => 'string'],
            ],
        ],
    ]);
});
JavaScript
const { createElement: el } = wp.element;
const { TextControl } = wp.components;

window.blockstudio.registerFieldType('acme/dimensions', {
  component(props) {
    const value =
      props.value &&
      typeof props.value === 'object' &&
      !Array.isArray(props.value)
        ? props.value
        : {};
    const sides = props.sides || ['top', 'right', 'bottom', 'left'];

    return el(
      'div',
      {},
      sides.map((side) =>
        el(TextControl, {
          key: side,
          label: side,
          value: value[side] || '',
          onChange(nextValue) {
            props.onChange({
              ...value,
              [side]: nextValue,
            });
          },
        }),
      ),
    );
  },
});

Pole pak lze používat v block.json jako nativní pole:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "margin",
        "type": "acme/dimensions",
        "label": "Margin",
        "sides": ["top", "bottom"],
        "default": {
          "top": "md",
          "bottom": "md"
        }
      }
    ]
  }
}

Běžné hodnoty šablon

Uložená hodnota je k dispozici v PHP, Twig a Blade stejně jako jakýkoli jiný atribut Blockstudio.

PHP
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
  <?php echo esc_html($a['title'] ?? ''); ?>
</div>

Stejné cesty k objektům fungují také v šablonách rozšíření:

JSON
{
  "blockstudio": {
    "extend": "core/group",
    "attributes": [
      {
        "id": "margin",
        "type": "acme/dimensions",
        "set": [
          {
            "attribute": "class",
            "value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
          }
        ]
      }
    ]
  }
}

Poznámky ke kompatibilitě

Stávající vestavěné typy polí zůstávají beze změny. Beze změny zůstávají také stávající znovupoužitelné skupiny polí custom/{name}. Názvy vlastních typů polí musí být malými písmeny a musí mít oborový název, například acme/dimensions; jmenné prostory custom/ a blockstudio/ zůstávají vyhrazené.

Pokud PHP zaregistruje typ pole, ale jeho skript editoru nezaregistruje odpovídající ovládací prvek, Blockstudio zachová uloženou hodnotu a v editoru zobrazí oznámení, že pole nelze upravovat. Pokud typ pole není zaregistrován v PHP, Blockstudio ho vynechá z generovaných atributů WordPress.

Aktualizace údržby 7.5.1

7.5.1 odstraňuje varování před převodem pole na řetězec, které se objevovalo při přípravě hodnot vícenásobného výběru k vykreslení. Uložené i vykreslené hodnoty už byly správné, ale do protokolů ladění se mohlo při každém vykreslení pole zapsat jedno varování.

Doprovodná aktualizace blockstudio/phpstan v0.1.7 také rozpoznává pole vnořená do anonymních skupin v PHP, Twig, Blade a odvozených tvarech atributů šablon. Stávající projekty mohou tuto opravu balíčku získat pomocí composer update blockstudio/phpstan.