
Blockstudio 7.4 vise à rendre les projets basés sur des fichiers plus portables. La version 7.2 a facilité l’inspection et la distribution des projets volumineux, et la version 7.3 a ajouté une couche UI par-dessus. La version 7.4 vise à transférer davantage d’éléments d’un projet — ses pages et son contenu sélectionné — de la base de données vers des fichiers suivis dans le contrôle de version.

La fonctionnalité phare est celle des collections de pages : elles permettent de pointer Blockstudio vers un dossier de sources de pages et d’en générer une structure complète de pages WordPress imbriquées. La source peut être PHP, Twig, Blade, HTML, Markdown ou un chargeur de confiance qui renvoie des pages issues d’une autre source locale.

En bref :

- **Collections de pages** : `pages.json` peut définir un ensemble complet de pages imbriquées, des valeurs par défaut, le comportement du type de publication, des mises en page, des chargeurs et des métadonnées de collection.
- **Pages Markdown** : `index.md` peut servir de contenu de page, avec `page.json` ou seul avec des métadonnées d’en-tête.
- **Mises en page pour les pages du site** : `layout.php` peut envelopper le contenu de page synchronisé et utiliser des fonctions d’aide telles que `blockstudio_page_tree()` et `blockstudio_page_content()`.
- **Sources de documentation externes** : les chargeurs de collection peuvent générer des pages à partir de fichiers locaux ou de Markdown/HTML renvoyés.
- **Sortie Markdown brute** : les sources de pages Markdown peuvent être diffusées en `.md` ou via `Accept: text/markdown`.
- **Types de publication personnalisés pour les collections** : les collections peuvent gérer des URL propres, vider automatiquement les règles de réécriture, fournir des routes Markdown brutes et migrer des pages vers des types de publication personnalisés sans contournements côté thème.
- **Content Sync** : `wp bs content pull`, `wp bs content push` et `wp bs content status` rendent portables les publications, termes, relations et références de métadonnées autorisés par le projet.
- **Préfixes de balises de bloc** : les préfixes de projet tels que `<theme-card>` peuvent être résolus dans des espaces de noms ordonnés sans alias par bloc.
- **Synchronisation plus fiable** : les changements de pages sont détectés dans les manifestes, les chargeurs, les mises en page, les métadonnées et les fichiers source.
- **Correctifs d’exécution et d’éditeur** : les options dynamiques restent à jour, les classes des blocs de requête sont conservées lors du rendu programmatique, `bsui/select` fonctionne mieux dans les formulaires denses, les propriétés RichText parviennent à l’éditeur et la suppression de lignes de répéteur avec RichText est désormais conservée après l’enregistrement.

## Pages basées sur des fichiers

La majeure partie de la version 7.4 repose sur les pages basées sur des fichiers.

### Collections de pages

Avant la version 7.4, les pages basées sur des fichiers étaient surtout une fonctionnalité à l’échelle d’un dossier : créer un `page.json`, ajouter un `index.php` ou un `index.twig`, et Blockstudio synchronise cette page unique dans WordPress.

Cela fonctionne toujours. La version 7.4 ajoute un second mode pour les structures plus vastes.

Ajoutez un manifeste `pages.json` à un dossier pour en faire une collection :

```txt
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
```

```json title="pages/docs/pages.json"
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

Chaque source de page de la collection est découverte, normalisée, synchronisée et liée par son chemin. Une page située dans `guide/install` devient enfant de `guide` ; si la page `guide` est absente, Blockstudio crée une page conteneur générée afin que la hiérarchie WordPress corresponde toujours à la structure du système de fichiers.

Les collections peuvent utiliser le type de publication natif `page` ou leur propre type. Lorsqu’une collection déclare un type de publication qui n’existe pas encore, Blockstudio l’enregistre à partir de `postTypeArgs`. Le manifeste `postType` devient également la valeur par défaut pour chaque page de la collection, de sorte que les projets n’ont pas à le répéter dans `defaults`.

Les types de publication des collections utilisent le slug de la collection comme base publique URL. Une collection `docs` résout sa page racine à `/docs/`, une page avec `path: "getting-started"` à `/docs/getting-started/`, et les chemins imbriqués sous la même base. Les URL en double, comme `/docs/docs/`, redirigent vers l’emplacement canonique. Les règles de réécriture sont vidées automatiquement lorsque le routage du type de publication de la collection change ; une nouvelle collection ne nécessite donc pas d’enregistrer manuellement les permaliens.

C’est ce qui permet aux documentations externes, aux manuels de produits, aux bases de connaissances et aux bibliothèques de pages de s’intégrer naturellement dans WordPress : la source reste dans des fichiers, tandis que le résultat demeure un contenu WordPress réel et modifiable.

### Markdown comme contenu de page

Markdown est désormais une source de page de premier plan.

Les pages Markdown autonomes utilisent des métadonnées d’en-tête :

```md title="pages/about/index.md"
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.
```

Vous pouvez aussi associer `page.json` à `index.md` pour séparer la configuration du contenu entre plusieurs fichiers. Les métadonnées d’en-tête de `index.md` peuvent remplacer les champs correspondants de `page.json`, et les clés d’en-tête inconnues sont conservées comme métadonnées.

Markdown est converti en HTML, puis transmis au même analyseur de pages que les modèles PHP, Twig et Blade. Le contenu final est donc un balisage de bloc natif.

### Mises en page et fonctions d’aide pour les pages

Les collections peuvent inclure un fichier `layout.php`. Sur le site, Blockstudio enveloppe le contenu de page synchronisé avec cette mise en page.

```php title="pages/docs/layout.php"
<main class="docs-layout">
  <aside>
    <?php foreach (blockstudio_page_tree('docs') as $item) : ?>
      <a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
        <?php echo esc_html($item['title']); ?>
      </a>
    <?php endforeach; ?>
  </aside>

  <article>
    <?php echo blockstudio_page_content(); ?>
  </article>
