web2pdf para TYPO3

Por que web2pdf é indispensável para sites TYPO3 com listas de preços e páginas de produto

Equipes de vendas precisam de PDFs imprimíveis. Clientes esperam um botão “Salvar como PDF” em páginas de produto. E compradores na indústria baixam listas de preços para encaminhá-las internamente. web2pdf resolve exatamente esse problema: a extensão renderiza qualquer página TYPO3 como PDF - com layout correto, imagens incorporadas e tipografia limpa. Em vez de criar manualmente cada página como PDF e atualizá-la a cada mudança, web2pdf gera o PDF ao vivo a partir do conteúdo atual da página.

Isso economiza não apenas tempo de edição, mas também evita versões PDF desatualizadas. Quando o preço de um produto é alterado no CMS, web2pdf entrega automaticamente a versão atualizada no próximo download.

Cenários típicos de uso

Catálogos de produtos e listas de preços no B2B. Uma empresa de engenharia mantém 200 páginas de produto no TYPO3. A equipe de campo precisa de uma ficha técnica imprimível para cada produto. web2pdf gera de cada página de produto um PDF com logo, dados técnicos e informações de contato no design corporativo.

Artigos e whitepapers como download. Empresas de mídia e editoras especializadas oferecem artigos de revista como download PDF. web2pdf converte o artigo incluindo imagens e formatação em um PDF otimizado para impressão. Um CSS de impressão controla quais elementos aparecem no PDF e quais não (navegação, footer, banner de cookies).

Ofertas e configurações. Resultados de configuradores, resumos de ofertas ou visões gerais de carrinho podem ser exportados como PDF via web2pdf. O usuário clica em “Oferta como PDF” e recebe um documento pronto para impressão.

Arquitetura técnica

web2pdf funciona como extensão TYPO3 com um plugin frontend que exibe um botão de download PDF em cada página. Ao clicar, a extensão chama internamente a página atual e passa o output HTML para um backend de renderização PDF.

A extensão suporta dois motores de renderização: wkhtmltopdf (solução clássica, baseada em versão antiga do WebKit - sem suporte a Flexbox e Grid CSS) e Puppeteer/Chromium (alternativa moderna com suporte CSS completo, incorporação correta de webfonts, execução de JavaScript).

Um CSS de impressão separado (@media print) controla quais elementos são visíveis no PDF. A Gosign recomenda ocultar navegação, footer, banner de cookies e elementos interativos no CSS de impressão e inserir logo, dados de contato e URL.

Problemas frequentes e soluções

PDF mostra layout errado, imagens ou fontes ausentes. Causa mais frequente: wkhtmltopdf não consegue renderizar CSS moderno. Sites que usam Flexbox ou CSS Grid ficam completamente diferentes no PDF. Solução: trocar para Puppeteer como motor de renderização.

Geração de PDF leva mais de 10 segundos. Puppeteer inicia um processo Chromium para cada PDF. Com requisições simultâneas, a carga do servidor multiplica. Solução: implementar caching de PDF. O PDF gerado é cacheado no sistema de arquivos por um tempo definido (ex: 60 minutos).

Páginas autenticadas entregam PDF vazio. web2pdf chama a página internamente via HTTP. Se a página está atrás de login, faltam os cookies de sessão. Solução: configurar um endpoint dedicado de renderização PDF que resolve a autenticação via token.

Migração e compatibilidade de versões

web2pdf está disponível de forma estável para TYPO3 v10 e v11. Para TYPO3 v12 LTS existem forks da comunidade. O pacote original não é mais mantido ativamente.

Para TYPO3 v13 e além, a Gosign recomenda uma mudança arquitetural: em vez de operar web2pdf como extensão TYPO3, a geração de PDF é implementada como microserviço separado. Um serviço Node.js com Puppeteer recebe URLs e retorna PDFs. Isso desacopla a geração de PDF do servidor TYPO3 e torna a solução independente da versão TYPO3.

O esforço de migração de web2pdf para uma solução baseada em Puppeteer é tipicamente de 2 a 4 dias. Os arquivos CSS de impressão existentes podem ser reutilizados 1:1.

Um aspecto frequentemente subestimado na geração de PDF: acessibilidade. PDFs gerados a partir de HTML não são automaticamente acessíveis. Para empresas sujeitas à Lei de Fortalecimento da Acessibilidade (BFSG, vigente desde junho de 2025), os PDFs gerados devem conter estruturas Tagged PDF. Nem wkhtmltopdf nem Puppeteer geram PDFs acessíveis por padrão.