Bloc WordPress

Définition : Un bloc WordPress est une unité de contenu identifiable, avec un nom, des attributs et un comportement de rendu. Il peut afficher du texte, une image ou une fonctionnalité dynamique.

Comprendre et utiliser

À quoi cela sert ?

Le bloc fournit une brique éditoriale indépendante : l’utilisateur ajoute, configure, déplace ou réutilise cette brique au lieu d’éditer directement un document HTML complexe.

Comment cela fonctionne ?

Un type de bloc est enregistré avec un nom unique. Chaque instance placée dans le contenu possède ses propres attributs et peut contenir des blocs enfants. L’éditeur et le serveur coopèrent pour produire le rendu.

Dans quel contexte l’utiliser ?

Un bloc personnalisé est pertinent lorsqu’une présentation ou un contrôle doit être répété sur plusieurs pages. Pour une simple combinaison de blocs existants, une composition peut être suffisante.

Cas concret : ATOOLPHA

Un bloc ATOOLPHA « Fait technique » pourrait stocker le libellé et la précision affichée, sans imposer une mise en page figée au rédacteur.

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.

{"apiVersion":3,"name":"atoolpha/technical-fact","title":"Fait technique","category":"text","attributes":{"label":{"type":"string","default":""}}}

Décryptage de l’exemple

Le nom distingue le bloc des types natifs core/*. L’attribut label représente une donnée modifiable propre à chaque instance. Ce JSON représente uniquement la déclaration, pas un bloc complet à lui seul.

Résultat attendu

Après création des composants et enregistrement côté serveur/client, le bloc devient identifiable par l’éditeur et ses attributs peuvent être conservés avec son contenu.

Atelier pratique de vérification

Créer une fiche temporaire avec deux instances d’un même type de bloc. Modifier seulement la première, enregistrer, puis comparer leurs attributs. Expliquer pourquoi le comportement général du type est partagé alors que les valeurs des instances restent indépendantes. Refaire le test après désactivation contrôlée de l’extension sur une copie locale.

Précautions et limites

Un fichier block.json n’exécute aucune logique à lui seul. Prévoir également les fichiers de rendu ou d’édition, leurs scripts enregistrés et les textes traduisibles.

Contrôle avant intégration dans un plugin

Documenter les attributs conservés et tester deux instances sur la même page. Lors d’une désactivation temporaire, vérifier que l’information essentielle demeure compréhensible et qu’aucune donnée persistante n’est supprimée involontairement.

À ne pas confondre

Type de bloc : définition générale ; instance de bloc : occurrence précise insérée sur une page ; composition : assemblage de plusieurs blocs.

Diagnostic et dépannage avancés

Si le bloc n’apparaît pas dans l’inserteur, vérifier sa double registration, ses dépendances d’assets, ses permissions éventuelles et les erreurs de console.