
Blockstudio 7 est là. C’est la plus grande version de l’histoire du projet : une réécriture complète du code, depuis les fondations. Chaque classe, chaque hook et chaque ligne de code ont été reconstruits de zéro, avec pour objectifs les standards modernes PHP, les pratiques de programmation WordPress et une maintenabilité à long terme.

Mais il ne s’agit pas seulement d’une refonte. Blockstudio 7 apporte des fonctionnalités majeures, comme les pages et les compositions basées sur des fichiers, un système de stockage des métadonnées d’articles, l’intégration de SEO et un nouvel analyseur HTML vers blocs qui fait fonctionner l’ensemble. De plus, Blockstudio est désormais entièrement gratuit et open source.

Découvrons toutes les nouveautés.

## Gratuit et open source

Je travaille sur Blockstudio depuis 2020 et j’ai publié des dizaines de versions au fil des ans. Les personnes qui l’utilisaient l’appréciaient, mais trouver un marché pour un framework de blocs WordPress commercial a toujours été difficile.

Ce qui a changé la donne, ce sont les LLM. Les assistants de programmation IA savent désormais assez bien écrire du code de blocs, mais ils ont besoin de structures claires basées sur des fichiers. Le balisage de blocs WordPress est désordonné : des commentaires HTML sérialisés avec des attributs JSON intégrés, mêlés à une structure DOM. C’est difficile à maîtriser pour les humains, et encore plus pour les LLM.

L’approche privilégiant les fichiers de Blockstudio a toujours eu pour but de simplifier les choses : un `block.json` et un modèle PHP dans un dossier. Pas d’entrées en base de données, pas de React, pas d’étape de compilation. Avec v7, cette philosophie va encore plus loin. L’analyseur HTML vers blocs vous permet d’écrire du HTML simple, qui est automatiquement converti en balisage de blocs valide. Tout reste dans le système de fichiers. Les seules écritures en base de données sont les synchronisations de pages demandées explicitement via PHP API ou CLI, et elles sont pilotées par des modèles de fichiers.

