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ă.
{
"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>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.
<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.
{
"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',
)
);
}
);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.
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.
# 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']
);
}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.
<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"
}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.
<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"
}Ș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.
<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"
}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.
{
"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 --yesBlocuri 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.
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