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. Przy kliknięciu rozszerzenie wewnętrznie wywołuje aktualną stronę i przekazuje output HTML do backendu renderującego PDF.

Rozszerzenie wspiera dwa silniki renderujące: wkhtmltopdf (klasyczne rozwiązanie oparte na starszej wersji WebKit - proste, ale nie wspiera CSS Flexbox i Grid) oraz Puppeteer/Chromium (nowoczesna alternatywa z pełnym wsparciem CSS, prawidłowym osadzaniem webfontów i wykonywaniem JavaScript - ale wyższym zużyciem zasobów).

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: wkhtmltopdf nie może renderować nowoczesnego CSS. Strony korzystające z Flexbox lub CSS Grid wyglądają w PDF zupełnie inaczej niż w przeglądarce. Rozwiązanie: przejście na Puppeteer jako silnik renderujący.

Generowanie PDF trwa ponad 10 sekund. Puppeteer uruchamia dla każdego PDF proces Chromium. Przy jednoczesnych zapytaniach obciążenie serwera mnoży się. Rozwiązanie: implementacja cachowania PDF. Wygenerowany PDF jest cachowany przez zdefiniowany czas (np. 60 minut).

Strony za loginem dostarczają pusty PDF. web2pdf wywołuje stronę wewnętrznie przez HTTP. Jeśli strona jest za loginem, brakuje ciasteczek sesji i proces renderujący widzi tylko stronę logowania. Rozwiązanie: konfiguracja specjalnego endpointu renderowania PDF rozwiązującego uwierzytelnianie przez token zamiast ciasteczek sesji.

Migracja i kompatybilność wersji

web2pdf jest stabilnie dostępne dla TYPO3 v10 i v11. Dla TYPO3 v12 LTS istnieją forki społecznościowe zapewniające kompatybilność. Oryginalny pakiet nie jest już aktywnie utrzymywany.

Dla TYPO3 v13 i dalszych 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.