HUSKY - WooCommerce Product Filter Professional

La paginación del filtro de WooCommerce no funciona: causas y soluciones

Cuando la paginación del filtro de WooCommerce no funciona, suele manifestarse de una de estas formas: enlaces de página que apuntan a /wp-admin/admin-ajax.php?paged=2, una página en blanco con un único 0, páginas vacías o un 404 al final de los resultados filtrados, el filtro olvidado en la página 2, o un scroll infinito que se detiene después del primer filtrado. Cada síntoma tiene su propia causa, y la mayoría proceden de cómo construye el tema su paginación, no del filtro. Empieza por la tabla y ve después a la sección correspondiente.

Qué vesCausa probable
Enlaces a admin-ajax.php?paged=2, página en blanco con 0Modo AJAX con un marcado de paginación no estándar
Dos paginaciones o dos líneas «Mostrando 1–12 de 40» después de filtrarEl tema imprime sus propios elementos fuera del área que HUSKY actualiza
Más páginas que productos, últimas páginas con 404 o vacíasNúmeros distintos de «productos por página» en HUSKY, el tema y el constructor
Cuadrícula vacía al cambiar un filtro estando en la página 3El número de página antiguo se arrastra al nuevo enlace del filtro
Filtro inactivo o sin estilo tras pasar a la página 2La paginación AJAX propia del tema, «cargar más» o el scroll infinito
Falta el filtro en la página 2, o la página 2 muestra productos sin filtrarFiltro colocado en el contenido de la página, o enlaces de paginación que pierden el filtro
Ninguna paginación después de filtrarPlantilla personalizada o tema que imprime la paginación fuera de los hooks del bucle

Enlaces a admin-ajax.php: modo AJAX y marcado del tema

Con Intenta ajaxificar la tienda (Try to ajaxify the shop) en Si (Yes) (o [woof_products is_ajax=1] en una página), HUSKY no recarga la página. Pide al servidor productos nuevos a través de admin-ajax.php y reemplaza el bloque de productos, paginación incluida. Como esa paginación nueva se genera dentro de la solicitud AJAX, sus enlaces apuntan a admin-ajax.php?paged=2. Nunca están pensados para seguirse: HUSKY captura los clics en .woocommerce-pagination a.page-numbers, lee el número de página y carga esa página por AJAX.

Si el tema cambia el marcado de la paginación (otra clase en el contenedor, enlaces sin la clase page-numbers, su propia función de paginación), el clic no se captura y el navegador abre el enlace tal cual. WordPress responde con 0 a una solicitud a admin-ajax.php sin acción, y esa es la página en blanco. El marcado que HUSKY espera es el propio de WooCommerce:

<nav class="woocommerce-pagination">
  <ul class="page-numbers">
    <li><span aria-current="page" class="page-numbers current">1</span></li>
    <li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
    <li><a class="next page-numbers" href="https://example.com/shop/page/2/">&rarr;</a></li>
  </ul>
</nav>

Inspecciona tu paginación en el navegador y compárala. Un tema que sobrescribe woocommerce/loop/pagination.php o usa su propia paginación puede corregirse en un tema hijo (basta incluso con una errata como woocmmerce-pagination en la clase del contenedor para romperla), pero la solución fiable no necesita código: pasa al modo de redirección. Abre los ajustes del plugin, pestaña Opciónes (Options), establece Intenta ajaxificar la tienda (Try to ajaxify the shop) en No y guarda; en las páginas con el shortcode usa is_ajax=0. Cada filtrado recarga entonces la página, y la paginación es la paginación normal del tema. AJAX no se puede desactivar solo para la paginación. Consulta también problemas de paginación en modo AJAX.

Si la opción dice que se guardó pero vuelve a Si (Yes), el Turbo Mode está activado. El Turbo Mode solo funciona con AJAX y vuelve a activar la opción en cada carga de página; desactiva primero el Turbo Mode.

Paginación duplicada o un contador de resultados que no se actualiza

