Treci la conținut

Pagini complete, definite în cod

Șabloane și Markdown, sincronizate cu WordPress printr-o singură comandă.

Colecții din fișiere

Definiți pages.json și lăsați Blockstudio să descopere fiecare sursă din interiorul acesteia. Căile imbricate devin pagini imbricate, setările implicite se aplică întregii colecții, iar directoarele părinte lipsă pot fi generate.

Folosiți colecțiile pentru documentație, baze de cunoștințe sau pagini de destinație și montați foldere externe sub un prefix de cale cu loader.php.

Puneți un layout.php sau un aspect de randare precum layout.tsx lângă pages.json pentru a încadra fiecare pagină a colecției într-un singur container, cu blockstudio_page_tree() pentru bara laterală.

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

Sincronizare explicită

wp bs pages sync aplică modificările; paginile nemodificate nu generează nicio scriere.

Surse Markdown

Folosiți index.md cu frontmatter sau combinați conținutul page.json cu Markdown.

Markdown brut

Paginile de fișier Markdown sunt accesibile la URL lor plus .md sau la URL obișnuit pentru Accept: text/markdown, cu un link canonic înapoi către HTML.

Încărcătoare de colecții

Montați foldere externe cu documentație într-o colecție, sub un prefix de cale.

Colecții de site

Un pages.json cu domeniul de aplicare site aplică valorile implicite comune întregului arbore de pagini și îl enumeră, fără să modifice URL-urile sau rândurile postărilor.

Ajutoare pentru navigare

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() și blockstudio_page_content() construiesc bare laterale, paginatoare și corpul paginii.

Colecții și tipuri de postări

Colecțiile pot înregistra tipuri de postări ierarhice dedicate.

Blocarea șablonului

Blocați pagini sau blocuri individuale cu contentOnly, all sau insert.

Scrieți HTML, obțineți blocuri

Elementele standard precum <h1>, <p> și <ul> corespund blocurilor de bază. Folosiți <block> pentru orice alt nume de bloc și nivel de imbricare.

Blockstudio analizează aspectul complet al paginii și îl transformă în blocuri WordPress reale, care pot fi editate.

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>

Pagini randate de componente

Setați render în page.json la o intrare precum page.tsx și la un încărcător data.php, iar randorul de pagini înregistrat de tema sau pluginul dvs. desenează întreaga pagină. Sincronizarea stochează un singur bloc blockstudio/page, iar conținutul WordPress, precum un shortcode, rămâne în slotul său.

Resursele returnate de randor sunt procesate la fel ca resursele blocurilor și sunt tipărite o singură dată, astfel încât o pagină prerandată le include. blockstudio.dev este alcătuit din pagini de componente.

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

Rute fără o postare

Blockstudio\Virtual_Routes::register() servește un document fără o postare asociată, precum o referință de componentă sau un catalog. Cu prefix și match, o singură înregistrare răspunde unei întregi familii de URL-uri, iar returnarea valorii null lasă URL la dispoziția lui WordPress.

Ruta este randată în bufferul de ieșire al lui Blockstudio, astfel încât blocurile sale primesc resursele și ieșirea Tailwind. Căile din urls sunt incluse în compilările de prerandare statică, iar Virtual_Routes::urls() le returnează pentru o hartă a site-ului.

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(),
        ]
    );
} );

Sincronizați doar când decideți

Fișierele paginilor se modifică în WordPress numai la cererea dvs. wp bs pages sync aplică fiecare sursă modificată, păstrează conținutul din editor marcat cu chei și elimină paginile ale căror fișiere au dispărut.

Amprentele verifică manifestele, încărcătoarele, aspectele și sursele, astfel că paginile nemodificate nu generează nicio scriere. Implementările apelează Pages::reconcile() și primesc un raport care poate fi citit de mașini.

Terminal
# 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

Blocurile cu chei păstrează conținutul

Adăugați key la orice bloc. La următoarea sincronizare, blocurile cu chei combină atributele șablonului cu conținutul existent al utilizatorului, în timp ce blocurile fără chei sunt înlocuite.

