HUSKY - WooCommerce Product Filter Professional

El filtro de productos de WooCommerce no funciona con WP Rocket ni con la caché

Cuando el filtro de productos de WooCommerce no funciona con WP Rocket u otro plugin de optimización, el patrón casi siempre es el mismo: todo funciona mientras has iniciado sesión, y para los visitantes los clics no hacen nada, el indicador de carga gira sin fin o el control deslizante de precio aparece como un simple campo de texto. HUSKY envía el mismo código a ambos. La diferencia es que la caché y la optimización de JavaScript suelen omitir a los administradores con sesión iniciada, así que nunca ves la página optimizada que reciben tus visitantes. A continuación: cómo leer el error en un minuto, qué excluir exactamente en WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer y Cloudflare, y cómo evitar que la caché de páginas rompa el filtrado AJAX con un error de nonce (nonce error).

Por qué el filtro funciona para los administradores y falla para los visitantes

El front end del filtro no es un único archivo de script, sino una cadena que debe ejecutarse en un orden fijo:

  1. jQuery, del que depende cada script del filtro.
  2. Un bloque de ajustes en línea impreso en la página (en el código fuente es <script id="woof_front-js-before">). Define las variables que el filtro necesita: woof_current_values, woof_is_ajax, swoof_search_slug, woof_ext_init_functions, el token de seguridad woof_front_nonce y otras.
  3. Los archivos del plugin de /wp-content/plugins/woocommerce-products-filter/: js/front.js, que lee esas variables, los scripts de los elementos del filtro y de las extensiones, y complementos de jQuery como iCheck (estilos de casillas), ion.rangeSlider (controles deslizantes) y plainOverlay (la capa de carga).

La optimización y la caché rompen esta cadena de tres maneras. La optimización cambia el orden, por ejemplo retrasando los archivos pero no el bloque en línea, o al revés. Mueve o reescribe el bloque en línea al combinar o minificar. Y una caché de páginas almacena HTML que contiene datos con fecha de caducidad: el token de seguridad. La mayoría de los plugins de caché y optimización sirven a los usuarios con sesión iniciada una página que no está ni en caché ni optimizada, de modo que la vista de administrador solo demuestra que el filtro en sí funciona.

Lee primero la consola del navegador

Abre la tienda en una ventana privada, donde no has iniciado sesión. Pulsa F12 (Cmd+Option+I en Mac), abre la pestaña Consola (Console), recarga la página y haz clic en un filtro. El primer error en rojo te indica dónde buscar.

