Bloc statique

Définition : Un bloc statique conserve dans la publication le HTML calculé lors de la sauvegarde. Ce contenu reste consultable sans recalcul serveur spécifique, sous réserve du rendu normal du thème.

Comprendre et utiliser

À quoi cela sert ?

Il convient aux informations éditoriales stables : encadrés, citations ou libellés dont le résultat doit rester identique tant que l’auteur ne les modifie pas.

Comment cela fonctionne ?

La fonction save sérialise le HTML dans post_content. Lors d’une réédition, WordPress compare la sortie de la version actuelle du bloc avec le contenu conservé.

Dans quel contexte l’utiliser ?

Choisir un bloc statique quand les données nécessaires sont présentes dans ses attributs et ne nécessitent pas d’interrogation d’une source fluctuante.

Cas concret : ATOOLPHA

Pour ATOOLPHA, une mention « Attention : vérifiez les permissions » doit garder le même contenu après sauvegarde, même lorsque la base documentaire évolue.

Exemple de sérialisation commenté

Exemple de sérialisation HTML : ne pas l’insérer tel quel dans une page publique.

<!-- wp:paragraph -->
<p>Vérifiez les permissions avant modification.</p>
<!-- /wp:paragraph -->

Décryptage de l’exemple

Cet exemple représente la sérialisation d’un bloc Paragraphe. Le contenu HTML se trouve dans la publication, entouré de délimiteurs reconnaissables par l’analyseur de blocs.

Résultat attendu

La phrase continue de figurer dans le contenu enregistré, et sa modification passe par l’éditeur ou une opération de mise à jour du post.

Atelier pratique de vérification

Enregistrer un bloc statique contenant une phrase courte. Désactiver le plugin sur une copie du site, sans supprimer la publication, puis contrôler ce qui reste dans post_content et l’affichage public. Réactiver le plugin et vérifier l’absence d’erreur de validation.

Précautions et limites

Un changement de balisage effectué dans save peut invalider les blocs déjà présents. Préparer des migrations de dépréciation lorsqu’une transformation du HTML est nécessaire.

Contrôle avant intégration dans un plugin

Comparer plusieurs articles historiques avant et après mise à jour du plugin. Le HTML enregistré doit rester pertinent, sans supposer que les styles ou les options propres à une extension désactivée soient encore disponibles.

À ne pas confondre

Un bloc dynamique produit sa sortie serveur au moment du rendu ; un bloc statique enregistre surtout sa sortie finale en HTML.

Diagnostic et dépannage avancés

Si un bloc est déclaré invalide après mise à jour, reproduire le cas avec un ancien article pour déterminer si la nouvelle fonction save est compatible.