downloadmanager für TYPO3

downloadmanager bringt Ordnung in TYPO3-Download-Bereiche, wenn ein verschachteltes Dateiverzeichnis nicht mehr reicht - mit Kategorien, Tags, Suche und einem Download-Zähler, der ohne Cookies auskommt

Sobald ein TYPO3-Projekt mehr als zwanzig Datei-Downloads zu verwalten hat, bricht die Handpflege zusammen. Redakteure verlinken PDFs über den Link-Browser, das Verzeichnis wächst chaotisch, bestehende Dokumente werden versehentlich überschrieben und Besucher finden über die Suche nichts mehr. downloadmanager löst genau dieses Problem: Er stellt den Datei-Bestand als strukturiertes Repository dar, mit eigenen Datensätzen, Kategorien, Tags, Metadaten und einer Oberfläche, die Nutzer gezielt durchsuchen können. Für Unternehmen mit Produkt-Datenblättern, Verbände mit Formular-Sammlungen und Kommunen mit Download-Zentren ist das die Standard-Lösung.

Der Unterschied zur Verwaltung über reine FAL-Ordner ist fundamental. Während fileadmin ein Dateisystem abbildet, führt downloadmanager eine redaktionelle Ebene oben drauf ein: Ein Dokument kann in mehreren Kategorien gleichzeitig erscheinen, seinen Anzeige-Titel unabhängig vom Dateinamen führen und über eine Veröffentlichungs-Planung gesteuert werden. Für Redaktionen mit Compliance-Anforderungen ist das oft Voraussetzung.

Typische Einsatzszenarien

Der klassische Fall ist der technische Produktkatalog. Ein Maschinenbauer pflegt zu jeder Maschine ein Datenblatt, eine Bedienungsanleitung, ein CE-Zertifikat und eine Ersatzteilliste. Jeder Download bekommt eine Produktkategorie, eine Typ-Zuordnung und optional ein Sprach-Tag. Besucher filtern nach Produktreihe und Dokument-Typ, bekommen sofort die passenden Dateien und der Shop muss nicht jedes PDF einzeln verlinken. Die Produktseite selbst kann einen Mini-Download-Bereich anzeigen, der automatisch alle zur Maschine gehörenden Dokumente listet - ganz ohne redaktionelle Doppelpflege.

Der zweite Fall sind Formular-Bereiche bei Kommunen, Behörden und Kammern. Antragsformulare, Merkblätter und Satzungen sind thematisch gruppiert, oft mehrsprachig, gelegentlich mit Zugriffsbeschränkung für interne Mitgliederbereiche. downloadmanager erlaubt genau diese Segmentierung über fe_groups und kategorisiert Dokumente nach Fachbereich. Für Öffentliche Verwaltungen ist zudem wichtig, dass Veröffentlichungsdaten und Gültigkeitsfristen pro Dokument verwaltet werden können.

Dritter Einsatz: Presse- und Investor-Relations-Bereiche. Geschäftsberichte, Pressemitteilungen und Bildmaterial werden zentral abgelegt, nach Jahr kategorisiert und mit Veröffentlichungsdatum versehen. Die Redaktion muss jedes Dokument nur einmal einpflegen, die Frontend-Listen werden automatisch generiert.

Technische Architektur

downloadmanager ist eine Extbase-Extension und pflegt eigene Datensätze in tx_downloadmanager_domain_model_download. Jeder Download referenziert eine oder mehrere FAL-Dateien und trägt Meta-Felder wie Titel, Beschreibung, Kategorie, Tags, Veröffentlichungsdatum, Sprache und Zugriffsgruppen. Das Backend-Modul erlaubt Massenimport, Bulk-Edit und Veröffentlichungs-Workflows.

Im Frontend liefert die Extension vorgefertigte Listen- und Detail-Views als Fluid-Templates. Listen können nach Kategorie, Tag, Suchbegriff oder Sortierkriterium gefiltert werden, die Parameter werden per GET-Parameter übergeben und im Cache berücksichtigt. Für die Suche nutzt die Extension die MySQL-Volltextsuche oder, auf Wunsch, eine angebundene Solr-Installation.

