L’extension compresse les images de la médiathèque via l’API ANK. Ce guide couvre l’installation, le traitement automatique et en lot, les formats WebP et AVIF, les sauvegardes et le dépannage.
1. Fonctionnement de l’extension
ANK Image Compress traite les fichiers JPEG, PNG et WebP d’origine ainsi que les tailles WordPress sélectionnées. Avant tout remplacement, l’extension vérifie la réponse de l’API, le format, les dimensions et la réduction du poids. Les fichiers compressés conservent leur nom et leur URL. Les octets d’origine sont sauvegardés dans un dossier privé hors du site.
Vous pouvez traiter automatiquement les nouveaux fichiers, compresser une image, une sélection ou toute la médiathèque, rechercher un titre ou un nom de fichier, parcourir 50 résultats par page, consulter les économies et restaurer un original.
2. Installation et clé API
- Installez l’archive ZIP d’ANK Image Compress dans Extensions → Ajouter → Téléverser une extension, puis activez-la.
- Créez un compte sur ankpicpress.com et récupérez votre clé API dans votre espace personnel. Vos identifiants et votre solde sont communs avec ank-tinypng.ru ; la connexion au navigateur reste propre à chaque domaine.
- Dans WordPress, ouvrez Réglages → ANK Compress, saisissez la clé et enregistrez les réglages.
- Vérifiez l’état de l’API et le solde dans le bloc Connexion. Une clé enregistrée n’est plus affichée.
Sur WordPress Multisite, définissez ANKIC_API_KEY dans wp-config.php pour partager une clé entre les sites du réseau. Gardez ce fichier privé. Quand la constante est définie, la clé n’est plus modifiable dans l’administration.
3. Traitement automatique
Activez le traitement des nouvelles images après téléversement via WP-Cron, puis enregistrez. WordPress ajoute l’image à la file peu après son arrivée. La page d’administration peut être fermée, mais WP-Cron doit s’exécuter grâce au trafic du site ou à une tâche système.
Pour vérifier, téléversez un petit fichier JPEG, PNG ou WebP non animé. Après le passage de cron, retrouvez-le dans le tableau de l’extension. « Terminé » indique que les fichiers admissibles ont été traités. Si rien ne démarre, contrôlez WP-Cron, la clé et le solde.
4. Compression manuelle et en lot
Pour une image, cliquez sur Compresser dans le tableau de l’extension ou la vue en liste de la médiathèque. Vous pouvez également sélectionner plusieurs images et utiliser l’action groupée de WordPress. L’action « Traiter toutes les images de cette page » ne concerne que les 50 résultats affichés.
Pour toute la médiathèque, lancez le traitement en lot. WP-Cron traite un fichier à chaque exécution programmée et enregistre la progression sur le serveur. Vous pouvez mettre en pause puis reprendre. Les compteurs de succès et d’erreurs concernent le passage en cours. Un nouveau passage ignore les versions déjà traitées sauf si vous demandez une nouvelle compression.
5. Tailles d’image, WebP et AVIF
Choisissez les tailles générées par WordPress à envoyer à l’API. L’image d’origine est toujours traitée. Plus de tailles sélectionnées peuvent entraîner plus de requêtes. Vous pouvez fixer une largeur et une hauteur maximales pour les nouveaux fichiers JPEG et WebP volumineux ; 0 conserve les réglages WordPress. Cette option ne réduit pas les PNG téléversés.
Le réglage de format crée les nouvelles tailles en WebP ou AVIF avec WordPress. Les images existantes et le fichier d’origine ne changent pas. Les tailles WebP peuvent ensuite être compressées par l’API ANK. Les tailles AVIF sont créées localement par WordPress et ne sont pas envoyées à l’API. L’éditeur d’images du serveur doit prendre en charge le format choisi.
6. Recherche, statistiques et restauration
Recherchez un titre ou un nom de fichier et parcourez 50 résultats par page. Le tableau indique le nombre de fichiers traités, l’espace gagné et l’état. Le bloc Statistiques totalise les images, les fichiers et les octets économisés.
Restaurer l’original rétablit les octets de la sauvegarde privée ; Recompresser démarre un nouveau traitement. Vérifiez votre solde avant de recompresser beaucoup de fichiers : un nouveau résultat valide peut consommer un crédit. WordPress doit pouvoir écrire dans le dossier parent de son installation pour stocker les sauvegardes hors du site public.
7. Crédits et limites actuelles
L’API ANK actuelle accepte les fichiers JPEG, PNG et WebP non animés jusqu’à 5 Mo et 20 mégapixels. Si le résultat n’est pas plus petit, le fichier reste intact et aucun crédit n’est consommé. Une requête identique répétée est protégée contre une double facturation. Le solde figure dans le bloc Connexion.
8. Dépannage et assistance
- API indisponible ou clé incorrecte : vérifiez la connexion dans Réglages → ANK Compress, enregistrez une nouvelle clé si nécessaire, puis actualisez.
- Le traitement automatique ne démarre pas : contrôlez le réglage et l’exécution réelle de WP-Cron. Téléversez un petit JPEG et vérifiez son état.
- Image ignorée : vérifiez le type MIME, les limites de 5 Mo et 20 Mpx ainsi que l’absence d’animation. L’AVIF requiert un éditeur compatible et n’est pas compressé par l’API.
- Sauvegarde impossible : accordez à WordPress les droits d’écriture sur le dossier parent de l’installation. L’extension ne remplace pas le fichier avant la réussite de la sauvegarde.
- Ancienne image affichée : videz le cache de page ou du CDN. L’extension ajoute une version aux URL produites normalement par WordPress après remplacement.
Si le problème persiste, écrivez à modules@ankpicpress.com en indiquant la version de l’extension, le type et la taille du fichier, le message d’erreur et les étapes pour le reproduire. N’envoyez ni clé API ni image privée.