HUSKY - WooCommerce Product Filter Professional

Filtre de produits WooCommerce qui ne fonctionne pas avec WP Rocket et le cache

Lorsqu’un filtre de produits WooCommerce ne fonctionne pas avec WP Rocket ou un autre plugin d’optimisation, le schéma est presque toujours le même : tout marche quand vous êtes connecté, et pour les visiteurs les clics ne font rien, le loader tourne sans fin ou le curseur de prix s’affiche comme un simple champ de texte. HUSKY envoie le même code aux deux. La différence vient du fait que le cache et l’optimisation JavaScript ignorent en général les administrateurs connectés : vous ne voyez donc jamais la page optimisée que reçoivent vos visiteurs. Voici comment lire l’erreur en une minute, ce qu’il faut exclure exactement dans WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer et Cloudflare, et comment empêcher le cache de page de casser le filtrage AJAX avec une nonce error.

Pourquoi le filtre fonctionne pour les administrateurs et échoue pour les visiteurs

Le front-end du filtre n’est pas un seul fichier de script, mais une chaîne qui doit s’exécuter dans un ordre précis :

  1. jQuery, dont dépendent tous les scripts du filtre.
  2. Un bloc de réglages en ligne inséré dans la page (dans le code source, c’est <script id="woof_front-js-before">). Il définit les variables dont le filtre a besoin : woof_current_values, woof_is_ajax, swoof_search_slug, woof_ext_init_functions, le jeton de sécurité woof_front_nonce et d’autres.
  3. Les fichiers du plugin situés dans /wp-content/plugins/woocommerce-products-filter/ : js/front.js, qui lit ces variables, les scripts des éléments de filtre et des extensions, ainsi que des modules jQuery comme iCheck (styles de cases à cocher), ion.rangeSlider (curseurs) et plainOverlay (la couche de chargement).

L’optimisation et le cache cassent cette chaîne de trois façons. L’optimisation modifie l’ordre, par exemple en différant les fichiers mais pas le bloc en ligne, ou l’inverse. Elle déplace ou réécrit le bloc en ligne lors de la combinaison ou de la minification. Et un cache de page stocke du HTML qui contient une donnée à date d’expiration : le jeton de sécurité. La plupart des plugins de cache et d’optimisation servent aux utilisateurs connectés une page ni mise en cache ni optimisée ; la vue administrateur prouve donc seulement que le filtre lui-même fonctionne.

Lisez d’abord la console du navigateur

Ouvrez la boutique dans une fenêtre de navigation privée, où vous n’êtes pas connecté. Appuyez sur F12 (Cmd+Option+I sur Mac), ouvrez l’onglet Console, rechargez la page et cliquez sur un filtre. La première erreur en rouge vous indique où chercher.

