Preskočiť na obsah

Dennis · 23. júla 2026

Blockstudio 7.5

Blockstudio Verzia 7.5 završuje pracovný postup Blockstudio zameraný na súbory: vlastné typy polí, šablóny Editora webu založené na súboroch, ostrovčeky blokov, úložisko databázy Storh, logické zdroje vyhľadávania a skladateľné značky blokov, ako aj rýchlejšie nasadzovanie a beh.

Opakovane použiteľné vlastné polia už umožňujú projektom raz definovať skupinu existujúcich polí a používať ju opakovane pomocou type: "custom/{name}". Vlastné typy polí riešia iný problém. Umožňujú téme alebo pluginu zaregistrovať nový typ poľa s vlastným menným priestorom, poskytnúť vlastný ovládací prvok editora a ukladať hodnotu ako bežné údaje Blockstudio.

Stručne:

  • Logické zdroje na zisťovanie obsahu: runtime prostredia môžu poskytovať zložený inventár logických tém vrátane pôvodu a identity vyrovnávacej pamäte, zatiaľ čo Blockstudio si zachováva zodpovednosť za zisťovanie, vyhľadávanie súrodeneckých súborov, generované prostriedky, Canvas a správanie Tailwind.
  • Register typov polí PHP: témy a pluginy môžu registrovať typy polí s menným priestorom, napríklad acme/dimensions pomocou bs_register_field_type() alebo filtra blockstudio/field_types.
  • Register ovládacích prvkov editora: vlastné skripty editora môžu volať window.blockstudio.registerFieldType() a vykresliť zodpovedajúci ovládací prvok React v bežnom Blockstudio poľa UI.
  • Štruktúrované hodnoty: vlastné polia môžu ukladať reťazce, čísla, logické hodnoty, polia alebo objekty bez prevodu hodnôt objektov cez normalizáciu polí možností.
  • Podpora ukladania: vlastné polia v metadátach príspevkov a možnostiach môžu deklarovať typ hodnoty a schému REST vrátane hodnôt objektov a polí.
  • Natívna integrácia: vlastné typy polí fungujú v skupinách, kartách, opakovačoch, opakovane použiteľných vlastných poliach, šablónach a cestách šablón rozšírení.
  • Šablóny editora webu: témy môžu definovať zdroje wp_template a wp_template_part zborením súborov šablón template.json, part.json a Blockstudio.
  • Ostrovy blokov: bloky môžu najprv vykresliť bezpečnú základnú vrstvu pre vyrovnávaciu pamäť a po načítaní stránky následne hydratovať alebo hromadne načítať fragmenty špecifické pre požiadavku.
  • Ukladanie databázy Storh: bs.db môže používať indexované úložisko so samostatným súborom pre každý záznam v priečinku nahratých súborov, pričom zachová verejné celočíselné ID a migráciu z JSONC na Storh cez WP-CLI.
  • Vylepšenia parsera a bsui: mapované odseky richtext vyžadujú menej vlastného prepojovacieho kódu parsera, InnerBlocks môže používať tokenizované allowedBlocks, vnorený výstup bs_render_block() zodpovedá vykresleniu na frontende v ukážkach editora a bsui/button získava ikony a jednoduchšie možnosti štýlovania.
  • Kombinovateľné značky blokov: značky s prefixom sa môžu rozlíšiť cez ďalší prefix (<theme-ui-input> na bsui/input) a značky s prefixom aj aliasové značky sa vykresľujú vo výstupe šablón blokov, nielen v obsahu stránky.
  • Vyrovnávacie pamäte bezpečné pre hostiteľa: vyrovnávacie pamäte runtime prostredia a editora sa teraz predvolene ukladajú mimo priečinka nahratých súborov, podporujú nastaviteľné umiestnenia a odstraňujú zastarané položky, aby sa v dlhotrvajúcich projektoch nehromadili súbory vyrovnávacej pamäte.
  • Priebežné zosúlaďovanie stránok: nástroje na nasadzovanie môžu zosúladiť úplný inventár stránok zo súborov, preskočiť nezmenené príspevky, presne oznámiť zmeny a po aktivácii uložiť overenú identitu zdroja.
  • Rýchlejšie vykresľovanie pri zahriatej vyrovnávacej pamäti: platné vyrovnávacie pamäte runtime prostredia sa načítajú ešte pred zisťovaním, súbežné požiadavky pri prázdnej vyrovnávacej pamäti zverejnia jeden atomický výsledok a Tailwind udržiava vyrovnávaciu pamäť veľkosti webu so znovupoužiteľným stavom kompilátora.
  • Bezpečné hromadné vykresľovanie: exportéry môžu medzi dokumentmi resetovať stav vykresľovania v rozsahu požiadavky bez opätovného zisťovania a počas vykresľovania blokov zhromažďovať závislosti zdrojov.

