web_fsearch_reset Shortcode
El shortcode web_fsearch_reset borra todas las selecciones de Faceted Search, o solo las seleccionadas. Gutenberg ofrece el bloque dinámico equivalente Faceted Search Reset; consulta Restablecer filtros en Gutenberg.
Uso
[web_fsearch_reset label="Reset filters" mode="all"]
[web_fsearch_reset context="catalog" mode="include" include="category,price" reset_extras="0"]Sustituye los IDs de contexto y de faceta por los configurados en tu sitio.
Atributos
| Atributo | Valor predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
context |
Vacío | ID de contexto habilitado | Vacío sigue el contexto de resultados activo de la página. |
label |
Reset filters traducido | Texto sin formato | Etiqueta visible del botón. |
class |
Vacío | Clases helper existentes | Añade clases al botón normal. |
mode |
all |
all, include, exclude |
Borra todas las facetas, solo las facetas incluidas, o todas excepto las facetas excluidas. |
include |
Vacío | IDs de facetas separados por comas | Facetas que borrar en modo de inclusión. Una lista vacía no borra ninguna. |
exclude |
Vacío | IDs de facetas separados por comas | Facetas que conservar en modo de exclusión. |
auto_hide |
1 |
1, 0 |
Oculta cuando no quedan selecciones objetivo ni controles extra restablecibles. Una casilla Legacy sin marcar también desactiva el ocultamiento. |
reset_extras |
Automático | Vacío, 1, 0 |
Restaura los valores predeterminados de Ordenar y Por página. Automático lo habilita para todos los modos y lo desactiva en los restablecimientos parciales. |
button_style |
1 |
Slug de estilo de botón configurado | Usa un estilo de tema habilitado, con una alternativa actual para referencias no disponibles. |
button_size |
default |
xs, sm, default, lg, x2, x2-large, x3-large, x4-large |
Helper de tamaño existente del tema. |
Cada lista de inclusión/exclusión está limitada a 500 IDs únicos saneados. Restablecer una faceta borra sus selecciones, no su definición global ni sus datos de índice.
Contexto y comportamiento
Habilita y configura Settings → POM Theme → Content model → Faceted search, un índice y resultados coincidentes. Los controles comparten un contexto interactivo por página. Las funciones deshabilitadas o los contextos explícitos no disponibles no muestran nada; los controles de otros contextos no alteran la consulta activa.
El restablecimiento tiene en cuenta las selecciones solo de URL y las entradas manuales pendientes. Un restablecimiento parcial conserva las selecciones no relacionadas. Cada restablecimiento reinicia la paginación, mientras que los controles extra siguen los primeros valores predeterminados coincidentes de Ordenar y Por página solo cuando se solicita. Las búsquedas manuales respetan el ajuste Refresh after reset? del listado de resultados (submit_on_reset). Se conservan los parámetros de URL no relacionados.
Ambos maquetadores usan el mismo renderizador, los helpers de botón existentes y los recursos condicionales de Faceted Search, con independencia de la administración del Page Builder.
Verificación
Comprueba los restablecimientos completos y parciales, los resultados vacíos, las selecciones solo de URL, los controles extra modificados, la política de envío manual, el ocultamiento automático y el enfoque de teclado. Prueba los botones Atrás/Adelante del navegador y varios controles que usen el mismo contexto.