Message de la consoleSignification
woof_current_values is not defined, de même pour woof_is_ajax, swoof_search_slug, woof_ext_init_functions (Firefox : assignment to undeclared variable, Safari : Can't find variable)Le bloc de réglages en ligne ne s’est pas exécuté avant front.js : il a été différé, déplacé, supprimé ou endommagé
jQuery is not definedjQuery est retardé ou différé, mais du code qui en a besoin s’est exécuté plus tôt
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a functionLe fichier du module ne s’est pas chargé, ou une seconde copie de jQuery s’est chargée après lui et a remplacé l’objet jQuery
woof_husky_txt is not definedLe bloc de données de la recherche par texte a été supprimé ou séparé de son fichier
SyntaxError pointant vers le bloc en ligneCode invalide dans le bloc en ligne, souvent à cause du champ de JavaScript personnalisé du plugin (voir plus bas)
Identifier 'woof_front_nonce' has already been declaredLe bloc de réglages s’est exécuté deux fois : un optimiseur, ou un thème avec des transitions de page AJAX, a relancé les scripts en ligne
"nonce error" is not valid JSONLa page provient d’un cache et son jeton de sécurité a expiré
Unexpected token '<' ... is not valid JSONLe serveur a répondu à la requête du filtre par du HTML : une notice PHP, une page de pare-feu ou une page en cache
Bad escaped character in JSONQuelque chose a réécrit la réponse AJAX en chemin vers le navigateur

Aucune erreur, mais le curseur est un simple champ, les boutons + des listes hiérarchiques manquent et les clics ne font rien : les scripts ne se sont pas encore exécutés. C’est l’aspect que prennent les fonctions du type « retarder le JavaScript jusqu’à l’interaction de l’utilisateur ». Affichez le code source de la page et cherchez woof_front : si les balises de script portent un type comme rocketlazyloadscript ou litespeed/javascript, un optimiseur les retient. Si woof_front n’apparaît pas du tout dans le code source, vérifiez le champ Initialiser le plugin uniquement sur les pages suivantes du site (Init plugin on the next site pages only) (Advanced → Code) : s’il liste des pages, le plugin ne se charge que sur celles-ci.

Que faut-il exclure de l’optimisation JavaScript

La règle est la même dans tous les outils : jQuery, les blocs en ligne et les fichiers du plugin doivent rester ensemble et dans leur ordre d’origine. N’exclure que front.js est une demi-solution courante qui ne fonctionne pas, car le bloc de réglages et jQuery restent différés. Ces trois lignes couvrent tout :

/wp-includes/js/jquery/
woocommerce-products-filter
woof_

La première ligne correspond à jQuery et à jQuery UI (le curseur de prix de style WooCommerce l’utilise). La deuxième correspond à tous les fichiers du plugin et de ses extensions. La troisième correspond aux blocs en ligne : leurs identifiants et les variables qu’ils contiennent commencent par woof_. Les champs d’exclusion des plugins d’optimisation comparent généralement un mot-clé à la fois à l’URL du fichier et au contenu des scripts en ligne.

  • WP Rocket. Dans Optimisation des fichiers (File Optimization), ajoutez les lignes aux fichiers exclus de Retarder l’exécution du JavaScript (Delay JavaScript execution) ; si le filtre reste cassé, ajoutez-les aussi aux exclusions de Charger le JavaScript en différé (Load JavaScript deferred), ou désactivez cette option. Si Optimiser la diffusion du CSS (Optimize CSS delivery) est réglé sur la suppression du CSS inutilisé, ajoutez les styles du plugin et les classes .woof à sa liste blanche CSS : de nombreuses classes du filtre n’apparaissent qu’après l’exécution du JavaScript, si bien qu’une analyse de la page statique les considère comme inutilisées.
  • LiteSpeed Cache. Combiner le JS (JS Combine) et Charger le JS en différé (Load JS Deferred) (différé ou retardé) sont les causes habituelles ; ajoutez les lignes aux exclusions JS et aux exclusions du différé/retardé. Si la requête du filtre aboutit mais que les produits ne se rafraîchissent pas et que la console affiche Bad escaped character in JSON, désactivez Mappage CDN (CDN Mapping) : dans des cas confirmés, il réécrivait la réponse AJAX.
  • Autoptimize. Quand le JavaScript est agrégé, jQuery passe dans le fichier combiné en fin de page, alors que le code en ligne reste à sa place et s’exécute trop tôt. Gardez js/jquery/jquery.min.js et woocommerce-products-filter dans Exclure des scripts d’Autoptimize (Exclude scripts from Autoptimize).
  • SiteGround Speed Optimizer, WP-Optimize et plugins similaires. Les options de combinaison, de report (defer) et de « retard des scripts en ligne » exigent toutes les mêmes exclusions, ou doivent être désactivées.
  • Cloudflare Rocket Loader. Il charge tous les scripts de façon asynchrone, blocs en ligne compris, et empêche aussi l’extension Constructeur de filtre en front-end (Filter front builder) de démarrer. Désactivez-le dans les réglages de vitesse de Cloudflare, puis purgez le cache Cloudflare.
  • La minification HTML qui « supprime les caractères inutiles » peut endommager les scripts en ligne. Désactivez sa minification du JavaScript en ligne.
  • Le code du thème ou d’un snippet sur le filtre script_loader_tag. WordPress fait passer le bloc en ligne par ce filtre avec la balise du script ; le code qui y supprime des attributs ou remplace des guillemets peut donc le corrompre. Supprimez ce code ou limitez-le à d’autres handles.

Deux réglages dans le filtre

Code JavaScript après la fin de l’AJAX (JavaScript code after AJAX is done) (WooCommerce → Réglages → Products Filter → Advanced → Code) est inséré dans le bloc de réglages en ligne comme corps d’une fonction. Une faute de frappe, comme une accolade non fermée, casse le bloc entier, et chaque variable du filtre devient « not defined ». Videz le champ pour tester ; pour exécuter du code après le filtrage, l’événement woof_ajax_done est un endroit plus sûr.

Optimiser le chargement des fichiers JavaScript de HUSKY (Optimize loading of HUSKY JavaScript files) (Advanced → Options) bascule entre deux modes de chargement : Non (No) charge front.js plus quatre scripts distincts pour les boutons radio, les cases à cocher et les listes déroulantes ; Oui (Yes) charge un seul fichier compressé, js/front_comprssd.js, dans le pied de page. Certaines configurations d’optimiseur fonctionnent avec une valeur et pas avec l’autre. Essayez les deux, en purgeant tous les caches après chaque changement.

Cache de page et « nonce error »

En mode AJAX (Essayer de passer la boutique en AJAX (Try to ajaxify the shop) dans l’onglet Options, ou une page [woof_products is_ajax=1]) et avec l’attribut ajax_redraw, le filtre demande de nouveaux produits au serveur et envoie le jeton woof_front_nonce pris dans la page. Le serveur le vérifie et, s’il n’est pas valide, répond par le texte brut nonce error. Le script attend du JSON, ne peut pas lire cette réponse, et le loader reste à l’écran.

Le jeton est créé au moment où le HTML est généré. Pour les visiteurs non connectés, les nonces WordPress sont valides au minimum 12 heures et au maximum 24 heures. Une page servie depuis un cache plus ancien que cela porte un jeton périmé. C’est pourquoi le problème apparaît sur les pages en cache un jour après la création du cache, et pourquoi un rechargement aide parfois : il tombe par hasard sur une copie récente. Vider le cache ne règle le problème que pour quelques heures. Les solutions durables :

  • Gardez la durée de vie du cache des pages HTML sous 12 heures. La durée par défaut de WP Rocket, 10 heures, est sûre ; un cache HTML de longue durée sur un CDN est le coupable typique.
  • Ne mettez pas en cache le HTML de la boutique et des catégories sur le CDN. Avec Cloudflare, ajoutez une règle de cache qui contourne le cache pour la boutique, les URL /product-category/ et toute autre page contenant le filtre, et conservez le cache de pages de WordPress, qui respecte sa propre durée de vie. Contourner uniquement les URL filtrées ne suffit pas : le jeton utilisé par le visiteur provient de la page où le filtrage commence.
  • Prolongez la durée de vie de ce seul jeton. Depuis WordPress 6.1, le filtre nonce_life reçoit le nom de l’action ; le jeton du filtre peut donc vivre plus longtemps sans toucher aucun autre nonce du site. Ce jeton ne protège que la requête publique de liste des produits.
/*
 * HUSKY: keep the filter token valid longer than the page cache lifespan.
 * A token is valid for at least half of this time (here: 2 days).
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('nonce_life', function ($life, $action = -1) {
    if ('woof_front_nonce' === $action) {
        return 4 * DAY_IN_SECONDS;
    }
    return $life;
}, 10, 2);

Le mode de redirection simple, sans AJAX et sans ajax_redraw, n’utilise pas du tout le jeton : chaque changement de filtre charge une nouvelle URL, et le cache de pages peut servir les URL filtrées comme n’importe quelle autre page. Si vous appelez le filtre depuis votre propre code, par exemple une requête jQuery personnalisée vers woof_draw_products, les données de la requête doivent inclure nonce_filter: woof_front_nonce, sinon le serveur répond nonce error même sans aucun cache.

Filtres périmés et autres effets secondaires du cache

  • Les réglages modifiés du filtre n’apparaissent pas. Les réglages font partie du HTML en cache et du bloc en ligne. Purgez toutes les couches de cache après les avoir enregistrés : le plugin de cache, le cache serveur (Varnish, Nginx, cache de l’hébergeur), le CDN, puis forcez l’actualisation du navigateur (Ctrl+F5, Cmd+Shift+R sur Mac).
  • Un lien filtré s’ouvre sans rien de sélectionné, ou une boutique vierge s’ouvre avec d’anciennes sélections. Le cache traite les URL avec des chaînes de requête différentes comme une seule page. Chaque URL ?swoof=1&... doit être mise en cache séparément ou pas du tout ; ne réglez donc jamais le cache pour ignorer les chaînes de requête sur les URL de la boutique.
  • Le filtre mobile apparaît sur ordinateur, ou l’inverse. Le mode mobile du filtre et certaines extensions décident côté serveur, d’après le user agent du navigateur, de ce qu’il faut afficher. Une page mise en cache pour un téléphone ne doit pas être servie à un ordinateur : activez des fichiers de cache séparés pour les appareils mobiles.
  • La première visite d’une nouvelle combinaison de filtres est plus lente : cette URL n’a pas encore de copie en cache. Pour la vitesse en général, voyez accélérer le filtrage sur les grands catalogues.

Un ordre de test sûr

  1. Travaillez dans une fenêtre de navigation privée, sans être connecté, console ouverte.
  2. Désactivez toute l’optimisation JavaScript (minification, combinaison, report, retard, Rocket Loader) et purgez toutes les couches de cache. Si le filtre fonctionne maintenant, l’optimisation est la cause. S’il échoue toujours, la cause est ailleurs : lisez la première erreur de la console et testez avec un thème par défaut sur une copie de préproduction.
  3. Réactivez les options une par une, purgez et testez après chacune. Quand l’une casse le filtre, ajoutez les trois lignes d’exclusion à cette option, ou laissez-la désactivée.
  4. En mode AJAX, vérifiez de nouveau le filtre sur une page restée un jour dans le cache. Pas de nonce error signifie que la durée de vie du cache ou celle du jeton est correcte.
  5. Testez aussi sur un téléphone et sur un ordinateur, ainsi que sur la deuxième page de résultats.

Si, après ces étapes, le filtre ne fonctionne toujours que pour les utilisateurs connectés, ouvrez un sujet sur le forum de support de HUSKY avec le lien de la page, la première erreur de la console et la liste des options d’optimisation que vous avez activées, et nous y jetterons un œil.