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

[Raccolte di pagine](https://blockstudio.dev/it/docs/pages-and-patterns/pages/#page-collections)

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.

[Riferimento alla sintassi delle pagine](https://blockstudio.dev/it/docs/pages-and-patterns/pages/)

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.

[Pagine dei componenti](https://blockstudio.dev/it/docs/pages-and-patterns/pages/#component-pages)

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.

[Route virtuali](https://blockstudio.dev/it/docs/pages-and-patterns/pages/#virtual-routes)

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.

[Comportamento della sincronizzazione](https://blockstudio.dev/it/docs/pages-and-patterns/pages/#sync-behavior)

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.

[Blocchi con chiave](https://blockstudio.dev/it/docs/pages-and-patterns/pages/#keyed-block-merging)

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.

[Blocco dei template](https://blockstudio.dev/it/docs/pages-and-patterns/pages/#template-lock)

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.

[Template del sito](https://blockstudio.dev/it/docs/pages-and-patterns/site-templates/)

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.

[Sincronizzazione dei contenuti](https://blockstudio.dev/it/docs/content-sync/)

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

[Passa a Plus](https://blockstudio.dev/it/plus/)
