downloadmanager for TYPO3

downloadmanager brings order to TYPO3 download areas when a nested file directory is no longer enough, with categories, tags, search and a cookie-free download counter

As soon as a TYPO3 project has to manage more than twenty file downloads, hand maintenance collapses. Editors link PDFs through the link browser, the directory grows chaotically, existing documents are accidentally overwritten and visitors can no longer find anything through search. downloadmanager solves exactly this problem: it presents the file base as a structured repository, with dedicated records, categories, tags, metadata and an interface that users can search purposefully. For companies with product data sheets, associations with form collections and municipalities with download centres, this is the standard solution.

The difference to managing pure FAL folders is fundamental. While fileadmin mirrors a file system, downloadmanager adds an editorial layer on top: a document can appear in several categories simultaneously, carry its display title independently of the file name and be controlled via a publication schedule. For editorial teams with compliance requirements, this is often a prerequisite.

Typical use cases

The classic case is the technical product catalogue. A mechanical engineering company maintains a data sheet, an operating manual, a CE certificate and a spare parts list for every machine. Every download gets a product category, a type assignment and, optionally, a language tag. Visitors filter by product line and document type, immediately get the matching files and the shop does not have to link every PDF individually. The product page itself can show a mini download area that automatically lists all documents belonging to the machine, without any editorial double maintenance.

The second case are form areas at municipalities, authorities and chambers. Application forms, info sheets and statutes are grouped thematically, often multilingual, occasionally with access restrictions for internal member areas. downloadmanager allows exactly this segmentation via fe_groups and categorises documents by subject area. For public administrations it is also important that publication dates and validity periods can be managed per document.

Third use: press and investor relations areas. Annual reports, press releases and image material are stored centrally, categorised by year and tagged with publication date. The editorial team only has to enter each document once, and the frontend lists are generated automatically.

Technical architecture

downloadmanager is an Extbase extension and maintains its own records in tx_downloadmanager_domain_model_download. Each download references one or more FAL files and carries meta fields such as title, description, category, tags, publication date, language and access groups. The backend module allows mass import, bulk edit and publication workflows.

In the frontend, the extension delivers pre-built list and detail views as Fluid templates. Lists can be filtered by category, tag, search term or sort criterion, the parameters are passed via GET and respected by the cache. For search, the extension uses the MySQL full-text search or, if required, a connected Solr installation.

Configuration runs through TypoScript and FlexForm. Typical settings are the default category, the number of entries per page, the sort order and integration with a project sitepackage template. Through event listeners, developers can hook in their own logic, for example a mail notification on new uploads or an export to other systems.

Download tracking is a central feature. Instead of external analytics with cookies, downloadmanager increments a server-side counter on every click, stored as a simple integer column on the record. This is GDPR (UK: UK GDPR)-friendly, does not add any burden to the consent banner and delivers a robust statement about which documents are actually in demand.

Common problems and solutions

The first problem is the migration of a legacy base. Anyone who has maintained downloads through the link browser for years first has to move them into downloadmanager records. The solution is a script that walks the existing fileadmin structures, extracts metadata from file names and creates records. Gosign uses an AI-supported pipeline for that, which proposes categories and tags from file contents and PDF metadata, so that the editorial team only has to confirm them.

Second problem: caching. Filtered lists with URL parameters create many cache variants, which bloats the TYPO3 cache. The solution lies in cHash handling and in a clean definition of which parameters are cache-relevant. For pages with many filters, edge caching through Cloudflare or Varnish with parameter-aware rules can make more sense than server-side caching.

Third problem: multilingual content. A document exists in five languages but should be managed as one logical entry, so that the metadata stays in sync. Here downloadmanager uses the TYPO3 language mechanism with translation records. What matters is that the editorial team understands which fields are maintained per language and which are global.

Migration and version compatibility

downloadmanager is actively maintained and compatible with TYPO3 v11, v12 and v13. On upgrades from older TYPO3 versions, the main thing to watch is Extbase changes: the repository methods and the persistence layer have changed several times between v9 and v12, which can break custom extensions of the extension. A typical upgrade project therefore also involves adapting custom controllers and templates.

For projects starting today, it is worth deciding upfront whether downloadmanager or a solution based on bespoke Extbase records is the right path. If the editorial team only needs standard downloads with categories and tags, the extension is the pragmatic choice. If complex workflows are required on top (approval, multi-stage publication, versioning), a bespoke solution can be easier to maintain in the long run.

Gosign migrates downloadmanager to new TYPO3 versions, accompanies legacy migrations and integrates the extension into existing sitepackages. AI-supported analysis helps propose categories and tags from existing file names and directory structures automatically, so that manual maintenance work shrinks to a minimum.