HUSKY - WooCommerce Product Filter Professional

Filtro de año, marca y modelo para WooCommerce con desplegables dependientes

Un filtro de año, marca y modelo para WooCommerce pregunta primero la marca, luego ofrece solo los modelos de esa marca, después solo los años de ese modelo y muestra las piezas que encajan. HUSKY lo construye con el tipo de filtro Desplegable Jerarquía (Hierarchy drop-down). Que funcione depende menos de los ajustes que de cómo estén guardados los datos de los vehículos: los desplegables solo pueden seguir una estructura de padres e hijos que ya exista en una taxonomía. A continuación: cómo funcionan los desplegables dependientes, cómo estructurar los datos, la configuración y qué comprobar cuando el segundo desplegable se queda vacío.

Cómo funciona un filtro de año, marca y modelo en HUSKY

El Desplegable Jerarquía (Hierarchy drop-down) lee una taxonomía jerárquica, el mismo tipo de árbol que las categorías de productos. El primer desplegable lista los términos de primer nivel (las marcas). Cuando el visitante elige Audi, el formulario se vuelve a dibujar y el segundo desplegable lista los hijos de Audi (sus modelos), luego los hijos del modelo elegido (sus años), hasta donde llegue el árbol.

La dependencia viene del propio árbol, no de los productos. Después de Audi, el segundo desplegable muestra los modelos de Audi y nada más, aunque algunas piezas también encajen en un BMW. Eso es exactamente lo que necesita un selector de vehículo, y tiene tres consecuencias:

  • Marca, modelo y año deben ser niveles de la misma taxonomía. No se pueden encadenar una taxonomía de marcas y una taxonomía de modelos, ni tampoco las categorías de productos y las etiquetas.
  • Los atributos de producto (pa_make, pa_model) no se pueden encadenar, porque los atributos de WooCommerce no tienen términos padre e hijo.
  • Los campos personalizados (campos de ACF, valores meta de una importación) no se pueden usar, porque este tipo solo trabaja con términos de taxonomía.

Cada elección reemplaza a la anterior en la búsqueda: después de Audi → A4 → 2015, la búsqueda contiene solo el último término, por ejemplo vehicle=2015-a4. En la página de resultados el plugin reconstruye toda la cadena a partir de ese término, de modo que los desplegables vuelven a mostrar Audi, A4 y 2015.

Estructura primero los datos de los vehículos

Categorías de productos o una taxonomía aparte

Puedes construir el árbol en las categorías de productos (Marca → Modelo → Año) y funciona. Sin embargo, en una tienda de recambios las categorías suelen describir la pieza (frenos, filtros, iluminación) y los visitantes quieren filtrar por ambas cosas. En ese caso, crea una taxonomía jerárquica aparte para los productos, por ejemplo Vehículos (Vehicles), con Custom Post Type UI o con tu propio código. Crear una taxonomía personalizada muestra los pasos; lo importante es establecer Jerárquica (Hierarchical) en true y asociarla a Productos.

Una rama por modelo

Elige el orden en que piensan tus clientes; Marca → Modelo → Año es el más habitual. Cada modelo recibe sus propios términos de año, de modo que el término 2015 existe una vez bajo A4 y otra bajo Golf. Eso es correcto: WordPress permite el mismo nombre bajo padres distintos y hace único el segundo slug añadiendo el slug del padre (por ejemplo 2015-a4). Para rangos de años, llama a un término «2012–2016» y conserva un slug como 2012-2016. Si usas la extensión SEO URL request, evita -and-, -or- y -to- dentro de los slugs: el plugin los usa como separadores en las URL de filtro.

Asigna los productos a cada vehículo al que encajan

Una pieza que encaja en el Audi A3 2012–2016 y en el BMW X5 2016–2018 se asigna a ambos términos de año. Con la lógica O (OR) predeterminada, basta con asignar solo el último nivel: cuando un visitante ha elegido solo la marca, WordPress incluye los términos hijos en la búsqueda. Si estableces Lógica de filtrado (Logic of filtering) en Y (AND) para esta taxonomía, el plugin deja de incluir los términos hijos y el producto también debe estar asignado a la marca y al modelo. Las preguntas frecuentes sobre el filtrado por jerarquía de categorías incluyen un fragmento que marca automáticamente los términos padre al guardar un producto.

