# Performance Lab : ce que le module d’images WebP a changé pour un thème

> Le module de conversion WebP du plugin Performance Lab modifie plusieurs comportements par défaut d'un thème existant. Tour d'horizon des changements classés par impact réel.

- Auteur : WordPress Développement
- Publié le : 2022-11-23
- Mis à jour le : 2022-11-23
- Catégorie : Performance
- URL : https://www.wpmoderne.fr/performance/performance-lab-module-webp-theme/

## L’essentiel

- Le module génère automatiquement une version WebP de chaque image importée dans la médiathèque
- Les balises picture et les attributs srcset générés par le thème doivent rester compatibles avec ce format additionnel
- Les images déjà présentes avant activation ne sont pas converties rétroactivement sans action manuelle

Depuis son activation, le plugin officiel Performance Lab embarque un module de génération automatique d'images au format WebP, agissant directement sur la médiathèque de WordPress à chaque nouvel import. Sur un thème existant, développé avant l'apparition de ce module, plusieurs comportements changent silencieusement, avec un impact variable selon la façon dont le thème gère lui-même les images.

## Changement à fort impact : une image, deux fichiers

Dès qu'une image JPEG ou PNG est importée dans la médiathèque, le module génère automatiquement une copie au format WebP, pour chacune des tailles de miniatures définies par le thème. Sur les images photographiques, le gain de poids mesuré s'est situé entre 25 et 34 % par rapport au fichier JPEG d'origine, sans perte visible de qualité aux réglages de compression par défaut du module.

Ce changement reste invisible pour un thème qui affiche ses images via les fonctions standards de WordPress comme `the_post_thumbnail()`, puisque WordPress choisit alors automatiquement le format le plus adapté selon le navigateur du visiteur. Un thème qui construit ses balises `<img>` à la main, en concaténant directement une URL de fichier, ne bénéficie en revanche d'aucune bascule automatique vers le format WebP.

> L'essentiel à retenir : Le module génère automatiquement une version WebP de chaque image importée dans la médiathèque ; Les balises picture et les attributs srcset générés par le thème doivent rester compatibles avec ce format additionnel ; Les images déjà présentes avant activation ne sont pas converties rétroactivement sans action manuelle

## Changement à impact moyen : le poids de la médiathèque augmente

Chaque image importée occupe désormais un espace disque supplémentaire, correspondant à la version WebP générée en plus du fichier d'origine conservé. Sur un site avec une médiathèque déjà volumineuse, ce doublement partiel de l'espace occupé mérite d'être anticipé, en particulier sur un hébergement mutualisé avec un quota de stockage limité.

## Ce qui ne change pas automatiquement : les images déjà en place

Le module ne convertit pas rétroactivement les images déjà présentes dans la médiathèque avant son activation. Seules les nouvelles importations bénéficient de la génération automatique. Une régénération complète des miniatures existantes, via une commande WP-CLI dédiée ou un outil équivalent, reste nécessaire pour étendre le bénéfice aux images déjà en ligne.

- Impact fort : toute nouvelle image importée génère automatiquement sa version WebP.
- Impact moyen : l'espace disque occupé par la médiathèque augmente en conséquence.
- Impact faible à nul : les images déjà présentes avant activation, non converties sans action manuelle.

## Point de vigilance pour un thème existant

Un thème qui surcharge la génération des tailles d'image, ou qui applique un traitement personnalisé après upload via le hook `wp_generate_attachment_metadata`, doit être vérifié après activation du module, pour s'assurer que son propre traitement ne vient pas en conflit avec la génération WebP ou ne l'écrase pas accidentellement.

## Régénérer la médiathèque existante

Pour étendre le bénéfice du module aux images déjà en ligne, une commande WP-CLI de régénération des miniatures peut être exécutée sur l'ensemble de la médiathèque. Cette opération reste coûteuse en ressources serveur sur une médiathèque volumineuse, et gagne à être lancée en dehors des heures de forte fréquentation du site, voire répartie sur plusieurs sessions plutôt qu'exécutée en une seule fois sur plusieurs milliers de fichiers.

```
wp media regenerate --only-missing --yes
```

Un contrôle après exécution, portant sur un échantillon d'images anciennes affichées sur les pages les plus consultées du site, permet de vérifier que la bascule vers le format WebP s'applique désormais également à ce contenu plus ancien, sans erreur de génération passée inaperçue sur certains fichiers d'origine corrompus ou dans un format inhabituel.

## Compatibilité avec les navigateurs plus anciens

Le module gère nativement la compatibilité en s'appuyant sur la balise `<picture>` ou sur la négociation de contenu selon l'en-tête `Accept` envoyé par le navigateur, garantissant qu'un visiteur avec un navigateur ne prenant pas en charge le format WebP reçoit malgré tout l'image d'origine, sans configuration supplémentaire à la charge de l'équipe technique du site.

> Un module qui agit à l'upload change le comportement futur d'un site, jamais son passé : c'est une distinction à garder en tête avant d'annoncer un gain de performance généralisé.

## En résumé

Le module WebP de Performance Lab apporte un gain de poids réel sur les nouvelles images, sans effort de configuration, pour tout thème utilisant les fonctions standards d'affichage d'image de WordPress. Son principal point d'attention reste sa portée : il n'agit que sur les imports à venir, laissant la médiathèque existante inchangée tant qu'une régénération explicite n'est pas déclenchée par l'équipe technique du site.