Créez votre site WordPress avec Elementor.Découvrir Elementor Lien partenaire

LANGUES DE BLOGPASCHER

Langues de ce guide

Ouvrez une autre édition du guide ou consultez une archive.

Éditions de ce guide

Archives disponibles

Traductions prévues (32)
  • Englishanglais
  • Españolespagnol
  • Deutschallemand
  • Portuguêsportugais
  • Italianoitalien
  • Nederlandsnéerlandais
  • Polskipolonais
  • Українськаukrainien
  • Češtinatchèque
  • Slovenčinaslovaque
  • Hrvatskicroate
  • Românăroumain
  • Magyarhongrois
  • Ελληνικάgrec
  • Türkçeturc
  • العربيةarabe
  • עבריתhébreu
  • हिन्दीhindi
  • বাংলাbengali
  • ไทยthaï
  • Tiếng Việtvietnamien
  • Bahasa Indonesiaindonésien
  • 简体中文chinois simplifié
  • 日本語japonais
  • 한국어coréen
  • Danskdanois
  • Svenskasuédois
  • Norsknorvégien
  • Suomifinnois
  • Eestiestonien
  • Latviešuletton
  • Lietuviųlituanien

Apparence du site

Éditeur et contenus · Débutant à intermédiaire

Bloc non valide dans WordPress : récupérer le contenu sans perdre l’original

Réparez un bloc WordPress non valide : conservez l’original, comparez les conversions, retrouvez une révision ou migrez un bloc tiers sans nouvelle extension.

Publié le · Mis à jour le · Méthode éditoriale

Reconnaître le message et délimiter le problème

Dans l’éditeur, un encadré annonce qu’un bloc contient un contenu inattendu ou non valide. Le texte ou l’image reste parfois visible sur le site public, tandis que ce bloc devient difficile à modifier. Le résultat recherché n’est pas seulement de fermer l’avertissement : il faut retrouver un contenu complet, modifiable et correctement enregistré.

Pour certains blocs, WordPress compare la structure enregistrée avec celle que le bloc sait produire. Une différence peut déclencher cette validation : modification manuelle du HTML, collage inhabituel ou changement du composant qui fournit le bloc. Le HTML est le balisage qui décrit les éléments d’une page. Ce message ne démontre pas, à lui seul, que la base de données est corrompue.

Ne confondez pas cette situation avec une réponse JSON non valide lors de l’enregistrement. Cette autre erreur concerne l’échange avec le serveur. Si elle apparaît également, conservez votre travail et faites traiter ce second problème séparément. Un bloc indiqué comme indisponible, un verrouillage et une erreur de fonctionnement JavaScript demandent eux aussi un diagnostic distinct.

Conserver une copie avant de tenter la récupération

Prérequis : gardez accès au document original et préparez un fichier texte local ainsi qu’un brouillon distinct. Cette copie protège le contenu pendant les essais ; elle ne remplace pas une sauvegarde du site.

  1. Laissez l’onglet original ouvert. Dans le menu général de l’éditeur, recherchez la commande de copie de tout le contenu, puis collez le résultat dans le fichier local. Vérifiez le début, la fin et la partie affectée avant de considérer la copie comme exploitable.
  2. Si la copie globale échoue, sélectionnez le bloc concerné et cherchez Copier dans son menu à trois points. Conservez séparément les textes accessibles, les adresses des médias et une capture de la disposition. Une capture aide à reconstruire l’apparence, mais ne conserve ni les réglages interactifs ni la structure des blocs.
  3. Dans Articles ou Pages, utilisez Ajouter pour créer un brouillon de travail. Collez-y le contenu et vérifiez qu’il s’agit bien de ce nouveau document avant un essai. Ne le publiez pas : les visiteurs doivent continuer à consulter la version originale. Les médias et les composants restent partagés avec le site.
  4. Gardez le fichier initial sans le remplacer par le résultat d’une conversion. Nommez séparément les versions d’essai. Vous devez pouvoir revenir au texte de départ même si le brouillon devient inutilisable ; aucun retour arrière dans l’éditeur ne doit être votre seule protection.
  5. Avant une mise à jour d’extension ou une intervention plus large, faites confirmer la sauvegarde de la base et des fichiers ainsi que la procédure de restauration. Si cette protection manque, arrêtez les modifications de composants : la copie du texte ne remettrait pas une extension ou une configuration en état.

