Vai al contenuto

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.

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

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.

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>

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.

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

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.

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

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.

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

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.

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>

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.

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>

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.

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

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.

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

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

Plus

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