Preskočiť na obsah

Dennis · 21. júna 2026

Blockstudio 7.4

Blockstudio Verzia 7.4 sa zameriava na prenositeľnosť projektov založených na súboroch. Verzia 7.2 uľahčila kontrolu a distribúciu väčších projektov a 7.3 pridala vrstvu UI; 7.4 presúva väčšiu časť projektu, jeho stránky a vybraný obsah z databázy do súborov spravovaných vo verziovacom systéme.

Hlavnou novinkou sú kolekcie stránok: umožňujú nasmerovať Blockstudio na priečinok so zdrojmi stránok a vytvoriť z neho úplnú vnorenú štruktúru stránok WordPress. Zdrojom môže byť PHP, Twig, Blade, HTML, Markdown alebo dôveryhodný zavádzač, ktorý načíta stránky z iného lokálneho zdroja.

Stručne:

  • Kolekcie stránok: pages.json dokáže definovať úplnú sústavu vnorených stránok, predvolené hodnoty, správanie typov príspevkov, rozloženia, zavádzače a metadáta kolekcie.
  • Stránky Markdown: index.md možno použiť ako obsah stránky, buď spolu s page.json, alebo samostatne s frontmatter.
  • Rozloženia stránok pre frontend: layout.php môžu obaliť synchronizovaný obsah stránky a využívať pomocné funkcie, napríklad blockstudio_page_tree() a blockstudio_page_content().
  • Externé zdroje dokumentácie: zavádzače kolekcií môžu vytvárať stránky z lokálnych súborov alebo vrátených hodnôt Markdown/HTML.
  • Surový výstup Markdown: zdroje stránok Markdown možno poskytovať ako .md alebo cez Accept: text/markdown.
  • Vlastné typy príspevkov pre kolekcie: kolekcie môžu mať čisté URL adresy, automatické obnovenie pravidiel prepisovania, trasy Markdown pre surové výstupy a migráciu stránok na CPT bez pomocných úprav v téme.
  • Synchronizácia obsahu: wp bs content pull, wp bs content push a wp bs content status umožňujú ukladať povolené príspevky, výrazy, vzťahy a deklarované odkazy na metadáta projektu v prenositeľných súboroch.
  • Predpony značiek blokov: predpony projektov, ako napríklad <theme-card>, možno rozpoznať vo viacerých zoradených názvových priestoroch bez aliasov pre jednotlivé bloky.
  • Spoľahlivejšia synchronizácia: zmeny stránok sa zisťujú v manifestoch, zavádzačoch, rozloženiach, metadátach aj zdrojových súboroch.
  • Opravy prostredia a editora: dynamické možnosti zostávajú aktuálne, triedy blokov dotazov sa zachovávajú pri programovom vykresľovaní, bsui/select funguje lepšie v hustých formulároch, vlastnosti RichText sa dostanú do editora a odstránenie riadka opakovacieho poľa s RichText sa po uložení zachová.

Stránky založené na súboroch

Väčšina noviniek vo verzii 7.4 stavia na stránkach založených na súboroch.

Kolekcie stránok

Pred verziou 7.4 boli stránky založené na súboroch prevažne funkciou na úrovni priečinka: vytvorte page.json, pridajte index.php alebo index.twig a Blockstudio zosynchronizuje túto jednu stránku do WordPress.

Aj naďalej to funguje. Verzia 7.4 pridáva druhý režim pre rozsiahlejšie štruktúry.

Pridajte do priečinka manifest pages.json a z priečinka sa stane kolekcia:

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
JSON
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}

Každý zdroj stránky v kolekcii sa nájde, normalizuje, zosynchronizuje a prepojí podľa cesty. Stránka na adrese guide/install sa stane podstránkou stránky guide; ak stránka guide chýba, Blockstudio vytvorí kontajnerovú stránku, aby hierarchia WordPress stále zodpovedala štruktúre súborového systému.

Kolekcie môžu používať natívny typ príspevku page alebo vlastný typ príspevku. Ak kolekcia deklaruje typ príspevku, ktorý ešte neexistuje, Blockstudio ho zaregistruje z postTypeArgs. Manifest postType sa zároveň stane predvolenou hodnotou pre každú stránku v kolekcii, takže projekty ho nemusia opakovať v defaults.

Vlastné typy príspevkov kolekcií používajú ako verejný základ URL slug kolekcie. Kolekcia docs obsluhuje koreňovú stránku na adrese /docs/, stránku s path: "getting-started" na adrese /docs/getting-started/ a vnorené cesty pod rovnakým základom. Zdvojené URL adresy, napríklad /docs/docs/, presmerujú na kanonickú adresu. Pravidlá prepisovania sa pri zmene smerovania typu príspevku kolekcie obnovia automaticky, takže nová kolekcia nevyžaduje manuálne uloženie trvalých odkazov.

