# Des pages complètes, définies dans le code

Modèles et Markdown, synchronisés avec WordPress en une seule commande.

## Collections issues de fichiers

Définissez `pages.json` et laissez Blockstudio découvrir toutes les sources qu’il contient. Les chemins imbriqués deviennent des pages imbriquées, les valeurs par défaut s’appliquent à la collection et les pages parentes manquantes peuvent être générées.

Utilisez les collections pour la documentation, les bases de connaissances ou les pages d’accueil, et montez des dossiers externes sous un préfixe de chemin avec `loader.php`.

Placez un `layout.php` ou une mise en page de rendu telle que `layout.tsx` à côté de `pages.json` pour envelopper chaque page de la collection dans une même structure, avec `blockstudio_page_tree()` pour la barre latérale.

[Collections de pages](https://blockstudio.dev/fr/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

```
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

## Synchronisation explicite

wp bs pages sync applique les modifications ; les pages inchangées ne génèrent aucune écriture.

## Sources Markdown

Utilisez index.md avec des métadonnées en tête de fichier, ou associez page.json à du contenu Markdown.

## Markdown brut

Les pages de fichiers Markdown sont accessibles à leur URL suivi de .md, ou à l’URL habituel avec Accept: text/markdown, avec un lien canonique vers HTML.

## Chargeurs de collections

Montez des dossiers de documentation externes dans une collection, sous un préfixe de chemin.

## Collections de sites

Un pages.json dont la portée est « site » applique des valeurs par défaut partagées à toute une arborescence de pages et la répertorie, sans modifier les URL ni les lignes d’articles.

## Assistants de navigation

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() et blockstudio_page_content() créent des barres latérales, des pagineurs et le corps de page.

## Collections et types d’articles

Les collections peuvent enregistrer des types d’articles hiérarchiques dédiés.

## Verrouillage des modèles

Verrouillez des pages ou des blocs individuels avec contentOnly, all ou insert.

## Écrivez HTML, obtenez des blocs

Les éléments standards tels que `<h1>`, `<p>` et `<ul>` correspondent aux blocs principaux. Utilisez `<block>` pour tous les autres noms de blocs et niveaux d’imbrication.

Blockstudio analyse des mises en page complètes et les convertit en véritables blocs WordPress modifiables.

[Référence de la syntaxe des pages](https://blockstudio.dev/fr/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>
```

## Pages rendues par des composants

Définissez `render` dans `page.json` avec une entrée telle que `page.tsx` et un chargeur `data.php`, et le moteur de rendu de page enregistré par votre thème ou votre extension génère la page entière. La synchronisation stocke un seul bloc `blockstudio/page`, et le contenu WordPress, comme un shortcode, reste dans son emplacement.

Les ressources renvoyées par le moteur de rendu subissent le même traitement que celles des blocs et ne sont imprimées qu’une fois, afin que les pages pré-rendues les incluent. blockstudio.dev est lui-même créé à partir de pages de composants.

[Pages de composants](https://blockstudio.dev/fr/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" }
}
```

## Routes sans article

`Blockstudio\Virtual_Routes::register()` sert un document sans article associé, comme une référence de composants ou un catalogue. Avec `prefix` et `match`, un seul enregistrement répond à toute une famille d’URL, et le renvoi de `null` laisse URL à WordPress.

La route est rendue dans le tampon de sortie de Blockstudio, ce qui permet à ses blocs de charger leurs ressources et de produire la sortie Tailwind. Les chemins de `urls` rejoignent les compilations de pré-rendu statique, et `Virtual_Routes::urls()` les renvoie pour un plan du site.

[Routes virtuelles](https://blockstudio.dev/fr/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(),
        ]
    );
} );
```

## Synchronisez quand vous le décidez

Les fichiers de page ne sont modifiés WordPress que lorsque vous le demandez. `wp bs pages sync` applique chaque source modifiée, conserve le contenu des blocs dotés d’une clé et supprime les pages dont les fichiers ont disparu.

Les empreintes couvrent les manifestes, les chargeurs, les mises en page et les sources : les pages inchangées ne génèrent donc aucune écriture. Les déploiements appellent `Pages::reconcile()` et reçoivent un rapport lisible par une machine.

[Fonctionnement de la synchronisation](https://blockstudio.dev/fr/docs/pages-and-patterns/pages/#sync-behavior)

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
```

## Les blocs dotés d’une clé préservent le contenu

Ajoutez `key` à n’importe quel bloc. À la synchronisation suivante, les blocs dotés d’une clé fusionnent les attributs du modèle avec le contenu utilisateur existant, tandis que les blocs sans clé sont remplacés.

Faites évoluer la structure au fil des déploiements tout en préservant le contenu des clients.

[Blocs avec clé](https://blockstudio.dev/fr/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>
```

## Verrouillage des modèles et modes de modification

`"all"` empêche les modifications, `"contentOnly"` verrouille la structure tout en autorisant les modifications de texte, et `"insert"` autorise la modification et le réordonnancement sans ajout ni suppression.

Remplacez n’importe quel élément avec `blockEditingMode` pour rendre une page verrouillée modifiable de manière sélective ou désactiver un bloc particulier.

[Verrouillage des modèles](https://blockstudio.dev/fr/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>
```

## Modèles de l’éditeur de site depuis des fichiers

Ajoutez `template.json` et un modèle à `templates/`, ou `part.json` à `parts/`, pour que votre thème de blocs utilise des sources de `wp_template` et `wp_template_part` issues de fichiers.

Ils utilisent la même syntaxe que les pages. Une personnalisation dans l’éditeur de site reste prioritaire jusqu’à sa réinitialisation ; la source fichier reprend alors le relais.

[Modèles du site](https://blockstudio.dev/fr/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" />
```

## Contenu sélectionné de la base de données dans git

`wp bs content pull` exporte les publications, termes, relations et métadonnées déclarées autorisés vers des fichiers portables, et `push` les applique à un autre environnement. Les références déclarées, les parents et les relations entre termes sont transférés sous forme d’UID stables.

Les articles gérés par la synchronisation des pages peuvent être associés à `includePageSyncManaged`. Leurs fichiers contiennent `"bodyOwner": "page-sync"`, afin que Content Sync transfère les métadonnées tandis que la synchronisation des pages conserve le corps.

[Synchronisation du contenu](https://blockstudio.dev/fr/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"
  }
}
```

## Blocs avec clé

Conservez le contenu utilisateur pendant l’évolution des modèles.

## Modes de modification

Définissez les valeurs par défaut des pages et remplacez celles d’éléments individuels.

## Liaisons de blocs

Reliez les blocs aux métadonnées d’article pour que le contenu survive à la synchronisation.

## Modèles de types d’articles

templateFor fait d’une page la structure de blocs de départ de chaque nouvel article d’un type donné.

## Identifiants d’articles épinglés

postId réattribue le même identifiant lorsqu’une page est supprimée puis synchronisée à nouveau, afin que les menus et les liens restent fonctionnels.

## Ébauches et verrouillages

sync: false avec Pages::force_sync() crée une page une seule fois, que les éditeurs peuvent gérer. Pages::lock() et unlock() empêchent la synchronisation d’une page.

## Moteurs de rendu personnalisés du parseur

Les filtres du générateur et du moteur de rendu transforment une balise de bloc en tableau de blocs d’un bloc tiers ou modifient la façon dont un bloc natif est écrit.

## Mappage des éléments

Associez un élément HTML à un autre bloc, choisissez le bloc à partir des attributs de l’élément et dirigez le paragraphe HTML vers un champ de contenu.

## Chemins de découverte personnalisés

Les filtres ajoutent des racines pour les pages, les compositions et les modèles de l’éditeur de site, par exemple à partir d’une extension.

## Sources de découverte logiques

Les aperçus, les superpositions et les thèmes générés peuvent fournir à Blockstudio un inventaire de fichiers composé au lieu d’un seul dossier de thème.

## Références stables

Les références déclarées aux articles, aux termes et aux pièces jointes deviennent des UID portables lors de l’extraction et sont résolues en identifiants locaux lors de l’envoi.

## État avant l’envoi

wp bs content status indique pour chaque entité si elle est inchangée, à mettre à jour, absente de la base de données, en conflit, verrouillée ou orpheline, et signale les clés de métadonnées qui ressemblent à des secrets.

## Envois validés et ciblés

L’envoi valide le plan entier avant d’écrire et ignore les entités verrouillées. –dry-run affiche le plan, et –prune –yes supprime uniquement les entités de cet ensemble de contenu.

## Suivi des versions

Suivez les fichiers de page dans Git et déployez-les dans tous les environnements.

## PHP API

Accédez par programmation aux arborescences, aux pages enfants, aux métadonnées, à la synchronisation, au verrouillage et aux identifiants.

Plus

## Le kit d’extension officiel

Modèles de site premium, instructions système pour l’IA et communauté privée Discord. Achat unique, mises à jour à vie.

- 500+ modèles de sites
- Instructions système de l’IA
- Mises à jour à vie
- Communauté privée Discord

[Obtenir Plus](https://blockstudio.dev/fr/plus/)
