Search

Omnisearch

Una única ventana de página completa que ofrece a tus visitantes los resultados con mayor probabilidad de conversión.
Omnisearch example

Omnisearch es una experiencia de búsqueda completa en una sola superposición. Combina resultados a medida que los visitantes escriben con la exploración total de resultados y facetas, reemplazando los componentes separados de Instant Search y Search Page.

Elige Omnisearch por sí solo o Instant Search y Search Page juntos. Si Omnisearch ya está instalado, no necesitas agregar ninguno de estos componentes. Personaliza el diseño y la configuración de tu Omnisearch existente para mejorar la experiencia.

Omnisearch incluye:

  • Resultados en vivo que se muestran a tus visitantes a medida que escriben, e incluyen productos, categorías y páginas.
  • Ordenación y filtrado: permite a tus visitantes refinar su búsqueda de manera intuitiva y sencilla.
  • Fácil de integrar en tu sitio utilizando una de nuestras excelentes plantillas iniciales.
  • Se adapta a tu marca modificando algunos ajustes estándar como el logo, fuentes, colores y más.
  • Totalmente personalizable con HTML, CSS y Liquid para developers.

Primeros pasos #

Omnisearch consta de un Diseño personalizable para los aspectos visuales y un bloque Elemento que permite instalarlo en tu sitio.

Crear un diseño #

Esto se realiza en Search > Designs > New Design

Selecciona el tipo Omnisearch, elige un diseño inicial y asígnale un nombre.

Haz clic en Save para guardar el diseño estándar. Vuelve a la lista de diseños o al diseño principal como un paso de navegación separado.

Nuestros diseños estándar funcionan inmediatamente y siempre se pueden editar después. Editarlos requiere conocimientos de HTML, CSS y Liquid. Consulta Styling en esta guía para más información.

Crear un Elemento #

Esto se realiza en Search > Element > New Element

Los bloques de Element son contenedores para los elementos que creas en tu cuenta my.clerk.io. Contienen la lógica para mostrar resultados y las configuraciones de cuántos resultados mostrar. La lógica de estado vacío también se puede manipular mediante Rules.

  • Nombre te ayuda a identificar tu elemento en caso de que quieras crear más de uno. Se puede modificar más adelante.

  • Tipo de elemento es Omnisearch por defecto, y no debería ser cambiado. Aquí también puedes agregar filters si es necesario, pero en la mayoría de los casos no es necesario.

  • Empty State Logic te permite seleccionar el tipo de productos que se mostrarán cuando Omnisearch se abre inicialmente, antes de que se escriba alguna palabra. Por defecto es Bestsellers pero también puede personalizarse, por ejemplo con Visitor Recommendations.

Finalizar Diseño #

El diseño que se usará para visualizar el bloque Element. Selecciona el diseño que creaste.

Si tu diseño incluye variables, también se pueden establecer aquí.

Puedes controlar la cantidad de resultados que se mostrarán para cada tipo, cada vez que se realiza una búsqueda. Generalmente recomendamos estas cantidades:

  • Productos: 20-60
  • Sugerencias: 5
  • Categorías y páginas: 10

Por último, elige los atributos que quieres incluir como Facetas y define los nombres con los que se mostrarán en los resultados de búsqueda. Si no encuentras un atributo específico en la lista, añádelo en la lista de “atributos filtrables” en Search Configuration.

Incrustar en el sitio #

El método recomendado para esto es mediante inyección, pero también puedes insertar el elemento en tu sitio con un embedcode.

La Visibilidad se utiliza para controlar quién puede ver el Omnisearch.

  • En previsualización te permite probar tu elemento sin afectar tu sitio en vivo. Puedes abrir tu sitio en vista previa haciendo clic en “Abrir sitio en previsualización” o añadiendo ?clerk_content_mode=preview a la url de tu sitio.

  • En mi sitio en vivo se utiliza cuando hayas terminado de hacer pruebas y estés listo para hacerlo público.

Usando inyección #

