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, o navegador chama a mesma página com um parâmetro adicional; um middleware da extensão pega a saída já renderizada dessa chamada e passa o HTML para a biblioteca PHP mPDF.

O mPDF (pacote Composer mpdf/mpdf, versão 8) é PHP puro e roda dentro do processo do TYPO3, sem programa externo nem navegador no servidor. Em compensação, trata cada elemento HTML de forma fixa como bloco ou inline: não implementa Flexbox e Grid CSS, e float e position só de forma limitada; tabelas grandes deixam a geração lenta e pesada em memória. Para ter no PDF o layout do site com suporte CSS completo (Flexbox, Grid, Custom Properties), é preciso um navegador headless como Puppeteer/Chromium.

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: o mPDF implementa só uma parte do CSS. Sites que usam Flexbox ou CSS Grid ficam completamente diferentes no PDF. Solução: um CSS de impressão separado, com layouts de blocos e tabelas que o mPDF entende. O mPDF incorpora fontes a partir de arquivos TTF, e o web2pdf traz para isso um diretório de fontes próprio. Se isso não bastar, resta migrar para o Puppeteer, fora do web2pdf.

Geração de PDF demora demais. O web2pdf gera cada PDF de novo no processo PHP da chamada, e o mPDF fica lento e consome muita memória em páginas longas com tabelas grandes. 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).

Exceção quando o plugin não está na página. Quem acrescenta o parâmetro de PDF aos links por conta própria, em vez de incluir o plugin da extensão, recebe uma exceção do TYPO3 na saída em cache, porque o setup TypoScript não foi inicializado. Solução, segundo a documentação: colocar o plugin em cada página que deve sair como PDF; o mais simples é fazer isso via TypoScript para todas as páginas. Páginas atrás de login não são um caso especial: o middleware converte a saída da chamada que o próprio visitante logado faz.

Migração e compatibilidade de versões

A Mittwald continua mantendo o web2pdf: a versão 4 suporta o TYPO3 v12.4 (desde agosto de 2023), a versão 5.0.1, de março de 2025, suporta o v13.4, e séries anteriores cobrem v10 e v11. Uma versão para o TYPO3 v14 ainda não existe no TER (situação em setembro de 2026).

Quando o PDF deve mostrar o layout do site com CSS moderno, 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. O mPDF não gera estruturas Tagged PDF; o suporte a PDF/UA é um pedido em aberto no projeto mPDF desde 2020. Para esse caso, a Gosign recomenda uma geração que transfira a semântica do HTML para tags PDF, por exemplo com o Puppeteer, que cria PDFs com tags por padrão.