Entity Pager
Proporciona enlaces de navegación anterior y siguiente en páginas de entidades utilizando Views como fuente de datos.
entity_pager
Instalar
composer require 'drupal/entity_pager:8.x-1.0'
Overview
Entity Pager es un módulo de Drupal que proporciona navegación anterior y siguiente en páginas de entidades, permitiendo a los usuarios navegar a través de una serie de entidades sin volver a una página de listado. El módulo aprovecha Views para definir el conjunto de entidades a través del cual navegar, haciéndolo altamente flexible y personalizable.
El módulo funciona creando un bloque de Views con el plugin de estilo Entity Pager. Cuando se coloca en una página de entidad, determina automáticamente la posición actual en el conjunto de resultados de la vista y muestra enlaces de navegación a las entidades anterior y siguiente. También soporta un enlace opcional "Todos" que puede apuntar a una página de listado o cualquier otra URL.
Entity Pager soporta reemplazo de tokens en el texto de los enlaces y URLs, permitiendo contenido dinámico basado en la entidad actual. También puede trabajar con relaciones de Views para navegar a través de entidades relacionadas, como navegar a través de todos los productos de una marca específica.
Features
- Proporciona enlaces de navegación anterior/siguiente en cualquier página de entidad (nodes, usuarios, términos de taxonomía, etc.)
- Usa Views como fuente de datos, permitiendo control total sobre el ordenamiento y filtrado de entidades
- Soporta texto de enlace personalizable con HTML y reemplazo de tokens
- Enlace "Todos" configurable para volver a páginas de listado o páginas de entidades relacionadas
- Soporta relaciones de Views para navegar a través de entidades relacionadas
- Opción de paginación circular para ir del último elemento al primero y viceversa
- Visualización opcional del contador de posición (ej., "2 de 5")
- Opción para mostrar u ocultar enlaces de navegación deshabilitados en la primera/última entidad
- Incluye una vista y bloque de demostración para configuración rápida
- Soporta sitios multilingües con manejo adecuado de idiomas
Use Cases
Navegación de publicaciones de blog
Agregar enlaces anterior/siguiente a publicaciones de blog para que los lectores puedan navegar fácilmente a través de los artículos en orden cronológico. Crear una View de todos los nodes de Artículo publicados ordenados por fecha, establecer el estilo a Entity Pager, y colocar el bloque en las páginas de node de artículo.
Navegación de catálogo de productos
Permitir a los clientes navegar a través de productos dentro de una categoría. Crear una View con un filtro contextual para la categoría del producto, usar el estilo Entity Pager, y los usuarios pueden navegar a través de todos los productos en la categoría actual.
Navegación de portafolio
Permitir a los visitantes navegar a través de elementos del portafolio o casos de estudio. El enlace 'Todos' puede configurarse para volver a la página principal del portafolio usando el token [site:url]/portfolio.
Navegación de entidades relacionadas con Entity Reference
Navegar a través de productos pertenecientes a una marca específica. Usando relaciones de Views y el token de Entity Reference en el enlace 'Todos' (ej., [node:field_brand]), los usuarios ven 'Anterior - Nombre de Marca - Siguiente' donde hacer clic en el nombre de la marca los regresa a la página de la marca.
Navegación de galería de fotos
Permitir a los usuarios ver fotos una a la vez con navegación anterior/siguiente. La función de contador muestra '3 de 25' para que los usuarios sepan su posición en la galería.
Lectura secuencial de documentación
Guiar a los usuarios a través de páginas de documentación en orden. La paginación circular puede habilitarse para volver a la primera página después de la última, creando una experiencia de lectura continua.
Tips
- Use la vista de demostración 'Entity Pager Example' como punto de partida - habilítela y examine su configuración para entender cómo funciona el módulo
- Establezca 'Elementos por página' a 0 (ilimitado) en la configuración del pager de la vista para incluir todas las entidades en la navegación
- Para mejor rendimiento con grandes conjuntos de resultados, considere agregar caché apropiado a su vista
- Use HTML en las etiquetas de los enlaces para estilos personalizados, ej., '<span class="icon-prev"></span> Anterior'
- Cuando use tokens de referencia de entidad para la URL del enlace 'Todos', use el mismo token para el texto del enlace para mostrar automáticamente el título de la entidad referenciada
- La vista debe ser un display de bloque - los displays de página típicamente no se usan ya que el entity pager está diseñado para aparecer en páginas de entidad
Technical Details
Troubleshooting 4
Asegúrese de que el campo ID de la entidad (ej., nid para nodes) esté incluido en los campos de la View. La vista debe devolver los IDs de entidad para determinar la posición actual. También verifique que la entidad actual coincida con el tipo de entidad base de la vista.
Verifique el orden de clasificación en su View. El entity pager usa el orden de resultados de la vista para determinar las entidades anterior y siguiente. Asegúrese de que su vista esté ordenada correctamente.
Asegúrese de que el módulo Token esté instalado. El reemplazo de tokens usa el contexto de entidad de la entidad anterior/siguiente (para enlaces prev/next) o de la entidad de la página actual (para el enlace 'todos').
El entity pager solo aparece si la entidad actual se encuentra en los resultados de la vista. Verifique que los filtros de su vista incluyan la entidad actual y que los permisos permitan verla.