Para miles de productos, asigna los términos mediante una importación. El importador de productos estándar de WooCommerce entiende rutas en la columna Categorías: Audi > A4 > 2015 crea los términos que faltan y asigna el producto al último, y varias rutas se separan con comas. Para una taxonomía personalizada necesitas una herramienta de importación compatible con taxonomías personalizadas.

Productos universales

No existe ningún ajuste que haga que un producto coincida con todos los vehículos. O bien asignas los productos universales a cada término del último nivel, aceptando que ningún año se verá nunca vacío, o los mantienes fuera del árbol de vehículos y pones un enlace a una categoría «Accesorios universales» junto al selector.

Configura el desplegable Jerarquía

  1. En WooCommerce → Ajustes → Products Filter → Extensiones (WooCommerce → Settings → Products Filter → Extensions), activa Desplegable Jerarquía (Hierarchy drop-down) y guarda.
  2. En la pestaña Structure, habilita tu taxonomía de vehículos y elige Desplegable Jerarquía (Hierarchy drop-down) como su tipo.
  3. Abre las opciones adicionales de la taxonomía (el icono del engranaje) y rellena Taxonomía etiqueta personalizada (Taxonomy custom label), por ejemplo Make+Model+Year^Find parts for your car.
  4. En la misma ventana establece Mostrar etiqueta de título (Show title label) en Si (Yes) si quieres el título del bloque, y Mostrar siempre la cadena (Show chain always) en Si (Yes) si quieres que los tres desplegables sean visibles desde el principio.
  5. En la pestaña Options, activa Mostrar recuento (Show count), Recuento dinámico (Dynamic recount) y Oculta terms vacios (Hide empty terms) si no quieres que se ofrezcan marcas, modelos y años sin productos (más en cómo ocultar términos vacíos).

En la etiqueta, las partes separadas por + son, en orden, los marcadores de posición de los desplegables: el primer desplegable muestra «Make», el segundo «Model», el tercero «Year». El texto después de ^ es el título del bloque. Sin ^, el título del bloque sería la cadena completa, con los signos más incluidos. Con Mostrar siempre la cadena (Show chain always) el plugin dibuja tantos desplegables como partes haya; los que todavía no se pueden usar quedan deshabilitados y muestran su marcador de posición hasta que se elige el nivel anterior.

Haz que el siguiente desplegable aparezca sin recargar la página

El siguiente desplegable lo construye el servidor a partir de la elección actual, así que después de cada elección el navegador tiene que pedir un formulario nuevo. Dos ajustes deciden cómo: autosubmit y ajax_redraw en el shortcode [woof], o Autoenviar (Autosubmit) y Redibujo de formularios AJAX (Form AJAX redrawing) en el widget. Cuando cambia un desplegable, el plugin solo reacciona si el autosubmit está activado.

autosubmitajax_redrawQué ocurre después de cada elección
00 o 1Nada. El siguiente desplegable aparece solo después de que el visitante hace clic en Filtro (Filter) y se cargan los resultados.
10Cada elección ejecuta la búsqueda: los productos se actualizan y el siguiente desplegable llega con ellos. Adecuado para la barra lateral de la tienda.
11Cada elección solo redibuja el formulario en segundo plano, sin buscar productos. El botón Filtro (Filter) ejecuta la búsqueda. Adecuado para un selector de vehículo.

Un selector que muestra solo los desplegables de vehículo tiene este aspecto (sustituye vehicle por el slug de tu taxonomía):

[woof tax_only="vehicle" by_only="none" autosubmit=1 ajax_redraw=1]

tax_only limita el formulario a la taxonomía de vehículos y by_only="none" oculta el precio, la búsqueda de texto y los demás filtros que no son de taxonomía. El plugin lee autosubmit y ajax_redraw del primer formulario de filtro de la página, así que un segundo formulario de HUSKY (un buscador en la cabecera, un widget en la barra lateral) puede anular el comportamiento del selector. Mantén un solo formulario por página siempre que puedas.

Un cuadro de búsqueda de vehículo en la página de inicio

