Shortcode web_search_gateway
Renderiza un formulario GET nativo que utiliza los campos actuales de un contexto de búsqueda facetada habilitado. Los visitantes envían el formulario a otra página de resultados; la página de origen no inicia el motor de búsqueda interactivo.
Uso
[web_search_gateway context="catalog" target_url="/results/#results" button_text="Search"]Habilita la búsqueda facetada y configura el contexto antes de usar el formulario. Tanto el contexto como el destino deben estar disponibles. El equivalente en Gutenberg es Search Gateway.
Atributos
| Atributo | Predeterminado | Valores aceptados y propósito |
|---|---|---|
context |
Vacío | ID del contexto habilitado requerido. |
destination_mode |
url |
url o wordpress_archive. |
target_url |
Vacío | Destino mediante ruta relativa o HTTP(S) absoluta. Los esquemas con credenciales o ejecutables se rechazan. |
archive_type |
post_type |
post_type, taxonomy o shop. |
archive_post_type |
Vacío | Tipo de contenido público con un archivo. |
archive_taxonomy |
Vacío | Taxonomía pública para el destino del término. |
archive_term |
Vacío | ID del término que pertenece a esa taxonomía. |
fields |
Vacío | Filas de campos ordenadas procedentes del constructor visual. Una configuración no vacía selecciona solo esos campos. |
fields_mode |
inherit |
custom conserva una selección intencionadamente vacía; en caso contrario, un fields vacío hereda los campos compatibles del contexto. |
field_overrides |
Vacío | Filas de campos antiguas, que se leen solo cuando no se suministra fields. |
facets |
all |
Atributo heredado conservado; la selección de campos está controlada por fields, no por este valor. |
show_submit |
yes |
no oculta el botón y mantiene el envío con Enter desde los campos de texto/rango. |
button_text |
Buscar (traducido) | Etiqueta visible en texto plano. |
button_style |
1 |
Estilo activo actual del tema; los estilos no disponibles usan una alternativa habilitada. |
button_size |
default |
xs, sm, default, lg, x2, x2-large, x3-large, x4-large. |
button_icon |
Vacío | Referencia canónica de icono del tema, como fontawesome/search. El SVG pasivo actual se resuelve al renderizar. |
submit_col_lg |
12 |
Ancho en escritorio, 1–12. |
submit_col_md |
12 |
Ancho en tableta horizontal, 1–12. |
submit_col_sm |
Vacío | Ancho en tableta vertical, 1–12; vacío hereda el móvil. |
submit_col |
12 |
Ancho en móvil, 1–12. |
preserve_params |
Vacío | Hasta 50 nombres de parámetros GET públicos separados por comas/espacios que se conservan de la URL de origen. |
el_class |
Vacío | Clases CSS auxiliares existentes en el formulario. |
form_id |
Vacío | ID explícito del formulario; usa un valor distinto para cada formulario de la página. |
Filas de campos
Usa el editor de campos del Page Builder para mantener las filas codificadas. Cada fila acepta facet_id, renderer, label, placeholder, show_label, enabled, col_lg, col_md, col_sm y col. Las etiquetas/marcadores de posición se heredan cuando están vacíos; la visibilidad y la inclusión se predeterminan a yes. Los anchos se predeterminan a 12, excepto el vertical, que hereda el móvil. Los cuatro puntos de ruptura son 992, 768, 576 e inferior a 576 píxeles.
Solo se respetan las sobrescrituras del renderizador compatibles. Los campos personalizados que faltan o están deshabilitados se omiten sin añadir de forma inesperada todos los campos del contexto. Las filas personalizadas están limitadas a 100 y las opciones a 500. Los controles de texto/sugerencia envían un único valor canónico; usa casillas de verificación o selecciones múltiples para varios valores. Las sugerencias no son un facetado AJAX interactivo.
Destino y parámetros
Un envío GET reemplaza la consulta en su URL de acción. Por lo tanto, el renderizador conserva los valores predeterminados seguros de la consulta de destino como campos ocultos, conserva el fragmento y evita duplicar el valor de un facetado propio. Los valores predeterminados del destino tienen prioridad sobre los parámetros conservados de la URL de origen.
El estado pf_ de origen y los nombres de parámetros sensibles, incluidas credenciales, tokens, nonces y valores de vista previa, no se copian. Los nombres de parámetros públicos deben empezar con una letra y contener solo letras, dígitos, guiones bajos o guiones, con un máximo de 64 caracteres.
No se necesita ningún estilo ni script público adicional. El formulario usa los helpers de cuadrícula/formulario/botón existentes del tema y mantiene el renderizado de forma independiente de la configuración de administración del Page Builder.
Verificación
Comprueba la restauración del destino sin selección, con cero numérico, opciones múltiples y rangos. Verifica las etiquetas, el envío por teclado y los cuatro anchos adaptables. La búsqueda facetada deshabilitada, los contextos que faltan y los destinos no válidos no muestran nada en lugar del texto del shortcode almacenado.
Consulta Build a Search Gateway.