Vérifier les accès et la portée du bloc

Il faut pouvoir modifier le contenu concerné ; les opérations sur les extensions nécessitent d’autres droits. Notez la version de WordPress, le thème, le nom du bloc et le changement ayant précédé l’erreur. Indiquez aussi si vous utilisez WordPress autohébergé, WordPress.com ou un réseau multisite. Les accès à l’hébergement et les menus disponibles ne sont pas interchangeables.

Ouvrez la Vue en liste depuis l’aperçu du document, en haut de l’éditeur. Dépliez le groupe qui contient le bloc et repérez son emplacement exact. Sélectionner le groupe entier au lieu d’un paragraphe peut entraîner une conversion beaucoup plus large que prévu.

Vérifiez enfin si ce contenu appartient à une composition synchronisée, anciennement appelée bloc réutilisable. Modifier son original peut affecter toutes ses utilisations. Copier une page ne supprime pas nécessairement cette relation. Pour un essai local, utilisez le détachement lorsqu’il est proposé et que vous êtes autorisé à le faire ; sinon, demandez l’intervention du responsable avant de poursuivre.

Choisir entre les trois approches

Commencez par la récupération ciblée si un bloc isolé affiche le message après une modification de son contenu. L’objectif est de comparer une correction limitée avec votre copie, sans toucher au reste du document.

Choisissez les révisions si vous savez qu’une version correcte a déjà été enregistrée et souhaitez retrouver ce contenu. Cette démarche est particulièrement utile lorsque la récupération retire des éléments importants. Elle ne répare pas automatiquement un composant devenu incompatible.

Passez au diagnostic du bloc tiers si plusieurs anciens contenus se dégradent après une mise à jour, ou si le bloc dépend d’une extension absente. Dans ce cas, répéter une conversion sur chaque page peut masquer la cause et faire perdre des fonctions. Aucun de ces parcours n’exige l’installation d’une nouvelle extension de dépannage.

Approche 1 : tenter une récupération sur la copie

Prérequis : utilisez le brouillon distinct et la copie extérieure vérifiée. Cette approche convient à un bloc isolé dont le fournisseur est encore disponible. Le résultat attendu est un contenu complet qui reste modifiable après enregistrement.

  1. Ouvrez la Vue en liste du brouillon, sélectionnez uniquement le bloc affecté et vérifiez son emplacement. Évitez de sélectionner le groupe ou toute la page : une récupération satisfaisante sur un paragraphe ne prouve rien pour une galerie ou un bloc commercial.
  2. Dans l’avertissement, cliquez une seule fois sur le bouton de récupération, souvent nommé Tenter la récupération ou Attempt Recovery selon la langue et la version. Comparez le résultat immédiatement avec le fichier initial et la capture conservée.
  3. Contrôlez les mots, les liens, les images et les réglages de présentation utiles. Une récupération peut retirer du balisage non reconnu. Si un élément manque, utilisez Annuler avant de multiplier les essais ; si vous ne retrouvez pas l’état voulu, repartez de la copie initiale dans le brouillon.
  4. Si le contenu semble complet, enregistrez le brouillon, quittez son édition puis rouvrez-le. Vérifiez que le bloc reste modifiable et que l’avertissement ne revient pas. Le contrôle porte ainsi sur le contenu enregistré, et non sur le seul affichage momentané de l’éditeur.
  5. Consignez le résultat : correction conservée ou erreur revenue, immédiatement, après enregistrement ou à la réouverture. Si l’essai échoue, laissez l’original intact et comparez une conversion ou une révision dans les sections suivantes. Ne répétez pas la même récupération sur toutes les pages.

Comparer une conversion sans sacrifier le contenu

Si la récupération ne convient pas, ouvrez le menu à trois points de l’avertissement. Lorsque Résoudre est proposé, examinez la comparaison entre le contenu existant et la version attendue. Repérez les suppressions annoncées avant de choisir la conversion en blocs. Si vous ne comprenez pas les différences, quittez cette comparaison sans accepter la transformation.