Esta es la forma más fácil de instalar. Clerk añadirá automáticamente el código de Omnisearch a tu sitio, dirigiéndose a un campo de búsqueda de tu elección y activándolo mediante un evento.

  • Evento controla lo que el usuario debe hacer para activar Omnisearch. Es probable que quieras que se muestre cuando tus visitantes hacen clic en tu icono de búsqueda o en el campo de entrada.

  • Elemento decide la parte del sitio web con la que debe interactuar el usuario. Por ejemplo, si quieres que tu elemento Omnisearch se muestre sólo cuando tus visitantes interactúan con la barra de búsqueda (clic o foco sobre ella), solo necesitas encontrar el selector CSS único que se le aplica. Si tienes identificadores diferentes en móvil y escritorio, añádelos ambos.

Encuentra tu selector CSS único de la siguiente manera:

  1. Inspecciona el código de tu sitio. En la mayoría de los navegadores puedes hacer clic derecho en cualquier parte de la página y elegir Inspeccionar o similar.
  2. Encuentra el elemento que quieras seleccionar.
  3. Haz clic derecho sobre él, y busca la opción copiar > copiar selector.

Usando código incrustado #

Esto te permite añadir Omnisearch con un snippet. Para usar esto, necesitas poder editar los archivos HTML de tu tienda online o añadir código con un editor.

Si tienes cambios sin guardar, guárdalos para generar el código incrustado.

Copia este código y pégalo en el archivo que genera todas las páginas de la tienda, idealmente cerca de la etiqueta final </body>.

Reemplaza INSERT_CSS_SELECTOR_FOR_ELEMENT_THAT_SHOULD_TRIGGER_OMNISEARCH por el selector CSS del elemento html que debe activar tu Omnisearch.

A continuación tienes un ejemplo completo del código de integración de Omnisearch con todas las opciones de configuración:

<span class="clerk"
    data-template="@omnisearch"
    data-api="search/omni"
    data-trigger-element="INSERT_CSS_SELECTOR_FOR_ELEMENT_THAT_SHOULD_TRIGGER_OMNISEARCH"
    data-limit="40"
    data-suggestions="6"
    data-categories="6"
    data-pages="6"
    data-omni-search-suggestions="6"
    data-omni-search-categories="6"
    data-omni-search-pages="6"
    data-omni-search-empty="recommendations/popular">
</span>

Modos de visualización #

Omnisearch admite dos modos de visualización que controlan cómo aparece la interfaz de búsqueda en tu sitio. Configúralo en la pestaña Insert al editar tu Elemento Omnisearch.

Superposición completa #

Este es el modo predeterminado. Cuando se activa, Omnisearch cubre toda la vista con una superposición a pantalla completa. La interfaz de búsqueda toma el control de la página, proporcionando una experiencia de búsqueda enfocada.

Utiliza este modo cuando quieras:

  • Un entorno de búsqueda sin distracciones
  • Control completo sobre el diseño de búsqueda
  • Que la interfaz de búsqueda sea completamente independiente del encabezado de tu sitio

Superposición parcial #

Este modo integra Omnisearch con el encabezado existente de tu sitio. En lugar de cubrir toda la pantalla, la superposición aparece debajo de tu encabezado, manteniéndolo visible y funcional.

Utiliza este modo cuando desees:

  • Mantener el encabezado y navegación accesibles durante la búsqueda
  • Una integración más fluida con el diseño existente de tu sitio
  • Que la experiencia de búsqueda parezca una extensión natural del sitio
Opciones de configuración #

Al seleccionar Superposición Parcial, aparecen configuraciones adicionales:

Selector del encabezado

El selector CSS del elemento encabezado de tu sitio. Omnisearch lo usa para posicionar la superposición justo debajo del encabezado, asegurando una alineación correcta.

Ejemplos de selectores:

  • header
  • .site-header
  • #main-header

Selector de input de búsqueda

El selector CSS de tu campo de búsqueda existente. Si se proporciona, Omnisearch se sincroniza con el campo de búsqueda del encabezado, creando una experiencia unificada donde al escribir en la caja de búsqueda se actualizan los resultados de Omnisearch.

Ejemplos de selectores:

  • #search-input
  • .header-search input
  • [name="search"]

Ancho

Controla el tamaño horizontal de la superposición:

  • Ancho completo: Ocupa todo el ancho de la vista
  • Ancho del contenido: Coincide con el ancho de un elemento contenedor que defines con un selector CSS
  • Ancho fijo: Un ancho en píxeles que defines

