PDF Generator – wtyczka open-source dla Craft CMS

Stack: Craft CMS PHP mPDF Twig Composer GitHub

Wyzwanie

Twórcy stron opartych na Craft CMS nie mieli natywnego, elastycznego sposobu na generowanie dokumentów PDF bezpośrednio z szablonów Twig — bez zewnętrznych serwisów, bez opuszczania ekosystemu CMS-a. Każda potrzeba generowania faktur, katalogów czy materiałów do pobrania wymagała albo ręcznej pracy, albo kosztownych rozwiązań SaaS.

Realizacja

Stworzyłem plugin PDF Generator dla Craft CMS, który integruje bibliotekę mPDF bezpośrednio z systemem szablonów Twig. Plugin umożliwia generowanie PDF-ów z dowolnego szablonu Twig, bloku kodu HTML lub zewnętrznego URL — z poziomu jednej linii w szablonie.

Plugin obsługuje dwie metody pracy:

• pdf() — generuje plik PDF i zwraca URL do pobrania lub wyświetlenia inline w przeglądarce
• pdfAsset() — generuje PDF i zapisuje go jako asset w Craft CMS Assets, z obsługą cachowania i wersjonowania

Wśród zaawansowanych funkcji znalazły się: niestandardowe fonty, znaki wodne (tekstowe i graficzne), automatyczny spis treści i zakładki z nagłówków H1–H6, generowanie kodów QR, miniaturki PDF, tryb RTL dla języków arabskich/hebrajskich, ochrona hasłem, formaty PDF-A i PDF-X, wsparcie dla wielu formatów papieru (A3–A5, Letter, Legal), a także generowanie PDF-ów w pętli dla całych sekcji wpisów.

Plugin dostępny jest bezpłatnie (plan Lite) oraz w planie Plus (na start $19 i $9/rok) z funkcjami enterprise: brak watermarku praw autorskich, formaty PDF-A/PDF-X, ochrona przed kopiowaniem i drukowaniem, konwersja CMYK.

Efekty

• 234 aktywne instalacje w oficjalnym Craft Plugin Store
• 14 gwiazdek na GitHubie, obserwowany przez deweloperów z całego świata
• Wsparcie dla Craft CMS 3, 4 i 5 — plugin rozwijany nieprzerwanie od wersji 3.x
• Wkłady od zewnętrznych deweloperów (contributors: @mokopan, @AramLoosman, @iwe-hi, @d-karstens)
• Dostępny przez composer require cooltronicpl/document-helpers — instalacja jedną komendą

Galeria

Linki

🔗 Craft Plugin Store | GitHub

Potrzebujesz generować PDF-y w Craft CMS? Skontaktuj się — oferuję również wdrożenie i tworzenie niestandardowych szablonów PDF.