La conversion en HTML personnalisé constitue une autre possibilité, surtout pour conserver un fragment de balisage à faire examiner. Elle ne redonne pas les réglages du bloc d’origine. Ce choix convient davantage à une personne capable de vérifier le HTML ; pour un débutant, reconstruire un paragraphe simple dans un bloc natif peut être plus facile à maintenir.

Ne collez pas de code inconnu pour faire disparaître l’erreur. Certains éléments HTML peuvent être filtrés à l’enregistrement selon les permissions et l’environnement. Un aperçu correct avant sauvegarde ne suffit pas. Ne demandez pas de droits plus étendus ni de désactivation du filtrage pour contourner cette protection.

Restez sur la copie pendant cette comparaison. Si une conversion retire du texte, modifie les liens ou remplace le contenu par un bloc vide, arrêtez cette piste et utilisez l’original préservé pour la reconstruction ou la recherche d’une révision.

Quand utiliser le bloc Classique ou reconstruire le bloc

Certaines interfaces proposent une conversion en bloc Classique. Il s’agit d’un bloc intégré à l’éditeur de blocs, avec des outils proches de l’ancien éditeur ; ce n’est pas une invitation à installer l’extension Classic Editor ni à changer tout le site d’éditeur.

Essayez cette conversion uniquement sur la copie, si elle est disponible. Vérifiez les éléments conservés avant toute nouvelle transformation. Passer ensuite de Classique à plusieurs blocs est encore une conversion : ne l’enchaînez pas automatiquement pendant le diagnostic.

Pour un contenu simple, vous pouvez plutôt ajouter un bloc Paragraphe, Titre ou Image à côté du bloc défectueux. Réintroduisez le texte sans sa mise en forme problématique, recréez les liens et sélectionnez les images dans la médiathèque. Comparez les deux versions avant de retirer la mauvaise occurrence de la copie. Si cette reconstruction est correcte après réouverture, vous disposez d’une réparation ciblée à reporter, pas d’une raison de refaire toute la page.

Approche 2 : retrouver une version exploitable dans les révisions

Prérequis : il doit exister une version enregistrée avant l’erreur et votre compte doit pouvoir consulter l’historique. Préservez l’état actuel hors de WordPress ; une restauration complète peut remplacer les changements récents et modifier immédiatement une page publiée.

  1. Dans le document original, ouvrez les réglages, puis l’onglet Article ou Page et Révisions. Selon la version, examinez l’aperçu visuel ou la comparaison du contenu sous forme de HTML. Confirmez le titre du document avant de parcourir les dates.
  2. Sélectionnez une version précédant l’apparition du problème sans cliquer sur Restaurer. Repérez l’auteur, l’heure et le passage utile. Une sauvegarde automatique n’est pas un historique infini ; aucune récupération ne doit être promise pour un texte qui n’a jamais été conservé.
  3. Comparez aussi les modifications récentes à garder ailleurs dans la page. Privilégiez l’extraction du seul bloc nécessaire, selon la méthode de la section suivante. Sur WordPress.com, le bouton Restaurer peut rétablir directement la version sur le site public : faites décider une restauration complète par la personne responsable de la publication.
  4. Quittez l’historique sans restauration complète tant que le choix n’est pas validé. Le résultat de cette recherche est une version identifiable et une portée de récupération décidée. Si aucun état n’est utile, ou si vos droits ne donnent pas accès à l’historique, transmettez cette limite à un éditeur autorisé.
  5. Contrôlez ensuite le fragment récupéré dans le brouillon. Si vous avez sélectionné le mauvais passage, abandonnez cette copie et reprenez l’extraction depuis l’état préservé. Si le même bloc redevient non valide après réouverture, passez au diagnostic du composant ; restaurer plusieurs dates ne corrige pas son incompatibilité.

Récupérer une partie sans restaurer toute la page

Lorsque l’historique visuel permet de sélectionner les blocs, copiez la partie utile depuis la révision, puis quittez l’historique sans restauration complète. Collez ce contenu dans votre brouillon de travail et contrôlez-le. Cette méthode est documentée sur WordPress.com ; ne supposez pas que toutes les anciennes interfaces possèdent les mêmes commandes.

