dreipc_pdf para TYPO3

Cuando los visitantes quieren descargar páginas TYPO3 como PDF, el resultado necesita un diseño propio

Los visitantes hacen clic en “Guardar como PDF” y esperan un documento limpio: diseño corporativo, logo, números de página, sin sobrecarga de navegación. Lo que ofrece la función de impresión del navegador es lo contrario: columnas cortadas, encabezados y pies de página superfluos, imágenes que faltan. La solución es un layout de impresión propio que genera PDFs a partir del contenido de páginas TYPO3, independiente de la representación del navegador. dreipc_pdf no está publicado ni en el TER ni en Packagist ni en GitHub, por lo que no se puede comprobar su funcionalidad. Los apartados siguientes describen el enfoque que sigue una solución de este tipo en TYPO3.

A diferencia de EXT:web2pdf, que convierte la página HTML renderizada en un PDF con la librería PHP mPDF, un enfoque orientado a datos trabaja con plantillas propias: renderiza los elementos de contenido de una página TYPO3 mediante plantillas PDF y genera a partir de ellos un PDF formateado. Esto permite control total sobre márgenes, encabezados y pies de página, tamaños de fuente y saltos de página.

Escenarios de uso habituales

Hojas de datos de producto desde el CMS. Fabricantes de maquinaria, empresas químicas y fabricantes de tecnología médica mantienen datos de producto en TYPO3. Los comerciales necesitan estos datos como PDF imprimible para visitas a clientes. Una solución PDF orientada a datos genera desde la página de producto TYPO3 un PDF con layout corporativo. En un cliente con 400 páginas de producto, los PDFs están disponibles automáticamente mediante botón en cada página.

Comunicados de prensa e informes de empresa. Los departamentos de comunicación publican comunicados de prensa en el sitio web y los ofrecen simultáneamente como PDF descargable. La solución PDF genera el PDF al hacer clic en el botón de descarga, siempre basado en el contenido actual.

Documentos informativos de entidades públicas. Las instituciones públicas ponen formularios, hojas informativas y comunicaciones a disposición como PDF. Los contenidos se mantienen en TYPO3 y con cambios se entregan automáticamente como PDF actualizado.

Arquitectura técnica

Una solución de este tipo utiliza una librería PDF de PHP como mPDF o TCPDF para la generación y registra en TYPO3 un tipo de página propio. Al solicitar una página con el parámetro de tipo PDF (?type=123), se genera un archivo PDF en lugar de la salida HTML y se ofrece para descarga.

El pipeline de renderizado trabaja en tres pasos. Primero, la solución lee los elementos de contenido de la página TYPO3 solicitada desde la base de datos. Segundo, renderiza cada elemento mediante una plantilla Fluid PDF dedicada. Tercero, pasa el string HTML renderizado a mPDF/TCPDF, que genera el PDF con los ajustes de página configurados.

Las plantillas PDF son plantillas Fluid con HTML/CSS que mPDF comprende. mPDF soporta un subconjunto de CSS2 y CSS3: márgenes de página (@page), encabezados/pies de página, tablas, imágenes, fuentes (fuentes TTF incrustables) y saltos de página.

Problemas frecuentes y soluciones

Faltan imágenes en el PDF. mPDF carga imágenes vía HTTP. Si el servidor está detrás de un reverse proxy o en un entorno Docker, mPDF no puede resolver sus propias URLs de imagen. Solución: incrustar imágenes a través de la ruta local del servidor en lugar de la URL.

La generación de PDF es lenta con páginas complejas. Una página con 30 elementos de contenido y 15 imágenes puede tardar 5-10 segundos en la generación de PDF. Solución: cachear los PDFs generados. En la primera solicitud se genera y almacena el PDF. Las solicitudes siguientes entregan la versión cacheada.

Los saltos de página en lugares incorrectos. mPDF rompe páginas donde el contenido excede la altura de la página, también en medio de una tabla o un párrafo. Solución: establecer saltos de página explícitos en las plantillas PDF y proteger las tablas contra el corte.

Migración y compatibilidad de versiones

dreipc_pdf no está publicado ni en el TER ni en Packagist ni en GitHub. Por eso no se puede comprobar qué versiones de TYPO3 soporta, y no hay forma de obtener públicamente una actualización para las versiones actuales.

Las alternativas para TYPO3 v12/v13: EXT:web2pdf (convierte la página HTML con mPDF, más sencillo, menos control sobre el layout), EXT:pdfviewhelpers (basado en ViewHelpers, trabaja con TCPDF), EXT:fluid_fpdf (plantillas Fluid con backend FPDF) o una solución personalizada con mPDF como paquete Composer.

Quien migre de una extensión PDF existente a una solución personalizada puede reutilizar las plantillas Fluid PDF que ya tenga, siempre que utilicen HTML/CSS compatible con mPDF. El wrapper de renderizado debe reescribirse, pero las plantillas se mantienen. En un proyecto típico con 5 plantillas PDF, el esfuerzo de migración es de 2-3 días. Gosign ha implementado generación de PDF en TYPO3 con diversas librerías y recomienda la solución adecuada según los requisitos.