Crea una puerta de enlace de búsqueda

Search Gateway es un formulario GET compacto que recopila valores canónicos de un contexto de Faceted Search existente y envía al visitante a otra URL.

Configuración de Search Gateway en el Page Builder

No muestra ni actualiza los resultados en su página de origen. Úsalo para una caja de búsqueda en la página de inicio, un panel de búsqueda en la cabecera o una página de aterrizaje de campaña que conduzca a un archivo completo.

En Gutenberg, usa el bloque dinámico Search Gateway block. Ambos editores usan el mismo formulario GET. Faceted Search y el contexto seleccionado deben estar habilitados; un contexto o destino no disponible no produce ningún formulario público.

Prepara el destino

Crea y verifica primero el destino:

  1. Configura su contexto de Faceted Search.
  2. Añade las facetas de destino y Listings (Feed).
  3. Confirma que la página de resultados completa acepta selecciones y crea parámetros pf_.

La puerta de enlace hereda los IDs de facetas, los valores canónicos y el comportamiento de inclusión/exclusión de ese contexto.

Añade la puerta de enlace

  1. Edita la página de origen en el Page Builder.
  2. Añade Search Gateway desde Faceted Search.
  3. Selecciona Context.
  4. Establece Destination mode:
    • URL e introduce Target URL; o
    • WordPress archive, y luego elige Post type archive, Taxonomy term archive o Shop.
  5. En Facets, añade y reordena los campos que los visitantes deben completar.
  6. Guarda la página.

El destino puede ser una ruta relativa o una URL HTTP(S) absoluta. Para un destino de taxonomía, elige la taxonomía e introduce el ID del término.

Configura cada campo

Cada fila de faceta puede establecer:

  • Facet;
  • Renderer: heredar, select, radio, checkboxes, select con búsqueda, autocomplete o text;
  • Label override y Placeholder override;
  • Show label?;
  • anchos de escritorio, tableta horizontal, tableta vertical y móvil. Vertical hereda de móvil salvo que se establezca explícitamente.

Solo se ofrecen facetas compatibles con entrada. Una anulación del renderer cambia el control compacto del formulario, no la semántica de coincidencia configurada de la faceta.

Los controles son entradas nativas, no los widgets interactivos de facetas. La configuración de select con búsqueda usa un select múltiple ordinario, y autocomplete usa las sugerencias del navegador de los valores canónicos. Los controles de texto y de sugerencias envían un solo valor; usa checkboxes o select múltiple para varios valores. Los rangos tienen entradas From/To con nombres individuales; la proximidad usa latitud, longitud y radio. Las listas de opciones están limitadas a 500 valores y los campos personalizados a 100. Un campo eliminado no provoca que una selección personalizada herede todos los campos del contexto.

Configura el envío

Usa Show submit button? para mostrar un botón con estilo o permitir el envío con Enter. Cuando el botón está visible, establece su texto, estilo, tamaño, icono y anchos de columna responsivos.

En Advanced, Preserve GET parameters acepta una lista de permitidos separada por comas de parámetros no relacionados de la página actual. No incluyas ahí parámetros de faceta pf_; la puerta de enlace genera por sí misma sus campos de faceta canónicos.

Los valores por defecto de la consulta del destino tienen prioridad sobre los parámetros preservados. Su fragmento se conserva y los controles de faceta propios no reciben valores por defecto ocultos duplicados. Los nombres de parámetros sensibles a la seguridad no se copian. Mantén un botón de envío visible para los formularios de solo selección.

Verifica la redirección

Envía cada campo por separado y luego una combinación. Confirma:

  • que el navegador navega al archivo previsto;
  • que el destino restaura las facetas seleccionadas;
  • que las etiquetas y los anchos responsivos coinciden con el diseño;
  • que una etiqueta oculta sigue dando al campo un nombre accesible;
  • que el modo de selección de la puerta de enlace coincide con el contexto de destino.