El filtro de WooCommerce por talla muestra variaciones agotadas: solución
Un comprador marca la talla M, y el filtro de WooCommerce por talla muestra una camiseta cuya variación M está agotada. Entonces la página del producto dice que la talla está agotada, y el comprador se va. El filtro no está roto: por defecto juzga un producto variable por su producto padre, igual que WooCommerce, y el padre sigue en stock mientras lo esté cualquiera de sus variaciones. A continuación: por qué el filtro muestra variaciones agotadas, el ajuste de HUSKY que le hace comprobar el stock de la talla seleccionada, las reglas que sigue esa comprobación y qué corregir cuando los resultados o los recuentos siguen siendo incorrectos.
Por qué el filtro por talla muestra variaciones agotadas
En WooCommerce un producto variable consta de dos tipos de registros. El producto padre es lo que listan las páginas de la tienda y de categorías. Su pestaña Atributos (Attributes) contiene los valores (Talla: S, M, L; Color: negro, rojo), y estos valores se asocian al padre como términos de atributo. Cada variación, como M / negro, es un registro independiente con su propio precio y su propio stock.
Un filtro por atributo busca productos padre que tengan el término seleccionado. Si la camiseta incluye M en su pestaña Atributos (Attributes), coincide con la talla M, sea cual sea el stock de la variación M. El estado de stock del padre tampoco ayuda: WooCommerce lo mantiene en En stock (In stock) mientras al menos una variación esté en stock (o en En reserva (On backorder) si una está en reserva) y lo cambia a Agotado (Out of stock) solo cuando todas las variaciones están agotadas. Por la misma razón, la opción de WooCommerce Ocultar los artículos agotados del catálogo (Hide out of stock items from the catalog) (WooCommerce → Settings → Products → Inventory) no resuelve esto: oculta la camiseta solo cuando se han acabado todas sus tallas. La pregunta «¿está disponible la talla M?» hay que hacérsela a las variaciones, y el filtro solo la hace cuando se lo indicas.
Haz que HUSKY compruebe el stock de la talla seleccionada
La comprobación de variaciones pertenece al elemento En stock (In stock). En HUSKY 3.4.6 es una extensión integrada que siempre está activa, así que no hay nada que activar en la pestaña Extensiones (Extensions).
- Abre WooCommerce → Settings → Products Filter, pestaña Estructura (Structure), y busca la fila En stock (In stock). Ponla en Sí (Yes) si los compradores deben ver la casilla.
- Haz clic en el botón del engranaje junto a ella (opciones adicionales (additional options)). En la ventana que se abre, pon el primer ajuste, Buscar en productos variables (Search in variable produts), en Buscar en productos y sus variaciones (Search in products and their variations). El valor predeterminado, Solo productos simples (Simple products only), mira únicamente el estado de stock propio de cada producto, que en un producto variable es el del padre.
- Deja Use new DB. en Sí (Yes) y elige Casilla de verificación (Checkbox) o Switcher en Ver (View).
- Guarda, vacía la caché de páginas y prueba: elige una talla que sepas que está agotada en un producto, marca En stock (In stock), y ese producto debería desaparecer de los resultados.
La comprobación se ejecuta solo mientras En stock (In stock) forma parte de la búsqueda y hay al menos un atributo de producto (una taxonomía pa_ como Talla o Color) seleccionado. Sin En stock (In stock), el filtrado por atributos sigue basándose en el padre. El ajuste supone trabajo adicional para la base de datos, por eso está desactivado por defecto; consulta la sección sobre velocidad más abajo.
Aplicar En stock sin casilla
Si las tallas agotadas nunca deben coincidir, no tienes que depender de que los compradores marquen la casilla. El filtro woof_get_request_data puede añadir la condición de stock a cada búsqueda que ejecuta el plugin:
/*
* HUSKY: always search in-stock products only.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
$data['stock'] = 'instock';
return $data;
});
Esto también elimina los productos simples agotados y los productos variables totalmente agotados de cada lista de productos que controla el filtro, como se describe en la FAQ sobre mostrar solo productos en stock. Pon la fila En stock (In stock) en No, para que los compradores no vean una casilla que siempre está marcada.
Si los productos agotados deben seguir visibles mientras los compradores navegan, y desaparecer solo cuando filtran por un atributo, añade la condición únicamente cuando haya un atributo en la búsqueda:
/*
* HUSKY: apply In stock only when a product attribute (pa_*) is being filtered.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
foreach (array_keys($data) as $key) {
if (strpos($key, 'pa_') === 0) {
$data['stock'] = 'instock';
break;
}
}
return $data;
});
Cómo decide la comprobación de variaciones
Con Use new DB. en Sí (Yes), HUSKY lee la tabla de búsqueda de atributos de producto de WooCommerce, donde cada variación tiene una fila por cada uno de sus valores de atributo junto con un indicador de stock. Para cada producto variable reúne las variaciones que llevan alguno de los valores seleccionados, y elimina el producto cuando existen tales variaciones y ninguna está en stock. Esta regla explica los resultados que al principio parecen extraños:
| Producto | Búsqueda | Resultado |
|---|---|---|
| S en stock, M agotada | Talla M + En stock | Oculto |
| S en stock, M agotada | Talla S o M + En stock | Se muestra: S está disponible |
| M figura en la pestaña Atributos (Attributes), pero no existe ninguna variación M | Talla M + En stock | Se muestra: ninguna variación M puede estar agotada |
| Una variación configurada como Cualquier talla (Any Size), en stock | Talla L + En stock | Se muestra: una variación Cualquier talla (Any Size) cuenta para todas las tallas listadas en el producto |
| M / negro agotada, M / rojo y S / negro en stock | Talla M + Color negro + En stock | Se muestra: cada valor seleccionado tiene una variación en stock |
| Variación M En reserva (On backorder) | Talla M + En stock | Se muestra: la reserva cuenta como disponible |
La tercera fila es un problema de datos, no del filtro. Un valor que permanece en la pestaña Atributos (Attributes) del padre después de que eliminaste su variación, o que nunca se usó para una variación, sigue coincidiendo y sigue contándose. Conserva solo los valores que tienen variaciones, o crea la variación y márcala como Agotado (Out of stock).
Las dos últimas filas son los límites de la comprobación. Los valores de atributos distintos se comprueban uno por uno, no como la combinación exacta que eligió el comprador, así que un producto puede seguir apareciendo cuando esa combinación concreta está agotada. Las variaciones en reserva se pueden comprar, por lo que En stock (In stock) las conserva; si tampoco deben coincidir, añade el elemento Excluir productos en reserva, que tiene el mismo ajuste Buscar en productos y sus variaciones (Search in products and their variations). Comprueba también lo que realmente escribió una importación: una variación guardada como En reserva (On backorder) en lugar de Agotado (Out of stock) permanece en los resultados.
Los resultados siguen mal: actualiza la tabla de búsqueda de WooCommerce
La tabla de búsqueda (wc_product_attributes_lookup) pertenece a WooCommerce. Se actualiza cuando se guarda un producto o una variación a través de WooCommerce, por defecto con un breve retraso: WooCommerce programa la actualización como una acción en segundo plano. La tabla se queda desfasada cuando:
- el stock lo cambia una importación o una herramienta de sincronización que escribe directamente en la base de datos en lugar de guardar los productos a través de WooCommerce;
- las acciones en segundo plano no se ejecutan, por ejemplo porque WP-Cron está desactivado sin un cron del servidor que lo sustituya. Las acciones pendientes con el hook
woocommerce_run_product_attribute_lookup_update_callbackse acumulan entonces en WooCommerce → Status → Scheduled Actions; - se interrumpió una regeneración completa de la tabla.
Entonces el filtro trabaja con datos de stock antiguos, y los resultados parecen aleatorios. Para reconstruir la tabla, abre WooCommerce → Status → Tools y haz clic en Regenerar (Regenerate) junto a Regenerar la tabla de búsqueda de atributos de producto (Regenerate the product attributes lookup table). Se ejecuta en segundo plano por lotes; el botón muestra Relleno en curso (Filling in progress) con un contador hasta que termina. La FAQ sobre los filtros de precio y stock que no funcionan trata las mismas herramientas. Si el stock cambia a menudo, considera WooCommerce → Settings → Products → Advanced → Tabla de búsqueda de atributos de producto (Product attributes lookup table) → Actualizaciones directas (Direct updates), que actualiza la tabla en el momento en que se guarda un producto.
Como prueba, o cuando la tabla no puede mantenerse al día, pon Use new DB. en No. Entonces HUSKY lee las propias variaciones (sus valores _stock_status y attribute_pa_…). Esto es más lento con muchas variaciones y sigue una regla más estricta: un producto se elimina cuando cualquier variación con un valor seleccionado está agotada, de modo que «Talla S o M» oculta la camiseta de la tabla anterior. Para obtener la misma regla que con la tabla de búsqueda, añade:
/*
* HUSKY, In stock with "Use new DB." = No: keep a variable product when at least
* one variation with a selected value is in stock.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_exclude_existing_variations', '__return_true');
Recuentos que incluyen variaciones agotadas
Los números junto a las tallas proceden de las mismas consultas que los resultados, así que siguen las mismas reglas.
- Sin En stock (In stock) en la búsqueda, el recuento de M incluye cada producto que tiene M en su padre, esté agotada o no. Con En stock (In stock) activo (marcado, o forzado con el fragmento anterior) y la búsqueda en variaciones activada, cada talla se cuenta con la comprobación de variaciones para esa talla.
- Añade Recuento dinámico (Dynamic recount) y Ocultar términos vacíos (Hide empty terms) (pestaña Opciones (Options)) a eso, y una talla cuyo recuento baja a cero desaparece del filtro, de modo que las tallas agotadas ya no se ofrecen en absoluto.
- Si WooCommerce oculta los artículos agotados, mantén Escuchar catálogo de visibilidad (Listen catalog visibility) (Advanced → Options) en Sí (Yes). Con No, los contadores incluyen también los productos que WooCommerce oculta, y un término puede mostrar un recuento mientras sus resultados están vacíos.
- Con Número de recuento dinámico de caché para cada elemento en el filtro (Cache dynamic recount number for each item in filter) (Advanced → Options), los recuentos se almacenan y no siguen los cambios de stock hasta que la caché se limpia automáticamente o con el botón limpiar caché (clear cache). Una caché de páginas también puede servir números antiguos.
Velocidad: el coste de comprobar variaciones
Cada búsqueda que combina un atributo con En stock (In stock) ejecuta consultas adicionales: dos sobre la tabla de búsqueda con Use new DB. en Sí (Yes), o una sobre todas las variaciones coincidentes con No. Con Recuento dinámico (Dynamic recount) la comprobación se ejecuta además para cada valor que recibe un recuento, de modo que un filtro con 40 tallas y colores la repite 40 veces por página. Con decenas de miles de variaciones esto se nota.
- Mantén Use new DB. en Sí (Yes) y la tabla de búsqueda al día; es el método más rápido.
- Activa Número de recuento dinámico de caché para cada elemento en el filtro (Cache dynamic recount number for each item in filter) y elige un intervalo de limpieza automática acorde con la rapidez con que cambia tu stock.
- Encontrarás más opciones en cómo acelerar el filtrado de productos en catálogos grandes.
El modo Turbo no es un atajo aquí. Filtra en el navegador del visitante a partir de un archivo precompilado, y su comprobación de En stock (In stock) mira solo el estado de stock propio de cada producto: el ajuste de variaciones no tiene efecto ahí, y los cambios de stock aparecen solo después de reconstruir el archivo. Si las tallas agotadas no deben coincidir, mantén desactivado el modo Turbo; sus otros límites se enumeran en solución de problemas del modo Turbo.
Lista de comprobación
- En stock (In stock) → engranaje → Buscar en productos y sus variaciones (Search in products and their variations) seleccionado y guardado.
- En stock (In stock) forma parte de la búsqueda: marcado por el comprador o forzado con
woof_get_request_data. - Los productos variables listan solo los valores de atributo que tienen variaciones.
- Las variaciones agotadas tienen el estado Agotado (Out of stock), no En reserva (On backorder).
- La tabla de búsqueda se regeneró después de las importaciones, y no hay actualizaciones de la tabla atascadas en Scheduled Actions.
- Caché de recuento y caché de páginas vaciadas después de los cambios de stock; modo Turbo desactivado.
Si el filtro sigue devolviendo un producto cuya talla seleccionada está agotada, abre un tema en el foro de soporte de HUSKY con el enlace del filtro, el producto y el estado de stock de sus variaciones.