Práve vďaka tomu pôsobia externá dokumentácia, produktové príručky, znalostné databázy a knižnice stránok v WordPress prirodzene: zdroj zostáva v súboroch, no výsledkom je stále skutočný upraviteľný obsah WordPress.

Markdown ako obsah stránky

Markdown je teraz plnohodnotným zdrojom stránok.

Samostatné stránky Markdown používajú frontmatter:

Markdown
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.

page.json môžete skombinovať aj s index.md, ak chcete rozdeliť konfiguráciu a obsah do rôznych súborov. Frontmatter v index.md môže prepísať zodpovedajúce polia page.json a neznáme kľúče frontmatter sa zachovajú ako metadáta.

Markdown sa prevedie na HTML a potom spracuje tým istým parserom stránok ako šablóny PHP, Twig a Blade, takže výsledný obsah má natívne označenie blokov.

Rozloženia a pomocné funkcie stránok

Kolekcie môžu obsahovať súbor layout.php. Na frontende Blockstudio obalí synchronizovaný obsah stránky pomocou tohto rozloženia.

PHP
<main class="docs-layout">
  <aside>
    <?php foreach (blockstudio_page_tree('docs') as $item) : ?>
      <a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
        <?php echo esc_html($item['title']); ?>
      </a>
    <?php endforeach; ?>
  </aside>

  <article>
    <?php echo blockstudio_page_content(); ?>
  </article>
</main>

Nové pomocné funkcie sprístupňujú kolekciu ako štruktúrované údaje:

PHP
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();

Získate tak potrebné súčasti na vytvorenie kompletného rámca dokumentácie: navigáciu zo stromu stránok, metadáta stránky z frontmatter a synchronizovaný obsah blokov WordPress ako hlavný priestor pre obsah.

Zavádzače a surové Markdown

Kolekcie môžu obsahovať dôveryhodný lokálny súbor loader.php. Môže priamo vracať stránky alebo nasmerovať Blockstudio na ďalšie lokálne adresáre, v ktorých má vyhľadávať.

PHP
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];

Je to užitočné, keď je zdroj už vytvorený inde: napríklad v priečinku s dokumentáciou balíka, pri exporte Markdown alebo v kroku zostavovania, ktorý vracia zoznam stránok.

Zdroje stránok Markdown môžu poskytovať aj surový zdroj Markdown. O stránku požiadajte s príponou .md alebo odošlite Accept: text/markdown. Frontmatter sa z odpovede odstráni, takže nástroje dostanú čitateľné telo dokumentu. Funguje to aj pri typoch príspevkov kolekcií vrátane adries ako /docs.md a /docs/getting-started.md.

Prečítajte si dokumentáciu k stránkam

Synchronizácia obsahu

Verzia 7.4 prináša aj synchronizáciu obsahu, pracovný postup WP-CLI pre tímy, ktoré chcú mať väčšiu časť svojho projektu WordPress uloženú v súboroch.

Shell
wp bs content pull
wp bs content push --dry-run
wp bs content status

Blockstudio už uchováva bloky, polia, šablóny, vzory a stránky založené na súboroch v projekte. Synchronizácia obsahu rozširuje tento pracovný postup zameraný na súbory o vybraný obsah databázy: povolené príspevky, výrazy, vzťahy a deklarované metadáta možno preniesť do súborov, skontrolovať v git a odoslať do iného prostredia.

Funguje zámerne explicitne. Zapnete ju v blockstudio.json, určíte typy príspevkov a taxonómie, ktoré chcete spravovať, a deklarujete odkazy na metadáta, ktoré sa majú prepísať pri prenose medzi prostrediami.

Pri načítaní Blockstudio zapisuje do súborov témy prenositeľné príspevky, výrazy, vzťahy a povolené metadáta. Pri odosielaní najprv overí plán a potom odkazy post, term a attachment prevedie späť na lokálne ID databázy. Neodvodzuje, že ľubovoľné celé čísla sú ID.

Rozsah verzie 7.4 je zámerne konzervatívny: zahŕňa príspevky, výrazy, vzťahy medzi výrazmi, povolené metadáta, prenositeľné UID, manifesty príloh, skúšobné spustenia, spracovanie odstraňovania, uzamknuté entity a hlásenie stavu. Zachytávanie definícií taxonómií, kopírovanie binárnych súborov médií a prepisovanie ID v označení blokov sú v tejto prvej verzii zámerne vynechané.

