downloadmanager para TYPO3

downloadmanager traz ordem a áreas de download TYPO3 quando um diretório de arquivos aninhado não basta, com categorias, tags, busca e um contador de downloads que dispensa cookies

Assim que um projeto TYPO3 passa a gerenciar mais de vinte downloads, a manutenção manual desaba. Redatores linkam PDFs via link browser, o diretório cresce caoticamente, documentos existentes são sobrescritos sem querer e visitantes não encontram mais nada via busca. O downloadmanager resolve exatamente esse problema: expõe o acervo de arquivos como repositório estruturado, com registros próprios, categorias, tags, metadados e uma interface que os usuários conseguem buscar de forma direcionada. Para empresas com fichas técnicas de produto, associações com coleções de formulários e prefeituras com centros de download, essa é a solução padrão.

A diferença em relação à gestão via pastas FAL puras é fundamental. Enquanto o fileadmin reflete um filesystem, o downloadmanager insere uma camada editorial por cima: um documento pode aparecer em várias categorias ao mesmo tempo, ter um título de exibição independente do nome de arquivo e ser controlado via planejamento de publicação. Para redações com exigências de compliance, isso costuma ser pré-requisito.

Cenários típicos de uso

O caso clássico é o catálogo técnico de produto. Uma indústria metalúrgica brasileira mantém para cada máquina uma ficha técnica, um manual de operação, um certificado de conformidade (como o INMETRO exige) e uma lista de peças de reposição. Cada download recebe uma categoria de produto, uma atribuição de tipo e, opcionalmente, uma tag de idioma. Os visitantes filtram por linha de produto e tipo de documento, recebem imediatamente os arquivos certos, e a loja não precisa linkar cada PDF individualmente. A própria página de produto pode exibir uma mini área de downloads que lista automaticamente todos os documentos da máquina, sem duplicidade editorial.

O segundo caso são áreas de formulário em prefeituras, órgãos públicos e conselhos profissionais. Formulários de requerimento, cartilhas e estatutos são agrupados tematicamente, muitas vezes multilíngues, ocasionalmente com restrição de acesso para áreas internas de associados. O downloadmanager permite exatamente essa segmentação via fe_groups e categoriza documentos por área. Para a administração pública, também é importante que datas de publicação e prazos de validade possam ser geridos por documento.

Terceiro uso: áreas de imprensa e relações com investidores. Relatórios anuais, releases de imprensa e material fotográfico ficam em um repositório central, categorizados por ano e com data de publicação. A redação só precisa cadastrar cada documento uma vez, as listas do frontend são geradas automaticamente.

Arquitetura técnica

O downloadmanager é uma extensão Extbase e mantém registros próprios em tx_downloadmanager_domain_model_download. Cada download referencia um ou mais arquivos FAL e carrega campos de meta como título, descrição, categoria, tags, data de publicação, idioma e grupos de acesso. O módulo de backend permite import em massa, bulk edit e workflows de publicação.

No frontend, a extensão entrega views prontos de lista e detalhe como templates Fluid. Listas podem ser filtradas por categoria, tag, termo de busca ou critério de ordenação, os parâmetros são passados via GET parameter e considerados no cache. Para a busca, a extensão usa a busca de texto MySQL ou, se solicitado, uma instalação Solr conectada.

A configuração é feita via TypoScript e FlexForm. Configurações típicas são a categoria padrão, o número de entradas por página, a ordem de classificação e a integração em um site package próprio. Via EventListener, desenvolvedores podem inserir lógica própria, por exemplo uma notificação por email em novos uploads ou uma exportação para outros sistemas.

O rastreamento de download é uma feature central. Em vez de analytics externo com cookies, o downloadmanager incrementa a cada clique um contador no servidor, guardado como simples coluna integer no registro. Isso é amigo da LGPD (PT: RGPD), não exige cookie banner e entrega uma afirmação consistente sobre quais documentos são realmente procurados.

Problemas frequentes e soluções

O primeiro problema é a migração de um acervo antigo. Quem manteve downloads por anos via link browser precisa primeiro convertê-los em registros do downloadmanager. A solução é um script que percorre as estruturas fileadmin existentes, extrai metadados dos nomes de arquivo e cria os registros. A Gosign usa para isso uma pipeline com suporte de IA que sugere categorias e tags a partir do conteúdo e dos metadados PDF, deixando para a redação apenas a confirmação.

Segundo problema: caching. Listas filtradas com parâmetros de URL geram muitas variantes de cache, o que incha o cache do TYPO3. A solução está no tratamento de cHash e em uma definição limpa de quais parâmetros são relevantes para cache. Para páginas com muitos filtros, um edge caching via Cloudflare ou Varnish com regra consciente dos parâmetros pode ser mais sensato que o cache no servidor.

Terceiro problema: multilinguismo. Um documento existe em cinco idiomas, mas deve ser mantido como uma entrada lógica, para que os metadados fiquem sincronizados. Aqui o downloadmanager usa o mecanismo de idioma TYPO3 com registros de tradução. É importante que a redação entenda quais campos são mantidos por idioma e quais valem globalmente.

Migração e compatibilidade de versões

O downloadmanager é mantido ativamente e é compatível com TYPO3 v11, v12 e v13. Em upgrades de versões TYPO3 antigas, vale atenção sobretudo a mudanças no Extbase: os métodos de repository e a camada de persistência mudaram várias vezes entre v9 e v12, o que pode quebrar extensões próprias da extensão. Um projeto de upgrade típico, portanto, também abrange a adaptação de controllers e templates próprios.

Para projetos que começam hoje, vale decidir antes se o downloadmanager ou uma solução com registros Extbase próprios é o caminho certo. Se a redação só precisa de downloads padrão com categorias e tags, a extensão é a escolha pragmática. Se além disso workflows complexos (aprovação, publicação em múltiplos passos, versionamento) são exigidos, uma solução sob medida pode ser mais fácil de manter a longo prazo.

A Gosign migra o downloadmanager para novas versões TYPO3, acompanha migrações de acervo antigo e integra a extensão em site packages existentes. Análise com suporte de IA ajuda a sugerir categorias e tags automaticamente a partir de nomes de arquivo e estruturas de diretório existentes, de forma que o trabalho manual de manutenção encolhe a um mínimo.