HUSKY - WooCommerce Product Filter Professional

Filtrar productos de WooCommerce por campo ACF: tipos, ajustes y soluciones

Puedes filtrar productos de WooCommerce por campo ACF con HUSKY, pero solo cuando el campo guarda su valor en una forma que una consulta a la base de datos pueda comparar. Los campos de un solo valor (Seleccionar, Botones de radio, Verdadero / Falso, Número, Texto, Selector de fecha) se filtran sin problemas. Los campos de casillas de verificación y los campos Seleccionar con Selección múltiple (Select Multiple) activada, o bien nunca aparecen en el filtro, o bien muestran opciones que siempre encuentran 0 productos. A continuación verás cómo lee HUSKY los datos de ACF, qué tipos de campo funcionan, cómo configurar cada uno y qué hacer con los campos de varios valores.

Dos formas en que HUSKY lee los campos ACF

ACF guarda cada campo como un metadato normal del producto: una fila en la tabla wp_postmeta, bajo el Nombre del campo (Field Name), con el valor guardado. HUSKY tiene dos extensiones integradas que filtran por esas filas. Ambas son extensiones del sistema, siempre activas, así que no hay nada que activar.

  • La extensión ACF (Campos ACF (ACF fields)) encuentra automáticamente tus grupos de campos de ACF y lista sus campos Seleccionar, Botones de radio y Verdadero / Falso en la pestaña Estructura (Structure) como Etiqueta del campo (Título del grupo) (Field label (Group title)). Establece el desplegable junto a un campo en Sí (Yes), guarda, y el campo queda incluido en el filtro. Los demás tipos de campo no aparecen en la lista. Los detalles están en la página de la extensión ACF.
  • La pestaña Meta datos (Meta Data) (extensión Meta filtro (Meta filter)) funciona con cualquier clave meta, sea de ACF o no. Tú añades la clave y eliges cómo se muestra: Deslizador (Slider), Buscar por texto (Search by text), Casilla de verificación (Checkbox), Desplegable (Drop-down), Desplegable múltiple (Multi Drop-down) o Selector de fecha (Datepicker), y qué tipo de datos contiene: número (number), string o fecha (date). Consulta filtrar por campos meta.

La extensión ACF es más rápida de configurar, pero tiene tres reglas que explican la mayoría de los casos de «falta el campo» y de «0 productos»:

  1. El grupo de campos debe estar asignado por tipo de contenido. HUSKY solo detecta los grupos cuyas reglas de Ubicación (Location) contienen El tipo de contenido es igual a Producto (Post Type is equal to Product). Un grupo que se muestra únicamente por una regla como la categoría de producto se omite, y sus campos nunca llegan a la pestaña Estructura (Structure).
  2. El valor de cada opción debe coincidir con su etiqueta. En ACF, una opción escrita como xl : Extra large guarda xl en el producto, pero la extensión ACF busca la etiqueta, Extra large, y no encuentra nada. Funcionan las opciones escritas como una sola palabra por línea (valor y etiqueta son iguales) o que solo se diferencian en mayúsculas y minúsculas, como red : Red. Las etiquetas que contienen comillas nunca coinciden.
  3. Selección múltiple debe estar desactivada. Un campo Seleccionar con Selección múltiple (Select Multiple) activada sigue apareciendo en la lista, pero no encuentra productos, por el motivo que se explica más abajo.

Si un campo incumple alguna de estas reglas, fíltralo mejor a través de la pestaña Meta datos, donde controlas la clave y los valores exactos.

Qué tipos de campo ACF se pueden filtrar

