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.jsonpeut 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.mdpeut servir de contenu de page, avecpage.jsonou seul avec des métadonnées d’en-tête. - Mises en page pour les pages du site :
layout.phppeut envelopper le contenu de page synchronisé et utiliser des fonctions d’aide telles queblockstudio_page_tree()etblockstudio_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
.mdou viaAccept: 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 pushetwp bs content statusrendent 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/selectfonctionne 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 :
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"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 :
---
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.
<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 :
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
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.
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.
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.phple 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 :
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: truerécupèrent les options en direct lorsque les recherches de l’éditeur sont vides. - Les balises de bloc
core/queryetcore/commentsgénérées par programmation conserventclassNamedans 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
allowedFormatsetwithoutInteractiveFormattingparviennent au composant de l’éditeur au lieu d’être supprimées auparavant. bsui/selectgère plus fiablement les données d’options et les menus qui débordent, surtout dans les contrôles d’éditeur plus denses.blockstudio/phpstanreconnaît les champs déclarés dans des conteneurstabs, 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.