El filtro AJAX de WooCommerce rompe la cuadrícula de productos: soluciones
La tienda se ve bien hasta el primer clic en el filtro. Entonces tres columnas pasan a ser cuatro, las filas se llenan de huecos, las tarjetas de producto pierden las insignias o los botones del tema, o la barra lateral se desliza bajo los productos. Cuando un filtro AJAX de WooCommerce rompe la cuadrícula de productos, los productos en sí son correctos; lo que ha cambiado es el HTML que los dibuja. A continuación verás qué sustituye el modo AJAX de HUSKY, por qué el marcado específico del tema se pierde por el camino y la solución para cada síntoma.
Qué sustituye el modo AJAX y qué no puede copiar
Con Intenta ajaxificar la tienda (Try to ajaxify the shop) establecido en Sí (Yes) (WooCommerce → Ajustes → Products Filter → Opciones), el plugin delimita la zona de productos de las páginas de la tienda y de categorías. En el hook woocommerce_before_shop_loop (prioridad 2) abre un contenedor <div class="woocommerce woocommerce-page woof_shortcode_output"> con <div id="woof_results_by_ajax"> dentro, y en woocommerce_after_shop_loop (prioridad 10) cierra ambos.
Cuando un visitante cambia el filtro, el script envía una petición a /wp-admin/admin-ajax.php con la acción woof_draw_products. El servidor renderiza [woof_products is_ajax=1] y el script sustituye el contenedor por el resultado. Ese resultado se construye solo con piezas estándar de WooCommerce:
- el hook
woocommerce_before_shop_loop(avisos, contador de resultados, desplegable de ordenación); woocommerce_product_loop_start(), que imprime<ul class="products columns-N">;- la parte de plantilla
content-product.phppara cada producto; woocommerce_product_loop_end()y el hookwoocommerce_after_shop_loop(paginación).
De ello se deducen dos cosas. Primero, todo lo que la plantilla de archivo de tu tema imprime por su cuenta entre los dos hooks (contenedores adicionales, una clase de cuadrícula, el aspecto de bucle de un maquetador) no está en el nuevo HTML. Segundo, el nuevo HTML se produce en una petición admin-ajax, no en la página de la tienda. El código que se ejecuta mientras se carga la página de la tienda, en la acción wp o template_redirect, dentro de la plantilla de archivo o solo cuando is_admin() es falso, nunca se ejecuta para él. Los scripts del tema que dieron estilo a la cuadrícula una sola vez al cargar la página tampoco se ejecutan de nuevo.
Averigua qué ha cambiado: compara el marcado antes y después
Abre la tienda en una ventana privada, haz clic derecho en el primer producto y elige Inspeccionar (Inspect). Anota las clases de ul.products, de sus elementos padre y del primer li.product. Aplica un filtro e inspecciona el mismo lugar otra vez. La diferencia indica la solución:
| Síntoma tras filtrar | Causa | Sección |
|---|---|---|
Distinto número de columnas, columns-4 en lugar de columns-3 | El ajuste de columnas del tema no se aplica en la petición AJAX | Columnas y huecos |
| Filas de 3, luego 1, luego 3; huecos en la cuadrícula | Las clases de fila first/last se cuentan para otro número de columnas | Columnas y huecos |
| La barra lateral o el pie se mueven, desaparecen o se repiten; productos mostrados dos veces | El tema no llama a los dos hooks del bucle de la tienda alrededor del bucle | Hooks del bucle de la tienda |
Falta una clase en ul.products, vuelven los botones o las insignias, se pierde la vista de cuadrícula/lista, imágenes en blanco | Marcado del tema, condiciones de PHP o scripts del tema | Funciones de tarjeta del tema |
Las columnas de producto cambian tras filtrar y aparecen huecos
[woof_products] toma su número de columnas del filtro loop_shop_columns de WooCommerce, que recurre a Productos por fila (Products per row) en Apariencia → Personalizar → WooCommerce → Catálogo de productos. Los temas con su propia opción de columnas suelen aplicarla solo mientras se carga una página de la tienda. En la petición AJAX ese código no se ejecuta, así que los resultados llegan con el valor de WooCommerce: a menudo 4 donde la tienda muestra 3.
Los huecos tienen la misma raíz. WooCommerce asigna al primer producto de cada fila la clase first y al último last, contados a partir de ese número de columnas, y la cuadrícula clásica con float empieza una fila nueva en cada first. Si el CSS del tema encaja 3 productos por fila y el HTML de AJAX cuenta 4, cada cuarto producto fuerza una fila nueva: 3 productos, luego 1 solo, luego 3 otra vez.
Fija el número de columnas una sola vez, para todas las peticiones, con el número que muestra tu tienda en escritorio:
/**
* Same number of columns on shop pages and in HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'loop_shop_columns', function () {
return 3; // products per row on desktop
}, 999 );
No lo envuelvas en comprobaciones como is_shop(), o se omitirá en la petición AJAX. La prioridad 999 hace que prevalezca sobre el filtro propio del tema. La breve pregunta frecuente forzar los resultados filtrados a un número fijo de columnas usa el mismo filtro. En una página personalizada, [woof_products columns=3] establece el número directamente. Los móviles y las tabletas reciben su estilo de las media queries del CSS del tema en ambos casos.
Si la clase dice columns-3 tras filtrar y los anchos siguen siendo incorrectos, el tema dimensiona los productos mediante una clase de su propio contenedor, fuera de la zona sustituida. Añade CSS para el contenedor AJAX en Apariencia → Personalizar → CSS adicional o en el campo Código CSS personalizado (Custom CSS code) del plugin (Avanzadas → Código):
/* HUSKY AJAX results: 3 products per row in a float-based grid */
#woof_results_by_ajax ul.products li.product {
width: 30.75%;
margin-right: 3.8%;
clear: none;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n) {
margin-right: 0;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n+1) {
clear: both;
}
Si tu tema maqueta ul.products con CSS grid en lugar de float, basta una regla: #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Envuelve cualquiera de las dos versiones en una media query de escritorio si el tema usa menos columnas en los móviles.
Barra lateral bajo los productos, pie roto, resultados duplicados: los hooks del bucle de la tienda
El modo AJAX necesita que el tema llame a woocommerce_before_shop_loop justo antes de la lista de productos y a woocommerce_after_shop_loop justo después, como hace la plantilla estándar de WooCommerce. Cuando no es así:
- Falta el hook de cierre. Los dos contenedores nunca se cierran, y el navegador los cierra solo al final de su elemento padre. La barra lateral, la segunda columna o el pie acaban dentro de la zona de productos: a menudo la barra lateral ya está bajo los productos al cargar la página, y tras el primer clic en el filtro todo lo que hay dentro del contenedor, incluida la barra lateral con el filtro, se sustituye por los resultados.
- Los hooks se llaman en otro lugar. Si el tema los activa en una barra de herramientas e imprime el bucle de productos después de
woocommerce_after_shop_loop, los resultados AJAX aterrizan en el contenedor mientras la cuadrícula original permanece debajo, de modo que los productos aparecen dos veces. - Los contenedores del tema cruzan los contenedores. Un elemento que el tema abre en
woocommerce_before_shop_loopy cierra enwoocommerce_after_shop_loopdebe quedar por completo dentro de los contenedores de HUSKY (abierto después de la prioridad 2, cerrado antes de la 10) o por completo fuera de ellos. Cualquier solapamiento intermedio rompe el anidamiento.
Para comprobarlo, abre el código fuente de la página (Ctrl+U), busca woof_results_by_ajax y sigue el HTML hacia abajo: tras el </ul> de cierre de los productos y la paginación debe haber dos </div> antes de que empiece la barra lateral o el pie. En la carpeta del tema, busca woocommerce_after_shop_loop en las plantillas de archivo. La parte de productos de una plantilla que funciona con el modo AJAX se parece al archive-product.php de WooCommerce:
<?php
if ( woocommerce_product_loop() ) {
do_action( 'woocommerce_before_shop_loop' );
woocommerce_product_loop_start();
if ( wc_get_loop_prop( 'total' ) ) {
while ( have_posts() ) {
the_post();
do_action( 'woocommerce_shop_loop' );
wc_get_template_part( 'content', 'product' );
}
}
woocommerce_product_loop_end();
do_action( 'woocommerce_after_shop_loop' );
} else {
do_action( 'woocommerce_no_products_found' );
}
Haz el cambio en una copia de la plantilla en un tema hijo, o pide al autor del tema que añada el hook que falta. Los diseños de maquetadores rara vez llaman a ambos hooks; para ellos, el modo de redirección, descrito más abajo, es la opción realista. Los productos que no cambian en absoluto se tratan en la URL del filtro cambia pero los productos no, y las plantillas de Elementor en Elementor Loop Grid y plantillas de archivo que no filtran.
Funciones de tarjeta del tema perdidas: insignias, botones, clases de cuadrícula, scripts
Cambios que tu PHP aplica solo en las páginas de la tienda
El código que oculta los botones de añadir al carrito, añade una línea de categoría o una insignia, y lo decide en wp o template_redirect con is_shop(), no se ejecuta en la petición AJAX, así que la tarjeta por defecto vuelve tras filtrar. Ejecútalo también para la petición de HUSKY. admin_init se activa en cada petición admin-ajax:
/**
* Card changes for shop pages AND for HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
function my_shop_card_changes() {
// Example: no add-to-cart buttons in the product grid
remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 );
}
// Normal page loads of the shop and product archives
add_action( 'wp', function () {
if ( is_shop() || is_product_taxonomy() ) {
my_shop_card_changes();
}
} );
// HUSKY AJAX filtering, sent through admin-ajax.php
add_action( 'admin_init', function () {
if ( wp_doing_ajax() && isset( $_REQUEST['action'] ) && 'woof_draw_products' === $_REQUEST['action'] ) {
my_shop_card_changes();
}
} );
Las opciones del tema que cambian la tarjeta (una línea de categoría, una imagen al pasar el cursor, un botón de vista rápida) suelen aplicarse de la misma manera dentro del tema. Si desaparecen tras filtrar y el tema no tiene un hook que cubra también las peticiones AJAX, usa el modo de redirección.
Clases que el tema añade a la lista de productos
Si la comparación muestra una clase en ul.products que existe al cargar la página y falta tras filtrar, añádela a la respuesta AJAX con el filtro woof_draw_products_html. Recibe el HTML que está a punto de enviarse al navegador:
/**
* Add the theme's grid class to the product list in HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
return str_replace(
'<ul class="products columns-',
'<ul class="products my-theme-grid columns-', // use the class from your page
$html
);
}, 10, 2 );
La cadena de búsqueda coincide con el loop/loop-start.php propio de WooCommerce; si tu tema sobrescribe ese archivo, copia la etiqueta de apertura del código fuente de la página. Cuando el tema renderiza las tarjetas con una parte de plantilla distinta de content-product.php, devuelve su nombre con el filtro woof_template_part: el valor product-grid carga content-product-grid.php desde la carpeta woocommerce de tu tema.
Scripts del tema: imágenes diferidas, alturas iguales, masonry, vista rápida
Los scripts que se ejecutan una sola vez al cargar la página (imágenes con carga diferida, tarjetas de igual altura, masonry, conmutadores de cuadrícula/lista, botones de vista rápida) no ven los productos nuevos. HUSKY dispara el evento de jQuery woof_ajax_done tras cada sustitución; coloca ahí la llamada de inicialización del tema, en un archivo JS del tema o en Código JavaScript después de AJAX (JavaScript code after AJAX is done) (Avanzadas → Código). El autor del tema puede indicar el nombre de la función; más sobre el evento en woof_ajax_done.
jQuery(document).on('woof_ajax_done', function () {
// Many layout scripts recalculate on resize
jQuery(window).trigger('resize');
// Call your theme's own init function here if it has one
});
Contador de resultados u ordenación mostrados dos veces
Un tema que imprime su propio contador y su barra de ordenación fuera de la zona de productos puede recibir igualmente las copias por defecto de WooCommerce dentro de los resultados AJAX. Oculta las copias interiores, solo si realmente son duplicados:
#woof_results_by_ajax .woocommerce-result-count,
#woof_results_by_ajax .woocommerce-ordering {
display: none;
}
Si el contador propio del tema fuera de la zona no se actualiza tras filtrar, pon su selector CSS en Selector CSS del contador de resultados (Result count css selector) (Avanzadas → Opciones): el plugin enviará entonces un contador nuevo con cada respuesta AJAX y sustituirá el elemento que encuentre.
Cuándo renunciar a AJAX: modo de redirección y modo Turbo
Algunos diseños no se pueden reconstruir con piezas estándar de WooCommerce: aspectos de bucle de maquetadores, carruseles, plantillas de tema sin los hooks. Establece Intenta ajaxificar la tienda (Try to ajaxify the shop) en No. Cada cambio del filtro carga entonces la URL filtrada y tu tema renderiza toda la página como de costumbre, de modo que la cuadrícula es idéntica a la de la tienda sin filtrar. Lo que pierdes es la actualización en el mismo lugar. Para recargar una sola vez por búsqueda en lugar de tras cada clic, establece Autoenviar (Autosubmit) en No para que el filtro espere a su botón, y consulta desplazamiento automático a los productos en el modo de redirección para llevar al visitante a los resultados.
Si Intenta ajaxificar la tienda (Try to ajaxify the shop) vuelve a Sí (Yes), es que el modo Turbo está activado: activa el modo AJAX en cada carga de página. Establece primero Activar modo Turbo (Enable turbo mode) en No en su pestaña, después desactiva AJAX y vacía la caché de página para que los visitantes reciban el nuevo ajuste.
Lista de comprobación
- Marcado comparado antes y después de filtrar en el inspector del navegador.
loop_shop_columnsdevuelve el número de columnas de la tienda sin condiciones de página.- El código fuente de la página muestra los dos contenedores de HUSKY cerrándose justo después de los productos y la paginación.
- Los cambios de tarjeta en PHP se ejecutan también para la petición
woof_draw_products; los scripts del tema se vuelven a ejecutar enwoof_ajax_done. - Si el diseño sigue siendo distinto: Intenta ajaxificar la tienda (Try to ajaxify the shop) = No, con el modo Turbo desactivado y las cachés vaciadas.
Si el diseño sigue rompiéndose con un tema por defecto como Storefront y solo HUSKY activo, abre un tema en el foro de soporte de HUSKY con un enlace a la página de la tienda y una descripción de lo que cambia tras filtrar.