Evoluați structura între implementări, păstrând intact conținutul clientului.

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>

Blocarea șabloanelor și moduri de editare

"all" împiedică modificările, "contentOnly" blochează structura și permite editarea textului, iar "insert" permite editarea și reordonarea fără a adăuga sau elimina elemente.

Suprascrieți orice element cu blockEditingMode pentru a permite editarea selectivă a unei pagini blocate sau pentru a dezactiva un bloc individual.

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>

Șabloanele editorului de site din fișiere

Adăugați template.json și un șablon la templates/ sau part.json la parts/, iar tema dvs. de blocuri va obține surse wp_template și wp_template_part susținute de fișiere.

Folosesc aceeași sintaxă ca paginile. O personalizare în editorul de site are în continuare prioritate până când cineva o resetează, apoi revine sursa din fișier.

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

Conținut selectat din baza de date în git

wp bs content pull proiectează articolele, termenii, relațiile și metadatele declarate din lista de permisiuni în fișiere portabile, iar push le aplică într-un alt mediu. Referințele declarate, părinții și relațiile dintre termeni sunt transferate ca UID-uri stabile.

Postările gestionate prin sincronizarea paginilor pot fi asociate cu includePageSyncManaged. Fișierele lor conțin "bodyOwner": "page-sync", astfel încât Content Sync transferă metadatele, iar sincronizarea paginilor păstrează corpul.

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

Blocuri cu chei

Păstrați conținutul utilizatorilor pe măsură ce evoluează șabloanele.

Moduri de editare

Setați valorile implicite pentru pagini și suprascrieți elemente individuale.

Legături între blocuri

Conectați blocurile la metadatele postărilor, astfel încât conținutul să fie păstrat la sincronizare.

Șabloane pentru tipuri de postări

templateFor face dintr-o pagină structura inițială de blocuri pentru fiecare postare nouă de un anumit tip.

ID-uri fixe pentru postări

postId recuperează același ID când o pagină este ștearsă și sincronizată din nou, astfel încât meniurile și linkurile să funcționeze în continuare.

Șabloane inițiale și blocări

sync: false împreună cu Pages::force_sync() creează o pagină o singură dată, pe care editorii o pot gestiona. Pages::lock() și unlock() împiedică sincronizarea unei pagini.

Randere personalizate pentru parser

Filtrele pentru compilator și randor transformă o etichetă de bloc într-o matrice de blocuri pentru un bloc terță parte sau schimbă modul în care este scris un bloc de bază.

Maparea elementelor

Asociați un element HTML cu un alt bloc, selectați blocul pe baza atributelor elementului și direcționați HTML al paragrafului către un câmp de conținut.

Căi personalizate de descoperire

Filtrele adaugă rădăcini pentru pagini, modele și șabloane Site Editor, de exemplu, dintr-un plugin.

Surse logice de descoperire

Previzualizările, suprapunerile și temele generate îi pot furniza lui Blockstudio un inventar compus de fișiere în locul unui singur director de temă.

Referințe stabile

Referințele declarate la postări, termeni și atașamente devin UID-uri portabile la preluare și se rezolvă în ID-uri locale la trimitere.

Starea înainte de trimitere

wp bs content status raportează fiecare entitate ca neschimbată, urmează să fie actualizată, lipsește din baza de date, în conflict, blocată sau orfană și avertizează cu privire la cheile meta care par secrete.

Trimiteri validate și limitate

Înainte de a scrie, comanda Push validează întregul plan și omite entitățile blocate. –dry-run afișează planul, iar –prune –yes elimină numai entitățile acestui set de conținut.

Cu controlul versiunilor

Urmăriți fișierele paginilor în Git și implementați-le în diferite medii.

PHP API

Accesați programatic arbori, elemente copil, metadate, sincronizare, blocări și ID-uri.

Plus

Kitul oficial de extensii

Șabloane premium de site, instrucțiuni de sistem pentru AI și o comunitate privată Discord. Achiziție unică, actualizări pe viață.

  • 500+ șabloane de site
  • Instrucțiuni de sistem pentru IA
  • Actualizări pe viață
  • Comunitate privată Discord