Media Gallery
Un módulo simple pero potente que te permite crear y gestionar galerías de elementos multimedia en tu sitio Drupal, con integración de lightbox PhotoSwipe.
media_gallery
Instalar
composer require 'drupal/media_gallery:^3.2'
Overview
El módulo Media Gallery proporciona un tipo de entidad de contenido personalizado para crear y gestionar galerías multimedia en tu sitio Drupal. Aprovecha los módulos Media y Media Library del núcleo de Drupal para proporcionar una interfaz fácil de usar para organizar elementos multimedia en galerías.
El módulo presenta una integración estrecha con la biblioteca PhotoSwipe para una experiencia de lightbox elegante al visualizar imágenes de la galería. Las galerías pueden mostrarse usando varias opciones de diseño incluyendo cuadrícula, horizontal, vertical, cuadrícula con imagen destacada, e incluso un carrusel Swiper (con el módulo Swiper instalado).
Media Gallery soporta paginación, orden inverso, contenido traducible, y proporciona controles de permisos completos para gestionar quién puede crear, editar, ver y eliminar galerías. También incluye bloques para mostrar los últimos elementos de la galería o galerías específicas en cualquier parte de tu sitio, con diseños configurables y opciones de enlace "Ver todo".
Features
- Tipo de entidad Media Gallery personalizado con título, descripción y referencias ilimitadas a elementos multimedia
- Integración de lightbox PhotoSwipe para una experiencia elegante de visualización de imágenes
- Múltiples opciones de diseño para bloques de galería: Cuadrícula, Horizontal, Vertical, Cuadrícula con Imagen Destacada y Swiper (carrusel)
- Paginación configurable con ajustes de elementos por página y opción de orden inverso
- Dos plugins de bloque: uno para mostrar los últimos elementos de todas las galerías, otro para mostrar una galería específica
- Integración con Pathauto para generación automática de alias de URL
- Soporte completo de traducción para sitios multilingües
- Compatible con Layout Builder
- Página Views integrada en /galleries mostrando todas las galerías publicadas
- Sistema extensible de plugins de diseño que permite añadir diseños personalizados por otros módulos
- Soporte para tipos de medios que no son imágenes (videos, contenido oEmbed) dentro de las galerías
Use Cases
Galería de Portafolio Fotográfico
Crea un portafolio de fotógrafo organizando imágenes en galerías temáticas (por ejemplo, 'Bodas', 'Retratos', 'Paisajes'). Usa el diseño de Cuadrícula con Imagen Destacada para resaltar la mejor foto de cada galería, y habilita la paginación para galerías con muchas imágenes.
Galería de Imágenes de Productos
Para sitios de comercio electrónico, crea galerías de productos mostrando artículos desde diferentes ángulos. Usa el diseño Swiper para una experiencia de carrusel en páginas de productos, permitiendo a los clientes deslizar entre imágenes de productos.
Muestra de Galería en Página Principal
Usa el bloque 'Últimos elementos de galería de todas las galerías' para mostrar adiciones recientes de todas las galerías en la página principal. Configura el enlace 'Ver todo' para dirigir a los visitantes a la página completa /galleries.
Álbumes de Fotos de Eventos
Crea galerías para eventos (conferencias, fiestas, etc.) donde los usuarios pueden explorar fotos con el lightbox PhotoSwipe. Habilita el orden inverso para mostrar las fotos más nuevas primero.
Galería de Medios Mixtos
Crea galerías que incluyan videos junto con imágenes. El módulo soporta medios oEmbed (YouTube, Vimeo) y archivos de video, renderizándolos apropiadamente dentro del diseño de la galería.
Tips
- Crea diseños personalizados extendiendo MediaGalleryLayoutBase y añadiendo el atributo #[MediaGalleryLayout]
- Usa el diseño de cuadrícula con columnas configurables para galerías responsive que se adaptan al tamaño de pantalla
- El diseño de Cuadrícula con Imagen Destacada es perfecto para galerías estilo portafolio donde quieres resaltar un elemento
- Configura diferentes estilos de imagen para miniaturas y el modal PhotoSwipe para equilibrar rendimiento y calidad
- Usa la función de enlace 'Ver Todo' en bloques para dirigir tráfico a tu página de listado de galerías
- Para galerías muy grandes, habilita la paginación para mejorar el rendimiento de carga de página
- Las entidades de galería son traducibles - crea galerías multilingües habilitando la traducción en el tipo de entidad
Technical Details
Admin Pages 3
/admin/structure/media-gallery
Página de configuración para el tipo de entidad Media Gallery. Proporciona acceso para gestionar campos, visualización de formularios y configuración de visualización para galerías.
/admin/content/media-gallery
Página de lista mostrando todas las galerías multimedia. Proporciona una vista general con ID, título, estado, autor, fechas de creación y actualización. Permite a los administradores añadir, editar y eliminar galerías.
/admin/content/media-gallery/add
Formulario para crear una nueva galería multimedia con título, descripción, elementos multimedia, configuración de paginación y opciones de publicación.
Permisos 9
Hooks 1
hook_media_gallery_layout_info_alter
Permite a los módulos alterar las definiciones de plugins de diseño de galería multimedia
Troubleshooting 4
Asegúrate de que el módulo PhotoSwipe esté correctamente instalado y habilitado. Verifica que los archivos de la biblioteca PhotoSwipe estén correctamente descargados. Verifica que el campo de imágenes esté usando el formateador 'photoswipe_field_formatter'.
El diseño Swiper requiere que el módulo Swiper (swiper_formatter) esté instalado. Instálalo vía Composer: composer require drupal/swiper_formatter, luego habilítalo y crea una entidad de configuración de Swiper.
Verifica que las galerías contengan elementos multimedia publicados. Comprueba que el usuario que visualiza tenga el permiso 'view published media gallery entities'. Para el bloque de galería específica, asegúrate de que se haya seleccionado una galería en la configuración del bloque.
Habilita el submódulo de migración apropiado basado en tu versión del módulo Media de D7 (media_gallery_migration para 7.x-1.x o media_gallery_migration2 para 7.x-2.x). Asegúrate de que todos los módulos de migración requeridos (migrate_plus, migrate_tools) estén instalados.
Security Notes 3
- El permiso 'Administer media gallery settings' está marcado como acceso restringido y solo debe otorgarse a administradores de confianza
- El acceso a medios se verifica al renderizar elementos de galería - los medios no publicados no aparecerán aunque estén incluidos en una galería
- La visibilidad de la galería respeta los permisos 'view published/unpublished media gallery entities'