Alto

Controla el tamaño vertical de la superposición:

  • Desde el encabezado hasta abajo: Llena el espacio desde debajo del encabezado hasta el fondo de la vista
  • Porcentaje de la pantalla: Un porcentaje de la altura de la ventana (por ej. 80%)
  • Altura fija: Un valor fijo en píxeles
  • Altura máxima: Define un límite superior, permitiendo que la superposición sea más pequeña si el contenido necesita menos espacio

Alineación horizontal

Controla dónde aparece la superposición horizontalmente:

  • Izquierda: Alineado al lado izquierdo de la vista
  • Centro: Centra la superposición horizontalmente
  • Derecha: Alineado al lado derecho de la vista

Posición vertical

Controla la ubicación vertical relativa al encabezado:

  • Debajo del encabezado: Posiciona la superposición justo debajo del elemento encabezado
  • Fijo desde arriba: Un desplazamiento en píxeles desde la parte superior de la vista

Configuración del diseño #

La mayor parte del Omni-search puede configurarse cambiando las variables en los archivos de diseño.

En el lenguaje de plantilla Liquid, una variable tiene la siguiente estructura:

{% assign variable_name = "variable value" %}

Por regla general, solo el valor de la variable debe modificarse para configurar el Omni-search.

Por supuesto, los usuarios más técnicos pueden seguir modificando líneas específicas de HTML y CSS, ver esta sección.

Para agregar un logo al diseño Omnisearch, establece os_brand_logo con la URL de imagen de tu logo.

Carga infinita/automática #

Si quieres controlar si el Omni-search debe cargar automáticamente más productos al llegar a la última fila, la variable debe establecerse en true o false. La variable normalmente se llama os_autoload. Ponla en false para evitar que Omnisearch cargue resultados automáticamente.

Traducciones #

Por defecto, la plantilla está en inglés. Si tu tienda tiene otro idioma, puedes traducir los textos cambiando los valores de las variables.

Traduce las variables de los botones de ordenación en la plantilla junto con todo el resto de variables de texto.

Consejo pro: Usa IA generativa (ej. chatGPT) para traducir en masa escribiendo “Traduce estos valores de variables del inglés al danés. Devuelve el código completo para poder copiar/pegar: PASTE_VARIABLES_HERE”

Estilización #

Para cambiar cualquier estilo, la configuración puede realizarse con las variables CSS.

Las plantillas usan variables CSS que tienen la siguiente estructura:

--variable_name: variable_value;

Para usuarios más técnicos, pueden modificarse reglas CSS individuales para cambios de diseño más avanzados.

Colores #

Los colores configurables se identifican y configurán bajo el comentario CSS “Colors” /* Colors */

Fuentes #

Al igual que los colores, la variable de fuente puede encontrarse bajo el comentario /* Font */.

Normalmente tiene una variable como: --font-family: 'Kumbh Sans', sans serif;

Diseño estándar #

El diseño estándar de Omnisearch incluye:

  • Soporte para menú desplegable de variantes: permite elegir variantes (ej. talla, color) antes de añadir al carrito.

  • Selector de cantidad.

  • Botón nativo de añadir al carrito que notifica a Clerk.js, asegurando que el análisis y merchandising estén sincronizados.

  • Markup limpio y bien estructurado con comentarios claros.

  • Variables centralizadas para estilo y comportamiento, facilitando ajustar colores, espaciado, etiquetas y opciones comunes sin cambiar el código principal.

  • Faceta de deslizador de precios para filtrado rápido por rango.

  • Sugerencias clicables que activan la búsqueda inmediatamente.

Para desarrolladores #

Estilización #

Los diseños constan de un diseño principal, CSS de estilos y un conjunto de sub-diseños que pueden referenciarse en el diseño principal.

Puedes editar todos estos para Escritorio y Móvil por separado. Por defecto, Omni-search usa el mismo HTML para todos los tamaños de pantalla, y usa CSS para ser totalmente responsivo. Por eso la pestaña Móvil no tiene código al principio.

Si es necesario, puedes crear un marcado HTML completamente diferente para Móvil, que se usará en pantallas pequeñas.

