Aller au contenu

Dennis · 21 juin 2026

Blockstudio 7.4

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 :

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
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 :

Markdown
---
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
<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
<?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

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.

Shell
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

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

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.