Tipo de campo ACFQué se guarda en el productoCómo filtrarlo en HUSKY
Seleccionar (único), Botones de radioEl valor de una opciónExtensión ACF, o Meta datos Desplegable (Drop-down) / Desplegable múltiple (Multi Drop-down)
Grupo de botonesEl valor de una opciónMeta datos Desplegable (Drop-down) / Desplegable múltiple (Multi Drop-down)
Verdadero / Falso1 o 0Extensión ACF, o Meta datos Casilla de verificación (Checkbox)
Número, RangoUn númeroMeta datos Deslizador (Slider), tipo número (number)
Texto, Correo electrónico, URLUna cadena de textoMeta datos Buscar por texto (Search by text), o Desplegable (Drop-down) con los valores listados
Selector de fechaUna fecha como 20250131 (Ymd)Meta datos Selector de fecha (Datepicker) más un hook (véase más abajo)
Casillas de verificación, Seleccionar con Selección múltiple (Select Multiple), Relación / Objeto de entrada / Taxonomía con varios valoresUn array serializadoNo con una comparación normal; consulta las dos salidas más abajo
Repetidor, Contenido flexibleFilas numeradas como specs_0_widthNo se pueden filtrar como un solo campo

Los campos dentro de un campo Grupo se guardan bajo groupname_fieldname y se filtran como su propio tipo. Un Selector de fecha y hora guarda texto como 2025-01-31 14:00:00, que el filtro Selector de fecha no puede comparar.

Por qué los campos de casillas y de selección múltiple no encuentran nada

Cuando un campo puede contener varios valores, ACF los empaqueta en una sola cadena con el formato serializado de PHP. Un coche con aire acondicionado y asientos calefactados recibe una fila meta como esta:

a:2:{i:0;s:2:"ac";i:1;s:12:"heated_seats";}

La extensión ACF y las vistas Desplegable, Desplegable múltiple y Casilla de verificación piden a la base de datos las filas cuyo valor es igual a la opción seleccionada. ac no es igual a esa cadena completa, así que el resultado es 0. Desactivar Selección múltiple (Select Multiple) en ACF no repara los productos existentes: sus valores siguen serializados hasta que cada producto se guarda de nuevo con un único valor.

Configurar un campo ACF en la pestaña Meta datos

  1. Encuentra la clave meta real. Es el Nombre del campo (Field Name) en ACF (por ejemplo, body_type), no su etiqueta. En la pestaña Meta datos (Meta Data), Obtener claves de cualquier producto por su ID (Get keys from any product by its ID) lista todas las claves de un producto. Cada campo ACF aparece dos veces: body_type contiene el valor y _body_type contiene la referencia interna del campo de ACF. Usa la clave sin el guion bajo. Las claves distinguen mayúsculas de minúsculas y nunca contienen espacios ni corchetes.
  2. Añade la clave con Añadir una clave personalizada a mano (Add Custom key by hands) o desde la lista, introduce un título y elige la vista y el tipo. Para valores de texto elige string. Con número (number), MySQL convierte texto como Coupe en 0 antes de comparar, y el filtro devuelve todos los productos que tienen la clave, lo que parece «el filtro no hace nada».
  3. Lista las opciones para Desplegable (Drop-down) y Desplegable múltiple (Multi Drop-down). Un metacampo es texto libre, así que HUSKY no puede construir la lista de valores por sí mismo; la escribes tú, separada por comas. Usa título^valor cuando el título visible difiera del valor guardado. Para las opciones de ACF coupe : Coupe y suv : SUV / Crossover sería:
    Coupe^coupe,SUV / Crossover^suv
    La parte posterior a ^ debe ser exactamente lo que guardó ACF, el valor de la opción, no su etiqueta.
  4. Guarda, abre la pestaña Estructura (Structure), establece el nuevo elemento en Sí (Yes), arrástralo a su sitio y guarda de nuevo. El icono del engranaje junto a él contiene las opciones propias de la vista, por ejemplo Opción de búsqueda (Search option) y Valor de búsqueda (Search value) para una Casilla de verificación, o Condicional de búsqueda de texto (Text search conditional) (ME GUSTA (LIKE) o EXACTO (EXACT)) para Buscar por texto (Search by text).

