WebP AVIF Pro — Guide complet

WebP AVIF Pro convertit et compresse les images de votre médiathèque en WebP ou AVIF, en local, sans abonnement ni quota. Ce guide couvre l’installation, les deux modes de livraison, la génération d’ALT text par IA, le SEO d’images, le traitement en lot, l’arrière-plan WP-Cron et WP-CLI, ainsi que la sauvegarde et le dépannage.

Prérequis serveur

Le plugin fonctionne avec l’un des deux moteurs d’image de PHP :

• Imagick compilé avec libheif (AVIF) et le support WebP — recommandé ;
• GD avec les fonctions imagewebp() et imageavif() (PHP 8.1 ou supérieur).

La page Réglages du plugin affiche des pastilles indiquant les moteurs et formats réellement disponibles sur votre hébergement (Imagick, GD, WebP, AVIF).

Installation

1. Téléversez le dossier df-webp-avif-pro dans /wp-content/plugins/ (ou installez le ZIP depuis Extensions puis Ajouter).
2. Activez l’extension depuis le menu Extensions.
3. Rendez-vous dans WebP AVIF Pro puis Réglages pour configurer le format, le mode de livraison, le renommage et l’IA.
4. Lancez une analyse (simulation) puis l’optimisation depuis la page Optimisation.

Format de sortie et compression

Choisissez WebP (compatibilité maximale) ou AVIF (compression supérieure). Options principales :

• Repli automatique vers WebP : si AVIF est demandé mais indisponible, le plugin produit du WebP au lieu d’échouer.
• Qualité : de 1 à 100, recommandé entre 78 et 85.
• Redimensionnement : limite le plus grand côté à une valeur en pixels (0 = désactivé). Mode « remplacer » uniquement.
• Suppression EXIF/ICC : retire les métadonnées pour alléger les fichiers.
• Ignorer les GIF animés : évite de casser les animations.

Modes de livraison

WebP AVIF Pro propose deux stratégies, à choisir selon votre contexte.

Remplacer

Le fichier d’origine est converti, éventuellement renommé, et toutes les références (contenu des articles, métadonnées) sont réécrites vers le nouveau fichier. Les originaux sont sauvegardés pour permettre une restauration.

Conserver l’original (non-destructif)

Un fichier next-gen est généré à côté de l’original (par exemple photo.jpg et photo.jpg.webp). À l’affichage, le plugin sert la version next-gen uniquement aux navigateurs qui l’acceptent, grâce à l’en-tête Accept ; les autres reçoivent l’original. Aucune règle htaccess n’est nécessaire.

Renommage SEO

Quatre modes de renommage des fichiers sont disponibles : aucun, nom du produit (WooCommerce), modèle personnalisé, ou base64 (anonymisation). Le mode modèle accepte des jetons :

• {product} {title} {sku} {cat} {alt} {id} {date} {n}

Exemple : {product}-{cat}-{n} produit un nom de fichier du type tapis-personnalise-entree-a1b2c3.webp. Le renommage ne s’applique pas en mode « conserver l’original ».

ALT text par IA

WebP AVIF Pro génère des attributs ALT descriptifs par IA, en plusieurs langues, à partir du visuel et du contexte produit.

1. Activez l’IA dans les Réglages, choisissez un fournisseur (Anthropic, OpenAI, Gemini, Mistral en analyse visuelle, ou DeepSeek en contexte seul) et renseignez votre clé API.
2. Sélectionnez les langues souhaitées. La première langue cochée alimente l’ALT principal ; les autres sont synchronisées sur les traductions Polylang si elles existent.
3. Générez les ALT depuis la page ALT IA (en lot), automatiquement à l’upload, ou image par image via l’action « Générer ALT (IA) » de la médiathèque.

SEO front-end

• Dimensions anti-CLS : ajoute les attributs width et height aux images du contenu qui en manquent, pour limiter le décalage de mise en page (Core Web Vitals).
• Schema ImageObject : émet un bloc JSON-LD sur les pages et fiches produit (image à la une et galerie WooCommerce).

Optimisation en lot

Depuis la page Optimisation :

• Analyser (simulation) : estime le gain sur un échantillon, sans rien modifier.
• Optimiser toute la médiathèque : traite les images par lots, sans bloquer le serveur. Vous pouvez quitter la page et relancer plus tard ; le traitement reprend là où il s’est arrêté.

Les cartes de statistiques affichent le nombre d’images converties, l’espace économisé et un historique mensuel.

Arrière-plan (WP-Cron) et WP-CLI

Pour les grandes médiathèques, activez le traitement en arrière-plan : le plugin optimise un lot toutes les 5 minutes via WP-Cron, sans garder d’onglet ouvert. Les agences peuvent aussi piloter le plugin en ligne de commande :

wp df-wap status
wp df-wap optimize --batch=20
wp df-wap optimize --dry-run
wp df-wap alt --batch=10
wp df-wap restore --yes

Sauvegarde, purge et restauration

En mode « remplacer », les originaux sont copiés dans /wp-content/uploads/df-wap-backups/ (dossier protégé). Vous pouvez :

• Restaurer une image (action de la médiathèque) ou toute la médiathèque (bouton « Tout restaurer »).
• Purger automatiquement les sauvegardes après un nombre de jours défini, pour récupérer de l’espace disque.

En mode « conserver », la restauration supprime simplement les fichiers next-gen ; les originaux n’ayant jamais été modifiés.

Diagnostics

La page Optimisation affiche des avertissements contextuels : présence d’un module de déport des médias (S3/CDN), constructeurs de page détectés, AVIF demandé mais indisponible, ou espace disque faible. Suivez ces recommandations avant un traitement massif.

Dépannage

• AVIF indisponible : activez le repli WebP, ou passez le format de sortie sur WebP. La page Réglages indique les moteurs disponibles.
• Images non remplacées dans un constructeur de page : certaines URLs stockées par les builders échappent à la réécriture. Préférez le mode « conserver l’original ».
• ALT non générés : vérifiez que l’IA est activée, que la clé API est valide et qu’il reste du crédit chez le fournisseur.
• Le traitement en lot semble lent : baissez le nombre d’images par lot (l’AVIF est gourmand), ou utilisez l’arrière-plan / WP-CLI.