# Sidebar de widgets classiques dans un thème bloc en 2023

> Hériter d'un site où une sidebar historique cohabite encore avec l'éditeur de site : gestion quotidienne du bloc Legacy Widget, deux ans après son apparition.

- Auteur : Clément Hadrot
- Publié le : 2023-05-30
- Mis à jour le : 2023-05-30
- Catégorie : FSE
- URL : https://wpmoderne.dev.wordpress-developpement.fr/fse/sidebar-widgets-classiques-theme-bloc-2023/

## L’essentiel

- Une cohabitation stable mais jamais définitive
- Chaque nouveau widget doit rester surveillé de près
- La migration complète reste toujours souhaitable à terme

Reprendre la maintenance d'un site que l'on n'a pas construit soi-même réserve toujours son lot de surprises. Sur ce site associatif, découvert récemment dans le cadre d'un contrat de maintenance, la colonne latérale reposait toujours, deux ans après la bascule vers un thème bloc, sur un bloc Legacy Widget encapsulant trois widgets classiques jamais migrés vers des blocs natifs.

Plutôt que de se précipiter vers une réécriture complète, souvent tentante pour un nouvel intervenant désireux de tout « moderniser », l'enjeu a été d'abord de comprendre pourquoi cette cohabitation avait tenu deux années sans incident, avant de décider s'il fallait vraiment la faire évoluer.

## Un état des lieux avant toute décision

Les trois widgets encapsulés concernaient un calendrier d'événements associatifs propulsé par une extension tierce spécialisée, un widget d'affichage des dons récents lié à une plateforme de paiement externe, et un widget de recherche personnalisé avec des filtres spécifiques à l'association. Chacun reposait sur du code PHP hérité, parfois vieux de plusieurs années, sans documentation technique associée.

Le premier réflexe a été de vérifier, pour chaque widget, si l'extension correspondante proposait déjà nativement un bloc Gutenberg équivalent, ce qui aurait rendu la migration bien plus simple qu'une réécriture complète depuis zéro.

## Ce que cette vérification a révélé

L'extension de calendrier d'événements proposait effectivement, depuis une mise à jour récente, un bloc natif équivalent au widget historique, avec des réglages quasiment identiques. Migrer ce widget spécifique est donc devenu une opération simple, réalisée en une petite heure de travail, sans risque particulier pour le fonctionnement du calendrier.

> L'essentiel à retenir : Une cohabitation stable mais jamais définitive ; Chaque nouveau widget doit rester surveillé de près ; La migration complète reste toujours souhaitable à terme

En revanche, le widget de dons récents dépendait d'une intégration personnalisée développée il y a plusieurs années par un prestataire disparu depuis, sans aucun bloc équivalent disponible et sans documentation technique exploitable. Une réécriture complète de ce widget en bloc natif représenterait un chantier non négligeable, hors du périmètre du contrat de maintenance actuel.

## La décision prise pour la suite

- Migrer immédiatement le widget de calendrier, puisque l'alternative native existait déjà et réduisait le risque global plutôt que de l'augmenter.
- Conserver le widget de dons récents en Legacy Widget, en documentant précisément son fonctionnement interne pour la première fois depuis sa création.
- Proposer au client un devis séparé pour la réécriture complète du widget de dons, en expliquant clairement le bénéfice attendu et le risque de statu quo prolongé.
- Conserver également le widget de recherche personnalisé, jugé suffisamment simple et stable pour ne pas justifier une réécriture dans l'immédiat.

## Ce que deux ans de cohabitation nous apprennent

Le bloc Legacy Widget, loin d'être une solution honteuse ou bancale comme on pourrait le craindre, s'est révélé remarquablement stable sur la durée, sans incident lié directement à sa présence. Les seules difficultés rencontrées concernaient les widgets eux-mêmes, indépendamment du mécanisme d'encapsulation qui les rendait compatibles avec le thème bloc.

> Une solution transitoire qui tient deux ans sans incident n'est plus vraiment transitoire : c'est devenu une architecture assumée, qu'il faut documenter comme telle plutôt que la considérer comme un chantier en attente permanente.

## En résumé

Reprendre un projet existant demande souvent plus de discernement que d'enthousiasme technique. Migrer ce qui peut l'être simplement, documenter ce qui doit encore attendre, et surtout éviter la réécriture précipitée d'un composant critique mal compris : voilà, à mon sens, la bonne méthode pour gérer ce type d'héritage technique sans mettre en péril un site qui fonctionne depuis des années.

Le devis pour le widget de dons a d'ailleurs été accepté quelques semaines plus tard par l'association, rassurée par la clarté du diagnostic initial et par la preuve, apportée sur le widget de calendrier, que ce genre de migration pouvait se faire sans casse quand les conditions techniques le permettaient réellement.
