Pagerer
Módulo de estilos de paginación configurables que proporciona una colección de estilos de paginación mejorados para reemplazar o complementar el paginador estándar de Drupal.
pagerer
Install
composer require 'drupal/pagerer:^3.1'
composer require 'drupal/pagerer:8.x-2.3'
Overview
Pagerer es un módulo completo de mejora de paginación que proporciona una colección de estilos de paginador configurables para mejorar los paginadores estándar de Drupal y Views. Permite a los administradores y constructores de sitios preconfigurar múltiples configuraciones de paginador (presets) donde cada preset puede estar compuesto por tres paneles: izquierdo, central y derecho. Cada panel puede contener cualquiera de los estilos de paginador disponibles, ofreciendo una flexibilidad extensiva para satisfacer requisitos de paginación complejos.
El módulo puede anular el paginador del núcleo de Drupal con cualquier configuración de preset globalmente, o los presets individuales pueden usarse dentro de Views específicos a través del plugin de paginador de Views incluido. Pagerer utiliza las clases CSS estándar del paginador de Drupal, asegurando compatibilidad de estilos CSS con los temas existentes.
Las capacidades principales incluyen: mostrar números de página, elementos o rangos de elementos; enlaces a páginas progresivamente más distantes (como +10, +100, +1000); enlaces de lógica adaptativa que se aproximan a las páginas objetivo mediante navegación similar a búsqueda binaria; separadores de texto y divisores personalizables; soporte para paginadores habilitados con AJAX en Views; y la capacidad de iniciar la numeración de páginas desde 1 en lugar de 0 en los parámetros de URL.
Features
- Sistema de paginador multi-panel con paneles izquierdo, central y derecho que pueden contener diferentes estilos de paginador cada uno
- Cinco estilos de paginador integrados: Standard (como el núcleo de Drupal), Progressive (enlaces a páginas cada vez más distantes), Adaptive (navegación similar a búsqueda binaria), Basic (similar al mini paginador de Views) y Multipane (estilo compuesto)
- Sistema de presets configurable que permite guardar configuraciones de paginador ilimitadas
- Reemplazo global del paginador del núcleo - reemplaza el paginador estándar de Drupal en todo el sitio con cualquier preset
- Integración con plugin de paginador de Views - usa diferentes presets de Pagerer para diferentes Views
- Modos de visualización: páginas, elementos o rangos de elementos con etiquetas de texto personalizables
- Enlaces de navegación primero/anterior/siguiente/último configurables con reglas de visualización flexibles
- Personalización de parámetros de URL - usa nombres de parámetros personalizados (por ejemplo, 'pg' en lugar de 'page') e indexación de páginas basada en uno
- Soporte para paginadores habilitados con AJAX en Views
- Diseño accesible con soporte para lectores de pantalla a través de texto configurable para lectores
- Personalización completa de texto a través de configuración de etiquetas traducibles
- Separadores de página y divisores con visualización configurable
Use Cases
Reemplazar el paginador en todo el sitio con navegación mejorada
Usa Pagerer para reemplazar el paginador predeterminado de Drupal en todas las páginas con una alternativa más rica en funciones. Configura un preset con tu estilo deseado (por ejemplo, Progressive para grandes conjuntos de datos) y selecciónalo como reemplazo del paginador del núcleo en la configuración de Pagerer.
Diferentes paginadores para diferentes Views
Crea múltiples presets de Pagerer adaptados a diferentes casos de uso. Para un catálogo de productos con miles de artículos, usa el estilo Progressive con enlaces a +10, +100 páginas. Para un archivo de blog, usa el estilo Basic. Asigna cada preset a la View apropiada.
URLs de página basadas en uno amigables para SEO
Configura los ajustes de URL para usar indexación de páginas basada en uno (pg=1 en lugar de page=0) para URLs más amigables para el usuario y SEO. También personaliza el nombre del parámetro de 'page' a 'pg' para URLs más limpias.
Paginador multi-panel con navegación e información
Crea un preset con estilo Basic en el panel izquierdo (mostrando navegación anterior/primero), estilo Standard en el centro (mostrando números de página) y estilo Basic en el panel derecho (mostrando navegación siguiente/último más conteo de elementos). Esto proporciona información de navegación completa.
Navegación de grandes conjuntos de datos con estilo Adaptive
Para conjuntos de datos muy grandes donde los usuarios necesitan encontrar una página específica rápidamente, usa el estilo Adaptive. Utiliza un enfoque de búsqueda binaria donde hacer clic en enlaces adaptativos reduce progresivamente el rango hasta alcanzar la página objetivo.
Mostrar elementos en lugar de páginas
Configura un paginador para mostrar 'Elementos 1-50 de 5000' en lugar de 'Página 1 de 100' estableciendo la opción de visualización a 'elementos' o 'rangos de elementos'. Esto es útil cuando el enfoque está en el conteo de contenido en lugar de números de página.
Tips
- Usa el módulo de ejemplo (pagerer_example) para ver demostraciones en vivo de todos los estilos de paginador en /pagerer/example
- El estilo Progressive con factores '10' crea enlaces a intervalos de +10, +100, +1000 páginas - útil para conjuntos de datos muy grandes
- El estilo Adaptive es ideal cuando los usuarios necesitan encontrar una página específica en un gran conjunto de datos pero no conocen el número exacto de página
- Al personalizar etiquetas de texto, usa marcadores como @number, @total, @item_low, @item_high, @total_items para valores dinámicos
- Cada panel puede tener un modo de visualización diferente - muestra páginas en el centro pero conteos de elementos en los paneles laterales
- Para accesibilidad, configura los valores de reader_text para proporcionar descripciones significativas para usuarios de lectores de pantalla
Technical Details
Admin Pages 5
/admin/config/user-interface/pagerer
Página principal de configuración de Pagerer que lista todos los presets de paginador creados con vistas previas en vivo, y permite seleccionar un preset para reemplazar el paginador del núcleo de Drupal globalmente.
/admin/config/user-interface/pagerer/url_settings
Configura los ajustes de parámetros de URL para anular el parámetro estándar 'page' de Drupal con un formato personalizado.
/admin/config/user-interface/pagerer/preset/add
Crea una nueva configuración de preset de Pagerer.
/admin/config/user-interface/pagerer/preset/manage/{pagerer_preset}
Configura los tres paneles (izquierdo, central, derecho) de un preset de Pagerer seleccionando un estilo para cada panel. Incluye vista previa en vivo del paginador configurado.
/admin/config/user-interface/pagerer/preset/manage/{pagerer_preset}/pane/{pane}
Formulario de configuración detallada para los ajustes de estilo de un panel específico incluyendo opciones de visualización, comportamiento de enlaces, separadores y cadenas de texto.
Hooks 2
hook_pagerer_style_plugin_info_alter
Permite a los módulos alterar las definiciones de plugins de estilo de Pagerer
hook_element_info_alter
Pagerer usa este hook para reemplazar el tema del elemento paginador del núcleo con el tema de pagerer cuando está configurado para anular el paginador del núcleo
Troubleshooting 4
Limpia todas las cachés después de cambiar la configuración de Pagerer. El módulo se conecta al sistema de elementos de renderizado que está en caché.
Asegúrate de haber habilitado la casilla 'Parámetro de URL' en la configuración de URL y guardado la configuración. Limpia las cachés después.
El preset debe estar creado y guardado antes de que aparezca en la configuración del paginador de Views. Crea el preset primero en la administración de Pagerer, luego configura la View.
Verifica la configuración de 'Restricción' en la configuración del panel. Si está establecido en 'al menos dos páginas' y solo hay una página de resultados, el paginador no se mostrará.