Una Casilla de verificación (Checkbox) es una única casilla para una clave. Encuentra los productos cuyo valor es 1 (campos Verdadero / Falso), otro Valor de búsqueda (Search value) como yes o, con Opción de búsqueda (Search option) establecida en El valor existe (Value exists), todos los productos que tienen el campo rellenado.

Si un valor guardado contiene una coma, cambia el separador de todas las listas Desplegable y Desplegable múltiple y reescribe después las listas con |:

/*
 * HUSKY: separate meta filter options with | instead of a comma.
 * Child theme functions.php or a code snippets plugin.
 * Example list afterwards: Wood, oak|Wood, pine|Metal
 */
add_filter( 'woof_meta_options_separator', function ( $separator ) {
    return '|';
} );

Los campos Número y Rango pertenecen a un Deslizador (Slider); los rangos, los pasos y los decimales se tratan en filtros de rango deslizante para atributos y metacampos.

Filtrar por un campo de fecha de ACF

El filtro Selector de fecha compara marcas de tiempo Unix de forma predeterminada, mientras que el Selector de fecha de ACF guarda las fechas como 20250131. El hook woof_meta_use_acf_dateformat hace que el filtro convierta las fechas elegidas al mismo formato antes de buscar:

/*
 * HUSKY: Datepicker meta filters search ACF Date Picker values (Ymd).
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woof_meta_use_acf_dateformat', '__return_true' );

Añade la clave de ACF en la pestaña Meta datos con la vista Selector de fecha (Datepicker) y deja el tipo en número (number): las fechas convertidas se comparan como números, y el tipo fecha (date) no produce aquí fechas utilizables. El hook se aplica a todos los filtros Selector de fecha del sitio, así que todos ellos deben apuntar a campos Selector de fecha de ACF. Para un periodo de validez (desde / hasta), añade los campos de inicio y de fin como dos filtros independientes.

Campos de casillas y de selección múltiple: dos salidas

Recomendada: mover los valores a una taxonomía

Los datos con varios valores por producto son justo para lo que están hechas las taxonomías. Con una taxonomía obtienes una casilla por cada valor, recuentos, lógica Y u O entre los valores seleccionados y compatibilidad con el modo Turbo, algo que un metacampo no puede ofrecer. No tienes que renunciar a ACF para editar:

  1. Crea una taxonomía de producto, por ejemplo Equipamiento (Equipment), como taxonomía personalizada o como atributo global en Productos → Atributos (Products → Attributes).
  2. En ACF, sustituye el campo de casillas de verificación por un campo Taxonomía (Taxonomy) que apunte a ella, con Guardar términos (Save Terms) y Cargar términos (Load Terms) activados. ACF asigna entonces al producto los términos elegidos en lugar de guardar un array.
  3. Los productos reciben sus términos cuando se guardan de nuevo; en un catálogo grande hazlo de forma masiva. La taxonomía aparece entonces en la pestaña Estructura (Structure) de HUSKY como cualquier otra.

Conservar el campo: buscar dentro del array guardado

Si el campo debe quedarse como está, se puede cambiar la comparación. El fragmento siguiente convierte la condición «es igual» de HUSKY para las claves listadas en una búsqueda LIKE del valor entrecomillado, de modo que ac pasa a ser LIKE '%"ac"%' y coincide con el elemento dentro de la cadena serializada, pero no con ac_rear. También corrige los recuentos de las opciones.

/*
 * HUSKY: Drop-down / Multi Drop-down meta filters for ACF Checkbox
 * and Select Multiple fields (values stored as serialized arrays).
 * Child theme functions.php or a code snippets plugin.
 */
function my_husky_serialized_keys() {
    return array( 'equipment' ); // ACF field names
}

