EHERO Smart Search es un buscador híbrido para WooCommerce que combina IA semántica (entiende la intención y el lenguaje natural mediante embeddings) con búsqueda por palabras clave (títulos, SKUs, atributos, categorías, marcas, sinónimos…). Sustituye la búsqueda básica de WordPress por una experiencia moderna que encuentra lo que el cliente quiere decir, no solo lo que escribe.

El buscador funciona en tres sitios a la vez:

• Widget en vivo: resultados instantáneos mientras el cliente escribe, con filtros, sugerencias y "quizás quisiste decir".
• Resultados completos sin recargar: al pulsar Intro se abre un panel AJAX a pantalla completa con todos los resultados y botón "Cargar más" — sin cambiar de página.
• Página de resultados clásica: la página de búsqueda de WooCommerce (?s=… o URLs amigables) también usa el motor inteligente, así Google y los clientes ven los mismos resultados.

Funcionalidades principales

EHERO Smart Search is a hybrid search engine for WooCommerce that combines semantic AI (understands intent and natural language through embeddings) with keyword search (titles, SKUs, attributes, categories, brands, synonyms…). It replaces the basic WordPress search with a modern experience that finds what the customer means, not just what they type.

The search works in three places at once:

• Live widget: instant results while the customer types, with filters, suggestions and "did you mean".
• Full results without reloading: pressing Enter opens a fullscreen AJAX panel with all the results and a "Load more" button — no page change.
• Classic results page: the WooCommerce search page (?s=… or pretty URLs) is also powered by the smart engine, so Google and customers see the same results.

Main features

Antes de instalar el plugin, asegúrate de que tu sitio web cumple con los siguientes requisitos mínimos:

Requisitos adicionales según funciones

Before installing the plugin, make sure your website meets the following minimum requirements:

Additional requirements per feature

Método 1: Subir el archivo ZIP desde WordPress

1. Accede a tu panel de WordPress en https://tutienda.com/wp-admin.
2. Ve a Plugins → Añadir nuevo → Subir plugin.
3. Haz clic en "Seleccionar archivo", elige el archivo ehero-smart-search.zip y pulsa "Instalar ahora".
4. Una vez instalado, haz clic en "Activar plugin".

Método 2: Subir por FTP

1. Descomprime ehero-smart-search.zip en tu ordenador.
2. Sube la carpeta ehero-smart-search a wp-content/plugins/ mediante FTP.
3. Activa el plugin desde Plugins → Plugins instalados.

Primeros pasos (5 minutos)

1. En Ajustes → General, marca Activar Smart Search y deja activados Reemplazar la búsqueda nativa y Potenciar la página de resultados.
2. En Inteligencia Artificial: si tienes licencia EHERO no necesitas nada más (usa la IA incluida). Si prefieres tu propia clave, selecciona "Mi propia clave API" y pégala.
3. Baja hasta Estado del índice y pulsa Reindexar todos los productos. Espera a que termine.
4. Ve a tu tienda y escribe en el buscador: verás resultados en vivo. Pulsa Intro para abrir el panel completo sin recargar.

Method 1: Upload ZIP from WordPress

1. Log in to your WordPress dashboard at https://yourstore.com/wp-admin.
2. Go to Plugins → Add New → Upload Plugin.
3. Click "Choose File", select ehero-smart-search.zip and click "Install Now".
4. Once installed, click "Activate Plugin".

Method 2: Upload via FTP

1. Unzip ehero-smart-search.zip on your computer.
2. Upload the ehero-smart-search folder to wp-content/plugins/ via FTP.
3. Activate the plugin from Plugins → Installed Plugins.

Quick start (5 minutes)

1. In Settings → General, check Enable Smart Search and keep Replace native search and Power the results page enabled.
2. In Artificial Intelligence: with an EHERO license you don't need anything else (it uses the included AI). If you prefer your own key, select "My own API key" and paste it.
3. Scroll to Index Status and click Reindex All Products. Wait for it to finish.
4. Go to your store and type in the search box: you'll see live results. Press Enter to open the full panel without reloading.

Se requiere una licencia válida para acceder a las funciones del plugin y recibir actualizaciones automáticas.

Activar la licencia

1. Ve a EHERO → Smart Search y abre la página de Licencia.
2. Introduce tu clave de licencia.
3. Introduce el correo electrónico asociado a la compra.
4. Haz clic en "Activar licencia".

La licencia se verifica automáticamente cada día. Con la licencia activa, además, puedes usar la IA incluida de EHERO sin contratar ninguna clave API (con cuota según tu plan).

A valid license is required to access the plugin's features and receive automatic updates.

Activate the license

1. Go to EHERO → Smart Search and open the License page.
2. Enter your license key.
3. Enter the email address associated with your purchase.
4. Click "Activate License".

The license is verified automatically every day. With an active license you can also use EHERO's included AI without hiring any API key (quota depends on your plan).

Accesible desde EHERO → Smart Search → Ajustes. Estos interruptores controlan dónde y cómo actúa el buscador.

General

Comportamiento de búsqueda

Rendimiento y seguridad

Accessible from EHERO → Smart Search → Settings. These switches control where and how the search engine operates.

General

Search behaviour

Performance & security

¿Para qué sirve exactamente la IA?

La IA hace tres cosas concretas en este plugin:

