10.3.0

10.3.0 – 20.02.2026

Neue Features

• PNG als Standardformat: Das Ausgabeformat wurde von JPEG auf PNG umgestellt, um eine bessere Farberhaltung bei dunklen Farben und Transparenz zu gewährleisten
• Gamma-Korrektur (optional): Neue Einstellung im Media-Manager-Effekt zur Helligkeitsanpassung (Werte 0.8–1.4). Standard: 1.0 (keine Korrektur). Empfohlen: 1.2 für eine Darstellung, die der PDF-Vorschau in macOS Preview entspricht. Nutzt Imagick bevorzugt, convert (ImageMagick CLI) als zweiten Fallback, GD als dritten Fallback
• ICC-Profil-Einbettung (optional): sRGB ICC-Profil kann in das Thumbnailbild eingebettet werden, damit Browser und Bildprogramme die Farben korrekt interpretieren. Nutzt automatisch das mitgelieferte TCPDF sRGB-Profil – keine zusätzliche Installation nötig. Unterstützt Imagick und convert (ImageMagick CLI) als Fallback

Verbesserungen

• PdfThumbnail: Neue Methoden setGamma(), setEmbedIccProfile(), applyGammaCorrection(), embedSrgbIccProfile(), findSrgbIccProfile(), findSrgbIccProfilePath(), getIccProfilePaths()
• rex_effect_pdf_thumbnail: Zwei neue Parameter im Media-Manager-Effekt (Gamma-Korrektur, ICC-Farbprofil)
• checkAvailableTools() zeigt nun auch convert (ImageMagick CLI) Verfügbarkeit an
• Gamma-Korrektur: Dreistufige Fallback-Kette (Imagick → convert CLI → GD)
• ICC-Profil: Zweistufiger Fallback (Imagick → convert CLI)
• Cache-Key berücksichtigt nun auch Gamma- und ICC-Einstellungen
• Sprachdateien: Neue Übersetzungen für Gamma und ICC-Profil (DE/EN)

Hintergrund

PDF-Viewer wie macOS Preview nutzen Display Color Management (z.B. Display P3), wodurch dunkle Farben satter und heller erscheinen. Browser zeigen Thumbnails ohne dieses Mapping, was insbesondere bei dunklen Grüntönen zu einem nahezu schwarzen Ergebnis führen kann. Der Wechsel auf PNG als Standardformat sowie die optionalen Gamma- und ICC-Features lösen dieses Problem.

10.2.0 – PDF-Thumbnails ohne ImageMagick

🖼️ PdfOut 10.2.0 – PDF-Thumbnails ohne ImageMagick

Das Problem

Ubuntu/Debian blockiert seit 2018 die PDF-zu-Bild-Konvertierung über ImageMagick (Policy in /etc/ImageMagick-6/policy.xml). Der bisherige Media-Manager-Effekt convert2img funktioniert dadurch für PDFs nicht mehr zuverlässig.

Die Lösung

PdfOut liefert ab sofort einen eigenen Media-Manager-Effekt „PDF-Thumbnail (pdfout)", der pdftoppm aus poppler-utils verwendet – nicht von der ImageMagick-Policy betroffen.

Neue Features

• Media-Manager-Effekt rex_effect_pdf_thumbnail – erzeugt Vorschaubilder der ersten (oder beliebigen) PDF-Seite
• PdfThumbnail-Klasse (FriendsOfRedaxo\PdfOut\PdfThumbnail) – auch direkt im Code nutzbar
• Intelligente Tool-Erkennung mit automatischem Fallback: pdftoppm → pdftocairo → Ghostscript → Imagick
• Status-Anzeige im Backend – zeigt im Effekt-Dialog an, welche Tools verfügbar sind (✓/✗)
• Caching – generierte Thumbnails werden gecacht und bei PDF-Änderung automatisch neu erzeugt
• Konfigurierbar: Ausgabeformat (JPG/PNG), DPI, JPEG-Qualität, Seitennummer, Hintergrundfarbe

Voraussetzung

# Ubuntu/Debian
apt install poppler-utils

# macOS
brew install poppler

Weitere Installationsanleitungen für Alpine, CentOS, Arch, openSUSE und Docker in der README.

Verwendung

Im Media Manager: Neuen Typ anlegen → Effekt „PDF-Thumbnail (pdfout)" hinzufügen → optional resize dahinter.

Im Template/Modul:

$thumbUrl = rex_media_manager::getUrl('pdf_thumb', 'dokument.pdf');
echo '<img src="' . $thumbUrl . '" alt="PDF-Vorschau">';

Direkt im Code:

use FriendsOfRedaxo\PdfOut\PdfThumbnail;

$thumb = new PdfThumbnail();
$imagePath = $thumb->setDpi(200)->setMaxWidth(800)->generate(rex_path::media('dokument.pdf'));

Hinweis

Der Effekt prüft die Dateiendung – bei Nicht-PDFs wird das Medium unverändert durchgereicht, genau wie bei convert2img.

10.1.1

Vendor-Update TCPDF to [6.10.1]

10.1.0

Neustes dompdf und ausführliche pdfjs demo ergänzt.
Neu: PDFjs auf 5.x angehoben und pdfjs kann nun über ein Workflow aktualisiert werden

What's Changed

• Vendor update, pdfs js update und demo by @skerbis in #101

Full Changelog: 10.0.1...10.1.0

10.0.1

What's Changed

• Bump dompdf/dompdf from 3.1.0 to 3.1.2 by @dependabot[bot] in #99

Full Changelog: 10.0.0...10.0.1

10.0.0

10.00 :: Alles neu - Sehr neu!

• 🌈 HTML zu PDF: Wandelt HTML in hochwertige PDFs um
• 🎨 Anpassbar: Ausrichtung, Schriftart, DPI und mehr
• 🖼 Media Integration: Bilder direkt aus dem REDAXO Media Manager
• 💾 Flexibel: Speichern oder direktes Streaming an Browser
• 🔢 Automatik: Seitenzahlen und -zählung automatisch
• 🔍 Viewer: Integrierter PDF-Viewer mit pdf.js
• 🔒 Sicher: Passwortschutz und Berechtigungen
• ✍️ Signiert: Digitale Signaturen für Authentizität
• 📋 Zertifikatsverwasltung
• 🚀 Workflow: Optimierter REDAXO-Workflow (dompdf → Cache → Signierung)

👋 Seht euch die Demo an

Major-Release: Es kann zu Inkompatibilitäten kommen, habe ich aber soweit möglich vermieden.

Es muss immer mit Namespace gearbeitet werden

use FriendsOfRedaxo\PdfOut\PdfOut; 

'10.0.0-beta1

10.00 :: Alles neu

• 🌈 HTML zu PDF: Wandelt HTML in hochwertige PDFs um
• 🎨 Anpassbar: Ausrichtung, Schriftart, DPI und mehr
• 🖼 Media Integration: Bilder direkt aus dem REDAXO Media Manager
• 💾 Flexibel: Speichern oder direktes Streaming an Browser
• 🔢 Automatik: Seitenzahlen und -zählung automatisch
• 🔍 Viewer: Integrierter PDF-Viewer mit pdf.js
• 🔒 Sicher: Passwortschutz und Berechtigungen
• ✍️ Signiert: Digitale Signaturen für Authentizität
• 🚀 Workflow: Optimierter REDAXO-Workflow (dompdf → Cache → Signierung)

👋 Seht euch die Demo an

Major-Release: Es kann zu Inkompatibilitäten kommen, habe ich aber soweit möglich vermieden.

Es muss immer mit Namespace gearbeitet werden

use FriendsOfRedaxo\PdfOut\PdfOut; 

9.1.0

What's Changed

• vendor 3.1.0 by @skerbis in #85

Full Changelog: 9.0.1...9.1.0

9.0.1

What's Changed

• Update pdfout.php by @godsdog in #80
• Bump dompdf/dompdf from 3.0.0 to 3.0.2 by @dependabot in #82
• vendor update v3.0.2 by @skerbis in #83

New Contributors

• @godsdog made their first contribution in #80

Full Changelog: 9.0.0...9.0.1

9.0.0

Major Release

Wichtig:
Ab jetzt bitte use FriendsOfRedaxo\PdfOut\PdfOut; verwenden.
Die alte Class ist noch nutzbar und wird im nächsten Major entfernt.

Neu:
setPaperSize() ermöglicht mehr Seitenformate

What's Changed

• Neue Property $paperSize für das Papierformat
• Neue Methode setPaperSize() zum Setzen von Format und Orientierung
• Bisherige Standardwerte (A4, portrait) bleiben erhalten
• Unterstützung für Standard-Formate und benutzerdefinierte Größen

• change namespace to FOR by @skerbis in #77
• erlaube papersize setting by @skerbis in #78

Full Changelog: 8.4.0...8.5.0