Mensaje de la consolaQué significa
woof_current_values is not defined, lo mismo para woof_is_ajax, swoof_search_slug, woof_ext_init_functions (Firefox: asignación a una variable no declarada (assignment to undeclared variable), Safari: No se encuentra la variable (Can't find variable))El bloque de ajustes en línea no se ejecutó antes de front.js: se retrasó, se movió, se eliminó o se rompió
jQuery is not definedjQuery está retrasado o diferido, pero el código que lo necesita se ejecutó antes
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a functionEl archivo del complemento no se cargó, o una segunda copia de jQuery se cargó después y reemplazó el objeto jQuery
woof_husky_txt is not definedEl bloque de datos de la búsqueda de texto se eliminó o se separó de su archivo
SyntaxError que apunta al bloque en líneaCódigo no válido en el bloque en línea, a menudo procedente del campo de JavaScript personalizado del propio plugin (ver más abajo)
Identifier 'woof_front_nonce' has already been declaredEl bloque de ajustes se ejecutó dos veces: un optimizador o un tema con transiciones de página AJAX volvió a ejecutar los scripts en línea
"nonce error" is not valid JSONLa página procedía de una caché y su token de seguridad ha caducado
Unexpected token '<' ... is not valid JSONEl servidor respondió a la solicitud del filtro con HTML: un aviso de PHP, una página de un firewall o una página en caché
Bad escaped character in JSONAlgo reescribió la respuesta AJAX de camino al navegador

Si no hay ningún error, pero el control deslizante es un campo simple, faltan los abridores + de las listas jerárquicas y los clics no hacen nada, es que los scripts todavía no se han ejecutado. Así se ven las funciones de «retrasar JavaScript hasta la interacción del usuario». Consulta el código fuente de la página y busca woof_front: si las etiquetas de script llevan un tipo como rocketlazyloadscript o litespeed/javascript, un optimizador las está reteniendo. Si woof_front no aparece en el código fuente, revisa el campo Inicie plugin en las siguientes páginas del sitio solamente (Init plugin on the next site pages only) (Advanced → Code): si enumera páginas, el plugin se carga solo en ellas.

Qué excluir de la optimización de JavaScript

La regla es la misma en todas las herramientas: jQuery, los bloques en línea y los archivos del plugin deben permanecer juntos y en su orden original. Excluir solo front.js es una solución a medias frecuente que no funciona, porque el bloque de ajustes y jQuery siguen retrasados. Estas tres líneas lo cubren todo:

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

La primera línea coincide con jQuery y jQuery UI (el control deslizante de precio al estilo WooCommerce lo usa). La segunda coincide con cada archivo del plugin y de sus extensiones. La tercera coincide con los bloques en línea: sus ids y las variables que contienen empiezan por woof_. Los campos de exclusión de los plugins de optimización suelen comparar una palabra clave tanto con la URL del archivo como con el contenido de los scripts en línea.

  • WP Rocket. En Optimización de archivos (File Optimization), añade las líneas a los archivos excluidos de Retrasar la ejecución de JavaScript (Delay JavaScript execution); si el filtro sigue fallando, añádelas también a las exclusiones de Cargar JavaScript diferido (Load JavaScript deferred), o desactiva esa opción. Si Optimizar la entrega de CSS (Optimize CSS delivery) está configurada para eliminar el CSS no utilizado, añade los estilos del plugin y las clases .woof a su lista segura de CSS: muchas clases del filtro aparecen solo después de ejecutarse JavaScript, por lo que un análisis de la página estática las considera no utilizadas.
  • LiteSpeed Cache. Combinar JS (JS Combine) y Cargar JS diferido (Load JS Deferred) (diferido o retrasado) son las causas habituales; añade las líneas a las exclusiones de JS y a las exclusiones de diferido/retrasado. Si la solicitud del filtro se completa pero los productos no se actualizan y la consola muestra Bad escaped character in JSON, desactiva Mapeo de CDN (CDN Mapping): en casos confirmados reescribía la respuesta AJAX.
  • Autoptimize. Cuando se agrega el JavaScript, jQuery pasa al archivo combinado al final de la página, mientras que el código en línea se queda donde estaba y se ejecuta demasiado pronto. Mantén js/jquery/jquery.min.js y woocommerce-products-filter en Excluir scripts de Autoptimize (Exclude scripts from Autoptimize).
  • SiteGround Speed Optimizer, WP-Optimize y similares. Las opciones de combinar, diferir y «retrasar scripts en línea» necesitan las mismas exclusiones, o deben estar desactivadas.
  • Cloudflare Rocket Loader. Carga todos los scripts de forma asíncrona, incluidos los bloques en línea, y además impide que se inicie la extensión Constructor de filtros en el front (Filter front builder). Desactívalo en los ajustes de velocidad de Cloudflare y después purga la caché de Cloudflare.
  • La minificación de HTML que «elimina caracteres innecesarios» puede dañar los scripts en línea. Desactiva su minificación de JavaScript en línea.
  • Código del tema o de un fragmento en el filtro script_loader_tag. WordPress pasa el bloque en línea por este filtro junto con la etiqueta de script, así que el código que elimina atributos o reemplaza comillas ahí puede corromperlo. Elimina ese código o límitalo a otros handles.

Dos ajustes dentro del filtro

Código JavaScript después de AJAX (JavaScript code after AJAX is done) (WooCommerce → Settings → Products Filter → Advanced → Code) se inserta en el bloque de ajustes en línea como cuerpo de una función. Un error tipográfico ahí, como un paréntesis sin cerrar, rompe todo el bloque, y todas las variables del filtro pasan a ser «not defined». Vacía el campo para probar; para ejecutar código después del filtrado, el evento woof_ajax_done es un lugar más seguro.

Optimizar la carga de los archivos JavaScript de HUSKY (Optimize loading of HUSKY JavaScript files) (Advanced → Options) alterna entre dos formas de carga: No carga front.js más cuatro scripts independientes para botones de opción, casillas y listas desplegables; Sí (Yes) carga un único archivo comprimido, js/front_comprssd.js, en el pie de página. Algunas configuraciones de optimizadores funcionan con un valor y no con el otro. Prueba ambos, purgando todas las cachés después de cada cambio.

Caché de páginas y el «nonce error»

En modo AJAX (Intenta ajaxificar la tienda (Try to ajaxify the shop) en la pestaña Options, o una página con [woof_products is_ajax=1]) y con el atributo ajax_redraw, el filtro pide al servidor los productos nuevos y envía el token woof_front_nonce tomado de la página. El servidor lo comprueba y, si no es válido, responde con el texto plano nonce error. El script espera JSON, no puede leer esa respuesta y el indicador de carga se queda en pantalla.

El token se crea cuando se genera el HTML. Para los visitantes sin sesión, los nonces de WordPress son válidos como mínimo 12 y como máximo 24 horas. Una página servida desde una caché más antigua que eso lleva un token muerto. Por eso el problema aparece en páginas en caché un día después de crear la caché, y por eso a veces ayuda recargar: casualmente se obtiene una copia reciente. Vaciar la caché lo arregla solo durante unas horas. Soluciones duraderas:

  • Mantén la vida útil de la caché de las páginas HTML por debajo de las 12 horas. La vida útil predeterminada de WP Rocket, de 10 horas, es segura; el almacenamiento prolongado de HTML en una CDN es el culpable típico.
  • No almacenes en caché el HTML de la tienda y de las categorías en la CDN. Con Cloudflare, añade una regla de caché que omita la caché para la tienda, las URL de /product-category/ y cualquier otra página con el filtro, y conserva la caché de páginas de WordPress, que respeta su propia vida útil. Omitir solo las URL filtradas no basta: el token que usa el visitante procede de la página donde empieza el filtrado.
  • Amplía la vida útil de este token en concreto. Desde WordPress 6.1, el filtro nonce_life recibe el nombre de la acción, de modo que el token del filtro puede durar más sin tocar ningún otro nonce del sitio. El token protege únicamente la solicitud pública del listado de productos.
/*
 * 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);

El modo de redirección simple, sin AJAX y sin ajax_redraw, no usa el token en absoluto: cada cambio del filtro carga una URL nueva, y la caché de páginas puede servir las URL filtradas como cualquier otra página. Si llamas al filtro desde tu propio código, por ejemplo con una solicitud jQuery personalizada a woof_draw_products, los datos de la solicitud deben incluir nonce_filter: woof_front_nonce, o el servidor responderá nonce error incluso sin ninguna caché.

Filtros obsoletos y otros efectos secundarios de la caché

  • Los ajustes modificados del filtro no se reflejan. Los ajustes forman parte del HTML en caché y del bloque en línea. Purga todas las capas de caché después de guardarlos: el plugin de caché, la caché del servidor (Varnish, Nginx, caché del hosting), la CDN, y después fuerza la recarga del navegador (Ctrl+F5, Cmd+Shift+R en Mac).
  • Un enlace filtrado se abre sin nada seleccionado, o una tienda limpia se abre con selecciones antiguas. La caché trata las URL con distintas cadenas de consulta como una sola página. Cada URL ?swoof=1&... debe almacenarse en caché por separado o no almacenarse, así que nunca configures la caché para ignorar las cadenas de consulta en las URL de la tienda.
  • El filtro móvil aparece en el escritorio, o al revés. El modo móvil del filtro y algunas extensiones deciden en el servidor, a partir del user agent del navegador, qué imprimir. Una página almacenada en caché para un teléfono no debe servirse a un ordenador de escritorio: activa archivos de caché separados para dispositivos móviles.
  • La primera visita a una combinación de filtros nueva es más lenta: esa URL aún no tiene copia en caché. Para la velocidad en general, consulta cómo acelerar el filtrado en catálogos grandes.

Un orden seguro para las pruebas

  1. Trabaja en una ventana privada, sin sesión iniciada y con la consola abierta.
  2. Desactiva toda la optimización de JavaScript (minificar, combinar, diferir, retrasar, Rocket Loader) y purga todas las capas de caché. Si ahora el filtro funciona, la causa es la optimización. Si sigue fallando, la causa es otra: lee el primer error de la consola y prueba con un tema predeterminado en una copia de staging.
  3. Vuelve a activar las opciones una a una, purga y prueba después de cada una. Cuando una rompa el filtro, añade las tres líneas de exclusión a esa opción o déjala desactivada.
  4. En modo AJAX, comprueba el filtro de nuevo en una página que lleve un día en la caché. Si no aparece ningún nonce error, la vida útil de la caché o la del token es la correcta.
  5. Prueba también en un teléfono además de en un ordenador, y en la segunda página de resultados.

Si después de estos pasos el filtro sigue funcionando solo para los usuarios con sesión iniciada, abre un tema en el foro de soporte de HUSKY con el enlace de la página, el primer error de la consola y la lista de opciones de optimización que tienes activadas, y lo revisaremos.