Los 2 modos de IA

Campos del modo "Mi propia clave API"

¿Qué pierdes sin IA?

El modo "Sin IA" mantiene toda la búsqueda por palabras clave: títulos, SKU (con variaciones), atributos, categorías, marcas y sinónimos, además de las funciones comerciales (merchandising, filtros, analíticas…). Lo que pierdes es:

• La comprensión del lenguaje natural: "algo para regalar a mi madre" no encontrará nada si esas palabras no están en los productos o en los sinónimos.
• La tolerancia automática a errores de ortografía y variaciones no contempladas.
• El botón de sugerencia de sinónimos con IA.

What is AI actually for?

AI does three concrete things in this plugin:

The 2 AI modes

"My own API key" mode fields

What do you lose without AI?

The "No AI" mode keeps all keyword search: titles, SKU (with variations), attributes, categories, brands and synonyms, plus the commercial features (merchandising, filters, analytics…). What you lose is:

• Natural-language understanding: "something to gift my mum" won't find anything unless those words exist in products or synonyms.
• Automatic tolerance to misspellings and unforeseen variations.
• The AI synonym suggestion button.

El plugin mantiene un índice propio de tus productos: una versión optimizada de cada producto preparada para buscar al instante. En "Campos a indexar" eliges qué partes del producto entran en ese índice.

Campos disponibles

Combinación recomendada: título, descripción corta, SKU, categorías, etiquetas, marcas y atributos. Más campos = encuentra más, pero puede añadir ruido.

Estado del índice y reindexado

Al final de la página de Ajustes, la sección Estado del índice muestra tres tarjetas:

• Productos: cuántos productos están indexados respecto al total.
• Con embeddings: cuántos tienen su vector de IA generado.
• Última actualización: cuándo se actualizó el índice por última vez.

El botón "Reindexar todos los productos" reconstruye el índice completo y muestra el progreso en pantalla. El índice también se actualiza solo cuando creas o editas un producto.

The plugin maintains its own index of your products: an optimized version of each product ready for instant search. Under "Index fields" you choose which parts of the product enter that index.

Available fields

Recommended combination: title, short description, SKU, categories, tags, brands and attributes. More fields = finds more, but may add noise.

Index status and reindexing

At the bottom of the Settings page, the Index Status section shows three cards:

• Products: how many products are indexed out of the total.
• With embeddings: how many have their AI vector generated.
• Last update: when the index was last updated.

The "Reindex All Products" button rebuilds the entire index and shows progress on screen. The index also updates itself when you create or edit a product.

Los sinónimos conectan las palabras que usan tus clientes con las palabras que usaste tú en las fichas de producto. Son especialmente importantes si trabajas en modo "Sin IA".

Formato

Un grupo de términos equivalentes por línea, separados por comas. Buscar cualquiera de los términos encuentra los demás:

zapatillas, deportivas, sneakers
móvil, celular, smartphone, teléfono
sudadera, hoodie, buzo

Úsalos para regionalismos (móvil/celular), anglicismos (hoodie/sudadera) y nombres de marca que la gente usa como genéricos.

Sugerencia con IA

El botón "Sugerir sinónimos con IA" (junto al campo de sinónimos) analiza tus búsquedas sin resultados de los últimos 90 días y el vocabulario real de tu catálogo, y añade líneas de sinónimos al campo para que las revises antes de guardar. Convierte búsquedas perdidas en ventas.

Packs de sinónimos por sector

Debajo del botón de IA tienes un selector con 10 diccionarios listos para cargar, curados en español/inglés:

Al pulsar "Cargar pack de sinónimos", las líneas se añaden al cuadro sin duplicados (si el primer término del grupo ya existe en tus sinónimos, esa línea se omite). Nada se guarda hasta que pulses tú "Guardar cambios": revisa y borra las líneas que no apliquen a tu catálogo.

Si desarrollas, puedes registrar packs propios con el filtro ehero_smart_search/synonym_packs.

Synonyms connect the words your customers use with the words you used in the product pages. They are especially important when running in "No AI" mode.

Format

One group of equivalent terms per line, separated by commas. Searching for any term in a group also matches the others:

sneakers, trainers, running shoes
mobile, cell phone, smartphone
hoodie, sweatshirt, jumper

Use them for regional words, loanwords and brand names people use generically.

AI suggestions

The "Suggest synonyms with AI" button (next to the synonyms field) analyses your zero-result searches from the last 90 days and your catalog's real vocabulary, and appends synonym lines to the field for you to review before saving. It turns lost searches into sales.

Sector synonym packs

Below the AI button there is a selector with 10 ready-made dictionaries, curated in Spanish/English: software & tech services (tpv ↔ pos, factura ↔ invoice, suscripción ↔ recurring payments…), fashion & footwear, erotic, home & furniture, beauty, sports, electronics, food, pets and kids.

Clicking "Load synonym pack" appends the lines to the box without duplicates (any group whose lead term already exists in your synonyms is skipped). Nothing is saved until you click "Save Changes": review and remove the lines that don't apply to your catalog.

Developers can register custom packs via the ehero_smart_search/synonym_packs filter.

La búsqueda por palabras clave ignora automáticamente los artículos y conectores en español e inglés: "de", "para", "con", "el", "la", "of", "for", "with"… No hay nada que configurar.

