Přejít k obsahu

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.json můž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.md lze použít jako obsah stránky, buď společně s page.json, nebo samostatně s předními metadaty.
  • Rozvržení stránek na frontendu: layout.php mohou obalit synchronizovaný obsah stránek a využívat pomocníky, například blockstudio_page_tree() a blockstudio_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 .md nebo přes Accept: 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 push a wp bs content status př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/select funguje 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:

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"
  }
}

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:

Markdown
---
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.

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é funkce zpřístupňují kolekci jako strukturovaná data:

PHP
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
<?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.

Shell
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 page na 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:

PHP
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: true načítají při prázdném hledání v editoru aktuální možnosti.
  • Programové značky bloků core/query a core/comments zachovávají className ve vygenerovaném obalovém značkování.
  • Pseudokomponenty šablon zachovávají vlastnosti camelCase, takže se vlastnosti jako allowedFormats a withoutInteractiveFormatting dostanou do komponenty editoru místo toho, aby byly předem odstraněny.
  • bsui/select spolehlivě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/phpstan rozpozná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.