Gallery para TYPO3

Por qué sf_filecollection_gallery resuelve correctamente las galerías de imágenes en TYPO3

Las galerías de imágenes están entre los requisitos más frecuentes en webs corporativas - fotos de producto, imágenes de equipo, documentación de eventos, proyectos de referencia. TYPO3 no trae un elemento nativo de galería. El elemento de contenido estándar “Imágenes” muestra imágenes apiladas o en columnas, pero sin lightbox, sin filtrado y sin opciones de layout flexibles. sf_filecollection_gallery cierra esta brecha usando TYPO3 File Collections como fuente de datos para galerías, con integración lightbox, varios layouts y lazy loading incluidos.

La ventaja decisiva frente a otras extensiones de galería: los editores trabajan con el sistema FAL que ya conocen. Las imágenes se organizan en File Collections, y la galería muestra automáticamente todas las imágenes de la colección asignada. Añadir nuevas imágenes significa: arrastrar la imagen a la colección, listo.

Escenarios de uso habituales

Proyectos de referencia y portfolios. Una agencia de arquitectura muestra en cada página de proyecto de 15 a 40 imágenes en galería. El editor gestiona una File Collection por proyecto. sf_filecollection_gallery renderiza la galería como grid con lightbox. Las descripciones de las imágenes desde los metadatos FAL se muestran automáticamente como pies de foto.

Documentación de eventos y fotografía de prensa. Un organizador de ferias documenta cada evento con 50 a 200 fotos. Las imágenes se suben en lotes a una File Collection. sf_filecollection_gallery genera thumbnails automáticamente, optimiza el tiempo de carga mediante lazy loading y muestra la galería en layout masonry.

Catálogos de producto con representación visual. Un fabricante de muebles muestra por categoría de producto una galería con fotografías de ambiente. Mediante varias File Collections (una por categoría) y un plugin frontend con filtro de categoría, los visitantes pueden cambiar entre galerías sin recargar la página.

Arquitectura técnica

sf_filecollection_gallery es una extensión Extbase integrada como plugin TYPO3 en elementos de contenido. La fuente de datos son TYPO3 File Collections del File Abstraction Layer (FAL). La extensión soporta colecciones estáticas (archivos asignados manualmente), colecciones basadas en carpeta (todos los archivos de un directorio) y colecciones basadas en categoría.

Las plantillas Fluid controlan la salida. La extensión incluye plantillas para layout grid, layout masonry y listas simples. sf_filecollection_gallery soporta varias librerías lightbox: Fancybox, PhotoSwipe y Lightcase. Gosign recomienda PhotoSwipe por su mejor soporte táctil y la ausencia de dependencia de jQuery.

Lazy loading está integrado nativamente mediante el atributo loading="lazy" y opcionalmente Intersection Observer para navegadores antiguos.

Problemas frecuentes y soluciones

La galería no muestra imágenes aunque la File Collection está llena. La causa suele ser una configuración de Storage incorrecta. La File Collection referencia un Storage al que el frontend no tiene acceso. Solución: verificar en el backend TYPO3 bajo Listado de archivos que las imágenes están en el Storage correcto y este está configurado como “public”.

El lightbox no funciona, las imágenes se abren como nueva página. La librería JavaScript del lightbox no se carga. Frecuentemente falta un include TypoScript o hay un conflicto con otra librería JavaScript. Con lightboxes basadas en jQuery (Fancybox), un conflicto de versión de jQuery puede ser la causa.

Tiempo de carga alto con galerías grandes. Una galería con más de 100 imágenes en alta resolución puede cargar lento si los thumbnails no están suficientemente comprimidos. Solución: configurar TYPO3 Image Processing para generar thumbnails en tamaño fijo (por ejemplo, 400x300px) y calidad optimizada (75-80 %). Activar formato WebP vía la configuración de Image Processing de TYPO3.

Migración y compatibilidad de versiones

sf_filecollection_gallery se mantiene activamente y está disponible para TYPO3 v11 y v12 LTS. La extensión tiene una API estable y apenas breaking changes. Al actualizar TYPO3 de v10 a v12 debe revisarse la configuración del lightbox. Gosign recomienda migrar de Fancybox a PhotoSwipe, que funciona sin jQuery y ofrece mejor rendimiento en dispositivos móviles. La migración de Fancybox a PhotoSwipe requiere típicamente de 4 a 8 horas.