downloadmanager dla TYPO3

downloadmanager wprowadza porządek do obszarów pobrań TYPO3, gdy zagnieżdżony katalog plików już nie wystarcza, z kategoriami, tagami, wyszukiwaniem i licznikiem pobrań działającym bez cookies

Gdy projekt TYPO3 zarządza więcej niż dwudziestoma pobieraniami plików, ręczna pielęgnacja się załamuje. Redaktorzy linkują PDF-y przez Link-Browser, katalog rośnie chaotycznie, istniejące dokumenty są przypadkowo nadpisywane, a odwiedzający przez wyszukiwanie nic już nie znajdują. downloadmanager rozwiązuje dokładnie ten problem: przedstawia zbiór plików jako strukturalne repozytorium, z własnymi rekordami, kategoriami, tagami, metadanymi i interfejsem, który użytkownicy mogą celowo przeszukiwać. Dla firm z kartami produktów, stowarzyszeń ze zbiorami formularzy i gmin z centrami pobrań to standardowe rozwiązanie.

Różnica w stosunku do zarządzania przez czyste foldery FAL jest fundamentalna. Podczas gdy fileadmin odwzorowuje system plików, downloadmanager wprowadza nad nim warstwę redakcyjną: dokument może pojawiać się jednocześnie w kilku kategoriach, mieć tytuł wyświetlania niezależny od nazwy pliku i być sterowany przez planowanie publikacji. Dla redakcji z wymaganiami compliance to często warunek wstępny.

Typowe scenariusze zastosowania

Klasycznym przypadkiem jest techniczny katalog produktów. Producent maszyn do każdej maszyny pielęgnuje kartę danych, instrukcję obsługi, certyfikat CE i listę części zamiennych. Każde pobranie otrzymuje kategorię produktu, przypisanie typu i opcjonalnie tag językowy. Odwiedzający filtrują po serii produktu i typie dokumentu, natychmiast otrzymują pasujące pliki, a sklep nie musi linkować każdego PDF pojedynczo. Sama strona produktu może pokazywać mini-obszar pobrań, który automatycznie listuje wszystkie dokumenty związane z maszyną, całkowicie bez redakcyjnej podwójnej pielęgnacji.

Drugim przypadkiem są obszary formularzy w gminach, urzędach i izbach. Formularze wniosków, ulotki informacyjne i statuty są grupowane tematycznie, często wielojęzycznie, okazjonalnie z ograniczeniem dostępu dla wewnętrznych obszarów członkowskich. downloadmanager umożliwia dokładnie tę segmentację przez fe_groups i kategoryzuje dokumenty według dziedziny. Dla administracji publicznej ważne jest ponadto, że daty publikacji i terminy obowiązywania mogą być zarządzane per dokument.

Trzecie zastosowanie: obszary prasowe i relacji inwestorskich. Raporty biznesowe, komunikaty prasowe i materiały graficzne są centralnie składowane, kategoryzowane po roku i opatrzone datą publikacji. Redakcja musi pielęgnować każdy dokument tylko raz, listy frontendowe są generowane automatycznie.

Architektura techniczna

downloadmanager to rozszerzenie Extbase i pielęgnuje własne rekordy w tx_downloadmanager_domain_model_download. Każde pobranie odwołuje się do jednego lub kilku plików FAL i nosi pola meta jak tytuł, opis, kategoria, tagi, data publikacji, język i grupy dostępu. Moduł backendowy pozwala na import masowy, bulk-edit i workflow publikacji.

We frontendzie rozszerzenie dostarcza gotowe widoki listy i detalu jako szablony Fluid. Listy można filtrować po kategorii, tagu, wyszukiwanym hasłe lub kryterium sortowania, parametry są przekazywane przez parametr GET i uwzględniane w cache. Do wyszukiwania rozszerzenie używa pełnotekstowego wyszukiwania MySQL lub, na życzenie, podłączonej instalacji Solr.

Konfiguracja odbywa się przez TypoScript i FlexForm. Typowe ustawienia to standardowa kategoria, liczba wpisów na stronę, kolejność sortowania i integracja w własnym szablonie sitepackage. Przez EventListenery deweloperzy mogą wpinać własną logikę, na przykład powiadomienie e-mailowe przy nowych uploadach lub eksport do innych systemów.

Śledzenie pobrań jest centralną funkcją. Zamiast zewnętrznej analityki z cookies downloadmanager przy każdym kliknięciu zwiększa licznik serwerowy, który leży jako prosta kolumna integer w rekordzie. To jest przyjazne dla RODO, nie obciąża banera cookies i dostarcza wiarygodną informację, które dokumenty są rzeczywiście poszukiwane.

Częste problemy i rozwiązania

Pierwszym problemem jest migracja z zasobu starego. Kto przez lata pielęgnował pobrania w Link-Browser, musi najpierw przenieść je do rekordów downloadmanager. Rozwiązaniem jest skrypt, który przechodzi przez istniejące struktury fileadmin, wyciąga metadane z nazw plików i tworzy rekordy. Gosign używa do tego pipeline wspieranego przez AI, który proponuje kategorie i tagi z zawartości plików i metadanych PDF, a redakcja musi je tylko potwierdzić.

Drugi problem: cache’owanie. Filtrowane listy z parametrami URL tworzą wiele wariantów cache, co nadyma cache TYPO3. Rozwiązanie leży w obsłudze cHash i w porządnej definicji, które parametry są istotne dla cache. Dla stron z wieloma filtrami edge-caching przez Cloudflare lub Varnish z regułą świadomą parametrów może być sensowniejszy niż cache’owanie serwerowe.

Trzeci problem: wielojęzyczność. Dokument istnieje w pięciu językach, ale ma być prowadzony jako jeden logiczny wpis, żeby metadane pozostawały zsynchronizowane. downloadmanager używa tu mechanizmu językowego TYPO3 z rekordami tłumaczeń. Ważne, aby redakcja rozumiała, które pola są pielęgnowane per język, a które obowiązują globalnie.

Migracja i kompatybilność wersji

downloadmanager jest aktywnie utrzymywane i kompatybilne z TYPO3 v11, v12 i v13. Przy upgrade ze starszych wersji TYPO3 trzeba uważać przede wszystkim na zmiany w Extbase: metody repozytoriów i warstwa persystencji zmieniły się między v9 a v12 wielokrotnie, co może łamać własne rozszerzenia. Typowy projekt upgrade obejmuje zatem również dostosowanie własnych kontrolerów i szablonów.

Dla projektów startujących dziś opłaca się wcześniej decyzja, czy downloadmanager czy rozwiązanie przez własne rekordy Extbase jest właściwą drogą. Jeśli redakcja potrzebuje wyłącznie standardowych pobrań z kategoriami i tagami, rozszerzenie jest pragmatycznym wyborem. Jeśli potrzebne są ponadto złożone workflow (zatwierdzanie, wieloetapowa publikacja, wersjonowanie), rozwiązanie na miarę może być długoterminowo łatwiejsze w pielęgnacji.

Gosign migruje downloadmanager na nowe wersje TYPO3, towarzyszy migracjom starych zasobów i integruje rozszerzenie w istniejące sitepackages. Wspierana przez AI analiza pomaga automatycznie proponować kategorie i tagi z istniejących nazw plików i struktur katalogów, dzięki czemu ręczna praca pielęgnacyjna kurczy się do minimum.