Dennis · 21. června 2026
Blockstudio 7.4
Blockstudio Verze 7.4 se zaměřuje na lepší přenositelnost projektů založených na souborech. Zatímco verze 7.2 usnadnila kontrolu a distribuci větších projektů a verze 7.3 přidala vrstvu UI, verze 7.4 se soustředí na přesun větší části projektu, jeho stránek a vybraného obsahu z databáze do souborů spravovaných ve verzovacím systému.
Hlavní novinkou jsou kolekce stránek: umožňují nasměrovat Blockstudio do složky se zdroji stránek a vytvořit z nich úplnou vnořenou strukturu stránek WordPress. Zdrojem může být PHP, Twig, Blade, HTML, Markdown nebo důvěryhodný načítač, který vrací stránky z jiného místního zdroje.
Stručně řečeno:
- Kolekce stránek:
pages.jsonmůže definovat úplnou sadu vnořených stránek, výchozí hodnoty, chování typu příspěvku, rozvržení, načítače a metadata kolekce. - Stránky Markdown:
index.mdlze použít jako obsah stránky, buď společně spage.json, nebo samostatně s předními metadaty. - Rozvržení stránek na frontendu:
layout.phpmohou obalit synchronizovaný obsah stránek a využívat pomocníky, napříkladblockstudio_page_tree()ablockstudio_page_content(). - Externí zdroje dokumentace: načítače kolekcí mohou vytvářet stránky z místních souborů nebo vrácených položek Markdown/HTML.
- Přímý výstup Markdown: zdroje stránek Markdown lze poskytovat jako
.mdnebo přesAccept: text/markdown. - Vlastní typy příspěvků kolekce: kolekce mohou mít čisté URL, automatické obnovení pravidel přepisování, přímé trasy Markdown a migrace stránek na vlastní typ příspěvku bez pomocných úprav motivu.
- Synchronizace obsahu:
wp bs content pull,wp bs content pushawp bs content statuspřevádějí povolené příspěvky, termíny, vztahy a deklarované odkazy v metadatech projektu do přenositelných souborů. - Předpony značek bloků: projektové předpony, například
<theme-card>, lze rozpoznávat napříč uspořádanými jmennými prostory bez aliasů pro jednotlivé bloky. - Spolehlivější synchronizace: změny stránek se zjišťují v manifestech, načítačích, rozvrženích, metadatech i zdrojových souborech.
- Opravy běhového prostředí a editoru: dynamické možnosti zůstávají aktuální, třídy bloků dotazů se zachovávají při programovém vykreslování,
bsui/selectfunguje lépe v hustých formulářích, vlastnosti RichText se předávají editoru a odstranění řádku opakovače s RichText přetrvá i po uložení.
Stránky založené na souborech
Většina novinek verze 7.4 staví na stránkách založených na souborech.
Kolekce stránek
Před verzí 7.4 byly stránky založené na souborech převážně funkcí na úrovni složky: vytvořte page.json, přidejte index.php nebo index.twig a Blockstudio synchronizuje tuto jedinou stránku do WordPress.
Tento způsob stále funguje. Verze 7.4 přidává druhý režim pro rozsáhlejší struktury.
Přidejte do složky manifest pages.json a složka se změní na kolekci:
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"
}
}
Všechny zdroje stránek v kolekci se objeví, normalizují, synchronizují a propojí podle cesty. Stránka na adrese guide/install se stane podřízenou stránkou guide; pokud chybí stránka guide, Blockstudio vytvoří generovanou kontejnerovou stránku, aby hierarchie WordPress stále odpovídala struktuře souborového systému.
Kolekce mohou používat nativní typ příspěvku page nebo vlastní typ. Pokud kolekce deklaruje typ příspěvku, který zatím neexistuje, Blockstudio jej zaregistruje z postTypeArgs. Manifest postType se také stává výchozí hodnotou pro všechny stránky v kolekci, takže ji projekty nemusí opakovat v defaults.
Typy příspěvků kolekcí používají jako veřejný základ URL slug kolekce. Kolekce docs zobrazí svou kořenovou stránku na adrese /docs/, stránku s path: "getting-started" na adrese /docs/getting-started/ a vnořené cesty pod stejným základem. Zdvojené URL, například /docs/docs/, přesměrují na kanonickou adresu. Pravidla přepisování se při změně směrování typu příspěvku kolekce obnoví automaticky, takže nová kolekce nevyžaduje ruční uložení trvalých odkazů.
Právě díky tomu působí externí dokumentace, produktové příručky, znalostní báze a knihovny stránek v WordPress přirozeně: zdroj zůstává v souborech, ale výsledkem je stále skutečný upravitelný obsah WordPress.
Markdown jako obsah stránky
Markdown je nyní plnohodnotným zdrojem stránky.
Samostatné stránky Markdown používají přední metadata:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
page.json můžete také kombinovat s index.md, pokud chcete mít konfiguraci a obsah v oddělených souborech. Přední metadata v index.md mohou přepsat odpovídající pole page.json a neznámé klíče předních metadat se zachovají jako metadata.
Markdown se převede na HTML a poté se zpracuje stejným parserem stránek jako šablony PHP, Twig a Blade, takže výsledný obsah tvoří nativní značky bloků.
Rozvržení a pomocné funkce stránek
Kolekce mohou obsahovat soubor layout.php. Na frontendu Blockstudio obalí synchronizovaný obsah stránky tímto rozvržením.
<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é funkce zpřístupňují kolekci jako strukturovaná data:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Díky tomu máte vše potřebné k vytvoření kompletního prostředí dokumentace: navigaci odvozenou ze stromu stránek, metadata stránek z předních metadat a synchronizovaný obsah bloků WordPress jako hlavní výstup.
Načítače a přímé Markdown
Kolekce mohou obsahovat důvěryhodný místní soubor loader.php. Ten může přímo vracet stránky nebo nasměrovat Blockstudio na další místní adresáře, ve kterých se mají stránky vyhledat.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
To se hodí, když je zdroj už vytvořen jinde: ve složce s dokumentací balíčku, exportu Markdown nebo kroku sestavení, který vrací seznam stránek.
Zdroje stránek Markdown mohou také poskytovat přímý zdroj Markdown. Vyžádejte si stránku s příponou .md nebo odešlete Accept: text/markdown. Přední metadata se z odpovědi odstraní, takže nástroje získají čitelné tělo dokumentu. Funguje to i pro typy příspěvků kolekcí, včetně URL jako /docs.md a /docs/getting-started.md.
Přečtěte si dokumentaci ke stránkám
Synchronizace obsahu
Verze 7.4 také přináší synchronizaci obsahu, což je WP-CLI pracovní postup pro týmy, které chtějí mít více částí projektu WordPress uložených v souborech.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio už ve vašem projektu spravuje bloky, pole, šablony, vzory a stránky založené na souborech. Content Sync přidává do tohoto pracovního postupu založeného na souborech vybraný obsah z databáze: povolené příspěvky, termíny, vztahy a deklarovaná metadata lze stáhnout do souborů, zkontrolovat v git a odeslat do jiného prostředí.
Je záměrně nastavena výslovně. Zapnete ji v blockstudio.json, povolíte typy příspěvků a taxonomie, které chcete spravovat, a určíte odkazy v metadatech, jež se mají mezi prostředími přepisovat.
Při stažení Blockstudio zapíše do souborů v motivu přenositelné příspěvky, termíny, vztahy a povolená metadata. Před odesláním ověří plán a deklarované odkazy post, term a attachment převede zpět na místní ID databáze. Libovolná celá čísla nepovažuje automaticky za ID.
Rozsah verze 7.4 je záměrně konzervativní: příspěvky, termíny, vztahy mezi termíny, povolená metadata, přenositelná UID, manifesty příloh, zkušební běhy, zpracování odebíraných položek, uzamčené entity a hlášení stavu. Zachycení definic taxonomií, kopírování binárních souborů médií a přepisování ID ve značkách bloků jsou v této první verzi záměrně vynechány.
Týmy tak mohou přehledně spravovat ve verzovacím systému vybraný obsah, například členy týmu, případové studie, místa, položky dokumentace nebo jiné strukturované záznamy, aniž by musely migrovat celou produkční databázi. Tento přístup je určen pro sady obsahu, které lze stále kontrolovat jako soubory: desítky či stovky položek, v některých projektech i nižší tisíce, pokud je obsah strukturovaný a mění se zřídka. Nenahrazuje zálohy databáze, synchronizaci elektronického obchodu či objednávek, analytiku, protokoly, odeslané formuláře ani jiná objemná data.
Přečtěte si dokumentaci k synchronizaci obsahu
Spolehlivější synchronizace
Blockstudio nyní zjišťuje změny ve zdrojích stránek, manifestech kolekcí, souborech načítačů a rozvržení, metadatech i souvisejících cestách. Pokud se některá z těchto položek změní, synchronizovaná stránka WordPress se aktualizuje.
Řetězec zpracování stránek nyní také řeší podrobnosti, díky kterým jsou dokumenty ze souborů praktické ve skutečných projektech:
- Zdroje stránek Markdown se synchronizují jako nativní obsah bloků včetně atributů bloků.
- Metadata z předních metadat jsou dostupná pomocným funkcím a rozvržením frontendu.
- Stránky kolekcí si při synchronizaci zachovávají stabilní identitu.
- Vnořené stránky mimo kolekci odkazují na svou nadřazenou stránku.
- Vnořené stránky mimo kolekci mohou zdědit nejbližšího předka
layout.php. - Odstraněné zdroje kolekce odstraní své generované stránky WordPress.
- Změna kolekce z
pagena vlastní typ příspěvku převede stávající synchronizované příspěvky místo vytváření duplicit. - Pořadí stránek se ukládá prostřednictvím
menu_order.
Předpony značek bloků
Značky bloků nyní podporují nastavitelné předpony jmenných prostorů. Projekt může zaregistrovat jednu krátkou předponu a nechat Blockstudio vyhledat blok v jednom či více jmenných prostorech:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
Po tomto nastavení může <theme-card> odkazovat na theme-components/card, <theme-button> může přejít na bsui/button a <theme-ui-feature-matrix> může odkazovat na theme-components/ui-feature-matrix.
Výslovné tag_aliases mají stále přednost, když projekt potřebuje jednorázové přepsání. Neznámé značky s předponou zůstávají beze změny a na bloky rozpoznané podle předpony se stále vztahují stávající filtry povolených a zakázaných značek bloků.
Přečtěte si dokumentaci ke značkám bloků
Opravy běhového prostředí a editoru
Verze 7.4 přináší také sadu oprav vycházejících z používání v reálných projektech.
- Možnosti naplněné dynamickým dotazem zůstávají aktuální při změnách příspěvků, termínů, uživatelů nebo souvisejících metadat a výběrová pole dotazů
populate.fetch: truenačítají při prázdném hledání v editoru aktuální možnosti. - Programové značky bloků
core/queryacore/commentszachovávajíclassNameve vygenerovaném obalovém značkování. - Pseudokomponenty šablon zachovávají vlastnosti camelCase, takže se vlastnosti jako
allowedFormatsawithoutInteractiveFormattingdostanou do komponenty editoru místo toho, aby byly předem odstraněny. bsui/selectspolehlivěji zpracovává data možností a nabídky přesahující dostupné místo, zejména v hustších ovládacích prvcích editoru.blockstudio/phpstanrozpoznává pole deklarovaná uvnitř kontejnerůtabs, takže validace šablon, Twig/Blade a značek bloků rozumí stejné podobě polí Blockstudio používané v projektech.- Odstranění řádku opakovače s RichText přetrvá i po uložení. Zastaralé hodnoty RichText už nemohou odstraněný řádek obnovit.
Proč na tomto vydání záleží
Tématem verze 7.4 je přenositelnost.
Kolekce stránek promění celé dokumentační weby ve složky se zdrojovými soubory. Stránky Markdown usnadňují psaní obsahu i jeho zpětné načítání. Content Sync rozšiřuje stejný model založený na souborech na vybraný obsah z databáze, takže příspěvky, termíny a vztahy mohou být uloženy v git a přesouvány mezi prostředími. Předpony značek bloků zpřehledňují šablony ve velkých knihovnách bloků.
Blockstudio zůstává založený na souborech. Bloky jsou stále složky. Stránky jsou stále soubory. Verze 7.4 jen umožňuje mít v těchto souborech a přesouvat s nimi další části projektu, jeho struktury stránek a vybraný obsah.