Pagine complete, definite nel codice
Template e Markdown, sincronizzati con WordPress con un solo comando.
Raccolte da file
Definisci pages.json e lascia che Blockstudio individui tutte le fonti al suo interno. I percorsi annidati diventano pagine annidate, i valori predefiniti si applicano alla raccolta e le pagine principali mancanti possono essere generate.
Usa le raccolte per documentazione, basi di conoscenza o landing page; con loader.php puoi montare cartelle esterne sotto un prefisso di percorso.
Posizionate un layout.php, o un layout del renderer come layout.tsx, accanto a pages.json per racchiudere ogni pagina della raccolta in un unico contenitore, con blockstudio_page_tree() per la barra laterale.
{
"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>Sincronizzazione esplicita
wp bs pages sync applica le modifiche; le pagine invariate non richiedono alcuna scrittura.
Fonti Markdown
Usa index.md con il frontmatter oppure abbina page.json ai contenuti Markdown.
Markdown grezzo
Le pagine file Markdown rispondono al rispettivo URL più .md, o al normale URL per Accept: text/markdown, con un link canonico che rimanda a HTML.
Loader delle raccolte
Monta cartelle di documentazione esterne in una raccolta, sotto un prefisso di percorso.
Raccolte del sito
Un pages.json con ambito site applica i valori predefiniti condivisi a un intero albero di pagine e lo elenca, senza modificare gli URL o le righe dei post.
Helper di navigazione
blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() e blockstudio_page_content() creano barre laterali, navigatori di pagina e il corpo.
Raccolte e tipi di articolo
Le raccolte possono registrare tipi di articolo gerarchici dedicati.
Blocco dei template
Blocca pagine o singoli blocchi con contentOnly, all o insert.
Scrivi HTML, ottieni blocchi
Gli elementi standard come <h1>, <p> e <ul> corrispondono ai blocchi principali. Usa <block> per qualsiasi altro nome di blocco e livello di annidamento.
Blockstudio interpreta layout di pagina completi e li converte in blocchi WordPress reali e modificabili.
<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>Pagine renderizzate dai componenti
Impostate render in page.json su una voce come page.tsx e su un loader data.php: il renderer di pagina registrato dal tema o dal plugin disegna l’intera pagina. La sincronizzazione memorizza un blocco blockstudio/page e i contenuti WordPress, come uno shortcode, restano nel proprio slot.
Gli asset restituiti dal renderer vengono elaborati come gli asset dei blocchi e stampati una sola volta, così una pagina prerenderizzata li include. blockstudio.dev stesso viene creato a partire dalle pagine dei componenti.
{
"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',
)
);
}
);Route senza un post
Blockstudio\Virtual_Routes::register() serve un documento senza un post associato, come un riferimento ai componenti o un catalogo. Con prefix e match, una registrazione gestisce un’intera famiglia di URL e restituire null lascia che URL gestisca WordPress.
La route viene renderizzata nel buffer di output di Blockstudio, quindi i suoi blocchi ricevono gli asset e l’output Tailwind. I percorsi in urls vengono inclusi nelle build di prerendering statico e Virtual_Routes::urls() li restituisce per una sitemap.
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(),
]
);
} );Sincronizza solo quando lo decidi
I file delle pagine vengono modificati WordPress solo su richiesta. wp bs pages sync applica tutte le fonti modificate, conserva i contenuti dell’editor associati a una chiave ed elimina le pagine i cui file non esistono più.
Le impronte digitali includono manifest, loader, layout e fonti, quindi le pagine invariate non richiedono alcuna scrittura. I deploy chiamano Pages::reconcile() e ricevono un report leggibile dalle macchine.
# 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']
);
}I blocchi con chiave conservano i contenuti
Aggiungi key a qualsiasi blocco. Alla sincronizzazione successiva, i blocchi con chiave uniscono gli attributi del template ai contenuti utente esistenti, mentre quelli senza chiave vengono sostituiti.
Fai evolvere la struttura tra un deploy e l’altro, mantenendo intatti i contenuti dei clienti.
<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"
}Blocco dei template e modalità di modifica
"all" impedisce le modifiche, "contentOnly" blocca la struttura ma consente di modificare il testo e "insert" permette di modificare e riordinare senza aggiungere o rimuovere elementi.
Usa blockEditingMode per rendere modificabile in modo selettivo una pagina bloccata o disabilitare un singolo blocco.
<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"
}Template dell’editor del sito da file
Aggiungi template.json e un template a templates/, oppure part.json a parts/, e il tuo tema a blocchi otterrà fonti wp_template e wp_template_part basate su file.
Usano la stessa sintassi delle pagine. Una personalizzazione nell’editor del sito resta prioritaria finché qualcuno non la reimposta; poi torna la versione del file.
<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"
}Contenuti selezionati dal database in git
wp bs content pull esporta post, termini, relazioni e metadati dichiarati consentiti in file portabili, mentre push li applica a un altro ambiente. I riferimenti dichiarati, i genitori e le relazioni tra termini vengono trasferiti come UID stabili.
I post gestiti dalla sincronizzazione delle pagine possono unirsi a includePageSyncManaged. I loro file contengono "bodyOwner": "page-sync", così Content Sync trasferisce i metadati mentre la sincronizzazione delle pagine mantiene il corpo.
{
"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 --yesBlocchi con chiave
Conserva i contenuti utente mentre i template evolvono.
Modalità di modifica
Imposta i valori predefiniti delle pagine e sovrascrivi singoli elementi.
Collegamenti ai blocchi
Collega i blocchi ai metadati degli articoli, così i contenuti restano anche dopo la sincronizzazione.
Template per tipo di post
templateFor imposta una pagina come struttura iniziale a blocchi per ogni nuovo post di un tipo.
ID dei post fissati
postId riutilizza lo stesso ID quando una pagina viene eliminata e sincronizzata di nuovo, così menu e link continuano a funzionare.
Impalcature e blocchi
sync: false con Pages::force_sync() crea una pagina una sola volta, lasciandola agli editor. Pages::lock() e unlock() escludono una pagina dalla sincronizzazione.
Renderer per parser personalizzati
I filtri del builder e del renderer trasformano un tag di blocco nell’array di blocchi di un blocco di terze parti oppure modificano il modo in cui viene scritto un blocco core.
Mappatura degli elementi
Mappate un elemento HTML a un altro blocco, scegliete il blocco in base agli attributi dell’elemento e instradate HTML dei paragrafi in un campo di contenuto.
Percorsi di rilevamento personalizzati
I filtri aggiungono radici per pagine, pattern e template del Site Editor, ad esempio da un plugin.
Origini di rilevamento logiche
Anteprime, overlay e temi generati possono fornire a Blockstudio un inventario di file composto invece di una singola cartella del tema.
Riferimenti stabili
I riferimenti dichiarati a post, termini e allegati diventano UID portabili durante il pull e vengono risolti in ID locali durante il push.
Stato prima del push
wp bs content status segnala per ogni entità se è invariata, da aggiornare, priva di record nel database, in conflitto, bloccata o orfana e avvisa delle chiavi meta che sembrano contenere segreti.
Push convalidati e con ambito definito
Il push convalida l’intero piano prima di scrivere e ignora le entità bloccate. –dry-run mostra il piano, mentre –prune –yes rimuove solo le entità di questo insieme di contenuti.
Con controllo di versione
Tieni traccia dei file delle pagine in Git e distribuiscili tra gli ambienti.
PHP API
Accedi via codice ad alberi, elementi figli, metadati, sincronizzazione, blocchi e ID.
Il kit ufficiale di estensioni
Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.
- Oltre 500 modelli di siti
- Istruzioni di sistema per l’AI
- Aggiornamenti a vita
- Community privata di Discord