function my_husky_match_serialized( $meta_query ) {
    if ( ! is_array( $meta_query ) ) {
        return $meta_query;
    }
    foreach ( $meta_query as $i => $clause ) {
        if ( ! is_array( $clause ) ) {
            continue;
        }
        if ( isset( $clause['key'], $clause['value'], $clause['compare'] )
            && '=' === $clause['compare']
            && is_scalar( $clause['value'] )
            && in_array( $clause['key'], my_husky_serialized_keys(), true ) ) {
            $meta_query[ $i ]['compare'] = 'LIKE';
            $meta_query[ $i ]['value']   = '"' . $clause['value'] . '"';
            $meta_query[ $i ]['type']    = 'CHAR';
        } else {
            $meta_query[ $i ] = my_husky_match_serialized( $clause );
        }
    }
    return $meta_query;
}

// Products found by the filter
add_filter( 'woof_get_meta_query', 'my_husky_match_serialized', 100 );

// Counts next to the options (Show count + Dynamic recount)
add_filter( 'woof_dynamic_count_attr', function ( $args ) {
    if ( isset( $args['meta_query'] ) ) {
        $args['meta_query'] = my_husky_match_serialized( $args['meta_query'] );
    }
    return $args;
}, 100 );

Después, añade equipment en la pestaña Meta datos como Desplegable (Drop-down) o Desplegable múltiple (Multi Drop-down), tipo string, con los valores de las opciones de ACF después de ^, por ejemplo Air conditioning^ac,Heated seats^heated_seats. Conoce los límites: un Desplegable múltiple encuentra los productos que tienen cualquiera de los valores seleccionados, no todos; una búsqueda LIKE '%…%' no puede usar un índice de la base de datos y se vuelve más lenta en catálogos grandes; y el fragmento no se aplica en el modo Turbo. Encontrarás más información sobre el hook en la página de woof_get_meta_query.

Variaciones, modo Turbo y cuadrículas de productos personalizadas

  • Los valores de las variaciones no se buscan. La consulta de la tienda devuelve productos padre y comprueba los metadatos propios del padre. Los atributos funcionan con variaciones porque el padre lleva todos los términos de sus variaciones; los valores meta no. Pon el valor en el producto padre.
  • El modo Turbo filtra en el navegador a partir de su propio archivo de datos, que incluye solo las claves añadidas en la pestaña Meta datos. Los campos mostrados a través de la extensión ACF y los hooks de PHP, como los fragmentos anteriores, no se usan allí. Consulta solución de problemas del modo Turbo.
  • La URL cambia pero se siguen mostrando todos los productos. Entonces el problema no es el campo: la cuadrícula del maquetador o la plantilla personalizada ejecuta su propia consulta e ignora todos los filtros. La solución está en la URL del filtro cambia pero los productos no se filtran.

Si el filtro ACF sigue sin encontrar productos

  • Comprueba qué se ha guardado realmente. En phpMyAdmin o una herramienta similar ejecuta SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123 con el ID de un producto (y el prefijo de tus tablas). Un valor que empieza por a: es un array serializado; una clave distinta de la que esperabas significa que ACF guarda con otro nombre.
  • Pestaña Meta datos: la clave sin el guion bajo inicial, con las mismas mayúsculas y minúsculas; tipo string para texto; el valor de la opción guardado después de ^.
  • Para la extensión ACF: la ubicación del grupo es El tipo de contenido es igual a Producto (Post Type is equal to Product), los valores de las opciones coinciden con sus etiquetas, Selección múltiple (Select Multiple) está desactivada y los productos se guardaron de nuevo tras cambiarla.
  • El valor está en el producto padre, no en las variaciones.
  • Un filtro de taxonomía funciona en la misma página. Si no es así, arregla primero la cuadrícula de productos.

Si todos los puntos se cumplen y el filtro sigue sin encontrar nada, abre un tema en el foro de soporte de HUSKY con el tipo y los ajustes del campo, la clave meta y una muestra del valor guardado, y lo revisaremos.