Celé stránky definované v kódu
Šablony a Markdown synchronizované s WordPress jediným příkazem.
Kolekce ze souborů
Definujte pages.json a nechte Blockstudio najít všechny zdroje pod ním. Vnořené cesty se změní na vnořené stránky, pro kolekci se použijí výchozí hodnoty a chybějící nadřazené stránky lze vytvořit.
Kolekce se hodí pro dokumentaci, znalostní báze nebo vstupní stránky. Pomocí loader.php můžete také připojit externí složky pod předponou cesty.
Vedle pages.json umístěte layout.php nebo rozvržení rendereru, například layout.tsx, aby obalovalo každou stránku kolekce do jednoho shellu; pro postranní panel použijte blockstudio_page_tree().
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}---
title: Installation
order: 10
---
# Installation
Install Blockstudio from this Markdown page.<?php $current = blockstudio_current_page(); ?>
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<?php $is_current = ($item['post_id'] ?? null) === ($current['post_id'] ?? null); ?>
<a
href="<?php echo esc_url($item['permalink'] ?? '#'); ?>"
<?php echo $is_current ? 'aria-current="page"' : ''; ?>
>
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>Výslovná synchronizace
Příkaz wp bs pages sync použije změny; nezměněné stránky nevyžadují žádné zápisy.
Zdroje Markdown
Použijte index.md s úvodními metadaty nebo spojte obsah page.json s Markdown.
Surové Markdown
Stránky ze souborů Markdown jsou dostupné na svém URL plus .md nebo na běžném URL pro Accept: text/markdown, s kanonickým odkazem zpět na HTML.
Načítače kolekcí
Připojte složky s externí dokumentací ke kolekci pod předponou cesty.
Kolekce webu
pages.json s rozsahem site nastavuje sdílené výchozí hodnoty pro celý strom stránek a vypisuje jej, aniž mění URL nebo řádky příspěvků.
Pomocníci navigace
blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() a blockstudio_page_content() vytvářejí postranní panely, stránkování a tělo.
Kolekce a typy příspěvků
Kolekce mohou registrovat vlastní hierarchické typy příspěvků.
Uzamčení šablony
Zamkněte stránky nebo jednotlivé bloky pomocí contentOnly, all nebo insert.
Napište HTML, získejte bloky
Standardní prvky jako <h1>, <p> a <ul> se mapují na základní bloky. Pro všechny ostatní názvy bloků a úrovně vnoření použijte <block>.
Blockstudio převádí kompletní rozvržení stránek na skutečné upravitelné bloky WordPress.
<div>
<h1 blockEditingMode="contentOnly">About Us</h1>
<p>We build tools for WordPress developers.</p>
<img src="/team.jpg" alt="Our team" />
</div>
<block name="core/columns">
<block name="core/column"><h2>Our Mission</h2></block>
<block name="core/column"><h2>Our Stack</h2></block>
</block>Stránky vykreslované komponentami
Nastavte render v page.json na položku, například page.tsx, a loader data.php; renderer stránky zaregistrovaný vaší šablonou nebo pluginem pak vykreslí celou stránku. Sync ukládá jeden blok blockstudio/page a obsah WordPress, například shortcode, zůstává ve svém slotu.
Prostředky vrácené rendererem se zpracují stejně jako prostředky bloků a vytisknou se jen jednou, takže předem vykreslená stránka je obsahuje. Samotné blockstudio.dev se sestavuje z komponentových stránek.
{
"name": "legal-notice",
"title": "Legal Notice",
"slug": "legal-notice",
"postStatus": "publish",
"render": { "entry": "page.tsx", "data": "data.php" }
}add_action(
'blockstudio/pages/renderers',
static function (): void {
Blockstudio\Page_Renderers::register(
'react',
array(
'extensions' => array( 'tsx' ),
'layouts' => array( 'layout.tsx' ),
'render' => 'my_theme_render_page',
)
);
}
);Trasy bez příspěvku
Blockstudio\Virtual_Routes::register() poskytuje dokument, za kterým nestojí žádný příspěvek, například referenci komponenty nebo katalog. Pomocí prefix a match obslouží jedna registrace celou skupinu URL a vrácením null se URL přenechá WordPress.
Trasa se vykreslí do výstupní vyrovnávací paměti Blockstudio, takže její bloky získají své prostředky a výstup Tailwind. Cesty v urls se přidají k sestavením statického předvykreslení a Virtual_Routes::urls() je vrátí pro mapu webu.
add_action( 'init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function ( $component, string $rest ) {
get_header();
echo my_component_page( $component );
get_footer();
},
[
'prefix' => true,
'match' => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
'title' => fn ( $component ) => my_component_title( $component ),
'urls' => fn () => my_component_paths(),
]
);
} );Synchronizace jen na vyžádání
Soubory stránek mění WordPress jen na vaše přání. wp bs pages sync použije všechny změněné zdroje, zachová obsah bloků s klíčem a odstraní stránky, jejichž soubory už neexistují.
Otisky zahrnují manifesty, načítače, rozvržení i zdroje, takže nezměněné stránky nevyžadují žádné zápisy. Při nasazení se zavolá Pages::reconcile() a vrátí strojově čitelnou zprávu.
# Apply changed sources, keep keyed edits
wp bs pages sync
# Replace managed content from the files
wp bs pages sync --authoritative
# Compare every page and report as JSON
wp bs pages sync --full --format=json$report = Blockstudio\Pages::reconcile();
if (0 === $report['failed']) {
// Once the release is live and verified:
Blockstudio\Pages::store_successful_source_identity(
$report['sourceIdentity']
);
}Bloky s klíčem zachovávají obsah
Přidejte key do libovolného bloku. Při další synchronizaci se u bloků s klíčem sloučí atributy šablony s existujícím uživatelským obsahem, zatímco bloky bez klíče se nahradí.
Měňte strukturu při nasazování nových verzí, zatímco obsah klientů zůstane zachován.
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
<h2>Welcome to our company</h2>
<p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
<block name="core/column"><h3>Our Team</h3></block>
</block>{
"name": "about",
"title": "About Us",
"slug": "about",
"templateLock": "contentOnly"
}Zamykání šablon a režimy úprav
"all" brání změnám, "contentOnly" zamyká strukturu a umožňuje upravovat text a "insert" umožňuje úpravy a změnu pořadí bez přidávání nebo odebírání.
Pomocí blockEditingMode přepište libovolný prvek a umožněte vybrané úpravy zamčené stránky nebo zakažte jednotlivý blok.
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
<p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
<h2>Customizable Section</h2>
</block>{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"templateLock": "contentOnly",
"blockEditingMode": "contentOnly"
}Šablony editoru webu ze souborů
Přidejte template.json a šablonu do templates/ nebo part.json do parts/ a vaše blokové téma získá zdroje wp_template a wp_template_part uložené v souborech.
Používají stejnou syntaxi jako stránky. Přizpůsobení v editoru webu má stále přednost, dokud ho někdo neobnoví; pak se znovu použije zdroj ze souboru.
<block name="core/template-part" slug="header" />
<div>
<h1>Welcome</h1>
<block name="core/post-content" />
</div>
<block name="core/template-part" slug="footer" />{
"slug": "front-page",
"title": "Front Page",
"description": "Homepage template"
}{
"slug": "header",
"title": "Header",
"area": "header"
}Vybraný obsah databáze v git
wp bs content pull exportuje povolené příspěvky, termíny, vztahy a deklarovaná metadata do přenositelných souborů a push je použije v jiném prostředí. Deklarované reference, nadřazené položky a vztahy termínů se přenášejí jako stabilní UID.
Příspěvky spravované synchronizací stránek lze propojit s includePageSyncManaged. Jejich soubory obsahují "bodyOwner": "page-sync", takže Content Sync přenáší metadata, zatímco synchronizace stránek ponechává tělo.
{
"content": {
"enabled": true,
"id": "default",
"path": "content",
"postTypes": ["team_member"],
"taxonomies": ["category"],
"meta": {
"include": ["_my_*"],
"references": {
"_thumbnail_id": { "kind": "attachment" },
"_related_posts": { "kind": "post", "path": "*" }
}
},
"media": "manifest"
}
}wp bs content pull --dry-run
wp bs content pull
wp bs content status
wp bs content push --dry-run
wp bs content push --prune --yesBloky s klíči
Zachovejte uživatelský obsah při změnách šablon.
Režimy úprav
Nastavte výchozí hodnoty stránky a přepište jednotlivé prvky.
Vazby bloků
Propojte bloky s metadaty příspěvků, aby obsah přežil synchronizaci.
Šablony typů příspěvků
templateFor nastaví stránku jako výchozí strukturu bloků pro každý nový příspěvek daného typu.
Připnutá ID příspěvků
postId při opětovné synchronizaci znovu přidělí stejné ID, i když byla stránka smazána, takže nabídky a odkazy dál fungují.
Kostra a zámky
sync: false spolu s Pages::force_sync() vytvoří stránku jednou, aby ji spravovali editoři. Pages::lock() a unlock() zabrání synchronizaci jediné stránky.
Vlastní renderery parseru
Filtry builderu a rendereru převedou značku bloku na pole bloků bloku třetí strany nebo změní způsob zápisu základního bloku.
Mapování prvků
Namapujte prvek HTML na jiný blok, vyberte blok podle atributů prvku a přesměrujte HTML odstavce do pole obsahu.
Vlastní cesty pro vyhledávání
Filtry přidávají kořenové cesty pro stránky, vzory a šablony Site Editoru, například z pluginu.
Logické zdroje pro vyhledávání
Náhledy, překryvy a generované šablony mohou předat Blockstudio složený seznam souborů místo jediné složky šablony.
Stabilní odkazy
Deklarované odkazy na příspěvky, termíny a přílohy se při stažení změní na přenositelné UID a při odeslání se převedou na místní ID.
Stav před odesláním
wp bs content status hlásí stav každé entity jako unchanged, would-update, missing-db, conflict, locked nebo orphaned a upozorňuje na meta klíče, které vypadají jako tajné údaje.
Ověřená odeslání s vymezeným rozsahem
Příkaz push ověří celý plán ještě před zápisem a přeskočí zamčené entity. –dry-run zobrazí plán a –prune –yes odstraní pouze entity této sady obsahu.
Správa verzí
Sledujte soubory stránek v Git a nasazujte je napříč prostředími.
PHP API
Programově přistupujte ke stromům, potomkům, metadatům, synchronizaci, zamykání a ID.
Oficiální sada rozšíření
Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.
- 500+ šablon webů
- Systémové instrukce AI
- Doživotní aktualizace
- Soukromá komunita Discord