Algunos temas imprimen el contador de resultados, la ordenación o la paginación fuera del bloque que HUSKY reemplaza. Después del filtrado AJAX ves entonces el elemento obsoleto del tema junto al nuevo, o un contador que todavía describe la tienda sin filtrar. Para el contador, introduce su selector, normalmente .woocommerce-result-count, en Avanzado → Opciones → Selector CSS del contador de resultados (Advanced → Options → Result count css selector); HUSKY lo redibuja entonces después de cada filtrado (Selector CSS del desplegable de orden (Order dropdown css selector) hace lo mismo con la ordenación). Si quedan duplicados, el modo de redirección los elimina.

Páginas de más y un 404 al final de los resultados

WordPress decide si /page/7/ existe a partir de la consulta principal de la página: si la consulta principal tiene seis páginas, la página 7 es un 404, sea lo que sea lo que muestre una cuadrícula de productos en esa página. Los problemas empiezan cuando la cuadrícula visible y la consulta principal cuentan los productos por página de forma distinta, por ejemplo un widget de constructor que muestra 30 por página mientras la consulta principal usa los 12 del tema: la paginación y los números de página existentes dejan de coincidir, y las páginas salen vacías o terminan en un 404 a mitad de camino. El ajuste propio de HUSKY, Avanzado → Opciones → Productos por página (Advanced → Options → Products per page), se aplica solo mientras hay un filtro activo (su valor predeterminado, -1, significa «no gestionar»), así que una discrepancia con él aparece solo después de filtrar.

  1. Encuentra todos los lugares que establecen el número: los ajustes del catálogo del tema o de WooCommerce, el widget de productos del constructor y el Productos por página (Products per page) de HUSKY.
  2. Establece el mismo número en todos ellos, o pon el de HUSKY en -1 para que no interfiera.
  3. Prueba sin el filtro: desactiva HUSKY un momento y abre directamente una página alta, como /shop/page/17/. Si ahora es un 404, la discrepancia está entre el tema y el constructor, no en el filtro.

Si el número de páginas sigue siendo demasiado alto solo al filtrar, el tema probablemente calcula la paginación a partir de otra consulta; corregir la paginación que muestra demasiadas páginas incluye un fragmento que fuerza el total desde la consulta filtrada. Avada tiene un caso propio, descrito en Avada: el filtro se pierde en la paginación.

Página vacía al cambiar un filtro en la página 2 o posteriores

Un visitante en la página 3 cambia un filtro. El nuevo resultado tiene una sola página, así que si el nuevo enlace sigue pidiendo la página 3, la cuadrícula queda vacía o la página es un 404. HUSKY lo evita en la paginación estándar: quita /page/N/ y el parámetro product-page de WooCommerce del enlace que construye, y en modo AJAX vuelve a la página 1 en cada cambio. Otros parámetros de página de la cadena de consulta se copian al nuevo enlace junto con el resto de la dirección, por ejemplo ?paged=3 en sitios con enlaces permanentes simples o el parámetro de paginación propio de un constructor de páginas. Usa enlaces permanentes amigables (Ajustes → Enlaces permanentes (Settings → Permalinks), cualquier estructura salvo Simple (Plain)) y la paginación estándar de WooCommerce, y revisa la dirección después de cambiar un filtro: no debe contener ningún número de página.

Paginación AJAX del tema, «cargar más» y scroll infinito

Muchos temas tienen su propia tienda AJAX: paginación, botones «cargar más», scroll infinito, ordenación AJAX o un conmutador de cuadrícula/lista que reemplazan los productos y la barra lateral sin recargar. HUSKY inicializa su formulario cuando se carga la página (y después de su propia actualización AJAX). Cuando el tema inserta HTML nuevo de la barra lateral, los nuevos elementos del filtro nunca se inicializan, por lo que el filtro deja de reaccionar, pierde su estilo o envía valores erróneos. La solicitud de «cargar más» de un tema también construye su propia consulta de «la página siguiente» y no sabe nada del filtro, por eso puede añadir productos sin filtrar a una lista filtrada.

  • Desactiva la paginación AJAX, la tienda AJAX, el scroll infinito y las opciones de «cargar más» del tema y prueba con la paginación estándar. Con esto se arreglan la mayoría de los casos.
  • Para el scroll infinito, HUSKY tiene soporte integrado para el plugin gratuito YITH Infinite Scrolling: después de cada filtrado AJAX reinicializa el scroll y corrige el enlace de la página siguiente. Usa los selectores indicados en scroll infinito para productos filtrados.
  • Cualquier otro script que deba reiniciarse tras el filtrado AJAX puede escuchar el evento woof_ajax_done, descrito en el evento woof_ajax_done. Qué llamada lo reinicia depende de ese script; pregunta a su autor.
