downloadmanager para TYPO3

downloadmanager ordena las áreas de descargas en TYPO3 cuando un directorio de archivos anidado ya no basta, con categorías, etiquetas, búsqueda y un contador de descargas sin cookies

En cuanto un proyecto TYPO3 tiene que gestionar más de veinte archivos de descarga, el mantenimiento manual se derrumba. Los redactores enlazan PDF mediante el link browser, el directorio crece caótico, los documentos existentes se sobrescriben por error y los visitantes ya no encuentran nada a través de la búsqueda. downloadmanager resuelve exactamente ese problema: presenta el fondo de archivos como un repositorio estructurado, con registros propios, categorías, etiquetas, metadatos y una interfaz en la que los usuarios pueden buscar de forma dirigida. Para empresas con hojas de datos de producto, asociaciones con colecciones de formularios y ayuntamientos con centros de descarga, es la solución estándar.

La diferencia con la gestión mediante simples carpetas FAL es fundamental. Mientras fileadmin representa un sistema de archivos, downloadmanager introduce una capa editorial por encima: un documento puede aparecer simultáneamente en varias categorías, llevar un título de visualización independiente del nombre de archivo y controlarse mediante una planificación de publicación. Para redacciones con requisitos de compliance, eso es a menudo una condición previa.

Escenarios típicos de uso

El caso clásico es el catálogo técnico de producto. Un fabricante de maquinaria mantiene, para cada máquina, una hoja de datos, un manual de uso, un certificado CE y una lista de piezas de recambio. Cada descarga recibe una categoría de producto, una asignación de tipo y, opcionalmente, una etiqueta de idioma. Los visitantes filtran por gama de producto y tipo de documento, obtienen de inmediato los archivos correspondientes, y la tienda no tiene que enlazar cada PDF por separado. La propia página de producto puede mostrar una mini área de descargas que lista automáticamente todos los documentos asociados a la máquina, sin duplicación editorial.

El segundo caso son las áreas de formularios en ayuntamientos, administraciones y colegios profesionales. Los formularios de solicitud, las fichas informativas y los estatutos están agrupados temáticamente, a menudo multilingües, ocasionalmente con restricción de acceso para áreas internas de miembros. downloadmanager permite exactamente esa segmentación mediante fe_groups y categoriza los documentos por área funcional. Para administraciones públicas es además importante que los datos de publicación y los plazos de validez puedan gestionarse por documento.

Tercer uso: áreas de prensa y relación con inversores. Informes anuales, notas de prensa y material gráfico se archivan centralmente, se categorizan por año y se marcan con fecha de publicación. La redacción solo tiene que introducir cada documento una vez; las listas de frontend se generan automáticamente.

Arquitectura técnica

downloadmanager es una extensión Extbase y mantiene registros propios en tx_downloadmanager_domain_model_download. Cada descarga referencia uno o varios archivos FAL y lleva metadatos como título, descripción, categoría, etiquetas, fecha de publicación, idioma y grupos de acceso. El módulo del backend permite importación masiva, bulk edit y flujos de publicación.

En el frontend la extensión entrega vistas de lista y detalle prefabricadas como plantillas Fluid. Las listas pueden filtrarse por categoría, etiqueta, término de búsqueda o criterio de ordenación, los parámetros se pasan como parámetros GET y se consideran en el caché. Para la búsqueda la extensión utiliza la búsqueda de texto completo de MySQL o, si se desea, una instalación Solr conectada.

La configuración corre por TypoScript y FlexForm. Los ajustes típicos son la categoría por defecto, el número de entradas por página, el orden de clasificación y la integración en una plantilla de sitepackage propia. Mediante EventListeners los desarrolladores pueden enganchar lógica propia, por ejemplo una notificación por correo ante nuevas subidas o una exportación a otros sistemas.

El seguimiento de descargas es una función central. En lugar de analítica externa con cookies, downloadmanager incrementa en cada clic un contador del lado del servidor que está como simple columna integer en el registro. Eso es amable con el RGPD, no carga un banner de cookies y entrega una afirmación sólida sobre qué documentos se piden realmente, algo que la AEPD valora positivamente en auditorías.

Problemas frecuentes y soluciones

El primer problema es la migración desde un fondo existente. Quien ha mantenido durante años las descargas en el link browser debe pasarlas primero a registros de downloadmanager. La solución es un script que recorra las estructuras fileadmin existentes, extraiga metadatos de los nombres de archivo y cree registros. Gosign usa para ello un pipeline asistido por IA que propone categorías y etiquetas a partir del contenido de los archivos y de los metadatos PDF, y la redacción solo tiene que confirmar.

Segundo problema: caching. Las listas filtradas con parámetros URL generan muchas variantes de caché, lo que infla el caché de TYPO3. La solución está en el manejo del cHash y en una definición limpia de qué parámetros son relevantes para el caché. Para páginas con muchos filtros, un edge caching mediante Cloudflare o Varnish con reglas conscientes de parámetros puede ser más sensato que un caché del lado del servidor.

Tercer problema: multilingüismo. Un documento existe en cinco idiomas, pero debe llevarse como un único registro lógico para que los metadatos queden sincronizados. Aquí downloadmanager usa el mecanismo de idiomas de TYPO3 con registros de traducción. Es importante que la redacción entienda qué campos se mantienen por idioma y cuáles son globales.

Migración y compatibilidad de versiones

downloadmanager se mantiene activamente y es compatible con TYPO3 v11, v12 y v13. Al actualizar desde versiones TYPO3 más antiguas hay que prestar atención sobre todo a los cambios en Extbase: los métodos del repositorio y la capa de persistencia han cambiado varias veces entre v9 y v12, lo que puede romper ampliaciones propias de la extensión. Un proyecto de upgrade típico abarca, por tanto, también la adaptación de controladores y plantillas propios.

Para proyectos que empiezan hoy vale la pena decidir previamente si downloadmanager o una solución mediante registros Extbase propios es el camino correcto. Si la redacción necesita exclusivamente descargas estándar con categorías y etiquetas, la extensión es la elección pragmática. Si además se requieren flujos complejos (aprobación, publicación multietapa, versionado), una solución a medida puede ser a largo plazo más fácil de mantener.

Gosign migra downloadmanager a nuevas versiones de TYPO3, acompaña migraciones de fondos existentes e integra la extensión en sitepackages existentes. El análisis asistido por IA ayuda a proponer automáticamente categorías y etiquetas a partir de los nombres de archivo y las estructuras de directorio existentes, de modo que el trabajo de mantenimiento manual se reduce al mínimo.