TTSWP fonctionne avec tous les principaux plugins de mise en cache : WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, Cache Enabler et d'autres. Le plugin ajoute automatiquement ses fichiers JavaScript et CSS aux listes d'exclusion du cache.
Ce que TTSWP configure automatiquement
Lorsqu'un plugin de cache compatible est détecté :
- Les fichiers JS de TTSWP sont marqués comme "ne pas minifier/combiner" (évite de casser le lecteur)
- Les fichiers CSS de TTSWP peuvent être combinés normalement
- Le script du menu de la barre d'administration de TTSWP est servi en temps réel (pour refléter les changements de forfait en direct)
- Les fichiers audio (MP3) ne sont pas inclus dans le cache de page HTML (ils ont leurs propres en-têtes d'expiration)
Aucune configuration manuelle n'est requise. Cela fonctionne automatiquement après l'activation de TTSWP.
Plugins de cache compatibles (testés)
- WP Rocket
- LiteSpeed Cache
- W3 Total Cache
- WP Super Cache
- Cache Enabler
- Hummingbird
- Swift Performance
- Autoptimize
Vider le cache après modification des paramètres
Lorsque vous modifiez les couleurs, le positionnement du lecteur ou les paramètres de voix, le front-end doit voir les CSS et JS à jour. Le plugin vide ses propres caches internes, mais votre plugin de cache peut servir une ancienne version de la page.
Après toute modification visible des paramètres :
- Videz le cache de votre plugin de mise en cache
- Si vous utilisez un CDN (Cloudflare, BunnyCDN, etc.), purgez-le également
Cache d'objets
Si votre site utilise Redis ou Memcached via un plugin de cache d'objets, TTSWP utilise le même cache pour :
- La liste des voix depuis ElevenLabs (1 heure)
- Les données de facturation depuis app.ttswp.com (24 heures)
- Les statistiques d'utilisation (5 minutes)
Aucune action requise. Le cache d'objets accélère le chargement des pages d'administration.
Cache de pages et lecteurs audio
Le cache de pages est compatible avec TTSWP. Le HTML du lecteur est statique par article (il ne change pas selon le visiteur). Les fichiers audio se chargent depuis une URL distincte et ne sont pas affectés par le cache de pages.
Un cas particulier à surveiller :
Cache mixte connecté / anonyme
Certains plugins de cache servent la même page mise en cache aux administrateurs connectés et aux visiteurs anonymes. Cela peut provoquer l'affichage d'éléments réservés aux administrateurs (le menu de la barre d'administration, par exemple) pour tout le monde. La plupart des plugins gèrent cela correctement par défaut.
Paramètres connus des plugins de cache
LiteSpeed Cache
- Activez le Cache d'objets si vous disposez de Redis ou Memcached (accélère l'administration)
- Laissez Combiner JS désactivé sur les écrans d'administration
- Le plugin exclut automatiquement
mementor-tts-admin.jsde l'optimisation
WP Rocket
- Aucune exclusion manuelle nécessaire
- Le plugin utilise les attributs
data-no-optimize="1"sur ses scripts
W3 Total Cache
- Activez le Cache de pages pour les pages audio front-end
- Laissez Minifier JS activé - le plugin exclut automatiquement ses propres scripts
Dépannage : audio mis en cache qui ne se met pas à jour
Si vous avez régénéré l'audio d'un article mais que l'ancien audio continue de se lire :
- Videz le cache de votre navigateur (Ctrl+Shift+Suppr)
- Videz le cache de pages de votre plugin de mise en cache
- Purgez votre CDN si vous en utilisez un
- Rechargez la page de l'article en forçant le rechargement (Ctrl+Shift+R)
Les fichiers audio sont servis avec leur propre horodatage dans l'URL, donc le navigateur devrait normalement récupérer la nouvelle version. Si ce n'est pas le cas, l'un des caches ci-dessus est la source du problème.