Shortcode web_fsearch_submit
El shortcode web_fsearch_submit aplica los filtros pendientes a los resultados de búsqueda facetada coincidentes. Funciona con listados manuales y automáticos y reinicia la paginación.
Uso
[web_fsearch_submit]
[web_fsearch_submit context="catalog" label="Apply filters" button_style="1" button_size="sm" button_icon="fontawesome/search"]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
context |
Vacío | ID de contexto habilitado | Vacío sigue el contexto de resultados activo. |
label |
Search traducido |
Texto sin formato | Nombre del botón visible y accesible; vacío usa el predeterminado. |
button_style |
1 |
Estilo de botón del tema habilitado | Los estilos no disponibles usan una alternativa habilitada. |
button_size |
default |
xs, sm, default, lg, x2, x2-large, x3-large, x4-large |
Utilidad de tamaño existente del tema. |
button_icon |
Vacío | Referencia de icono registrada, como fontawesome/search |
Icono decorativo actual; si faltan iconos, la etiqueta permanece visible. |
class |
Vacío | Clases CSS separadas por espacios | Utilidades existentes adicionales en el botón. |
Contexto de búsqueda facetada
Habilita y configura la búsqueda facetada en Settings → POM Theme → Content model → Faceted search. Usa un contexto interactivo por página con resultados coincidentes. Los contextos explícitos que faltan o están deshabilitados no muestran nada. Con la función deshabilitada, el shortcode tampoco muestra nada. La administración del Page Builder puede permanecer deshabilitada.
El listado de resultados es el responsable de la política de envío manual/automático. Enviar fuerza una actualización inmediata en cualquiera de los dos modos; no cambia esa política. Conserva los filtros solo de URL y los argumentos de URL no relacionados, y reinicia la paginación ordinaria y dividida. La salida es un type="button" nativo con las utilidades web-btn existentes, no una acción de envío de formulario.
Varios controles coincidentes comparten la misma búsqueda. Durante una solicitud exponen estados de accesibilidad de ocupado/deshabilitado e ignoran la activación repetida mientras conservan el foco. Si se produce un fallo, aparece un mensaje accesible y los filtros pendientes se pueden reintentar. Los controles ocultos, deshabilitados o de contexto ajeno no se envían.
Verificación
Prueba con selecciones activas y pendientes, filtros solo de URL, sin selecciones y con un conjunto de resultados vacío. Comprueba la activación por teclado, los clics repetidos, el reintento tras una solicitud fallida y la coexistencia con Reset. Confirma que la primera página de resultados aparece después del envío.
En Gutenberg, usa Faceted Search Submit para obtener el mismo renderizado y comportamiento con controles de edición nativos.