Conectar el filtro HUSKY a una tabla de productos WooCommerce
El filtro integrado en una tabla de productos cubre lo básico: precio, SKU, stock, categorías y atributos. Cuando los compradores necesitan filtros que dependan unos de otros, opciones limitadas a lo que realmente está disponible o un enlace al resultado filtrado, conecta una tabla de productos WooCommerce con el filtro HUSKY (WooCommerce Products Filter, también conocido como WOOF). La tabla muestra entonces exactamente los productos que encuentra HUSKY, con sus propias columnas, ordenación y paginación. A continuación se explica cómo funciona la conexión, los dos shortcodes que necesita y cómo conseguir con ella filtros dependientes y URL de filtro que se puedan compartir.
Lo que no hace el filtro integrado de la tabla
La pestaña Filtro de una tabla construye un filtro AJAX rápido y, para muchas tablas, es suficiente. Tiene límites deliberados:
- Sin opciones dependientes. Cada elemento enumera todos los términos no vacíos de su taxonomía en toda la tienda. Elegir Product A en una lista desplegable no reduce las tallas que se ofrecen en la siguiente.
- Sin recuentos ni ocultación de callejones sin salida. Un comprador puede elegir una combinación que no devuelve nada y solo lo descubre al ver la tabla vacía.
- Sin el estado del filtro en la URL. El filtro funciona dentro de la página, así que una vista filtrada no se puede guardar como marcador ni enviar a otra persona.
- Controles sencillos. Los nombres largos de términos se cortan en una selección múltiple estrecha, y no hay muestras de color, imágenes ni formularios paso a paso.
HUSKY hace todo esto. Es un plugin independiente del mismo equipo, disponible en wordpress.org, y la tabla incluye una conexión lista para él.
Conectar el filtro HUSKY a una tabla de productos WooCommerce
Cuando una tabla tiene filter_provider='woof', cada solicitud de sus filas pasa a HUSKY sus parámetros actuales, HUSKY calcula los ID de los productos coincidentes y la tabla muestra solo esos productos, usando aún sus propias columnas, ordenación y paginación. La conexión está en el plugin de la tabla, así que no hace falta añadir nada a functions.php; el código de la página woot_filter_provider_ es el mismo mecanismo, a modo de referencia.
- Instala y activa HUSKY. En WooCommerce → Ajustes → Filtro de productos (Products Filter), en la pestaña Estructura (Structure), activa las taxonomías y los elementos que debe tener el filtro (categorías, atributos, precio, etc.) y guarda.
- Pon el filtro y la tabla en la misma página:
Sustituye[woof ajax_redraw=1 autosubmit=1 redirect="https://example.com/price-list/"] [woot id=1 filter_provider='woof']1por el ID de tu tabla y la dirección por la de esta misma página. El atributoredirectes importante: en una página normal (cualquiera que no sea un archivo de categoría, etiqueta o atributo de producto) HUSKY construye sus enlaces de búsqueda en la página de la tienda, así que sin él una búsqueda puede llevar al comprador a la tienda, donde no está la tabla. El filtro también puede colocarse en un widget de barra lateral de esa página; el widget de HUSKY tiene los mismos ajustes que Redirigir a (Redirect to) y Redibujado AJAX del formulario (Form AJAX redrawing). - Comprueba las comillas. Escribe los shortcodes en un editor de código o en un bloque Shortcode. Los procesadores de texto y algunos editores convierten
'woof'en’woof’con comillas tipográficas; el valor del atributo deja entonces de ser igual awoof, y la tabla ignora el filtro sin ningún error. También puedes quitar las comillas:filter_provider=wooffunciona. - Desactiva el filtro y la búsqueda propios de la tabla. Con
filter_provider='woof'la tabla delega el filtrado en HUSKY, y la mayoría de los elementos de su propia pestaña Filtro, así como su campo Buscar por título (search by title), dejan de restringir los resultados. Deja vacía la pestaña Filtro o activa Desactivar formulario de filtro (Disable filter form) en las Opciones de la tabla, desactiva allí Mostrar búsqueda por título (Show search by title) y usa en su lugar la búsqueda de texto de HUSKY, como se describe en buscar en una tabla de productos por descripción.
Con o sin recarga de la página
El atributo ajax_redraw=1 decide cómo reacciona la página a un cambio en el filtro.
[woof ajax_redraw=1 autosubmit=1]: sin recarga. En cada cambio HUSKY redibuja solo su formulario, con los recuentos actualizados, y lo anuncia con un evento de JavaScript; la tabla escucha ese evento y vuelve a cargar sus filas con el nuevo filtro. Tras el primer cambio, la tabla oculta el botón Filtrar (Filter) de HUSKY, ya que la tabla se actualiza sola. Para ocultar el botón desde el principio, añade.woof[data-ajax-redraw="1"] .woof_submit_search_form { display: none; }al CSS personalizado de tu tema.[woof redirect="..."]sinajax_redraw: con recarga. Cada cambio (o el botón Filtrar (Filter), si el envío automático está desactivado) recarga la página con el filtro en la URL, y la tabla lo lee al cargarse. Es más lento de usar, pero la barra de direcciones siempre contiene el filtro actual.
Las instrucciones antiguas usan [woof is_ajax=1]. is_ajax es un atributo de [woof_products], no de [woof], que lo ignora, así que esa combinación funciona en modo recarga. No añadas [woof_products] a la página de la tabla: imprime una segunda lista de productos normal debajo de la tabla.
Filtros dependientes que muestran solo las opciones disponibles
Los filtros dependientes son una función de HUSKY llamada Recuento dinámico (Dynamic recount). Cuando un comprador selecciona un valor en una sección, HUSKY recalcula todas las demás secciones con los productos que quedan, de modo que las opciones sin resultados desaparecen. En WooCommerce → Ajustes → Filtro de productos (Products Filter) → Opciones (Options):
- Mostrar recuento (Show count): Sí. El recuento dinámico se apoya en los recuentos.
- Recuento dinámico (Dynamic recount): Sí. Los recuentos siguen la selección actual.
- Ocultar términos vacíos (Hide empty terms): Sí. Las opciones con recuento 0 se ocultan en lugar de mostrarse en gris.
Elige Product A y la sección de tallas muestra solo Small y Medium, si esas son las únicas tallas de Product A. Con ajax_redraw=1 esto ocurre en el mismo sitio; en modo recarga, tras la recarga.
Conviene conocer dos ajustes relacionados. Las distintas secciones se restringen siempre entre sí: un color y una talla deben cumplirse a la vez. Dentro de una sección, dos casillas marcadas significan por defecto una u otra; para exigir ambos términos en el mismo producto, abre las opciones adicionales de esa taxonomía en la pestaña Estructura (Structure) y establece Lógica de filtrado (Logic of filtering) en AND. Para una selección guiada, en la que el comprador responde una pregunta cada vez (color base, luego nombre del color, luego estilo), HUSKY tiene una extensión de filtro paso a paso con el shortcode [woof_step]; actívala en la pestaña Extensiones (Extensions) y consulta su documentación en el sitio de HUSKY.
URL que se pueden compartir con los filtros actuales
HUSKY mantiene el filtro en parámetros de la URL: el indicador de búsqueda swoof=1 más un parámetro por sección, por ejemplo:
https://example.com/price-list/?swoof=1&product_cat=shirts&pa_color=red,blue
Una tabla con filter_provider='woof' lee estos parámetros al cargar la página, de modo que el enlace abre la tabla ya filtrada, con las mismas opciones marcadas en el formulario de HUSKY. Así se comparte una tabla filtrada con un cliente, se incluye en un boletín o se enlaza un elemento de menú con una selección ya preparada.
En modo recarga, la barra de direcciones contiene siempre el enlace actual, listo para copiar. En el modo sin recarga, la barra de direcciones no se actualiza de forma fiable en cada cambio, así que si te importan más los enlaces compartibles que evitar las recargas, usa [woof] sin ajax_redraw. Un enlace también se puede construir a mano a partir de los slugs de los términos, que se muestran en Productos → Categorías y Productos → Atributos.
Otros plugins de filtro: el selector del contenedor de productos y el hook
Muchos plugins de filtro piden un "contenedor de productos" o un "selector de la lista de productos", ul.products por defecto, y sustituyen su contenido tras filtrar. En una tabla de productos las filas están en .woot-table tbody, una fila por producto. Sin embargo, introducir ese selector no suele bastar: un plugin así coloca en el cuerpo de la tabla su propio marcado de producto, las tarjetas del bucle de la tienda, en lugar de filas de tabla, y las columnas, la ordenación y la paginación de la tabla dejan de coincidir con lo que se muestra.
Una conexión que funciona pasa los resultados del filtro a la propia consulta de la tabla. La tabla llama al filtro woot_filter_provider_{name} para cada tabla con filter_provider='{name}', con los argumentos de la consulta, los datos del filtro y los argumentos del shortcode, y el plugin limita la consulta, normalmente estableciendo post__in con los ID que encontró su filtro. La página woot_filter_provider_ muestra como modelo la adaptación completa para HUSKY, y el hook woot_wp_query_args cubre los casos más sencillos en los que una tabla solo necesita una selección fija. El plugin de filtro también tiene que avisar a la tabla de cuándo debe redibujarse, como hace HUSKY con su evento; esa parte depende de su desarrollador.
Lista de comprobación para resolver problemas
- La tabla ignora el filtro: busca comillas tipográficas alrededor de
woofen el shortcode y asegúrate de que HUSKY está activo. - Un cambio en el filtro abre la página de la tienda: añade a
[woof]el atributoredirectcon la dirección de la página de la tabla. - El filtro no tiene elementos: no hay taxonomías ni elementos activados en la pestaña Estructura (Structure) de HUSKY.
- No ocurre nada tras un cambio en modo sin recarga: el atributo debe ser exactamente
ajax_redraw=1y la consola del navegador no debe tener errores de JavaScript. Excluye los scripts de ambos plugins de las opciones de retraso y combinación de JavaScript de los plugins de optimización. - El filtro no aparece en la página: si en la pestaña Avanzado (Advanced) de HUSKY se usa Iniciar el plugin solo en las páginas siguientes (Init plugin on the next site pages only), añade la página de la tabla a su lista.
- La tabla muestra los productos correctos pero las opciones no desaparecen: Mostrar recuento (Show count), Recuento dinámico (Dynamic recount) y Ocultar términos vacíos (Hide empty terms) deben estar todos en Sí.
- Aparece una segunda lista de productos debajo de la tabla: quita
[woof_products]de la página.
Si la tabla y el filtro siguen sin funcionar juntos, abre un tema en el foro de soporte de WOOT con un enlace a la página.