Přejít k obsahu

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().

pages/docs/pages.json
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}

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.

index.php
<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.

pages/legal-notice/page.json
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}

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.

functions.php
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.

Terminál
# 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

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.

index.php
<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>

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.

index.php
<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>

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

templates/front-page/index.php
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />

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.

blockstudio.json
{
  "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"
  }
}

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

Plus

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