Shortcode web_fsearch_per_page
El shortcode web_fsearch_per_page muestra un selector de número de resultados para la búsqueda facetada.
Uso
[web_fsearch_per_page]Atributos
| Atributo | Valor por defecto | Valores admitidos | Propósito |
|---|---|---|---|
context |
Página actual | ID de contexto habilitado | Propietario opcional; solo el contexto de resultados activo es interactivo. |
class |
— | Cadena salvo que se indique lo contrario | Añade una o más clases CSS personalizadas al control mostrado. |
label |
— | Cadena salvo que se indique lo contrario | Establece la etiqueta visible del control. |
options |
— | Cadena salvo que se indique lo contrario | Define los valores seleccionables usando el formato documentado para este control. |
default |
default |
Cadena salvo que se indique lo contrario | Define el valor seleccionado inicialmente. |
Contexto de búsqueda facetada
Habilita y configura la búsqueda facetada en Settings → POM Theme → Content model → Faceted search. Los controles, resultados y pasarelas que pertenecen al mismo conjunto deben usar valores de contexto compatibles.
Define options a través del constructor como los tamaños de página admitidos y selecciona uno de ellos como default. Mantén los valores positivos y moderados: las páginas muy grandes aumentan el trabajo de consulta, renderizado, imágenes y del navegador, y pueden hacer que la interfaz sea más lenta que la paginación.
Prueba cada opción con filtros activos, la página parcial final, la restauración de URL, el comportamiento de restablecimiento y la navegación de avance/retroceso del navegador. Cambiar el tamaño de página debería devolver al visitante a una página válida del mismo conjunto de resultados filtrados, en lugar de conservar un número de página fuera de rango.
Verificación
Prueba web_fsearch_per_page con el contexto de búsqueda facetada configurado, con selecciones activas, sin selecciones y con un conjunto de resultados vacío. Presta especial atención a class y label.
Bloque nativo y comportamiento compartido
Usa Faceted Search Pager and Per Page para los controles nativos equivalentes. Ambas rutas usan la misma puerta de función, solicitud de resultados, recursos condicionales y plantillas. Las etiquetas de instancia, los estilos y las listas ordenadas de tamaños permanecen independientes.
Load more e Infinite tienen prioridad sobre la paginación de reemplazo y ocultan Per Page para el contexto coincidente. Las opciones heredadas de número de resultados por página conservan enteros positivos ordenados, incluidos los valores superiores a 200. Los valores por defecto all y las selecciones por URL existentes muestran el conjunto de resultados completo; los valores con formato incorrecto usan el valor por defecto de la consulta. Los controles de tamaño nativos del editor siguen limitados a 50 opciones de 1 a 200. El primer selector de tamaño coincidente proporciona su valor por defecto salvo que exista una opción explícita en la URL. Cambiar el tamaño restablece la paginación, y Reset lo cambia solo cuando está configurado para restablecer los controles adicionales.