Coloca el shortcode anterior en la página de inicio. En una página que no es un archivo de la tienda, el botón Filtro (Filter) abre la página de la tienda con el vehículo elegido; añade redirect="https://example.com/parts/" para enviar a los visitantes a otra página de resultados. La página de la tienda puede conservar su filtro habitual en la barra lateral; si también muestra la taxonomía de vehículos como desplegable de jerarquía, la cadena llega preseleccionada. Las reglas de redirección, el modo AJAX y la portada estática se tratan en el filtro de productos en la página de inicio o en una página personalizada.

Cuando los datos son atributos: qué funciona en su lugar

Si la marca, el modelo y el año ya están guardados como atributos, los desplegables no pueden depender unos de otros a través de un árbol. Hay dos opciones que se acercan:

  • Recuento dinámico con términos vacíos ocultos. Con los mismos ajustes autosubmit y ajax_redraw, cuando el visitante elige Ford se oculta todo modelo que no tenga productos entre los resultados de Ford. El límite: el plugin solo oculta valores con cero productos en los resultados actuales. Una pieza que encaja en un Ford Focus y en un Toyota Yaris mantiene Yaris en la lista de modelos después de elegir Ford, y una pieza vendida para 1994–2024 mantiene visibles todos los años. El plugin no puede saber qué año pertenece a qué modelo, porque los atributos no están relacionados entre sí.
  • El filtro Step by step ([woof_step]) muestra los filtros de uno en uno, como un asistente. Funciona con cualquier filtro, atributos incluidos, pero usa la misma regla de relevancia, así que se mantienen las mismas fugas.

Para un ajuste exacto de compatibilidad, mueve los datos a una única taxonomía jerárquica; es una importación que se hace una sola vez.

Desplegables en una fila

Por defecto los desplegables se apilan. Para colocarlos uno junto a otro en un área ancha (encima de los productos o en la página de inicio), añade este CSS en Apariencia → Personalizar → CSS adicional (Appearance → Customize → Additional CSS) o en la hoja de estilos de tu tema hijo. Funciona con los aspectos de desplegable nativo, Chosen y SelectWoo, y pasa a filas separadas en pantallas estrechas:

/* HUSKY: hierarchy drop-downs side by side */
.woof_container_select_hierarchy .woof_block_html_items {
    display: flex;
    flex-wrap: wrap;
    gap: 10px;
}
.woof_container_select_hierarchy .woof_block_html_items > select,
.woof_container_select_hierarchy .woof_block_html_items > .chosen-container,
.woof_container_select_hierarchy .woof_block_html_items > .select2-container {
    flex: 1 1 180px;
    min-width: 0;
}

Si el siguiente desplegable sigue vacío o deshabilitado

  • El autosubmit está desactivado. Con autosubmit=0 una elección no hace nada hasta que se hace clic en Filtro (Filter), incluso con ajax_redraw=1. Usa las combinaciones de la tabla.
  • Otro formulario controla la página. Quita de la página los demás formularios de HUSKY y prueba de nuevo.
  • El término elegido no tiene hijos. Revisa el árbol en la pantalla de administración de la taxonomía. Un modelo sin términos de año termina ahí la cadena; con Mostrar siempre la cadena (Show chain always) el desplegable de año queda deshabilitado.
  • Los hijos no tienen productos. Con Oculta terms vacios (Hide empty terms) activado, no se ofrecen modelos ni años sin productos. Si ninguna opción del primer nivel tiene productos, el plugin oculta todo el bloque después de cargar la página, de modo que el selector aparece un instante y desaparece.
  • Faltan términos nuevos. Con Términos de la caché (Cache terms) activado, haz clic en limpiar términos de la caché (clear terms cache) en Avanzado → Opciones (Advanced → Options) después de importar vehículos nuevos.
  • El Turbo Mode está activado. Sustituye la solicitud de búsqueda normal por la suya propia. Si la cadena no se abre, prueba una vez con el Turbo Mode desactivado.
  • El árbol está en las categorías de productos y estás en una página de categoría. Allí la cadena empieza en la categoría actual, y en una categoría del último nivel (un año) el bloque no se muestra; véase por qué el filtro muestra solo subcategorías en una página de categoría.

Si la cadena sigue sin abrirse, abre un tema en el foro de soporte de HUSKY con un enlace a la página, los ajustes del shortcode o del widget que usas y la etiqueta personalizada de la taxonomía.