Si vous disposez seulement d’une comparaison HTML, utilisez-la pour identifier le passage recherché. Ne copiez pas une sélection approximative qui couperait les limites d’un bloc ou laisserait un groupe incomplet. Faites extraire le fragment correctement par une personne compétente si nécessaire, ou reconstruisez le contenu simple à partir du texte retrouvé.

Enregistrez et rouvrez la copie récupérée. Si le même bloc redevient non valide, l’ancienne version du contenu ne suffit pas : le problème peut tenir à la version actuelle du composant. Passez alors à la troisième approche au lieu de restaurer successivement plusieurs dates sur la page publique.

Approche 3 : identifier le composant qui fournit le bloc tiers

Prérequis : relevez les versions et le nom du bloc ; les interventions sur les extensions exigent un administrateur autorisé. Un bloc tiers provient d’une extension ou d’un thème. Ce parcours cherche son fournisseur avant toute conversion ou migration.

  1. Dans l’avertissement et la Vue en liste, relevez le nom du bloc et son identifiant technique lorsqu’il apparaît. Conservez un exemple minimal sans données privées. Faites rapprocher ce nom des composants installés par l’administrateur, sans installer une extension de remplacement au hasard.
  2. Distinguez le bloc présent dont l’ancien contenu ne se valide plus du bloc déclaré non pris en charge. Dans le premier cas, notez la version du fournisseur et les mises à jour récentes ; dans le second, vérifiez si ce fournisseur est désactivé, absent ou indisponible dans ce contexte.
  3. Conservez les blocs manquants pendant l’inventaire. Une conversion en HTML peut préserver une partie du contenu mais ne rétablit pas leurs fonctions. En multisite, demandez au responsable du réseau de vérifier les composants gérés à ce niveau. Sur WordPress.com, utilisez les accès disponibles ou le support du service.
  4. Le résultat attendu est un fournisseur identifié et une hypothèse précise à vérifier sur une copie séparée, comme décrit ensuite. Si l’identification reste incertaine, arrêtez la modification et transmettez le nom du bloc avec les versions. Aucun retour arrière n’est nécessaire pour cet inventaire en lecture seule ; conservez l’original avant les essais suivants.

Vérifier une incompatibilité avant une migration

Prérequis : faites préparer une préproduction avec sa propre base, une sauvegarde et des paiements, notifications et envois réels neutralisés. Une simple proximité entre une mise à jour et l’erreur ne prouve pas la cause.

  1. Consultez la documentation et les notes de version du fournisseur pour le bloc exact. Notez la modification suspectée et choisissez une page représentative. Vérifiez que l’erreur se reproduit dans cette copie avant de toucher au composant.
  2. Avec le mainteneur, changez un seul élément à la fois dans la préproduction. Conservez sa version et sa configuration initiales, ainsi que la procédure de restauration, puis rouvrez le même contenu. Ne désactivez pas globalement les extensions en production.
  3. Comparez le contenu et les fonctions après l’essai, puis rétablissez la configuration précédente avant de changer d’hypothèse. Si le fournisseur a modifié le format enregistré, transmettez-lui l’exemple minimal : la compatibilité avec les anciens blocs relève de sa migration documentée.
  4. Arrêtez si la copie ne reproduit pas le problème ou si vous ne pouvez pas restaurer son état de départ. Ne modifiez pas les fichiers du fournisseur pour improviser une migration et ne conservez pas durablement une ancienne version sans examen de sécurité et de compatibilité. Une cause confirmée permet de choisir une correction, pas de généraliser immédiatement le changement.

Migrer vers des blocs maintenus lorsque c’est nécessaire

Si le composant est abandonné ou si une migration est recommandée par son fournisseur, établissez d’abord ce que chaque bloc accomplit. Un texte et une image peuvent souvent être reconstruits avec les blocs déjà présents. Un formulaire, une recherche ou un affichage calculé exige un remplacement fonctionnel, pas une simple copie de son apparence.

Certains blocs produisent leur résultat sur le serveur. Leur contenu enregistré peut ne pas contenir tout le rendu final ; conserver du HTML ne garantit donc ni le fonctionnement ni même la présence de toutes les informations. Faites valider la solution pour le type de bloc concerné avant de retirer son fournisseur.

