Buscar en una tabla de productos WooCommerce por descripción, extracto y SKU
El campo de búsqueda situado sobre una tabla de productos busca solo en los títulos de producto, así que un comprador que escribe una palabra de la descripción no encuentra nada. Para buscar en una tabla de productos de WooCommerce por descripción, descripción corta o SKU, amplías lo que busca ese campo con un único atributo de shortcode, o añades campos de búsqueda independientes al filtro de la tabla. A continuación verás cómo funciona la búsqueda integrada, cómo ampliarla y por qué a veces un campo de búsqueda parece no hacer nada.
Cómo funciona la búsqueda integrada de una tabla de productos
Cada tabla tiene un campo de búsqueda por título encima. Lo controlan tres filas de la pestaña Opciones (Options) de la tabla:
- Mostrar búsqueda por título (Show search by title): muestra u oculta el campo.
- Mín. de símbolos (Min symbols count): la búsqueda más corta que acepta el campo, 3 de forma predeterminada.
- Marcador de la búsqueda por título (Search by title placeholder): el texto de ayuda dentro del campo.
Lo mismo se puede configurar por shortcode con hide_text_search=1, text_search_min_symbols=2 y text_search_placeholder='Find a product'. La posición del campo respecto al formulario de filtro se explica en cómo definir la posición del filtro por título de entrada.
Tres detalles de su comportamiento explican la mayoría de los avisos de que "la búsqueda no funciona":
- Busca al pulsar Intro, no mientras se escribe. La tabla recarga sus filas cuando el comprador pulsa Intro (la tecla de búsqueda del teclado del teléfono). Esc o la pequeña × del campo borra la búsqueda.
- Una búsqueda demasiado corta se ignora. Con menos caracteres que Mín. de símbolos (Min symbols count), el campo muestra un borde rojo discontinuo y no se envía nada. Reduce el valor si tus productos tienen nombres o códigos cortos.
- Coincide con el texto tal como se escribe. La búsqueda encuentra los productos cuyo título contiene el texto escrito como una sola pieza, sin distinguir mayúsculas de minúsculas. red shirt encuentra "Red shirt, long sleeve" pero no "Shirt in red".
Busca en la tabla de productos de WooCommerce por descripción y extracto
En WooCommerce la descripción larga del producto se guarda como contenido de la entrada (post_content) y la descripción corta como extracto (post_excerpt). El atributo woot_text_search_by de [woot] define en cuáles de estos campos busca el campo de búsqueda:
[woot id=1 woot_text_search_by='post_title,post_content,post_excerpt']
Un producto se encuentra cuando cualquiera de los campos indicados contiene el texto buscado. Sirve cualquier combinación, por ejemplo 'post_title,post_excerpt' para dejar fuera las descripciones largas. Tres reglas para el valor:
- Separado por comas, sin espacios. Cada nombre debe coincidir exactamente. Con
'post_title, post_content'el segundo nombre empieza con un espacio, no se reconoce y se descarta sin avisar, así que la búsqueda se queda en los títulos. - Comillas rectas. Los editores que convierten
'en’pegan la comilla al primer y al último nombre, y ambos se descartan. Si no queda ningún nombre válido, la búsqueda no filtra nada y cada búsqueda devuelve todos los productos. Escribe el shortcode en un bloque Shortcode o en el editor de código, o prescinde de las comillas:woot_text_search_by=post_title,post_content,post_excerpttambién funciona. - Solo estos tres campos.
post_title,post_contentypost_excerptson los nombres aceptados; cualquier otro se ignora. El SKU y los campos personalizados se buscan mediante el filtro, como se muestra más abajo.
El ajuste también se aplica al elemento Título (Title) del formulario de filtro de la tabla, porque ambos campos envían la misma búsqueda. El texto encontrado en la descripción no se resalta; para que los compradores lo vean, añade la columna Contenido (Content) o Extracto (Excerpt).
Para definir los campos de una tabla en todos los lugares donde aparece, incluida la búsqueda [woot_drop_down] que se describe más abajo y que no tiene este atributo, añádelos mediante código:
/*
* Products table #1: the search field also looks in the description
* and the short description. Child theme functions.php or a code snippets plugin.
*/
add_filter('woot_review_shortcode_args', function ($args) {
if (isset($args['id']) && (int) $args['id'] === 1) {
$args['woot_text_search_by'] = 'post_title,post_content,post_excerpt';
}
return $args;
});
Campos de búsqueda independientes y búsqueda por SKU en el filtro
En lugar de un solo campo para todo, la pestaña Filtro (Filter) de la tabla puede mostrar campos de texto independientes: Título (Title), Contenido (Content), Extracto (Excerpt) y SKU. Cada uno busca solo en su propio campo, se combinan entre sí y con los demás elementos del filtro y, como el campo principal, se ejecutan al pulsar Intro. En sus opciones, cada uno tiene un Marcador (Placeholder) y un Ancho (Width), y los campos de título, contenido y extracto además una Longitud mínima (Minlength).
El elemento SKU es la forma de buscar por SKU. Su opción Lógica de búsqueda (Search logic) permite elegir entre LIKE (el SKU contiene el texto escrito, así que A12 también encuentra A123) y EXACT (debe coincidir el SKU completo). Dos límites:
- Busca el SKU del producto de la fila. En una tabla normal las filas son productos, por lo que los SKU de las variaciones, que pertenecen a los registros de variación, no se encuentran. Una tabla que lista las variaciones como filas, como se describe en mostrar variaciones como filas independientes, sí las encuentra.
- Los espacios y los guiones cuentan. ZDUP112 no coincide con ZDUP 112; si los compradores escriben los códigos de formas distintas, mantén los SKU en un único formato.
Un campo de búsqueda en otras páginas: [woot_drop_down]
Para poner una búsqueda de productos en la cabecera, en una barra lateral o en la página de la tienda, usa [woot_drop_down]. Muestra un campo de búsqueda y, cuando el comprador pulsa Intro, despliega debajo una tabla con los resultados:
[woot_drop_down id=1 placeholder='Search products' width='100%' height=400]
id es la tabla cuyas columnas usan los resultados, height la altura máxima del desplegable en píxeles, y skin define el aspecto de los resultados; sin él usan el aspecto predeterminado, no el skin de la tabla. Busca en los títulos a menos que la tabla reciba woot_text_search_by mediante el código anterior. Encontrarás ejemplos de colocación en cómo añadir un campo de búsqueda con una tabla desplegable.
Búsqueda de texto con el filtro HUSKY
Cuando la tabla está conectada al filtro de productos HUSKY con filter_provider='woof', como se describe en conectar el filtro HUSKY a una tabla de productos de WooCommerce, su búsqueda de texto puede hacer de campo de búsqueda. Activa Search by text en la pestaña Structure de HUSKY (o coloca [woof_text_filter]) y, en sus opciones adicionales, define Behavior con los campos en los que buscar, por ejemplo título o contenido o extracto; +SKU añade el SKU al mismo campo. Se diferencia de la búsqueda propia de la tabla de un modo útil: divide el texto en palabras y encuentra los productos que las contienen todas en cualquier orden, así que shirt red también encuentra "Red cotton shirt". Además tiene autocompletado y puede buscar en campos personalizados. Úsala en lugar del campo propio de la tabla: una vez que HUSKY es el proveedor de filtro, la tabla le pasa el filtrado a HUSKY y su campo de búsqueda por título ya no acota los resultados, así que desactiva Mostrar búsqueda por título (Show search by title) en esa tabla.
Velocidad en catálogos grandes
Ambas búsquedas usan LIKE con el texto en medio de un valor, algo que la base de datos no puede resolver con un índice: cada búsqueda lee los campos buscados de todos los productos. Los títulos son cortos, por lo que es rápido incluso con miles de productos. Las descripciones suelen ser largas, y buscar en post_content en un catálogo grande cuesta notablemente más. Busca en las descripciones solo en las tablas que lo necesiten, y mantén Mín. de símbolos (Min symbols count) en 3 o más para que una o dos letras no inicien una búsqueda por todas las descripciones.
Si la búsqueda sigue sin funcionar
- Pulsa Intro después de escribir y comprueba que el texto tenga al menos Mín. de símbolos (Min symbols count) caracteres.
- No se busca en las descripciones: revisa si hay espacios o comillas tipográficas en
woot_text_search_by. - Cada búsqueda devuelve todos los productos: el atributo no contiene ningún nombre de campo válido.
- El shortcode tiene
mode='json'omode='to_json': esas tablas cargan todas las filas a la vez y buscan en ellas en el navegador solo por título, sin formulario de filtro, así quewoot_text_search_byno tiene efecto. Quita el atributo para buscar en el servidor. - Falta el campo: Mostrar búsqueda por título (Show search by title) está desactivado, o el shortcode tiene
hide_text_search=1.
Si nada de esto ayuda, abre un tema en el foro de soporte de WOOT con un enlace a la página y el shortcode que usas.