Die Konfiguration erfolgt über TypoScript und FlexForm. Typische Einstellungen sind die Standard-Kategorie, die Anzahl der Einträge pro Seite, die Sortierreihenfolge und die Integration in ein eigenes Sitepackage-Template. Über EventListener können Entwickler eigene Logik einhängen, etwa eine Mail-Benachrichtigung bei neuen Uploads oder einen Export in andere Systeme.

Download-Tracking ist ein zentrales Feature. Statt externer Analytics mit Cookies erhöht downloadmanager bei jedem Klick einen serverseitigen Zähler, der als einfache Integer-Spalte im Datensatz liegt. Das ist DSGVO-freundlich, belastet keinen Cookie-Banner und liefert eine belastbare Aussage, welche Dokumente tatsächlich nachgefragt werden.

Häufige Probleme und Lösungen

Das erste Problem ist die Migration aus einem Altbestand. Wer Jahre lang Downloads im Link-Browser gepflegt hat, muss sie zunächst in downloadmanager-Datensätze überführen. Die Lösung ist ein Skript, das die vorhandenen Fileadmin-Strukturen durchläuft, Metadaten aus Dateinamen extrahiert und Datensätze anlegt. Gosign nutzt dafür KI-gestützte Pipeline, die Kategorien und Tags aus Dateiinhalten und PDF-Metadaten vorschlägt und die Redaktion nur noch bestätigen muss.

Zweites Problem: Caching. Gefilterte Listen mit URL-Parametern erzeugen viele Cache-Varianten, was den TYPO3-Cache aufbläht. Die Lösung liegt im cHash-Handling und in einer sauberen Definition, welche Parameter cache-relevant sind. Für Seiten mit vielen Filtern kann ein Edge-Caching über Cloudflare oder Varnish mit parameter-bewusster Regel sinnvoller sein als serverseitiges Caching.

Drittes Problem: Mehrsprachigkeit. Ein Dokument existiert in fünf Sprachen, soll aber als ein logischer Eintrag geführt werden, damit die Metadaten synchron bleiben. Hier nutzt downloadmanager den TYPO3-Sprachmechanismus mit Übersetzungs-Datensätzen. Wichtig ist, dass die Redaktion versteht, welche Felder pro Sprache gepflegt werden und welche global gelten.

Migration und Versions-Kompatibilität

downloadmanager wird aktiv gepflegt und ist mit TYPO3 v11, v12 und v13 kompatibel. Beim Upgrade von älteren TYPO3-Versionen ist vor allem auf Extbase-Änderungen zu achten: Die Repository-Methoden und die Persistenzschicht haben sich zwischen v9 und v12 mehrfach geändert, was eigene Erweiterungen der Extension brechen kann. Ein typisches Upgrade-Projekt umfasst daher auch die Anpassung eigener Controller und Templates.

Für Projekte, die heute starten, lohnt sich vorab die Entscheidung, ob downloadmanager oder eine Lösung über Extbase-eigene Datensätze der richtige Weg ist. Wenn die Redaktion ausschließlich Standard-Downloads mit Kategorien und Tags braucht, ist die Extension die pragmatische Wahl. Wenn darüber hinaus komplexe Workflows (Freigabe, mehrstufige Veröffentlichung, Versionierung) gefragt sind, kann eine maßgeschneiderte Lösung langfristig einfacher zu pflegen sein.

Gosign migriert downloadmanager auf neue TYPO3-Versionen, begleitet Altbestandsmigrationen und integriert die Extension in bestehende Sitepackages. KI-gestützte Analyse hilft dabei, Kategorien und Tags aus bestehenden Dateinamen und Verzeichnisstrukturen automatisch vorzuschlagen, sodass die manuelle Pflege-Arbeit auf ein Minimum schrumpft.