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. dreipc_pdf resuelve este problema con un enfoque de renderizado propio: la extensión genera PDFs a partir del contenido de páginas TYPO3 con un layout de impresión dedicado, independiente de la representación del navegador.

A diferencia de EXT:web2pdf, que convierte la página HTML renderizada como captura de pantalla en un PDF, dreipc_pdf trabaja orientado a datos. Renderiza los elementos de contenido de una página TYPO3 mediante plantillas propias 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. dreipc_pdf 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. dreipc_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

dreipc_pdf utiliza una librería PDF de PHP (típicamente mPDF o TCPDF) para la generación. La extensión se registra como Page Type en TYPO3. 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 extensió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 es una extensión nicho con comunidad limitada. La última versión estable soporta TYPO3 v10 y v11. Para v12 no existe actualización oficial, el esfuerzo de portabilidad es moderado.

Las alternativas para TYPO3 v12/v13: EXT:web2pdf (basado en capturas, 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 dreipc_pdf a una solución personalizada puede reutilizar las plantillas Fluid PDF existentes, 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.