Faire de Blockstudio un projet open source est la suite naturelle. Plus les LLM s’entraînent sur du code Blockstudio, mieux ils savent en générer. Une base de code ouverte, une documentation ouverte et un [fichier de contexte IA](https://blockstudio.dev/fr/docs/dev/ai/) prêt à l’emploi que n’importe quel outil peut exploiter : voilà comment créer le meilleur environnement pour le développement WordPress assisté par IA.

Le plugin complet est disponible sur [GitHub](https://github.com/inline0/blockstudio) pour que chacun puisse l’utiliser, le forker et y contribuer. Pas de clés de licence, pas de péages, aucune fonctionnalité verrouillée.

## Nouvelles fonctionnalités

### Pages basées sur des fichiers

C’est l’un des ajouts majeurs de la version 7.0. Vous pouvez désormais définir des pages WordPress entières sous forme de modèles de fichiers, qui se synchronisent avec la base de données sous forme de contenu de blocs natif lorsque vous lancez la API ou CLI de synchronisation des pages.

Créez un dossier avec un `page.json` et un fichier modèle :

```json title="page.json"
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
```

```php title="index.php"
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>
```

Exécutez `wp bs pages sync` pour que Blockstudio analyse le HTML en blocs WordPress et crée ou mette à jour la page dans la base de données.

#### Fusion des blocs par clé

Lors de la synchronisation des modèles, les modifications des utilisateurs seraient normalement écrasées. L’attribut `key` permet de les préserver d’une synchronisation à l’autre :

```html title="index.php"
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
```

Les blocs dont les clés correspondent conservent leur contenu modifié par l’utilisateur lors de la mise à jour du modèle. Les blocs sans clé sont entièrement remplacés.

#### Liaisons de blocs

Au lieu d’utiliser des clés, vous pouvez utiliser les [liaisons de blocsAPI](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) du cœur de WordPress pour relier directement les blocs aux métadonnées d’articles. Il ne s’agit pas d’une fonctionnalité Blockstudio, mais d’une API native de WordPress API. Blockstudio transmet simplement l’attribut `metadata` au balisage de bloc généré. Le contenu est stocké dans les métadonnées plutôt que dans le balisage des blocs, de sorte que la synchronisation des modèles ne détruit jamais les modifications des utilisateurs. Les données peuvent aussi être interrogées via `WP_Query` et sont accessibles dans REST API.

```html title="index.php"
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>
```

Les deux approches peuvent être utilisées dans le même modèle.

#### Contrôles de modification

Les pages prennent en charge `blockEditingMode` et `templateLock` pour contrôler ce que les utilisateurs peuvent modifier :

```json title="page.json"
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}
```

Cette option verrouille la structure de la page tout en permettant aux utilisateurs de modifier le texte et les médias. Les éléments individuels peuvent remplacer le réglage de la page à l’aide d’un attribut `blockEditingMode` dans le modèle.

#### Association à des identifiants d’articles

Utilisez `postId` pour associer un modèle de page à un article WordPress existant, afin d’éviter les doublons et de garantir que le modèle met toujours à jour le bon article :

```json title="page.json"
{
  "name": "home",
  "title": "Home",
  "postId": 2
}
```

Pour tous les détails, consultez la [documentation sur les pages](https://blockstudio.dev/fr/docs/pages-and-patterns/pages/).

### Compositions basées sur des fichiers

Comme pour les pages, vous pouvez désormais définir des compositions de blocs sous forme de modèles de fichiers. Écrivez votre composition en HTML, et Blockstudio l’analyse en balisage de blocs et l’enregistre comme composition de blocs native WordPress. Elle apparaît dans l’inséreur de blocs et les utilisateurs peuvent la placer où ils le souhaitent.

```json title="pattern.json"
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
```

```html title="index.php"
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>
```

Contrairement aux pages, les compositions ne créent pas d’entrées en base de données. Elles sont enregistrées en mémoire à chaque chargement de page. Consultez la [documentation sur les compositions](https://blockstudio.dev/fr/docs/pages-and-patterns/patterns/).

### Analyseur HTML vers blocs

Les pages et les compositions reposent sur un nouvel analyseur HTML qui convertit les modèles HTML standard en balisage de blocs WordPress. Il gère automatiquement les blocs conteneurs (comme les groupes et les colonnes) et les blocs feuilles (comme les paragraphes et les titres). L’analyseur utilise une architecture de rendu fondée sur des traits, facile à étendre pour prendre en charge d’autres types de blocs via le filtre `blockstudio/parser/renderers` :

```php title="functions.php"
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
    $renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
        $content = $parser->get_inner_html( $element );
        $html    = '<div class="acme-hero">' . $content . '</div>';

        return array(
            'blockName'    => 'acme/hero',
            'attrs'        => $attrs,
            'innerBlocks'  => array(),
            'innerHTML'    => $html,
            'innerContent' => array( $html ),
        );
    };

    return $renderers;
}, 10, 2 );
```

Une fois le bloc enregistré, vous pouvez l’utiliser dans n’importe quel modèle de page ou de composition :

```html title="index.php"
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>
```

### Stockage

Les champs peuvent désormais stocker leurs valeurs dans les métadonnées d’articles ou les options du site, en plus des attributs de bloc. C’est une nouveauté majeure :

```json title="block.json"
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}
```

Avec les valeurs stockées dans les métadonnées d’articles, vous pouvez :

- Interroger les articles selon les valeurs des champs à l’aide de `WP_Query` et `meta_query`
- Accéder aux données des champs via REST API pour les configurations sans interface
- Partager les données avec d’autres plugins, comme les outils SEO et les couches de cache

Vous pouvez également stocker des valeurs dans la table des options pour les paramètres globaux à l’échelle du site :

```json title="block.json"
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}
```

Consultez la [documentation sur le stockage](https://blockstudio.dev/fr/docs/blocks/storage/) pour tout savoir sur API.

### Champs personnalisés

Les définitions de champs réutilisables peuvent désormais être partagées entre plusieurs blocs. Définissez un ensemble de champs une seule fois, puis utilisez-le dans n’importe quel bloc. Vous évitez ainsi les répétitions lorsque plusieurs blocs partagent la même structure de champs.

Créez un `field.json` dans votre répertoire blockstudio :

```json title="fields/hero/field.json"
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}
```

Utilisez ensuite le préfixe `custom/` pour y faire référence depuis n’importe quel bloc :

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}
```

La propriété `idStructure` préfixe l’identifiant de chaque champ. Ainsi, `heading` devient `hero_heading`. Vous pouvez également remplacer certaines propriétés de champ pour chaque instance avec la clé `overrides`.

Consultez la [documentation sur les champs personnalisés](https://blockstudio.dev/fr/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

La prise en charge de Tailwind a été entièrement reconstruite pour v4. Au lieu de compiler côté client via CDN et d’enregistrer les fichiers sur le disque à l’enregistrement de l’article (l’approche v6), Blockstudio 7 compile Tailwind côté serveur à chaque requête frontend via [TailwindPHP](https://github.com/dnnsjsk/tailwindphp). Aucun Node.js, aucun CLI et aucune étape de compilation ne sont nécessaires.

La compilation utilise une mise en cache fondée sur les candidats : Blockstudio extrait tous les noms de classes CSS du HTML final, les trie et les hache avec votre configuration CSS, puis recherche un fichier en cache. Les mêmes classes produisent un cache identique, même si le HTML environnant change (nonces, horodatages, contenu dynamique).

La configuration utilise la syntaxe privilégiant CSS de Tailwind v4. Définissez des thèmes personnalisés et des classes utilitaires directement dans votre `blockstudio.json` ou via le filtre `blockstudio/tailwind/css` :

```php title="functions.php"
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});
```

Dans l’éditeur de blocs, un script Tailwind CDN intégré affiche un aperçu en direct pendant la saisie. Le type de champ `classes` propose la saisie semi-automatique pour toutes les classes utilitaires Tailwind. Le frontend utilise toujours le CSS compilé côté serveur, injecté sous forme de balise de style inline avant `</head>`.

Consultez la [documentation Tailwind](https://blockstudio.dev/fr/docs/tailwind/) pour la configuration complète.

### Interactivité API

Blockstudio prend désormais en charge l’[API d’interactivité WordPressAPI](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/). Activez-la dans votre block.json :

```json title="block.json"
{
  "blockstudio": {
    "interactivity": true
  }
}
```

Ajoutez des directives `data-wp-*` à votre modèle :

```php title="index.php"
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>
```

Puis créez un `script.js` avec la logique de votre magasin :

```javascript title="script.js"
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});
```

Blockstudio gère l’importmap, le chargement des modules et le traitement des directives à la fois sur le frontend et dans l’éditeur de blocs. Les blocs qui utilisent uniquement des directives déclaratives avec `data-wp-context` (comme `data-wp-bind--hidden` ou `data-wp-text`) fonctionnent sans aucun JavaScript. L’état côté serveur via `wp_interactivity_state()` est également pris en charge sur le frontend.

Consultez la [documentation sur l’interactivité](https://blockstudio.dev/fr/docs/blocks/interactivity/) pour la configuration complète.

### Analyse de contenu SEO

Les blocs Blockstudio sont dynamiques : par défaut, leur contenu de champ est donc invisible pour les plugins SEO. Blockstudio 7 corrige cela grâce à des intégrations automatiques avec Yoast SEO, Rank Math et SEOPress. Les valeurs textuelles des champs `text`, `textarea`, `richtext`, `wysiwyg` et `link` (y compris les lignes imbriquées des répéteurs) sont extraites et transmises à l’analyse de contenu de chaque plugin. Les plugins SEO peuvent ainsi analyser correctement le contenu de vos blocs : densité des mots-clés, lisibilité et autres mesures. Aucune configuration nécessaire.

### Lignes par défaut des répéteurs

Les champs répéteurs prennent désormais en charge une propriété `default` contenant un tableau de lignes préremplies. Lorsqu’un bloc est inséré, le répéteur est rempli avec les lignes et les valeurs spécifiées, dans l’éditeur comme sur le frontend :

```json title="block.json"
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "default": [
    { "title": "Fast", "icon": "bolt" },
    { "title": "Secure", "icon": "shield" }
  ],
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    { "id": "icon", "type": "text", "label": "Icon" }
  ]
}
```

La propriété `min` fonctionne également avec les valeurs par défaut des champs : si un répéteur possède `min: 3` et que ses champs internes ont des valeurs `default`, les lignes générées automatiquement sont préremplies avec ces valeurs au lieu de rester vides.

## Améliorations et corrections

- **`min` du répéteur avec des valeurs par défaut de champ** : les lignes minimales générées automatiquement utilisent désormais les valeurs par défaut des champs, à la fois sur le frontend et dans l’éditeur
- **Styles de l’éditeur Tailwind** : le Tailwind CSS compilé est désormais injecté dans l’iframe de l’éditeur de blocs avec CDN, afin que les règles personnalisées `@apply` et la configuration du thème fonctionnent dans l’éditeur
- **[Fichier de contexte IA](https://blockstudio.dev/fr/docs/dev/ai/)** : le `blockstudio-llm.txt` a été reconstruit sous forme de fichier statique, assemblé à partir de la documentation complète v7 et de schémas JSON dédupliqués (environ 48k tokens), remplaçant la génération dynamique à partir de v6
- **Fenêtre détachée du champ de code** : le champ de code peut désormais s’ouvrir dans une fenêtre séparée, avec des annulations/rétablissements indépendants et la coloration syntaxique JavaScript
- **Compilation côté serveur Tailwind v4** : consultez la section [Tailwind](#tailwind-css-v4) ci-dessus
- **Version 3 de API** : les blocs s’affichent désormais correctement dans l’éditeur en iframe, y compris l’éditeur de site et les aperçus adaptatifs
- **Notation par points pour les ressources** : convention de nommage plus claire pour les suffixes de ressources (`*.inline.css`, `*.editor.js`, `*.scoped.css`)
- Correction d’un avertissement `bs_render_block()` de `WP_Block_Supports` lors de l’utilisation de `useBlockProps`
- Correction des champs conditionnels qui ne respectaient pas les valeurs par défaut au premier chargement
- Correction des signes dollar supprimés du contenu `<RichText />` sur le frontend
- Correction de la fonctionnalité `populate` pour prendre en charge les taxonomies enregistrées par d’autres plugins
- Correction d’une erreur null `optionsPopulate` dans les contextes WPML

## Sous le capot

### Réécriture complète

Il ne s’agit ni d’une refonte ni d’un simple nettoyage. Chaque classe a été réécrite de zéro. Le résultat : une base de code plus propre et modulaire, plus facile à maintenir et à étendre.

### PHP moderne

Blockstudio 7 nécessite PHP 8.2+ et utilise des déclarations de types modernes dans tout le code.

## Changements incompatibles

Cette mise à jour majeure vers la version 7.0 comprend plusieurs changements incompatibles. La plupart disposent de solutions de repli compatibles avec les versions précédentes, mais vous devriez les examiner avant la mise à niveau. Pour le guide de migration complet, consultez la [documentation de migration v7](https://blockstudio.dev/fr/docs/dev/migration/v7/).

### Les noms des hooks sont désormais en snake_case

Tous les hooks PHP ont été renommés de camelCase en snake_case, conformément aux conventions du cœur WordPress :

```php title="functions.php"
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
    return ['my-stylesheet'];
});

// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
    return ['my-stylesheet'];
});
```

Les anciens noms en camelCase fonctionnent toujours, mais nous vous recommandons de les mettre à jour.

### Le champ interrupteur est désactivé par défaut

La propriété `switch` est désormais définie sur `false` par défaut au lieu de `true`. Dans v6, chaque champ avait sur son bord gauche un interrupteur invisible, activé par défaut. Dans v7, l’interrupteur est facultatif et représenté par une icône d’œil visible dans le libellé du champ. Si vous vous appuyiez sur le comportement activé par défaut, ajoutez `"switch": true` à vos définitions de champs.

### Les noms des fichiers de ressources utilisent la notation par points

Les suffixes des ressources utilisent désormais des points au lieu de tirets (`style.inline.css` au lieu de `style-inline.css`). L’ancienne notation avec tirets fonctionne toujours, mais la notation par points est désormais recommandée.

### Préfixe d’importation npm

Les imports de modules ES utilisent désormais `npm:` au lieu de `blockstudio/` :

```javascript title="script.js"
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
```

Le préfixe `blockstudio/` reste pris en charge pour assurer la rétrocompatibilité.

### Fonctionnalités supprimées

**Zone d’administration et éditeur de code.** La page de réglages d’administration WordPress et l’éditeur de code de blocs intégré ont tous deux été supprimés. Toute la configuration passe désormais par les filtres `blockstudio.json` et PHP, ce qui permet de conserver votre configuration dans le contrôle de version avec vos blocs.

L’éditeur de code était utile dans les anciennes versions pour prévisualiser les blocs, mais il n’a jamais atteint le niveau d’un véritable environnement de développement. Au fil des années, plusieurs fonctionnalités du plugin ont été limitées, car elles ne pouvaient pas être prises en charge dans l’éditeur autonome. Il n’aurait pas non plus pu remplacer un IDE complet. Sa suppression permet au plugin de se consacrer entièrement au développement basé sur des fichiers, sans compromis.

**Clé de licence.** Elle n’est plus nécessaire. Blockstudio est gratuit et open source.

**Bibliothèque de blocs.** La bibliothèque intégrée « Blockstudio Elements » (Gallery, Slider, Image Comparison, Code, Icon) a été supprimée. Il s’agissait d’exemples de blocs prédéfinis fournis avec le plugin. Si vous les utilisiez, copiez les dossiers de blocs de v6 dans le répertoire blockstudio de votre thème.

## Premiers pas

Installez Blockstudio 7 et créez votre premier bloc en quelques minutes. Consultez le [guide de démarrage](https://blockstudio.dev/fr/docs/general/getting-started/) pour suivre les étapes, ou le [guide de migration v7](https://blockstudio.dev/fr/docs/dev/migration/v7/) si vous effectuez une mise à niveau depuis v6.

Le code source complet est disponible sur [GitHub](https://github.com/inline0/blockstudio). Les signalements de problèmes, les demandes de fusion et les commentaires sont les bienvenus.
