Nom de bloc (namespace/slug)

Définition : Le nom d’un bloc WordPress associe un espace de noms et un identifiant sous la forme namespace/slug. Cette identité unique évite les collisions entre blocs natifs et extensions.

Comprendre et utiliser

À quoi cela sert ?

Ce nom permet à l’éditeur et au serveur de retrouver la définition correspondante. Il intervient dans la sérialisation du contenu, les styles générés et les opérations de transformation.

Comment cela fonctionne ?

Un nom valide emploie notamment des minuscules, chiffres et tirets avec un seul séparateur /. Modifier ce nom après publication peut rendre les anciens contenus dépendants d’un type inexistant.

Dans quel contexte l’utiliser ?

Choisir un préfixe propre à l’éditeur du plugin pour chaque nouveau bloc, et conserver une stratégie de migration si le nom doit changer.

Cas concret : ATOOLPHA

Une extension ATOOLPHA enregistre atoolpha/definition-card, tandis que WordPress fournit core/paragraph : les deux noms restent distincts et prévisibles.

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/definition-card","title":"Carte de définition","category":"text"}

Décryptage de l’exemple

Le préfixe atoolpha désigne l’espace de noms et definition-card le slug. L’ensemble constitue l’identité technique, indépendamment du titre affiché aux rédacteurs.

Résultat attendu

Après registration, WordPress distingue le bloc ATOOLPHA des types core/* et des blocs appartenant à d’autres extensions.

Atelier pratique de vérification

Enregistrer deux blocs avec des espaces de noms distincts et vérifier leur présence dans le registre. Renommer uniquement le title de l’un des types, puis rouvrir un contenu existant. Simuler ensuite un changement du name sur une copie pour mesurer le risque de bloc introuvable.

Précautions et limites

Ne pas modifier l’identité d’un bloc en production seulement pour améliorer son intitulé. Le titre éditorial peut changer sans casser l’identité stockée dans les publications.

Contrôle avant intégration dans un plugin

Protéger les identités déjà publiées dans les articles. Lors d’un renommage, établir une correspondance explicite des anciens noms et vérifier les anciennes publications plutôt que de compter sur une conversion automatique.