Tímy tak môžu jednoducho verzovať vybraný obsah, napríklad členov tímu, prípadové štúdie, lokality, položky dokumentácie alebo iné štruktúrované záznamy, bez toho, aby z celej produkčnej databázy urobili migráciu. Je to určené pre súbory obsahu, ktoré možno stále kontrolovať: desiatky až stovky záznamov a v niektorých projektoch aj niekoľko tisíc, ak je obsah štruktúrovaný a mení sa len zriedka. Nenahrádza zálohy databázy, synchronizáciu elektronického obchodu či objednávok, analytiku, protokoly, odoslané formuláre ani iné veľké objemy údajov.

Prečítajte si dokumentáciu k synchronizácii obsahu

Spoľahlivejšia synchronizácia

Blockstudio teraz zisťuje zmeny v zdrojoch stránok, manifestoch kolekcií, súboroch zavádzačov a rozložení, metadátach aj súvisiacich cestách. Ak sa zmení ktorákoľvek z týchto položiek, synchronizovaná stránka WordPress sa aktualizuje.

Proces spracovania stránok zvláda aj podrobnosti, vďaka ktorým sú dokumenty založené na súboroch praktické v skutočných projektoch:

  • Zdroje stránok Markdown sa synchronizujú ako natívny obsah blokov vrátane atribútov blokov
  • metadáta frontmatter sú dostupné pomocným funkciám frontendu a rozloženiam
  • stránky kolekcií si zachovávajú stabilnú identitu aj po opakovanej synchronizácii
  • vnorené stránky mimo kolekcií odkazujú na svoju nadradenú stránku
  • vnorené stránky mimo kolekcií môžu zdediť najbližšieho predka layout.php
  • odstránené zdroje kolekcií vymažú vygenerované stránky WordPress
  • zmena typu príspevku kolekcie z page na vlastný typ migruje existujúce synchronizované príspevky namiesto vytvárania duplikátov
  • poradie stránok sa uchováva prostredníctvom menu_order

Predpony značiek blokov

Značky blokov teraz podporujú nastaviteľné predpony názvových priestorov. Projekt môže zaregistrovať jednu krátku predponu a nechať Blockstudio vyhľadať blok v jednom alebo viacerých názvových priestoroch:

PHP
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});

Takto môže <theme-card> odkazovať na theme-components/card, <theme-button> môže použiť ako záložnú možnosť bsui/button a <theme-ui-feature-matrix> môže odkazovať na theme-components/ui-feature-matrix.

Ak projekt potrebuje jednorazové prepísanie, prednosť majú explicitné značky tag_aliases. Značky s neznámou predponou zostanú nezmenené a na bloky rozpoznané podľa predpony sa naďalej vzťahujú existujúce filtre povoľovania a zakazovania značiek blokov.

Prečítajte si dokumentáciu k značkám blokov

Opravy prostredia a editora

Verzia 7.4 obsahuje aj opravy vychádzajúce z používania v skutočných projektoch.

  • Dynamické možnosti dopĺňané dotazmi zostávajú aktuálne pri zmenách príspevkov, výrazov, používateľov alebo súvisiacich metadát a výbery dotazov populate.fetch: true načítavajú aktuálne možnosti pri prázdnom vyhľadávaní v editore.
  • Značky blokov core/query a core/comments vytvorené programovo zachovávajú className vo vygenerovanom obalovom označení.
  • Pseudokomponenty šablón zachovávajú vlastnosti s camelCase zápisom, takže vlastnosti ako allowedFormats a withoutInteractiveFormatting sa dostanú do komponentu editora a nestratia sa skôr.
  • bsui/select spoľahlivejšie spracúva údaje možností a pretekajúce ponuky, najmä v hustejších ovládacích prvkoch editora.
  • blockstudio/phpstan rozpoznáva polia deklarované v kontajneroch tabs, takže validácia šablón, Twig/Blade a značiek blokov rozumie rovnakému tvaru polí, aký používajú projekty Blockstudio.
  • Odstránený riadok opakovacieho poľa s RichText zostane odstránený aj po uložení. Zastarané hodnoty RichText už nedokážu odstránený riadok obnoviť.

Prečo je toto vydanie dôležité

Témou verzie 7.4 je prenositeľnosť.

Kolekcie stránok premieňajú celé dokumentačné weby na priečinky so zdrojovými súbormi. Stránky Markdown uľahčujú písanie tohto obsahu aj jeho opätovné načítanie. Synchronizácia obsahu rozširuje rovnaký model súborov na prvom mieste aj na vybraný obsah databázy, takže príspevky, výrazy a vzťahy môžu byť uložené v git a presúvať sa medzi prostrediami. Predpony značiek blokov zlepšujú čitateľnosť šablón vo veľkých knižniciach blokov.

Blockstudio je stále založený na súboroch. Bloky sú stále priečinky. Stránky sú stále súbory. Verzia 7.4 umožňuje ukladať do týchto súborov viac častí projektu, jeho štruktúry stránok a vybraného obsahu, a prenášať ich spolu s nimi.