Inicialmente, quizá solo quieras ajustar algunas cosas para hacer que el diseño se parezca a tu marca. Siempre puedes editar el diseño después.

HTML #

Este es el diseño principal que controla la colocación de todos los elementos. Usa Liquid como lenguaje de plantillas.

En nuestros diseños iniciales, la primera sección está dedicada a los elementos que más se cambian, como etiquetas de ordenación, moneda y los diversos textos que puedes traducir a tu idioma.

CSS #

Estilo que se inyectará junto con el HTML, dándote control total del aspecto visual de forma contenida.

Sub-diseños disponibles #

En el editor de código Search, Available Designs and Components aparece debajo del área de código principal. Desplázate hacia abajo para encontrar y editar un componente. Usa las pestañas sobre el editor para alternar HTML/CSS de escritorio y móvil.

Tras editar un componente, haz clic en Save, y vuelve al diseño principal por separado. Cualquier diseño añadido aquí se puede referenciar en el diseño general. Funcionan como módulos que se editan de forma independiente y se añaden con su ID y nombre: {{@247373 - TopBarSearchForm}}

Puedes eliminar, duplicar o copiar la referencia de cualquier sub-diseño haciendo clic en el botón de tres puntos.

Para editar un sub-diseño, haz clic en su icono Editar. Al terminar de editar, haz clic Guardar y cerrar para volver al editor principal.

Algunos elementos necesitan identificadores específicos, como:

  • El campo de entrada id="clerk-omnisearch-input"
  • El wrapper de contenido id="clerk-omnisearch-content"

Cuando quieras ver tu progreso, puedes hacerlo haciendo clic en el botón “Previsualizar diseño”.

Los cambios más habituales en los diseños son estos:

  • Logo: Accede a TopBarSearchForm y reemplaza el logo por el tuyo.

  • Fuentes: Si lo necesitas, ajusta las fuentes para igualar la apariencia de tu sitio.

  • Colores: Puedes añadir los colores de tu marca en los elementos que quieras destacar o combinar con el resto de tu sitio como botones y etiquetas.

  • Botones y bordes de etiqueta: Puedes ajustar su color, radio, ancho…

  • Enlaces: Si tienes un estilo específico para tus enlaces, también puedes modificarlo.

Partes reactivas vs estáticas #

Comprender qué partes de Omnisearch se vuelven a renderizar por consulta —y cuáles no— es importante a la hora de personalizar el diseño.

