web2pdf para TYPO3

Por qué web2pdf es imprescindible para webs TYPO3 con listas de precios y páginas de producto

Los equipos comerciales necesitan PDFs imprimibles. Los clientes esperan en las páginas de producto un botón “Guardar como PDF”. Y los compradores de la industria descargan listas de precios para reenviarlas internamente. web2pdf resuelve exactamente este problema: la extensión renderiza cualquier página TYPO3 como PDF - con layout correcto, imágenes embebidas y tipografía limpia. En lugar de crear cada página manualmente como PDF y actualizarla ante cambios, web2pdf genera el PDF en vivo a partir del contenido actual.

Eso no solo ahorra tiempo de redacción, sino que también evita versiones PDF obsoletas. Si el precio de un producto se modifica en el CMS, web2pdf entrega automáticamente la versión actualizada en la siguiente descarga.

Escenarios de uso habituales

Catálogos de producto y listas de precios en B2B. Una empresa de maquinaria gestiona 200 páginas de producto en TYPO3. El equipo comercial necesita una ficha técnica imprimible de cada producto. web2pdf genera desde cada página de producto un PDF con logo, datos técnicos e información de contacto en el diseño corporativo.

Artículos y whitepapers como descarga. Medios y editoriales especializadas ofrecen artículos de revista como descarga PDF. web2pdf convierte el artículo incluyendo imágenes y formato en un PDF optimizado para impresión. Un CSS de impresión controla qué elementos aparecen en el PDF (contenido) y cuáles no (navegación, footer, banner de cookies).

Ofertas y configuraciones. Resultados de configuradores, resúmenes de ofertas o vistas generales del carrito se exportan como PDF vía web2pdf.

Arquitectura técnica

web2pdf funciona como extensión TYPO3 con un plugin frontend que muestra un botón de descarga PDF en cada página. Al hacer clic, el navegador vuelve a llamar a la misma página con un parámetro adicional; un middleware de la extensión toma la salida ya renderizada de esa llamada y pasa el HTML a la librería PHP mPDF (paquete Composer mpdf/mpdf, versión 8). mPDF es PHP puro y se ejecuta en el propio proceso de TYPO3, sin programa externo ni navegador en el servidor, pero no admite CSS Flexbox ni Grid y solo admite float y position de forma limitada. Quien necesite en el PDF el layout de la web con soporte CSS completo (Flexbox, Grid, Custom Properties) tiene que recurrir a un navegador headless como Puppeteer/Chromium.

Un CSS de impresión separado (@media print) controla qué elementos son visibles en el PDF. Gosign recomienda ocultar navegación, footer, banner de cookies y elementos interactivos, e insertar en su lugar logo, datos de contacto y código QR con la URL fuente.

Problemas frecuentes y soluciones

El PDF muestra layout incorrecto, faltan imágenes o fuentes. Causa más frecuente: mPDF solo implementa una parte de CSS. Webs que usan Flexbox o CSS Grid se ven completamente distintas en el PDF. Solución: un CSS de impresión separado con layouts de bloques y tablas que mPDF entienda. mPDF incrusta las fuentes a partir de archivos TTF; web2pdf trae para ello su propio directorio de fuentes. Si eso no basta, queda el cambio a Puppeteer fuera de web2pdf.

La generación del PDF tarda demasiado. web2pdf genera cada PDF de nuevo en el proceso PHP de la llamada, y mPDF es lento y consume mucha memoria con páginas largas y tablas grandes. Con peticiones simultáneas se multiplica la carga del servidor. Solución: implementar caché de PDF. El PDF generado se almacena en caché durante un tiempo definido (por ejemplo, 60 minutos).

Excepción cuando falta el plugin en la página. Quien añade por su cuenta el parámetro PDF a los enlaces, en lugar de integrar el plugin de la extensión, obtiene en la salida cacheada una excepción de TYPO3, porque el setup TypoScript no está inicializado. Solución según la documentación: colocar el plugin en cada página que deba salir como PDF; lo más sencillo es hacerlo por TypoScript para todas las páginas. Las páginas detrás de un login no son un caso especial: el middleware convierte la salida de la llamada que hace el propio visitante autenticado.

Migración y compatibilidad de versiones

Mittwald sigue manteniendo web2pdf: la versión 4 soporta TYPO3 v12.4 (desde agosto de 2023), la versión 5.0.1 de marzo de 2025 soporta v13.4 y las series anteriores cubren v10 y v11. En el TER todavía no hay versión para TYPO3 v14 (a fecha de septiembre de 2026).

Cuando el PDF debe mostrar el layout de la web con CSS moderno, Gosign recomienda un cambio arquitectónico: en lugar de operar web2pdf como extensión TYPO3, la generación de PDF se implementa como microservicio separado. Un servicio Node.js con Puppeteer recibe URLs y devuelve PDFs. Eso desacopla la generación de PDF del servidor TYPO3.

Un aspecto frecuentemente subestimado: la accesibilidad. Los PDFs generados desde HTML no son automáticamente accesibles. Para las empresas sujetas a la Directiva Europea de Accesibilidad (en España, la Ley 11/2023, desde junio de 2025), los PDFs generados deben contener estructuras Tagged PDF. mPDF no genera estructuras Tagged PDF; el soporte de PDF/UA figura en el proyecto mPDF como petición abierta desde 2020. Gosign recomienda para estos casos una generación que traslade la semántica HTML a etiquetas PDF, por ejemplo con Puppeteer, que crea PDFs etiquetados por defecto.