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.jsondokáž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.mdmožno použiť ako obsah stránky, buď spolu spage.json, alebo samostatne s frontmatter. - Rozloženia stránok pre frontend:
layout.phpmôžu obaliť synchronizovaný obsah stránky a využívať pomocné funkcie, napríkladblockstudio_page_tree()ablockstudio_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
.mdalebo cezAccept: 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 pushawp bs content statusumožň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/selectfunguje 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:
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"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:
---
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.
<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:
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
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.
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
pagena 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:
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: truenačítavajú aktuálne možnosti pri prázdnom vyhľadávaní v editore. - Značky blokov
core/queryacore/commentsvytvorené programovo zachovávajúclassNamevo vygenerovanom obalovom označení. - Pseudokomponenty šablón zachovávajú vlastnosti s camelCase zápisom, takže vlastnosti ako
allowedFormatsawithoutInteractiveFormattingsa dostanú do komponentu editora a nestratia sa skôr. bsui/selectspoľahlivejšie spracúva údaje možností a pretekajúce ponuky, najmä v hustejších ovládacích prvkoch editora.blockstudio/phpstanrozpoznáva polia deklarované v kontajnerochtabs, 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.