Resumen de Filtros Expuestos de Views
Muestra un resumen de los filtros expuestos seleccionados en el área de encabezado o pie de página de Views, permitiendo a los usuarios ver y eliminar filtros activos.
views_filters_summary
Instalar
composer require 'drupal/views_filters_summary:^3.3'
Overview
Views Exposed Filters Summary es un plugin de área de Views que proporciona una representación visual clara de qué filtros expuestos ha seleccionado el usuario. El resumen puede mostrarse en el área de encabezado o pie de página de cualquier View e incluye los nombres de los filtros y sus valores seleccionados.
El módulo es altamente configurable, permitiendo a los administradores controlar qué filtros aparecen en el resumen, cómo se formatean y si se muestran enlaces de eliminación individuales o un enlace de reinicio global. Soporta varios tipos de filtros incluyendo términos de taxonomía, bundles de entidades, campos de lista, filtros booleanos, nombres de usuario y rangos de fechas con manejo adecuado de operadores (igual, diferente, entre, mayor que, menor que, contiene, etc.).
El módulo incluye funcionalidad JavaScript completa que funciona tanto con Views habilitadas para AJAX como con Views estándar, asegurando que cuando los usuarios eliminen filtros individuales o reinicien todos los filtros, el View se actualice apropiadamente. Múltiples submódulos proporcionan integración con módulos contribuidos populares como Better Exposed Filters, Search API, Entity Browser, Address y Commerce.
Features
- Muestra el resumen de filtros expuestos en las áreas de encabezado o pie de página del View indicando qué filtros están actualmente activos
- Proporciona eliminación individual de filtros con botón 'X' que limpia valores de filtro específicos y actualiza el View
- Incluye una opción de enlace de reinicio para limpiar todos los filtros activos de una vez
- Selección de filtros configurable - elige qué filtros expuestos incluir en el resumen
- Visualización opcional de etiquetas de filtros junto a los valores para mayor contexto
- Agrupa filtros de múltiples valores bajo una sola etiqueta para reducir el desorden visual
- Separador personalizable entre elementos de filtro (coma, barra vertical, etc.)
- Texto de prefijo personalizable antes del resumen de filtros (ej., 'Filtrando por:')
- Etiquetas de resultados en singular y plural para gramática correcta (ej., '1 resultado' vs '5 resultados')
- Formato de contenido totalmente personalizable con tokens de reemplazo incluyendo @total, @result_label, @exposed_filter_summary
- Soporta visualización consciente de operadores (muestra 'No igual a', 'Contiene', 'Mayor que', etc.)
- Funciona con Views habilitadas para AJAX para actualizaciones de filtros sin recarga de página
- Funciona con Views estándar sin AJAX usando manipulación del estado del historial
- Traduce nombres de términos de taxonomía al idioma actual del usuario en sitios multilingües
- Sistema completo de hooks para extender y personalizar el comportamiento de visualización de filtros
- Once submódulos para integración con módulos contribuidos populares
Use Cases
Catálogo de Productos con Múltiples Filtros
En un sitio de comercio electrónico con vistas de productos filtradas por categoría, rango de precios, marca y disponibilidad, muestra un resumen como 'Mostrando 42 productos para Categoría: Electrónica, Precio: $100-$500, Marca: Sony' con botones X para eliminar filtros individuales y un enlace Reiniciar para limpiar todos.
Panel de Administración de Contenido
En una vista de gestión de contenido con filtros por tipo de contenido, autor, estado y rango de fechas, muestra los filtros activos en el encabezado para que los administradores puedan ver rápidamente qué subconjunto de contenido están viendo y modificar fácilmente su selección.
Página de Resultados de Búsqueda con Navegación Facetada
Al usar Search API con filtros facetados, muestra las selecciones de facetas activas (términos de taxonomía, tipos de contenido, rangos de fechas) en una barra de resumen sobre los resultados, permitiendo a los usuarios ver y eliminar facetas individuales sin desplazarse a la barra lateral.
Directorio de Usuarios con Filtros Accesibles
Para un directorio de usuarios filtrado por rol, departamento y ubicación, usa el submódulo A11y para proporcionar eliminación de filtros amigable para lectores de pantalla con etiquetas ARIA apropiadas y estructura HTML semántica.
Widget de Selección de Entity Browser
En un Entity Browser usado para seleccionar contenido relacionado, muestra los filtros activos para que los editores de contenido sepan por qué criterios están navegando al seleccionar entidades para referenciar.
Filtrado de Taxonomía Multilingüe
En un sitio multilingüe con contenido filtrado por taxonomía, muestra los nombres de términos de taxonomía traducidos en el resumen de filtros coincidiendo con el idioma actual del usuario para una experiencia consistente.
Tips
- Usa el token @exposed_filter_summary en el campo Contenido para posicionar el resumen de filtros en cualquier lugar dentro de tu texto de resultados (ej., 'Mostrando @total @result_label @exposed_filter_summary')
- Habilita 'Mostrar etiquetas' cuando los usuarios podrían no reconocer los valores de filtro sin contexto (ej., mostrar 'Categoría: Electrónica' en lugar de solo 'Electrónica')
- Usa 'Agrupar filtros de múltiples valores' para consolidar selecciones como 'Categorías: Electrónica, Ropa, Libros' en lugar de repetir la etiqueta para cada valor
- Instala el submódulo A11y para implementaciones que cumplan con accesibilidad con HTML semántico apropiado y soporte para lectores de pantalla
- Al usar Views con AJAX, el resumen de filtros se actualiza automáticamente cuando los filtros cambian sin recargar la página completa
- El enlace de reinicio solo reinicia los filtros mostrados en el resumen, no otros filtros en el View - útil para preservar ciertos estados de filtro predeterminados
- El texto separador personalizado (coma, barra vertical, punto y coma) puede incluir espaciado según sea necesario - el predeterminado es ', ' con espacio final
- El texto de prefijo aparece antes de todos los elementos de filtro pero solo cuando hay filtros activos para mostrar
- Extiende el soporte de filtros implementando hook_views_filters_summary_plugin_alias() para mapear plugins de filtro personalizados a lógica de procesamiento existente
- Usa hook_views_filters_summary_info_alter() para personalizar el formato de fechas u otros requisitos de visualización específicos de filtros
Technical Details
Hooks 8
hook_views_filters_summary_info_alter
Altera la definición de información del resumen de un filtro incluyendo ID, etiqueta y valores procesados. Útil para cambiar cómo se muestran tipos de filtro específicos.
hook_views_filters_summary_replacements_alter
Añade o modifica tokens de reemplazo disponibles en el formato de texto del resumen. Permite añadir tokens personalizados como @search_api_fulltext.
hook_views_filters_summary_item_alter
Modifica un elemento de filtro específico antes de renderizarlo, incluyendo sus atributos de enlace y propiedades de visualización.
hook_views_filters_summary_plugin_alias
Mapea un ID de plugin de filtro a la lógica de procesamiento de otro plugin. Útil cuando plugins de filtro personalizados se comportan como los estándar.
hook_views_filters_summary_valid_index
Valida un valor de índice de array para un plugin de filtro específico, determinando si debe incluirse en el resumen.
hook_views_filters_summary_exposed_form_id_alter
Cambia el ID del formulario expuesto usado para hacer coincidir el resumen con su formulario, requerido para módulos que incrustan Views en formularios personalizados.
hook_views_filters_summary_filter_value_alter
Altera el valor crudo del filtro antes de que sea procesado y mostrado en el resumen.
hook_views_filters_summary_filter_value_label_alter
Modifica la etiqueta de visualización para un valor de filtro, permitiendo formato personalizado basado en el tipo de filtro o configuración.
Troubleshooting 6
Verifica si tu tipo de filtro está soportado. Para plugins de filtro personalizados, instala el submódulo apropiado o implementa hook_views_filters_summary_plugin_alias() para mapearlo a un tipo de plugin soportado.
Asegúrate de que el View tenga AJAX habilitado en la configuración Avanzada. El JavaScript verifica la clase 'views-filters-summary--use-ajax' para determinar el método de envío.
Habilita el submódulo views_filters_summary_eb que proporciona el ID de formulario expuesto correcto para displays de Entity Browser.
Para Views sin AJAX, el módulo usa history.replaceState para actualizar la URL. Asegúrate de que tu servidor maneje correctamente los parámetros de consulta actualizados.
El módulo traduce los términos de taxonomía al idioma actual. Asegúrate de que los términos tengan traducciones disponibles y que el módulo Language esté correctamente configurado.
Los filtros de rango se muestran como 'min-max' o usan prefijos de operador como 'Mayor o igual que' cuando solo un límite está establecido. Este es el comportamiento esperado.