Ejemplo: en «gafas de sol para mujer» solo cuentan gafas, sol y mujer. Sin este filtrado, palabras como "de" o "para" coincidirían con casi todo el catálogo y ensuciarían los resultados — algo clave cuando se trabaja sin IA.

Además, el resaltado del término buscado en los resultados no marca palabras de 1-2 letras, evitando efectos extraños como marcar "de" dentro de "verde".

Keyword search automatically ignores articles and connectors in Spanish and English: "de", "para", "con", "el", "la", "of", "for", "with"… There is nothing to configure.

Example: in "sunglasses for women" only sunglasses and women count. Without this filtering, words like "of" or "for" would match almost the whole catalog and pollute the results — crucial when running without AI.

Additionally, the highlighting of the search term in results doesn't mark 1-2 letter words, avoiding odd effects such as marking "de" inside a longer word.

En Ajustes → Apariencia y layouts eliges cómo se ve el buscador. El layout y el tema por defecto se aplican a los buscadores reemplazados del tema y a los shortcodes sin atributos.

Los 4 layouts

Los 4 temas

Color de acento

El color de acento (botones, precios, resaltados) se personaliza con cualquier color hexadecimal (por ejemplo #e91e63) para que combine con tu marca. Si lo dejas vacío, se usa el azul EHERO (#017cba).

Icono del buscador

En Ajustes → Apariencia y layouts → Icono del buscador eliges la lupa que se muestra en el campo de búsqueda, en el botón compacto y en el overlay. Tienes 6 iconos predefinidos (clásico, fino, en negrita, con círculo, con destello de IA y redondeado) o puedes subir tu propia imagen (SVG o PNG cuadrado con fondo transparente, ~32×32 px) con el botón "Subir / elegir imagen". Al elegir una imagen se activa automáticamente el icono personalizado; pulsa "Quitar imagen" para volver a un preajuste. El cambio se aplica en todas partes a la vez.

Estilos avanzados

En Ajustes → Estilos avanzados tienes control total sobre la apariencia, agrupado en tres bloques con vista previa en vivo:

• General: fondo, texto, texto secundario/iconos, bordes, fondo al pasar el ratón, redondeo y sombra del desplegable. Son los colores base que comparten la barra, el botón y los resultados.
• Barra del buscador: fondo, color de texto, color del placeholder, color y grosor del borde, redondeo, tamaño de fuente, alto (relleno vertical) y color de foco.
• Botón compacto: fondo, color del icono, borde y grosor, tamaño del botón, redondeo, tamaño del icono y los colores al pasar el ratón.

Cada campo que dejes vacío mantiene el valor del tema elegido; solo los que rellenes generan estilos. Así puedes partir de un tema (Light, Dark, Pill…) y retocar solo lo que quieras para que encaje con tu marca.

Layout Compacto como icono limpio: en Apariencia tienes "Estilo del botón compacto" (Botón / Solo icono / Sin estilos), "Etiqueta HTML" (Botón <button> o Enlace <a>), y el tamaño y color del icono. Con "Solo icono" el buscador se muestra como un icono sin círculo ni borde, igual que los iconos nativos de tu cabecera (carrito, cuenta). En Bricks y Elementor estos mismos controles aparecen en el propio elemento cuando eliges el layout Compacto.

Modo "Sin estilos" y estructura del elemento

Si eliges Sin estilos (y opcionalmente la etiqueta <a>), el plugin no aplica ninguna clase ni estilo propio: solo deja un gancho para que el clic abra el buscador y el icono dentro. Así puedes maquetarlo como quieras (por ejemplo, idéntico al carrito).

Estructura del disparador compacto según el modo:

• Botón: <button class="ehero-ss-trigger ehero-ss-compact-btn">…icono…</button> — círculo con borde y fondo.
• Solo icono: <button class="ehero-ss-trigger ehero-ss-compact-btn ehero-ss-compact-btn--plain">…icono…</button> — sin círculo/borde/fondo.
• Sin estilos: <a href="#" role="button" class="ehero-ss-trigger">…icono…</a> (o <button> según la etiqueta) — sin clases de estilo del plugin.

Cómo se compone cada parte:

• .ehero-ss-widget — contenedor del buscador. En Bricks/Elementor es el propio elemento que seleccionas (sin div extra).
• .ehero-ss-trigger — gancho de JavaScript; siempre presente en compacto. Es lo que abre el buscador al pulsar. No lleva estilos, así que puedes dárselos tú.
• .ehero-ss-compact-btn (y --plain) — clases de estilo del plugin. Solo aparecen en los modos Botón y Solo icono.
• El icono es un <svg> (o un <img> si subiste imagen). Para colorearlo desde tu CSS usa color (el SVG usa currentColor) y para el tamaño width/height.

Ejemplo para estilarlo tú mismo en modo Sin estilos:

.ehero-ss-trigger { display:inline-flex; color:#017cba; }
.ehero-ss-trigger svg { width:35px; height:35px; }
.ehero-ss-trigger:hover { color:#015e8c; }

In Settings → Appearance & Layouts you choose how the search looks. The default layout and theme apply to replaced theme search boxes and to shortcodes without attributes.

The 4 layouts

The 4 themes

Accent color

The accent color (buttons, prices, highlights) can be set to any hex color (e.g. #e91e63) to match your brand. If left empty, the EHERO blue (#017cba) is used.

Search icon

In Settings → Appearance & Layouts → Search icon you pick the magnifier shown in the search field, the compact button and the overlay. Choose from 6 presets (classic, thin, bold, in a circle, with an AI sparkle, and rounded) or upload your own image (a square SVG or PNG with transparent background, ~32×32 px) with the "Upload / choose image" button. Picking an image automatically switches to the custom icon; press "Remove image" to go back to a preset. The change applies everywhere at once.

Advanced styles

In Settings → Advanced styles you get full control over the look, grouped into three blocks with a live preview:

• General: background, text, secondary text/icons, borders, hover background, corner radius and dropdown shadow — the base colours shared by the bar, the button and the results.
• Search bar: background, text colour, placeholder colour, border colour and width, corner radius, font size, height (vertical padding) and focus colour.
• Compact button: background, icon colour, border and width, button size, corner radius, icon size and hover colours.

Any field you leave empty keeps the selected theme's value; only the fields you fill in produce styles. So you can start from a theme (Light, Dark, Pill…) and tweak only what you need to match your brand.

Compact layout as a plain icon: under Appearance you have "Compact button style" (Button / Plain icon / Unstyled), "HTML tag" (Button <button> or Link <a>), icon size and icon colour. With "Plain icon" the search renders as a bare icon with no circle or border, just like the native icons in your header (cart, account). In Bricks and Elementor these same controls appear on the element itself when you choose the Compact layout.

"Unstyled" mode and element structure

If you choose Unstyled (and optionally the <a> tag), the plugin applies no classes or styles of its own: it only keeps a hook so the click opens the search, plus the icon inside. You can then build it however you like (for example, identical to the cart).

Compact trigger structure by mode:

• Button: <button class="ehero-ss-trigger ehero-ss-compact-btn">…icon…</button> — circle with border and background.
• Plain icon: <button class="ehero-ss-trigger ehero-ss-compact-btn ehero-ss-compact-btn--plain">…icon…</button> — no circle/border/background.
• Unstyled: <a href="#" role="button" class="ehero-ss-trigger">…icon…</a> (or <button> depending on the tag) — no plugin style classes.

What each part is:

• .ehero-ss-widget — the search container. In Bricks/Elementor it is the element you select (no extra wrapper div).
• .ehero-ss-trigger — the JavaScript hook; always present in compact. It is what opens the search on click. It carries no styles, so you can add your own.
• .ehero-ss-compact-btn (and --plain) — the plugin's style classes. They only appear in Button and Plain icon modes.
• The icon is an <svg> (or an <img> if you uploaded one). To colour it from your CSS use color (the SVG uses currentColor) and for size width/height.

Example to style it yourself in Unstyled mode:

.ehero-ss-trigger { display:inline-flex; color:#017cba; }
.ehero-ss-trigger svg { width:35px; height:35px; }
.ehero-ss-trigger:hover { color:#015e8c; }

Shortcode

Inserta [ehero_smart_search] en cualquier página, entrada, widget o bloque. Todos los atributos son opcionales: sin ellos se usan los valores de Ajustes.

Ejemplos

[ehero_smart_search]

[ehero_smart_search layout="overlay" theme="dark"]

[ehero_smart_search layout="inline" placeholder="¿Qué estás buscando?"]

[ehero_smart_search layout="compact" accent="#e91e63"]

[ehero_smart_search category="zapatillas" max_results="6"]

Gutenberg, Elementor y Bricks Builder

Además del shortcode, el buscador está disponible como elemento nativo en los tres constructores más usados. Las opciones (layout, tema, placeholder, máximo de resultados, categoría y color de acento) son las mismas en los tres.

Shortcode

Insert [ehero_smart_search] in any page, post, widget or block. All attributes are optional: without them, the Settings values are used.

Examples

[ehero_smart_search]

[ehero_smart_search layout="overlay" theme="dark"]

[ehero_smart_search layout="inline" placeholder="What are you looking for?"]

[ehero_smart_search layout="compact" accent="#e91e63"]

[ehero_smart_search category="sneakers" max_results="6"]

Gutenberg, Elementor & Bricks Builder

Besides the shortcode, the search is available as a native element in the three most popular builders. The options (layout, theme, placeholder, max results, category and accent color) are the same in all three.

Estas funciones se activan solas en el frontend; aquí explicamos cómo se comportan y qué necesitan.

Botón «X» para limpiar

Cuando hay texto en el campo aparece un botón «X» que borra la búsqueda, cierra los resultados y vuelve a mostrar las búsquedas populares. Disponible en todos los layouts y en el panel a pantalla completa, conviviendo con el botón de voz.

Búsqueda por voz

En navegadores compatibles (Chrome, Edge, Safari) aparece un micrófono en el campo para dictar la búsqueda. La transcripción se ve en vivo mientras hablas y la búsqueda se lanza al terminar.

• El micrófono solo se muestra en contextos seguros (HTTPS).
• Un segundo clic detiene la escucha; el placeholder cambia a "Escuchando…".
• Si el servicio de voz del navegador se queda colgado, la escucha se corta a los 12 segundos y se muestra un aviso. El código de error se registra en la consola del navegador para diagnóstico.
• Si el micrófono está bloqueado, no se oye nada o el servicio no está disponible, se avisa con un mensaje claro.

Búsquedas recientes y tendencias

Al enfocar el buscador vacío, el cliente ve sus búsquedas recientes (guardadas en su propio navegador, con botón de borrar) y las búsquedas en tendencia de la tienda.

Resaltado del término

El término buscado se resalta en los nombres de producto de los resultados, para que el cliente vea de un vistazo por qué aparece cada producto.

Añadir al carrito sin salir del buscador

Los productos simples comprables muestran un botón de carrito en el resultado. Un clic lo añade vía AJAX, refresca el mini-carrito del tema y muestra una notificación. Los productos variables llevan a su ficha para elegir opciones.

Pestaña Productos | Contenido

Con la opción "Buscar también en entradas y páginas" activada (Ajustes → Extras), el panel completo muestra las pestañas Productos | Contenido para que el cliente encuentre también tus guías, FAQ y artículos del blog.

Sugerencias y "quizás quisiste decir"

En búsquedas sin resultado, el buscador propone términos parecidos, búsquedas relacionadas y búsquedas populares para que el cliente no se quede en una página vacía.

These features activate themselves on the frontend; here we explain how they behave and what they need.

"X" clear button

When there is text in the field, an "X" button appears that clears the search, closes the results and shows the popular searches again. Available in all layouts and in the fullscreen panel, alongside the voice button.

Voice search

In supported browsers (Chrome, Edge, Safari) a microphone appears in the field to dictate the search. The transcription shows live while you speak and the search runs when you finish.

• The microphone only shows in secure contexts (HTTPS).
• A second click stops listening; the placeholder changes to "Listening…".
• If the browser's speech service hangs, listening is cut off after 12 seconds and a notice is shown. The error code is logged to the browser console for diagnosis.
• If the microphone is blocked, nothing is heard or the service is unavailable, a clear message is shown.

Recent searches and trending

When focusing the empty search box, customers see their recent searches (stored in their own browser, with a clear button) and the store's trending searches.

Term highlighting

The search term is highlighted in product names in the results, so customers can see at a glance why each product appears.

Add to cart without leaving the search

Purchasable simple products show a cart button on the result. One click adds it via AJAX, refreshes the theme mini-cart and shows a toast. Variable products link to their page to pick options.

Products | Content tab

With "Also search posts & pages" enabled (Settings → Extras), the full panel shows Products | Content tabs so customers can also find your guides, FAQs and blog posts.

Suggestions and "did you mean"

On zero-result searches, the engine proposes similar terms, related searches and popular searches so the customer never lands on an empty page.

En Ajustes → Merchandising creas reglas por término de búsqueda: los productos fijados aparecen siempre arriba y, si quieres, se muestra un banner promocional con enlace. Funciona tanto en el desplegable como en el panel completo.

Campos de cada regla

Usa "Añadir regla" para crear más filas y el icono de papelera para eliminar cualquiera de ellas (incluida la última).

Ejemplo práctico

1. Crea una regla con el término regalo.
2. En productos fijados, busca y selecciona tus tarjetas regalo.
3. En el banner escribe "Envoltorio gratis esta semana" y enlaza a tu página de promociones.
4. Guarda. Cuando alguien busque "regalo", verá las tarjetas regalo arriba y el banner promocional.

In Settings → Merchandising you create rules per search term: pinned products always appear on top and, optionally, a promotional banner with a link is shown. Works in both the dropdown and the full panel.

Fields per rule

Use "Add rule" to create more rows and the trash icon to remove any of them (including the last one).

Practical example

1. Create a rule with the term gift.
2. Under pinned products, search and select your gift cards.
3. In the banner write "Free wrapping this week" and link to your promotions page.
4. Save. When someone searches "gift", they'll see the gift cards on top and the promotional banner.

Desde la 1.10 el buscador aprovecha la prueba social de tu tienda y te deja afinar el orden de los resultados.

Estrellas en los resultados

Cada producto con reseñas muestra su valoración media y nº de reseñas (★ 4.5 (12)) tanto en el dropdown como en el panel completo. No hay que activar nada: aparece automáticamente cuando el producto tiene reseñas de WooCommerce.

Rating boost

En Ajustes → Comportamiento de búsqueda → Rating boost puedes hacer que los productos mejor valorados suban posiciones:

Boost de destacados y ofertas

Con la casilla "Boost featured & on-sale products", los productos destacados y los que están en oferta reciben un pequeño empujón en el ranking. Además, independientemente de esta opción, los resultados muestran badges sobre la imagen: OFERTA (rebaja activa) y NUEVO (publicado en los últimos 30 días).

Impulso por categoría en la consulta

Con "Boost products from categories named in the query" activado, si una palabra de la búsqueda coincide con el nombre de una categoría, los productos de esa categoría se ponen por delante. Ejemplos: «zapatillas hombre» prioriza la categoría Hombre; «sync dreamlove prestashop» pone el módulo de PrestaShop antes que el de WooCommerce. Recomendado cuando tus categorías significan algo para el cliente: plataforma, público, marca, gama…

Tolerancia a erratas (v1.12)

Con "Typo tolerance" activado, si una búsqueda no devuelve nada se autocorrige usando las palabras reales de tu catálogo (títulos, categorías, etiquetas y marcas) y se repite. El cliente que escribe «zapatilas» ve los resultados de «zapatillas» con el aviso «Mostrando resultados para…». No corrige números ni palabras que ya son parte de un producto.

Resultados con la variación que coincide (v1.12)

Con "Show the matching variation", en productos variables, si la búsqueda nombra una variante («camiseta roja M») el resultado muestra esa variación concreta: su imagen, su precio, su enlace directo y una etiqueta con los atributos. Prioriza variaciones en stock.

"También te puede interesar" (v1.12)

Con "Show You may also like products", bajo los resultados (en la vista overlay/completa) aparece una tira de productos relacionados: primero las ventas cruzadas que tú hayas definido en el primer resultado y, si faltan, los relacionados por categoría de WooCommerce.

Productos agotados (v1.12)

En "Out-of-stock products" eliges cómo tratar lo agotado: mostrar normal, mandar al final (siguen apareciendo pero por debajo de lo disponible) u ocultar de los resultados.

Productos agrupados (v1.12)

Los nombres de los productos que contiene un agrupado se indexan dentro del propio agrupado, así buscar un artículo del paquete también encuentra el grupo. Los productos hijos siguen apareciendo por su cuenta.

Indexar preguntas y respuestas (Q&A)

Si tienes EHERO Woo Product Reviews activo, en Campos a indexar aparece el campo "Q&A (Product Reviews)". Al activarlo y reindexar, las preguntas publicadas, la respuesta de la tienda y las respuestas aprobadas de la comunidad pasan a formar parte del texto de búsqueda: el cliente que busca «¿cabe un portátil de 15 pulgadas?» encuentra la mochila aunque la ficha no use esas palabras.

Barra de confianza del negocio

Si tienes EHERO Woo Reviews (reseñas de Google, Facebook, Tripadvisor…), activa "Show business rating in the search panel" en Ajustes → Extras: el panel de búsqueda mostrará tu valoración agregada («★ 4.7/5 · 342 reseñas de clientes»). La cifra se cachea 12 horas.

Since 1.10 the search leverages your store's social proof and lets you fine-tune the result order.

Stars in results

Every product with reviews shows its average rating and review count (★ 4.5 (12)) in both the dropdown and the full panel. Nothing to enable: it appears automatically when the product has WooCommerce reviews.

Rating boost

In Settings → Search Behaviour → Rating boost you can make better-reviewed products climb positions:

Featured & sale boosts

With "Boost featured & on-sale products" checked, featured products and active sales get a small ranking nudge. Regardless of this option, results show badges over the image: SALE (active discount) and NEW (published in the last 30 days).

Category intent boost

With "Boost products from categories named in the query" enabled, when a search word matches a category name, products in that category rank first. Examples: "running shoes men" favours the Men category; "dreamlove sync prestashop" puts the PrestaShop module ahead of the WooCommerce one. Recommended when your categories carry meaning for the customer: platform, audience, brand, range…

Typo tolerance (v1.12)

With "Typo tolerance" on, if a search returns nothing it is auto-corrected using your catalog's real words (titles, categories, tags, brands) and retried. A customer typing "zapatilas" sees the "zapatillas" results with a "Showing results for…" notice. It never corrects numbers or words that are already part of a product.

Variation-aware results (v1.12)

With "Show the matching variation", for variable products, if the query names a variant ("red t-shirt M") the result shows that exact variation — its image, price, direct link and an attribute label. In-stock variations are preferred.

"You may also like" (v1.12)

With "Show You may also like products", a related-products strip appears under the results (overlay/full layout): the top result's cross-sells first and, if missing, WooCommerce category-related products.

Out-of-stock products (v1.12)

Under "Out-of-stock products" choose how to treat them: show normally, push to the bottom (still shown, below in-stock items) or hide from results.

Grouped products (v1.12)

The names of the items inside a grouped product are indexed into the group itself, so searching for an item in the bundle also finds the group. Child products still appear on their own.

Indexing questions & answers (Q&A)

If EHERO Woo Product Reviews is active, the "Q&A (Product Reviews)" field appears under Index fields. Enable it and reindex: published questions, the store's answer and approved community answers become part of the searchable text — a customer searching "does it fit a 15-inch laptop?" finds the backpack even if the product page never uses those words.

Business trust bar

If you run EHERO Woo Reviews (Google, Facebook, Tripadvisor reviews…), enable "Show business rating in the search panel" in Settings → Extras: the search panel will show your aggregate rating ("★ 4.7/5 · 342 customer reviews"). The figure is cached for 12 hours.

Redirecciones de búsqueda

En Ajustes → Comportamiento de búsqueda → Query redirects defines reglas «término | URL», una por línea:

devoluciones | https://mitienda.com/devoluciones/
envío | https://mitienda.com/envios/
contacto | https://mitienda.com/contacto/

Cuando un cliente busca exactamente ese término (sin distinguir mayúsculas), va directo a la URL en lugar de ver resultados de productos. Perfecto para consultas de servicio y para campañas («blackfriday | /promociones/»).

Filtro de precio en lenguaje natural

El motor entiende restricciones de precio escritas dentro de la propia búsqueda y las convierte en filtro automáticamente:

• «vestido por menos de 50» → vestidos con precio ≤ 50 €
• «zapatillas entre 20 y 40» → zapatillas de 20 a 40 €
• «reloj más de 100» → relojes desde 100 €
• También en inglés: under 30, over 100, between 20 and 40.

El panel muestra el aviso «Filtro de precio aplicado» para que el cliente sepa qué se ha hecho. Si el cliente usa además los filtros manuales de precio, estos siempre tienen prioridad.

Accesos directos a categorías y marcas

Si lo que se teclea coincide con el nombre de una categoría o de una marca, aparecen hasta 4 chips clicables encima de los resultados («Categoría: Zapatillas (38)», «Marca: Nike (52)») que llevan directamente al archivo correspondiente. No requiere configuración.

Query redirects

In Settings → Search Behaviour → Query redirects you define "term | URL" rules, one per line:

returns | https://mystore.com/returns/
shipping | https://mystore.com/shipping/
contact | https://mystore.com/contact/

When a customer searches exactly that term (case-insensitive), they go straight to the URL instead of seeing product results. Perfect for service queries and campaigns ("blackfriday | /deals/").

Natural-language price filter

The engine understands price constraints written inside the query itself and turns them into a filter automatically:

• "dress under 50" → dresses priced ≤ 50
• "sneakers between 20 and 40" → sneakers from 20 to 40
• "watch over 100" → watches from 100 up
• Spanish also works: menos de 50, más de 100, entre 20 y 40.

The panel shows a "Price filter applied" notice so the customer knows what happened. Manual price filters from the UI always take priority.

Category & brand quick links

If the typed text matches a category or brand name, up to 4 clickable chips appear above the results ("Category: Sneakers (38)", "Brand: Nike (52)") linking to the archive. No configuration needed.

El panel completo de resultados (layouts overlay e inline, y el panel que se abre con Intro) incluye filtros que el cliente puede combinar sin recargar la página:

Los filtros se recalculan con cada búsqueda: solo se muestran las categorías y rangos que existen entre los resultados actuales, evitando filtros vacíos.

The full results panel (overlay and inline layouts, plus the panel opened with Enter) includes filters that customers can combine without reloading the page:

Filters are recalculated with every search: only categories and ranges that exist among the current results are shown, avoiding empty filters.

Cuando una búsqueda no devuelve nada, el buscador puede ofrecer un campo "¿Te avisamos?" donde el cliente deja su email para que le notifiques cuando tengas el producto.

Cómo se activa

1. Ve a Ajustes → Extras e integraciones.
2. Activa "Capturar emails en búsquedas sin resultados".
3. Guarda los cambios.

Dónde se guardan los emails

• Se listan en la pestaña Analytics, junto al término que buscó cada cliente.
• Se envían también a EHERO Leads (si tienes el plugin instalado), para gestionarlos como leads de venta.

When a search returns nothing, the search box can offer a "Notify me" field where the customer leaves their email so you can notify them when you stock the product.

How to enable it

1. Go to Settings → Extras & Integrations.
2. Enable "Capture emails on zero-result searches".
3. Save the changes.

Where the emails are stored

• They are listed in the Analytics tab, next to the term each customer searched for.
• They are also forwarded to EHERO Leads (if you have the plugin installed), to manage them as sales leads.

Si tu tienda tiene Google Analytics 4 instalado (vía gtag.js o Google Tag Manager), el plugin envía automáticamente los eventos estándar del embudo de búsqueda. No hay que configurar nada: se activa con la casilla "Enviar eventos GA4" en Ajustes → Extras.

Con estos tres eventos puedes construir en GA4 el embudo completo: búsqueda → clic → carrito → compra, y medir qué porcentaje de tus ventas nace en el buscador.

If your store runs Google Analytics 4 (via gtag.js or Google Tag Manager), the plugin automatically sends the standard search-funnel events. Nothing to configure: enable the "Send GA4 events" checkbox in Settings → Extras.

With these three events you can build the full funnel in GA4: search → click → cart → purchase, and measure what share of your sales starts at the search box.

Actívalo en Ajustes → Extras e integraciones con la casilla "Email report", elige la frecuencia (semanal — cada lunes, o mensual — el día 1) e indica la dirección de destino (por defecto, el email del administrador).

El informe resume el periodo correspondiente (7 o 30 días):

• Búsquedas totales del periodo.
• Clics en resultados.
• Pedidos atribuidos al buscador, con sus ingresos.
• Top de búsquedas.
• Búsquedas sin resultado — tus oportunidades de catálogo y sinónimos.

Retención de datos

En Ajustes → Rendimiento y seguridad → Search log retention puedes fijar cuántos días se conserva el registro de búsquedas. Una tarea diaria borra automáticamente lo más antiguo. Con 0 se conserva todo. Útil para mantener la tabla ligera en tiendas con mucho tráfico y para cumplir tu política de privacidad.

Enable it in Settings → Extras & Integrations with the "Email report" checkbox, choose the frequency (weekly — every Monday, or monthly — on the 1st) and set the destination address (the admin email by default).

The report summarises the matching period (7 or 30 days):

• Total searches for the period.
• Clicks on results.
• Attributed orders with their revenue.
• Top searches.
• Zero-result searches — your catalog and synonym opportunities.

Data retention

In Settings → Performance & Security → Search log retention you can set how many days the search log is kept. A daily task automatically deletes anything older. 0 keeps everything. Useful to keep the table lean on busy stores and to comply with your privacy policy.

Las opciones SEO están en Ajustes → SEO. Convierten el buscador en una pieza más de tu posicionamiento.

The SEO options live in Settings → SEO. They turn the search into one more piece of your ranking strategy.

La pestaña Analytics (EHERO → Smart Search → Analytics) registra cada búsqueda y cada clic y los convierte en un panel profesional con indicadores, gráficas interactivas y tablas con buscador y paginación.

Indicadores (KPIs)

Ocho tarjetas resumen el periodo elegido (7, 30, 90, 180 o 365 días): búsquedas totales, clics, CTR, tasa de búsquedas sin resultado, términos únicos, resultados medios por búsqueda, pedidos atribuidos e ingresos atribuidos. Las cuatro primeras incluyen la variación frente al periodo anterior (▲/▼ en verde o rojo) para detectar tendencias de un vistazo.

Gráficas

Tablas

Todas las tablas tienen paginación y un filtro de texto para localizar cualquier término al instante.

Exportación

• CSV — datos agregados por término, listos para Looker Studio o Google Sheets.
• Excel — el mismo informe en formato .xls con cabecera con estilo, listo para abrir.
• PDF — informe ejecutivo con los KPIs, la gráfica de tendencia y las tablas principales. Perfecto para enviarlo a un cliente o a dirección.

Cómo sacarle partido

1. Revisa las búsquedas sin resultado cada semana: añade sinónimos para los términos que sí tienes y valora incorporar los productos que no.
2. Vigila la tabla "Vistas pero sin clic": si una búsqueda popular no genera clics, los resultados no convencen (foto, precio, orden).
3. Usa el top de búsquedas para decidir qué productos destacar en portada y en merchandising.
4. Mira los pedidos atribuidos para conocer el impacto real del buscador en tus ventas.

The Analytics tab (EHERO → Smart Search → Analytics) logs every search and click and turns them into a professional dashboard with KPIs, interactive charts and searchable, paginated tables.

KPIs

Eight cards summarise the selected period (7, 30, 90, 180 or 365 days): total searches, clicks, CTR, zero-result rate, unique terms, average results per search, attributed orders and attributed revenue. The first four include the change versus the previous period (▲/▼ in green or red) so you can spot trends at a glance.

Charts

Tables

Every table has pagination and a text filter to find any term instantly.

Export

• CSV — aggregated per-term data, ready for Looker Studio or Google Sheets.
• Excel — the same report as a styled .xls file, ready to open.
• PDF — executive report with the KPIs, the trend chart and the main tables. Perfect for sending to a client or to management.

How to make the most of it

1. Review zero-result searches weekly: add synonyms for terms you do stock and consider adding the products you don't.
2. Watch the "Seen but not clicked" table: if a popular search gets no clicks, the results aren't convincing (photo, price, ranking).
3. Use the top searches to decide which products to feature on the homepage and in merchandising.
4. Check attributed orders to learn the search box's real impact on your sales.

La pestaña Diagnostics responde a la pregunta clave: ¿se está usando la IA de verdad en mis búsquedas? Muestra el modo de IA activo, cuántos productos están indexados, cuántos tienen embeddings de IA (el porcentaje de cobertura) y el último error de IA registrado.

Probador de búsquedas

Escribe una consulta y pulsa Run test: se ejecuta una búsqueda real (sin caché) y verás qué aportó cada motor — si la IA generó el embedding y en cuántos milisegundos, su top de candidatos con puntuaciones, el top por palabras clave y el resultado final combinado con tus pesos. Ideal para afinar el peso semántico frente al de palabras clave.

Registro de trazas

Activa el interruptor "Log every search" y cada búsqueda del frontend guardará su traza completa: hit de caché, llamada de embedding (ok/error), candidatos por motor, regla de merchandising aplicada y tiempos. Se conservan las últimas 50. Cuando termines de diagnosticar, puedes desactivarlo.

The Diagnostics tab answers the key question: is the AI really being used in my searches? It shows the active AI mode, how many products are indexed, how many have AI embeddings (coverage percentage) and the last recorded AI error.

Search tester

Type a query and press Run test: a real search runs (bypassing the cache) and you'll see what each engine contributed — whether the AI generated the embedding and how long it took, its top candidates with scores, the keyword top and the final combined result using your weights. Ideal for tuning the semantic vs keyword weight.

Trace log

Turn on "Log every search" and every frontend search stores its full trace: cache hit, embedding call (ok/error), candidates per engine, applied merchandising rule and timings. The latest 50 are kept. Turn it off when you're done diagnosing.

Contacto

Escríbenos a soporte@consultoriaehero.com o visita consultoriaehero.com.

Información a incluir

• Versión del plugin, WordPress y WooCommerce.
• Versión de PHP.
• Captura de pantalla del error o del comportamiento inesperado.
• El término de búsqueda con el que ocurre el problema.
• Si el problema es de voz o del frontend, los mensajes de la consola del navegador (F12).

Contact

Write to soporte@consultoriaehero.com or visit consultoriaehero.com.

Information to include

• Plugin, WordPress, and WooCommerce versions.
• PHP version.
• Screenshot of the error or unexpected behaviour.
• The search term that triggers the problem.
• For voice or frontend issues, the browser console messages (F12).