Compositions de blocs (Block Patterns)

Définition : Une composition de blocs est un agencement prédéfini de blocs réutilisables, disponible lors de l’édition. Elle accélère la création de sections cohérentes sans imposer un nouveau type de bloc.

Comprendre et utiliser

À quoi cela sert ?

L’auteur insère une structure prête à compléter, telle qu’une section d’appel à l’action ou une présentation de service. La plupart des blocs insérés restent éditables individuellement.

Comment cela fonctionne ?

Un pattern peut être déclaré dans un thème ou enregistré avec register_block_pattern(). Son contenu est une sérialisation de blocs préconfigurés.

Dans quel contexte l’utiliser ?

À utiliser lorsque l’objectif est de réutiliser une mise en page composée de blocs existants, plutôt que d’implémenter un comportement logiciel nouveau.

Cas concret : ATOOLPHA

ATOOLPHA souhaite proposer une section « Pour aller plus loin » avec un titre, un paragraphe et un bouton déjà structurés.

Exemple de code commenté

Extrait documentaire : le contexte WordPress du plugin/éditeur et les dépendances décrites sont nécessaires ; ne pas coller dans le contenu d’une page.

<?php
add_action( 'init', function () {
    register_block_pattern( 'atoolpha/learn-more', array(
        'title' => __( 'Pour aller plus loin', 'atoolpha' ),
        'content' => '<!-- wp:paragraph --><p>À approfondir</p><!-- /wp:paragraph -->',
    ) );
} );

Décryptage de l’exemple

Le pattern enregistre un nom d’espace propre à ATOOLPHA et une structure éditoriale simple. Un ensemble complexe contiendrait plusieurs délimiteurs de blocs imbriqués correctement sérialisés.

Résultat attendu

Après registration, l’auteur peut insérer ce modèle puis remplacer les textes sur la page concernée.

Atelier pratique de vérification

Enregistrer une composition contenant plusieurs blocs, l’insérer dans deux pages brouillon et modifier une seule instance. Comparer les contenus sauvegardés pour confirmer l’indépendance dans le cas du pattern non synchronisé. Tester ensuite une composition synchronisée si l’environnement le permet, sans confondre les comportements.

Précautions et limites

La composition n’implique pas nécessairement une synchronisation globale des copies insérées. Vérifier la différence entre pattern ordinaire et pattern synchronisé selon le besoin.

Contrôle avant intégration dans un plugin

Documenter si la composition est synchronisée ou non, ainsi que les conditions de modification des instances. Tester que les mises à jour du modèle ne changent pas involontairement des pages déjà personnalisées.

À ne pas confondre

Un pattern est un assemblage de blocs ; une variation est une configuration initiale d’un type ; un template définit une structure à l’échelle du contenu ou du site.

Diagnostic et dépannage avancés

Lorsqu’un pattern inséré apparaît mal structuré, inspecter la sérialisation des délimiteurs et tester l’insertion sur une publication de démonstration.