Nové funkcie

Verzia 7.5 prináša rozsiahlu sadu nových možností na zisťovanie obsahu, prácu so šablónami a ukladanie dát.

Logické zdroje na zisťovanie obsahu

Blockstudio zvyčajne zisťuje súbory z fyzických adresárov tém. Verzia 7.5 pridáva zdroj nižšej úrovne API pre runtime prostredia, ktoré skladajú tému z prekrytí, ukážok, generovaných súborov, vzdialených pripojení alebo iných zložených inventárov.

Integrácia môže poskytnúť konečný logický strom súborov, zatiaľ čo Blockstudio si zachováva zodpovednosť za správanie blokov, polí, stránok, vzorov, editora webu, Canvasu, prostriedkov 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 zostávajú stabilné, aj keď súrodenecké súbory pochádzajú z rôznych fyzických koreňových adresárov. ID zdrojov a odtlačky prstov vstupujú do identít vyrovnávacej pamäte runtime prostredia a Tailwind, sledované vstupy ich zneplatňujú a pôvod určuje, kam možno zapisovať generované súbory. Predvolený zdroj súborového systému zostáva pre bežné témy nezmenený.

Šablóny editora webu zo súborov

Stránky a vzory už tímom umožňujú uchovávať štruktúry obsahu v súboroch. Verzia 7.5 rozširuje tento model aj 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 kompiluje zdroj pomocou rovnakého parsera ako stránky a vzory a potom sprístupní výsledok WordPress ako bežnú šablónu editora webu alebo jej časť. Editor webu šablónu zobrazí, frontend ju môže vykresliť a WordPress naďalej spravuje prispôsobenia.

Táto posledná časť je dôležitá. Šablóny zo súborov slúžia ako záložný zdroj. Keď používateľ uloží šablónu v editore webu, WordPress vytvorí bežné prispôsobenie v databáze wp_template alebo wp_template_part a prednosť dostane táto verzia. Po obnovení predvoleného stavu prispôsobenia sa znova zobrazí najnovší zdroj zo súboru.

Priebežné nasadzovanie stránok

Stránky zo súborov získali vo verzii 7.5 mechanizmus zosúlaďovania pri nasadzovaní API. Od verzie 7.6.2 sú tieto výslovné vstupné body synchronizácie jedinými možnosťami API a wp bs pages sync; bežné požiadavky zmeny zdrojov nikdy neuplatňujú:

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

Proces zistí celý požadovaný inventár stránok, porovná obsah a odtlačky prstov synchronizačného mechanizmu a oznámi vytvorené, aktualizované, nezmenené, odstránené a neúspešné stránky. Pri stránkach s rovnakými odtlačkami prstov sa nezapisuje do príspevkov ani ich metaúdajov. Chýbajúce spravované stránky sa odstránia až po dokončení zisťovania bez chýb.

Zosúladenie vráti deterministickú identitu zdroja, ale neoznačí nasadenie za úspešné. Nástroj na nasadzovanie uloží túto identitu až po aktivácii a overení zodpovedajúcich súborov a trás. Bežné zavedenie WP-CLI registruje typy príspevkov kolekcií a pravidlá prepisovania z vyrovnávacej pamäte bez zisťovania a synchronizácie každej stránky.

Ostrovy blokov

Väčšina blokov Blockstudio sa vykresľuje na serveri. To je vhodné pre WordPress, no prináša známy problém s ukladaním do vyrovnávacej pamäte: jeden personalizovaný blok môže sťažiť ukladanie celej stránky.

