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, la extensión llama internamente a la página actual y pasa la salida HTML a un motor de renderizado PDF. La extensión soporta dos motores: wkhtmltopdf (la solución clásica basada en una versión antigua de WebKit, sin soporte CSS Flexbox/Grid) y Puppeteer/Chromium (la alternativa moderna con soporte CSS completo y embebido correcto de webfonts).

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: wkhtmltopdf no puede renderizar CSS moderno. Webs que usan Flexbox o CSS Grid se ven completamente distintas en el PDF. Solución: cambiar a Puppeteer como motor de renderizado.

La generación del PDF tarda más de 10 segundos. Puppeteer arranca un proceso Chromium por cada PDF. 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).

Páginas autenticadas entregan un PDF vacío. web2pdf llama a la página internamente vía HTTP. Si la página está detrás de un login, faltan las cookies de sesión y el proceso de renderizado solo ve la página de login. Solución: configurar un endpoint de renderizado PDF dedicado que resuelva la autenticación vía token en lugar de cookies de sesión.

Migración y compatibilidad de versiones

web2pdf está disponible de forma estable para TYPO3 v10 y v11. Para TYPO3 v12 LTS existen forks de la comunidad. El paquete original ya no se mantiene activamente.

Para TYPO3 v13 en adelante, 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. Conforme a la Directiva Europea de Accesibilidad y la normativa española vigente, los PDFs generados deben contener estructuras Tagged PDF. Ni wkhtmltopdf ni Puppeteer generan por defecto PDFs accesibles. Gosign recomienda para estos casos un procesamiento posterior con una librería PDF especializada.