web2pdf dla TYPO3

Dlaczego web2pdf jest niezastąpione dla witryn TYPO3 z cennikami i stronami produktowymi

Zespoły sprzedaży potrzebują drukowalnych PDF. Klienci oczekują na stronach produktowych przycisku “Zapisz jako PDF”. A kupcy w przemyśle pobierają cenniki, by przekazać je wewnętrznie. web2pdf rozwiązuje dokładnie ten problem: rozszerzenie renderuje dowolne strony TYPO3 jako PDF - z prawidłowym layoutem, osadzonymi obrazami i czystą typografią. Zamiast ręcznie tworzyć każdą stronę jako PDF i aktualizować przy zmianach, web2pdf generuje PDF na żywo z aktualnej treści strony.

To oszczędza nie tylko czas redakcji, ale też zapobiega przestarzałym wersjom PDF. Gdy cena produktu zmieni się w CMS, web2pdf przy następnym pobraniu automatycznie dostarcza aktualną wersję.

Typowe scenariusze zastosowań

Katalogi produktowe i cenniki w B2B. Firma z branży maszynowej zarządza 200 stronami produktowymi w TYPO3. Dział handlowy potrzebuje do każdego produktu drukowalnej karty danych. web2pdf generuje z każdej strony produktowej PDF z logo, danymi technicznymi i informacjami kontaktowymi w Corporate Design.

Artykuły i whitepapers do pobrania. Firmy mediowe i wydawnictwa fachowe oferują artykuły magazynowe jako PDF do pobrania. web2pdf konwertuje artykuł włącznie z obrazami i formatowaniem w PDF zoptymalizowany pod druk. Print-CSS steruje, które elementy pojawiają się w PDF (treść) a które nie (nawigacja, stopka, baner cookie).

Oferty i konfiguracje. Wyniki konfiguratora, podsumowania ofert czy przeglądy koszyka można eksportować przez web2pdf jako PDF. Użytkownik klika “Oferta jako PDF” i otrzymuje gotowy do druku dokument ze wszystkimi wybranymi opcjami.

Architektura techniczna

web2pdf działa jako rozszerzenie TYPO3 z pluginem frontendowym wyświetlającym przycisk pobierania PDF na każdej stronie. Po kliknięciu przeglądarka wywołuje tę samą stronę z dodatkowym parametrem; middleware rozszerzenia przejmuje gotowy, wyrenderowany output tego wywołania i przekazuje HTML do biblioteki PHP mPDF.

mPDF (pakiet Composer mpdf/mpdf, wersja 8) jest napisany w czystym PHP i działa w procesie TYPO3, bez zewnętrznego programu i bez przeglądarki na serwerze. Ograniczenia: nie obsługuje CSS Flexbox i Grid, float i position tylko częściowo, a przy dużych tabelach generowanie jest wolne i wymaga dużo pamięci. Kto potrzebuje w PDF layoutu strony z pełnym wsparciem CSS, nie obejdzie się bez przeglądarki headless, takiej jak Puppeteer/Chromium.

Oddzielny Print-CSS (@media print) steruje, które elementy są widoczne w PDF. Gosign zaleca ukrywanie nawigacji, stopki, banera cookie i elementów interaktywnych w Print-CSS i wstawianie zamiast nich logo, danych kontaktowych i wskazania URL.

Częste problemy i rozwiązania

PDF wyświetla zły layout, brakujące obrazy lub czcionki. Najczęstsza przyczyna: mPDF obsługuje tylko część CSS. Strony korzystające z Flexbox lub CSS Grid wyglądają w PDF zupełnie inaczej niż w przeglądarce. Rozwiązanie: oddzielny Print-CSS z układem z bloków i tabel, które mPDF rozumie, oraz czcionki TTF, dla których web2pdf ma własny katalog. Jeśli to nie wystarczy, pozostaje przejście na Puppeteer poza web2pdf.

Generowanie PDF trwa zbyt długo. web2pdf generuje każdy PDF od nowa w procesie PHP danego wywołania, a mPDF przy długich stronach z dużymi tabelami działa wolno i zużywa dużo pamięci. Przy jednoczesnych zapytaniach obciążenie serwera mnoży się. Rozwiązanie: implementacja cachowania PDF. Wygenerowany PDF jest cachowany przez zdefiniowany czas (np. 60 minut).

Wyjątek, gdy na stronie brakuje pluginu. Kto sam dopisuje parametr PDF do linków, zamiast osadzić plugin rozszerzenia, otrzymuje w cachowanym wyniku wyjątek TYPO3, ponieważ setup TypoScript nie jest wtedy zainicjalizowany. Rozwiązanie według dokumentacji: umieścić plugin na każdej stronie, która ma być dostępna jako PDF, najprościej przez TypoScript dla wszystkich stron. Strony za loginem nie są natomiast przypadkiem szczególnym: middleware przekształca output wywołania, które wysyła sam zalogowany odwiedzający.

Migracja i kompatybilność wersji

Mittwald nadal utrzymuje web2pdf: wersja 4 obsługuje TYPO3 v12.4 (od sierpnia 2023), wersja 5.0.1 z marca 2025 obsługuje v13.4, a starsze linie wersji obejmują v10 i v11. Wersji dla TYPO3 v14 w TER jeszcze nie ma (stan na wrzesień 2026).

Tam, gdzie PDF ma odwzorowywać layout strony z nowoczesnym CSS, Gosign zaleca zmianę architektoniczną: zamiast prowadzić web2pdf jako rozszerzenie TYPO3, generowanie PDF jest implementowane jako oddzielny mikroserwis. Serwis Node.js z Puppeteer przyjmuje URL i zwraca PDF. To oddziela generowanie PDF od serwera TYPO3 i czyni rozwiązanie niezależnym od wersji TYPO3.

Nakład migracji z web2pdf na rozwiązanie oparte na Puppeteer wynosi typowo 2 do 4 dni. Istniejące pliki Print-CSS można przejąć 1:1. Tylko mechanizm wywołania (kliknięcie przycisku, obsługa URL) musi być dostosowany.