Partes estáticas se renderizan una vez cuando se abre la superposición y no se modifican en consultas posteriores:

  • El contenedor de la superposición (clerk-omnisearch-overlay)
  • El campo de entrada (#clerk-omnisearch-input)
  • Todo el HTML en el diseño que vive fuera de #clerk-omnisearch-content — como el logo, botón de cerrar o la barra superior

El campo de entrada es intencionalmente estático. Volver a renderizarlo en cada tecla interrumpiría la escritura del visitante y arruinaría la experiencia.

Partes reactivas son todo lo que está dentro de #clerk-omnisearch-content. Todo este envoltorio se vuelve a renderizar con cada consulta:

  • Resultados de productos
  • Facetas y filtros
  • Categorías, páginas y sugerencias
  • Conteo de resultados y controles de ordenación
  • Mensajes de sin resultados

Si quieres que un elemento se actualice cuando cambia la consulta —por ejemplo, un conteo en vivo de resultados en el encabezado— debe estar dentro de #clerk-omnisearch-content. Si quieres que se mantenga visible y estable mientras el visitante escribe, colócalo afuera de ese envoltorio.

Estado Sin Resultados #

Cuando una consulta no devuelve productos, Omnisearch no muestra automáticamente un fallback —esto se controla en el diseño usando Liquid.

La forma recomendada es comprobar si products está vacío y condicionar el renderizado de un deslizador alternativo y un mensaje personalizado:

{% if products.length > 0 %}
  <!-- Resultados normales -->
  {% for product in products %}
    <!-- product card -->
  {% endfor %}

{% else %}
  <!-- Sin resultados -->
  <div class="clerk-no-results-message">
    Sin resultados para "{{ query }}" — pero aquí tienes algunas opciones populares:
  </div>

  <span class="clerk"
    data-api="recommendations/popular"
    data-limit="8"
    data-template="@omnisearch-product-card">
  </span>
{% endif %}

También puedes usar results.products.no_exact_match para detectar cuando Omnisearch muestra coincidencias relacionadas en vez de exactas, y mostrar un mensaje apropiado:

{% if results.products.no_exact_match %}
  <div class="clerk-no-exact-match">
    Sin coincidencias exactas para "{{ query }}" — mostrando lo más parecido:
  </div>
{% endif %}

Ambos patrones pueden combinarse. Habitualmente, el mensaje no_exact_match se muestra encima de los resultados, y el deslizador fallback solo cuando products.length == 0.

El texto del mensaje de sin resultados está en HTML plano dentro del diseño, así que puedes traducirlo o estilizarlo libremente sin cambiar configuraciones fuera del editor.

Estructura de la superposición #

Cuando se inicia omnisearch, se crea un elemento con la clase clerk-omnisearch-overlay que se inserta al final del body.

Aquí inyectamos el diseño; como el campo de entrada forma parte del diseño, hay que asegurarse de no renderizarlo de nuevo en cada búsqueda. La estructura debe verse así debajo de la superposición:

<div>
    <input type="text" id="clerk-omnisearch-input"/>
    <div id="clerk-omnisearch-content">
        Element!
    </div>
</div>

Campo de entrada #

Para encontrar el campo, necesita tener el identificador clerk-omnisearch-input. Al activarse el elemento disparador, se mueve el foco del cursor a este campo y se agrega la consulta existente, para mantener la experiencia fluida.

Wrapper de contenido #

El wrapper de contenido es donde sucede la mayor parte de la acción; el envoltorio debe tener el identificador clerk-omnisearch-content. Aquí deben ir las facetas, sliders y todo lo que no es el campo de entrada.

Clases #

Se puede agregar funcionalidad al diseño añadiendo clases específicas a los elementos.

Botón de cerrar #

clerk-omnisearch-close

Cuando se adjunta la clase a un elemento dentro del diseño, ese elemento ocultará la superposición.

Ordenación #

clerk-omnisearch-sort

Encuentra los dropdowns de ordenación y añade listeners.

Para agregar ordenación al diseño, añádelo al elemento seleccionador, ej. un dropdown. Debe ser de tipo value:[desc|asc], así que el valor que queremos ordenar, seguido de dos puntos y luego desc o asc. Opcionalmente puedes agregar un atributo data-sort-type si quieres ordenar categorías o páginas.

Faceta de búsqueda #

clerk-facet-search

Si hay búsqueda de facetas, crea un listener y oculta las que no coincidan con la consulta.

La clase, cuando está presente en una web, comprueba si hay elementos de búsqueda en facetas. Las búsquedas en facetas permiten buscar entre las facetas. Debe tener un valor de string para funcionar.

Borrado total #

clerk-omnisearch-full-reset

Al hacer clic, los elementos con esta clase borrarán todas las facetas seleccionadas y restablecerán la consulta.

Borrado de facetas #

clerk-omnisearch-facet-full-reset

Al hacer clic, los elementos con esta clase deseleccionarán todas las facetas activas. Suele usarse en un botón “Borrar todo” dentro de un grupo de facetas, permitiendo restablecer los filtros de forma sencilla.

Borrado de grupo #

clerk-omnisearch-facet-group-reset

Al hacer clic, los elementos con esta clase deseleccionarán todos los elementos hijos del grupo.

Para permitir borrar un grupo de facetas completo, un elemento debe tener la clase y el atributo con el grupo por nombre data-facet-group.

Borrado de faceta #

clerk-omnisearch-facet-reset

Los elementos con esta clase deben deseleccionar una sola faceta según el par de atributo grupo/valor.

Esta clase es para cuando se necesita deseleccionar una sola faceta. El elemento debe tener tanto data-facet-group como data-facet-value. Al activarse, solo deselecciona esa faceta específica, dejando las demás intactas.

Selección de faceta #

clerk-facet

Los elementos con esta clase serán tratados como facetas seleccionables.

Todas las facetas deben tener esta clase junto con los atributos data-facet-group y data-facet-value, para que sepamos cuál está seleccionando el cliente.

Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.