Ostrovy blokov rozdeľujú túto hranicu na úrovni bloku.

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

Dynamický ostrov pri prvej odpovedi vykreslí iba zástupný prvok bezpečný pre vyrovnávaciu pamäť. Prehliadač potom odošle jednu hromadnú požiadavku pre všetky pripravené dynamické ostrovy na stránke a Blockstudio vykreslí tieto fragmenty v skutočnom kontexte požiadavky návštevníka.

Celú stránku tak možno uložiť do vyrovnávacej pamäte ako základnú vrstvu, zatiaľ čo počet položiek v košíku, ovládacie prvky účtu, UI obmedzené oprávneniami a ďalšie časti špecifické pre používateľa zostanú aktuálne.

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

Pre bloky, ktoré už vykresľujú obsah HTML bezpečný pre vyrovnávaciu pamäť a potrebujú iba signál na pripojenie frontendu, použite hydratovaný ostrov:

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

Hydratované ostrovy neodosielajú požiadavku REST. Vykreslia sa bežným spôsobom a na frontende dostanú udalosť blockstudio:island:hydrate.

Dynamické ostrovy fungujú aj cez programové cesty vykresľovania:

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

A tiež cez značky blokov:

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

Koncový bod má zámerne úzko vymedzený účel. Vykresľuje iba registrované bloky Blockstudio, ktoré sú dynamické a výslovne označené ako dynamické ostrovy. Atribúty sa filtrujú podľa schémy bloku a zoznamu povolených atribútov ostrova a každá značka obsahuje podpis vygenerovaný obsluhujúcou lokalitou WordPress.

Ukladanie databázy Storh

Databázová vrstva Blockstudio už podporuje tabuľky, SQLite, JSONC, metaúdaje príspevkov a vlastné typy príspevkov. Verzia 7.5 pridáva storage: "storh" pre projekty, ktoré chcú súborové úložisko s bezpečnejšími súbežnými zápismi a indexmi odvodenými od schémy, no nechcú ukladať živé záznamy vedľa zdrojových súborov blokov.

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

Záznamy Storh sa ukladajú do priečinka nahratých súborov:

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

Verejné API zostáva nezmenené. bs.db(), REST a Db::get() naďalej vracajú celočíselné hodnoty id. Interne Blockstudio mapuje tieto ID na ID dokumentov Storh UUIDv7, takže existujúci kód klienta netreba meniť.

Každé pole deklarované v schéme sa indexuje pre filtre rovnosti, číselné polia a polia podobné dátumom dostávajú rozsahové indexy a výslovné požiadavky na jedinečnosť sa odovzdávajú ďalej. Pre projekty, ktoré začali so súbormi počiatočných údajov JSONC, nová migrácia CLI ponechá zdrojový súbor na mieste a zapíše ekvivalentné úložisko Storh:

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

Tým sa JSONC jasnejšie vymedzuje ako jednoduchý formát počiatočných údajov a konfigurácie vhodný na commitovanie, zatiaľ čo Storh sa stáva vhodnejším predvoleným súborovým backendom pre zapisovateľné produkčné dáta.

Vylepšenia parsera a bsui

Verzia 7.5 dolaďuje aj menšie časti, ktoré sa začnú prejavovať, keď projekt intenzívnejšie využíva šablóny zo súborov a pribalené UI.

Mapovanie prvkov teraz zvládne bežný prípad odseku richtext bez vlastného nástroja na zostavenie. Ak <p> mapuje na registrovaný blok Blockstudio mimo jadra s atribútom richtext content, jednoduchý vnútorný text sa skopíruje do tohto atribútu. Vnorené značky a mapované podradené prvky sa naďalej parsujú ako vnútorné bloky.

InnerBlocks v šablónach prijíma tokenizované allowedBlocks:

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