/*
 * Runs after every HUSKY AJAX filtering.
 * Put it in a JavaScript file of your child theme.
 */
jQuery(document).on('woof_ajax_done', function () {
    // call the init function of your infinite scroll or load-more script here
});

En lugar de un archivo del tema, el cuerpo de esa función puede ir en Avanzado → Código → Código JavaScript tras finalizar AJAX (Advanced → Code → JavaScript code after AJAX is done).

El filtro falta o se olvida en la página 2

  • El filtro desaparece en la página 2. Estaba colocado en el contenido de la página de la tienda o en la descripción de una categoría. WooCommerce imprime ambos solo en la primera página de un archivo. Coloca el filtro en un widget de la barra lateral, en un área del tema que aparezca en todas las páginas o en un bloque del constructor fuera de la descripción.
  • La página 2 muestra productos sin filtrar. En el modo de redirección, la paginación estándar de WooCommerce mantiene el filtro en sus enlaces (/shop/page/2/?swoof=1&pa_color=red). Pasa el cursor sobre un enlace de página: si faltan swoof=1 y los valores de tu filtro, el tema construye sus propios enlaces sin la cadena de consulta; cambia a la paginación estándar o corrige la función de enlaces del tema.
  • La página 2 redirige a la tienda o pierde la categoría. Los plugins y el código personalizado que reescriben las URL de productos o los slugs de archivo pueden entrar en conflicto con los enlaces del filtro. Prueba con ellos desactivados; para un caso conocido, véase HUSKY y Permalinks Manager Pro.

Ninguna paginación después de filtrar

En modo AJAX el bloque actualizado contiene lo que WooCommerce imprime en el hook woocommerce_after_shop_loop, y ahí es donde vive la paginación de WooCommerce. Un tema que quita la paginación de ese hook e imprime la suya en otro lugar la pierde después del primer filtrado AJAX; el modo de redirección evita el problema. Si construiste tu propia plantilla de archivo, imprime tú mismo la paginación después del bucle de productos:

<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>

Una plantilla personalizada también necesita los hooks estándar del bucle de la tienda para que el modo AJAX funcione en absoluto; la URL del filtro cambia pero los productos no explica cuáles son.

Para llevar a los visitantes de vuelta al principio de los productos después de un cambio de página, consulta desplazamiento automático tras el filtrado AJAX o, en modo de redirección, desplazamiento automático a los productos en modo de redirección.

Lista de comprobación cuando la paginación del filtro de WooCommerce no funciona

  • Probado en modo de redirección (Intenta ajaxificar la tienda (Try to ajaxify the shop) = No, Turbo Mode desactivado, is_ajax=0 en los shortcodes) después de vaciar todas las cachés.
  • El marcado de la paginación es nav.woocommerce-pagination con enlaces a.page-numbers.
  • El número de productos por página es el mismo en el tema, el constructor y HUSKY, o el de HUSKY es -1.
  • La paginación AJAX del tema, «cargar más» y el scroll infinito están desactivados, o se reinicializan con woof_ajax_done.
  • Los enlaces de paginación de una página filtrada contienen swoof=1 y los valores del filtro, y ningún número de página antiguo sobrevive a un cambio de filtro.
  • El filtro está en una barra lateral o en un área de la plantilla, no en la descripción de la tienda ni de la categoría.

Si la paginación sigue fallando en modo de redirección con la paginación estándar del tema, abre un tema en el foro de soporte de HUSKY con el enlace de la página y la dirección de una página que falla.