Sur la copie, ajoutez le remplacement à côté de l’ancienne occurrence, réintroduisez les données utiles et contrôlez les fonctions. N’enlevez l’ancien bloc qu’après comparaison et sauvegarde. Pour plusieurs pages, commencez par une seule occurrence représentative et tenez une liste des contenus à reprendre. Une migration réussie se mesure aux usages conservés, pas au nombre d’avertissements supprimés.

Valider la réparation avant de modifier la page publique

Rouvrez le brouillon après enregistrement. Vérifiez que le bloc reste modifiable et que le message ne revient pas. Ouvrez ensuite son aperçu sur un écran large puis étroit. Contrôlez les titres, les textes alternatifs, l’ordre des éléments, les liens et les contenus masqués derrière un accordéon ou un onglet.

Pour un élément interactif, définissez un essai sans effet réel. Vérifier qu’un formulaire affiche ses champs ne prouve pas qu’il traite les réponses ; inversement, ne déclenchez pas un envoi vers de vrais destinataires pour tester une copie. Faites préparer un environnement adapté si une fonction importante doit être validée.

Une fois le résultat approuvé, reportez uniquement la correction nécessaire dans le contenu original avec les droits requis. Avant d’enregistrer une page déjà publiée, comparez la liste des éléments modifiés et évitez les changements simultanés d’un autre auteur. Contrôlez ensuite la page publique et rouvrez l’éditeur. Gardez les copies jusqu’à validation de ces deux contrôles.

Savoir quand arrêter et demander une aide ciblée

Arrêtez les conversions lorsque le contenu disparaît, qu’une fonction essentielle est perdue ou que plusieurs blocs reviennent en erreur. Adressez le dossier au développeur du bloc pour une incompatibilité précise ; sollicitez l’hébergeur pour une sauvegarde, une préproduction ou des erreurs côté serveur. Sur WordPress.com, le support peut orienter les contrôles propres au service.

Transmettez le message exact, les versions, le nom du bloc, les étapes de reproduction et le résultat d’un seul essai documenté. Retirez du contenu d’exemple les données personnelles, informations commerciales privées et valeurs d’authentification. Ne publiez pas un export complet de votre page confidentielle sur un forum.

Pour prévenir la répétition, gardez une sauvegarde avant les changements de composants et vérifiez quelques pages représentatives après mise à jour. Évitez les modifications manuelles de structure HTML dans les blocs que vous souhaitez continuer à éditer visuellement. La réparation est terminée lorsque le contenu utile et ses fonctions sont préservés, pas seulement lorsque l’encadré d’erreur a disparu.

Comprendre un bloc Paragraphe à partir de son balisage

Sur un brouillon jetable, un paragraphe simple peut être enregistré sous la forme ci-dessous. Les commentaires délimitent le bloc ; le texte entre les balises p est son contenu. Ce fragment sert à comprendre la structure, pas à remplacer le code d’une page complète.

Si quelqu’un remplace manuellement les balises p par des balises div en conservant la déclaration wp:paragraph, le rendu peut encore ressembler à du texte, mais la structure ne correspond plus nécessairement à ce que le bloc Paragraphe sait enregistrer. La bonne réparation est de reconstruire ce seul paragraphe avec son texte et ses liens, puis d’enregistrer et de rouvrir le brouillon. Retirer les commentaires pour supprimer l’avertissement changerait la nature du contenu plutôt que de réparer le bloc.

Pour un bloc tiers, ne généralisez pas ce remplacement de balises : son code peut prévoir des classes, attributs ou blocs internes particuliers. Le développeur doit conserver la lecture des anciens formats avec une dépréciation et, si nécessaire, une migration adaptée. Le contrôle utile comporte un ancien contenu, un nouveau contenu et une réouverture après enregistrement, sans perte des attributs attendus.

<!-- wp:paragraph -->
<p>Texte de démonstration conservé.</p>
<!-- /wp:paragraph -->

Sources et références

Ces références permettent de vérifier les fonctions, les prérequis et les limites décrits. Une documentation consultée ne constitue pas un essai pratique.

Consulter les 17 références

Ces guides peuvent aussi vous aider