</main>
```

Les nouvelles fonctions d’aide exposent la collection sous forme de données structurées :

```php
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
```

Vous disposez ainsi des éléments nécessaires pour créer une structure complète de documentation : une navigation issue de l’arborescence des pages, des métadonnées de page provenant des métadonnées d’en-tête et le contenu synchronisé des blocs WordPress comme contenu principal.

### Chargeurs et Markdown brut

Les collections peuvent inclure un fichier local `loader.php` de confiance. Celui-ci peut renvoyer directement des pages ou indiquer à Blockstudio d’explorer d’autres répertoires locaux.

```php title="pages/docs/loader.php"
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];
```

C’est utile lorsque la source est déjà générée ailleurs : un dossier de documentation de paquet, un export Markdown ou une étape de compilation qui renvoie une liste de pages.

Les sources de pages Markdown peuvent également fournir leur source Markdown brute. Demandez la page avec le suffixe `.md` ou envoyez `Accept: text/markdown`. Les métadonnées d’en-tête sont retirées de la réponse, afin que les outils reçoivent le corps lisible du document. Cela fonctionne aussi pour les types de publication des collections, y compris les URL telles que `/docs.md` et `/docs/getting-started.md`.

[Lire la documentation Pages](https://blockstudio.dev/fr/docs/pages-and-patterns/pages/)

## Content Sync

La version 7.4 introduit également Content Sync, un workflow WP-CLI pour les équipes qui souhaitent représenter davantage d’éléments de leur projet WordPress sous forme de fichiers.

```bash
wp bs content pull
wp bs content push --dry-run
wp bs content status
```

Blockstudio conserve déjà dans votre projet les blocs, les champs, les modèles, les compositions et les pages basées sur des fichiers. Content Sync ajoute du contenu sélectionné de la base de données à ce workflow privilégiant les fichiers : les publications, les termes, les relations et les métadonnées déclarés comme autorisés peuvent être extraits vers des fichiers, examinés dans git et transférés vers un autre environnement.

La configuration est volontairement explicite. Activez-la dans `blockstudio.json`, autorisez les types de publication et les taxonomies à gérer, puis déclarez les références de métadonnées à réécrire d’un environnement à l’autre.

Lors de l’extraction, Blockstudio écrit dans des fichiers du thème les publications, termes, relations et métadonnées autorisés, sous une forme portable. Lors de l’importation, il valide le plan avant l’écriture et résout les références déclarées `post`, `term` et `attachment` en identifiants de base de données locaux. Il ne suppose pas que des entiers arbitraires sont des identifiants.

Le périmètre de la version 7.4 est volontairement restreint : publications, termes, relations entre termes, métadonnées autorisées, UID portables, manifestes de pièces jointes, simulations, gestion de l’élagage, entités verrouillées et rapports d’état. La capture des définitions de taxonomie, la copie des fichiers binaires des médias et la réécriture des identifiants dans le balisage de bloc sont délibérément exclues de cette première version.

Les équipes disposent ainsi d’un moyen clair de versionner du contenu sélectionné, comme les membres d’une équipe, les études de cas, les lieux, les entrées de documentation ou d’autres enregistrements structurés, sans transformer toute la base de données de production en migration. Cette approche vise les ensembles de contenu qui restent faciles à examiner sous forme de fichiers : des dizaines ou des centaines d’entrées, et, pour certains projets, quelques milliers lorsque le contenu est structuré et change peu. Elle ne remplace pas les sauvegardes de base de données, la synchronisation du commerce en ligne ou des commandes, les analyses, les journaux, les soumissions de formulaires ni les autres données à fort volume.

[Lire la documentation Content Sync](https://blockstudio.dev/fr/docs/content-sync/)

### Synchronisation plus fiable

Blockstudio détecte désormais les changements dans les sources de pages, les manifestes de collection, les fichiers de chargeur et de mise en page, les métadonnées et les chemins associés. Si l’un de ces éléments change, la page WordPress synchronisée est mise à jour.

Le pipeline de pages gère également les détails qui rendent les documentations basées sur des fichiers pratiques dans de vrais projets :

- Les sources de pages Markdown sont synchronisées en contenu de bloc natif, attributs de bloc compris
- Les métadonnées d’en-tête sont accessibles aux fonctions d’aide et aux mises en page du site
- Les pages des collections conservent une identité stable lors des synchronisations
- Les pages imbriquées hors collection sont liées à leur page parente
- Les pages imbriquées hors collection peuvent hériter de l’élément `layout.php` le plus proche dans l’arborescence
- La suppression des sources d’une collection supprime les pages WordPress générées correspondantes
- Le passage d’une collection de `page` à un type de publication personnalisé migre les publications déjà synchronisées au lieu de créer des doublons
- L’ordre des pages est conservé via `menu_order`

## Préfixes de balises de bloc

Les balises de bloc prennent désormais en charge des préfixes d’espace de noms configurables. Un projet peut enregistrer un préfixe court et demander à Blockstudio de résoudre le bloc dans un ou plusieurs espaces de noms :

```php
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});
```

Une fois cette configuration en place, `<theme-card>` peut être résolu en `theme-components/card`, `<theme-button>` peut utiliser `bsui/button` comme solution de repli, et `<theme-ui-feature-matrix>` peut être résolu en `theme-components/ui-feature-matrix`.

Les `tag_aliases` explicites restent prioritaires lorsqu’un projet a besoin d’une substitution ponctuelle. Les balises à préfixe inconnu restent inchangées, et les filtres existants d’autorisation et de refus des balises de bloc s’appliquent toujours aux blocs résolus à partir d’un préfixe.

[Lire la documentation sur les balises de bloc](https://blockstudio.dev/fr/docs/blocks/rendering/#prefix-shorthands)

## Correctifs d’exécution et d’éditeur

La version 7.4 comprend également plusieurs correctifs issus de l’utilisation de vrais projets.

- Les options alimentées par des requêtes dynamiques restent à jour lorsque les publications, les termes, les utilisateurs ou les métadonnées associées changent, et les champs de sélection de requête `populate.fetch: true` récupèrent les options en direct lorsque les recherches de l’éditeur sont vides.
- Les balises de bloc `core/query` et `core/comments` générées par programmation conservent `className` dans le balisage d’enveloppe produit.
- Les pseudo-composants de modèle préservent les propriétés en casse mixte, de sorte que des propriétés telles que `allowedFormats` et `withoutInteractiveFormatting` parviennent au composant de l’éditeur au lieu d’être supprimées auparavant.
- `bsui/select` gère plus fiablement les données d’options et les menus qui débordent, surtout dans les contrôles d’éditeur plus denses.
- `blockstudio/phpstan` reconnaît les champs déclarés dans des conteneurs `tabs`, afin que la validation des modèles, de Twig/Blade et des balises de bloc interprète la même structure de champs que celle utilisée par Blockstudio dans les projets.
- La suppression d’une ligne de répéteur contenant RichText est conservée après l’enregistrement. Les anciennes valeurs RichText ne peuvent plus rétablir la ligne supprimée.

## Pourquoi cette version est importante

Le thème de la version 7.4 est la portabilité.

Les collections de pages transforment des sites de documentation entiers en dossiers de fichiers source. Les pages Markdown rendent ce contenu facile à rédiger et à récupérer. Content Sync étend le même modèle privilégiant les fichiers au contenu sélectionné de la base de données, afin que les publications, les termes et les relations puissent être stockés dans git et transférés entre environnements. Les préfixes de balises de bloc rendent les grandes bibliothèques de blocs plus lisibles dans les modèles.

Blockstudio reste basé sur des fichiers. Les blocs restent des dossiers. Les pages restent des fichiers. La version 7.4 permet simplement de stocker davantage d’éléments d’un projet — ses structures de pages et son contenu sélectionné — dans ces fichiers et de les transférer avec eux.