Podporované tokeny sú namespace/*, category:<slug> a @theme. Rozbalia sa na serveri ešte pred odovzdaním šablóny editoru, takže cesta vykresľovania frontendu zostáva nezmenená.

Programové vloženia sú tiež predvídateľnejšie. bs_render_block() a bs_block() teraz vykresľujú vložené bloky ako HTML vyriešené na frontende, aj keď sa volajú z ukážky editora iného bloku. Vďaka tomu vnorené bloky nevkladajú do značiek ukážky surové pseudo-komponenty <RichText /> ani <InnerBlocks />.

V prípade zabaleného UI bsui/button teraz podporuje atribút icon a iconPosition. Zabalené vložené štýly bsui/* sa generujú vo vrstve kaskády @layer bsui a varianty tlačidiel možno rozšíriť pomocou blockstudio/ui/button/variants-style spolu s existujúcim filtrom blockstudio/blocks/attributes.

Značky blokov sa dajú skladať aj ďalej. Prefix sa môže rozlíšiť cez ďalší prefix, takže <theme-ui-input /> s projektovým prefixom theme cez mennú oblasť prefixu ui sa rozlíši na bsui/input. Registrované značky s prefixom a aliasové značky sa teraz vykresľujú aj vo výstupe šablón blokov, nielen v obsahu stránok, takže ich šablóna môže vypísať priamo bez volania bs_render_block().

Vlastné nástroje na zostavovanie blokov registrované cez blockstudio/block_tags/builders sa teraz jednotne podieľajú na parsovaní značiek aj mapovaných prvkov. Výslovné filtre vykresľovania sa naďalej spúšťajú následne a môžu prepísať výsledok nástroja na zostavenie.

Rýchlejšie zahriate požiadavky a exporty

Vyrovnávacie pamäte runtime prostredia a editora sa teraz predvolene ukladajú do wp-content/blockstudio/cache namiesto priečinka nahratých súborov. Umiestnenie možno zmeniť cez cache.path alebo blockstudio/cache/dir, vďaka čomu zostáva trvalé ukladanie do vyrovnávacej pamäte dostupné aj na hostiteľoch, ktorí blokujú dáta PHP v priečinku nahratých súborov. Vyrovnávacie pamäte runtime prostredia, prostriedkov editora a Tailwind tiež automaticky odstraňujú zastarané položky, takže sa na disku v dlhotrvajúcich projektoch nehromadia neobmedzené množstvá súborov vyrovnávacej pamäte.

Počas zahriatych požiadaviek frontendu sa teraz platný register runtime prostredia načíta ešte pred zostavením zdrojov na zisťovanie obsahu. Tým sa preskočí rekurzívne zisťovanie zdrojov, zostavovanie blokov, parsovanie polí aj opakované prechádzanie stromov kľúčov vyrovnávacej pamäte. Produkčné a testovacie požiadavky predvolene dôverujú overenej snímke sledovaných zmien počas 20 sekúnd, zatiaľ čo lokálne a vývojové prostredia vykonávajú kontrolu pri každej požiadavke.

Pri vytváraní vyrovnávacej pamäte za studena sa výsledok vytvorí jediným procesom. Jedna požiadavka zostaví a atomicky zverejní dáta, zatiaľ čo súbežné požiadavky čakajú na dokončenie. Tailwind teraz predvolene uchováva až 1,000 skompilovaných položiek počas 30 dní a znovu používa zahriaty stav zostavovania kompilátora, takže trasy webu s mnohými stránkami už nepreťažujú malú vyrovnávaciu pamäť.

Exportéry s dlhou životnosťou môžu medzi dokumentmi volať Blockstudio\Batch_Render::reset(). Tým sa vymažú počítadlá, prostriedky, ostrovy, rozloženia a generovanie Tailwind v rozsahu požiadavky bez opätovného zostavovania zdrojov na zisťovanie obsahu. Filter blockstudio/render/dependencies sprístupňuje cesty k šablónam a prostriedkom použitým jednotlivými vykreslenými blokmi, aby bolo možné zostaviť grafy závislostí.

Spoľahlivosť a kompatibilita

Vydanie dopĺňa niekoľko opráv:

  • Definície polí zmenené cez blockstudio/blocks/attributes teraz určujú overovanie možností pri vykresľovaní aj schému editora. Typované číselné a logické hodnoty možností sa tiež vyhodnocujú jednotne.
  • Obaly blokov editora používajú rovnaké generované triedy ako vykreslenia frontendu a Canvas môže kopírovať nakonfigurované triedy tela stránky frontendu pomocou nového filtra blockstudio/editor/canvas/body_class.
  • Synchronizácia obsahu overuje celý plán zdrojov pred deštruktívnymi zápismi, operácie odstraňovania obmedzuje na nakonfigurovanú množinu obsahu a oznamuje zlyhania zápisu súborov bez aktualizácie stavu synchronizácie príslušnej položky.
  • Balíky Composer pribalené v aktívnych témach alebo nadradených témach so symbolickými odkazmi vyhľadávajú prostriedky editora vo verejnom adresári témy URL.
  • Stránky zo súborov s kľúčom zachovávajú hodnoty polí Blockstudio spravované editorom, pri synchronizácii migrujú starší vnorený tvar kľúča a akceptujú nulu ako platný číselný kľúč.
  • Dynamické ostrovy overujú podpisy pred filtrami atribútov požiadavky, ignorujú nepodpísaný kontext požiadavky, obnovujú prihlásených návštevníkov z rovnakého zdroja a predchádzajú kolíziám vyrovnávacej pamäte medzi anonymnými používateľmi.
  • Surové koncové body stránok Markdown teraz rešpektujú viditeľnosť príspevkov a ochranu heslom.
  • Ovládacie prvky editora spoľahlivejšie zvládajú prázdne podmienky, hodnoty prepnutia všetkých začiarkavacích políčok, asynchrónne obnovenia možností, dynamické poradie vykresľovania a stav RichText alebo WYSIWYG v opakovačoch.

Vlastné typy polí

Viac informácií o vyššie predstavených vlastných typoch polí.

Prečo vlastné typy polí?

Blockstudio má byť užitočné hneď po inštalácii, no skutočné projekty často potrebujú ovládacie prvky špecifické pre danú oblasť: výber tokenov pre rozostupy, roly farieb dizajnového systému, responzívne rozmery, zdroje ikon, výbery produktov alebo redakčné ovládacie prvky, ktoré mapujú na štruktúrovanú hodnotu.

Pred verziou 7.5 mohli takéto projekty skladať viacero vstavaných polí alebo si upraviť editor. Verzia 7.5 ponúka podporovanú strednú cestu: Blockstudio spravuje životný cyklus poľa a projekt spravuje ovládací prvok.

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,
            });
          },
        }),
      ),
    );
  },
});

Potom možno pole používať v block.json ako natívne pole:

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

Bežné hodnoty šablóny

Uložená hodnota je dostupná v PHP, Twig a Blade rovnako ako každý iný atribút Blockstudio.

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

Rovnaké cesty k objektom fungujú aj v šablónach rozšírení:

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 ku kompatibilite

Existujúce vstavané typy polí zostávajú nezmenené. Nezmenené zostávajú aj existujúce opakovane použiteľné skupiny polí custom/{name}. Názvy vlastných typov polí musia byť napísané malými písmenami a musia mať mennú oblasť, napríklad acme/dimensions; menné oblasti custom/ a blockstudio/ zostávajú rezervované.

Ak PHP zaregistruje typ poľa, no jeho skript editora nezaregistruje zodpovedajúci ovládací prvok, Blockstudio zachová uloženú hodnotu a v editore zobrazí upozornenie, že pole nemožno upraviť. Ak typ poľa nie je zaregistrovaný v PHP, Blockstudio ho vynechá z generovaných atribútov WordPress.

Údržbová aktualizácia 7.5.1

7.5.1 odstraňuje upozornenie na konverziu poľa na reťazec, ktoré sa zobrazovalo pri príprave hodnôt viacerých výberov na vykreslenie. Uložené aj vykreslené hodnoty boli správne, ale v protokoloch ladenia sa mohlo objaviť jedno upozornenie pri každom vykreslení poľa.

Sprievodná aktualizácia blockstudio/phpstan v0.1.7 rozpoznáva aj polia vnorené v anonymných skupinách v rámci PHP, Twig, Blade a odvodených tvarov atribútov šablón. Existujúce projekty môžu túto opravu balíka získať pomocou composer update blockstudio/phpstan.