Excursões - Gerador de Folder

O que é

O Gerador de Folder transforma os dados já cadastrados de uma excursão em um material gráfico em PDF pronto para divulgação. Reúne, em um único arquivo, a imagem de capa, descrição, atrações, datas, local, preço, QR Code do site, galeria de fotos e dados de contato da empresa, em layouts pensados para impressão (A4, A5) ou para redes sociais (Instagram Story).

O usuário costuma chegar aqui depois de cadastrar a excursão e preencher o conteúdo (descrição, atrações, fotos), quando precisa de um arquivo para mandar por WhatsApp, e-mail, anexar a propostas ou imprimir como panfleto. A página é uma interface de configuração com preview em tempo real ao lado: qualquer alteração no painel esquerdo regenera o folder à direita.

Como usar

1. Vá em Excursões no sidebar e abra a excursão desejada.
2. Acesse Gerador de Folder a partir da excursão (URL /admin/excursoes/{excursao}/folder-generator). O preview no formato A4 Retrato é gerado automaticamente ao carregar.
3. No painel esquerdo, ajuste as configurações:
   • Template - escolha entre A4 Retrato, A4 Paisagem, A5 Flyer ou Instagram Story clicando no card desejado.
   • Estilo Visual - selecione Moderno, Clássico, Minimalista, Vibrante ou Elegante.
   • Cores - clique em uma das paletas (Azul Oceano, Verde Natureza, Laranja Sunset, Roxo Luxo, Vermelho Paixão, Rosa Tropical, Cinza Executivo, Dourado Premium) ou personalize Cor Primária, Secundária, do Texto, dos Títulos e Texto nos Cards via seletor de cor.
   • Conteúdo - marque/desmarque os blocos a exibir (Dados Básicos, Descrição, Atrações, O Que Esperar, Regras, O Que Levar, Inclusos, Não Inclusos) e use as setas para reordená-los.
   • Imagem de Capa - marque Exibir imagem de capa e clique na miniatura desejada (imagem principal da excursão ou qualquer foto da galeria).
   • Galeria de Fotos - marque Incluir galeria de fotos, defina quantas fotos por linha (1 a 4), altura em milímetros (20 a 50 mm) e clique nas miniaturas para selecionar. Use Selecionar todas para incluir o conjunto inteiro.
   • Opções Adicionais - ative Incluir QR Code para o site, Exibir logo da empresa, Exibir informações de contato, Exibir preço e Mostrar preço por categoria quando o preço estiver ativo. Defina também o número de colunas das listas (1 a 4).
   • Tipografia - escolha as fontes do Título e do Corpo entre Arial, Georgia, Times New Roman, Verdana ou Trebuchet MS.
4. Clique em Atualizar Preview (botão azul no cabeçalho) sempre que quiser refazer a renderização manualmente - algumas alterações já disparam o preview sozinhas (template, estilo).
5. Quando estiver satisfeito, abra o dropdown Exportar (botão verde no canto superior direito) e escolha:
   • Baixar PDF - força download do arquivo folder_{slug-da-excursao}_{data-hora}.pdf.
   • Imprimir - abre o PDF inline em nova aba para enviar à impressora pelo navegador.

Casos especiais

Salvar e reaplicar configurações como preset

Para reutilizar uma combinação de template, cores, fontes e seleção de blocos:

1. Clique em Presets no cabeçalho e depois em Salvar Preset Atual.
2. Digite um nome no modal (ex.: "Folder padrão verão") e confirme.
3. O preset fica disponível na lista Presets Salvos dentro do mesmo dropdown e pode ser reaplicado a qualquer momento clicando no nome. Os presets ficam armazenados na própria excursão (campo folder_presets).

Adicionar conteúdo personalizado (não cadastrado na excursão)

Quando precisar incluir um texto livre que não está no conteúdo padrão da excursão (ex.: "Política de cancelamento promocional", "Brinde da edição"):

1. Na seção Conteúdo do painel esquerdo, clique em Adicionar conteúdo personalizado (botão tracejado roxo ao final da lista de blocos).
2. Preencha o Título da seção e o Conteúdo (use linhas em branco para separar parágrafos).
3. Clique em Salvar. O novo bloco aparece no fim da ordem com ícone roxo, pode ser reordenado pelas setas e editado/removido pelos ícones de lápis e X.

Bloco de preços só funciona com preços ativos cadastrados

A opção Mostrar preço por categoria só exibe valores se houver categorias e preços ativos na excursão. Sem cadastro, o folder mostra apenas o preço base (quando definido) ou omite o bloco.

QR Code aponta para o site público

Ao ativar Incluir QR Code para o site, o folder gera um QR Code apontando para a URL de compartilhamento da excursão (share_url ou rota pública site.excursao). Útil para que clientes potenciais escaneiem direto de um folder impresso e abram a página de inscrição.

Geração via Gotenberg com fallback DomPDF

A geração de PDF usa o Gotenberg (renderiza HTML/CSS como navegador, mantém o estilo fiel ao preview). Se o serviço estiver indisponível, o sistema cai para o DomPDF automaticamente - nesse caso, alguns efeitos visuais avançados (gradientes, sombras, layouts complexos) podem renderizar diferente do preview.

Erros comuns e como resolver

• "Erro ao gerar preview: ..." - Causa: HTML do template não renderizou (geralmente conteúdo malformado ou falha ao baixar imagem da capa/galeria). Solução: tente recarregar a página, desmarque temporariamente a galeria ou a imagem de capa para isolar o problema; verifique se as fotos da excursão abrem normalmente.
• "Erro ao gerar PDF: ..." (toast vermelho ao baixar) - Causa: falha no Gotenberg e no fallback DomPDF (HTML inválido, imagem inacessível, timeout). Solução: gere o preview novamente, reduza a quantidade de fotos na galeria ou desative o QR Code e tente exportar de novo.
• Botão Exportar fica desabilitado (cinza) - Causa: ainda não foi gerado nenhum preview na sessão atual. Solução: clique em Atualizar Preview primeiro; após o preview carregar, o botão verde fica ativo.
• Bloco "Vazio" amarelo ao lado de uma seção - Causa: a seção não tem conteúdo preenchido no cadastro da excursão (ex.: Atrações ou Regras vazios). Solução: vá em Conteúdo da Excursão e preencha o campo correspondente, ou desmarque o bloco no folder.
• "Informe um titulo" (ao salvar conteúdo personalizado) - Causa: tentou salvar uma seção personalizada sem preencher o título. Solução: preencha o campo Título da seção antes de salvar.
• "Preset não encontrado" - Causa: o nome do preset enviado não existe mais (foi removido em outra sessão ou nunca foi salvo nessa excursão). Solução: recarregue a página para atualizar a lista do dropdown Presets.

Onde encontrar

• URL: /admin/excursoes/{excursao}/folder-generator
• Caminho no menu: Excursões > {nome da excursão} > Gerador de Folder
• Permissão necessária: ver as viagens
• Módulo necessário: nenhum

Veja também

• Conteúdo da Excursão - preenche descrição, atrações, regras e fotos que alimentam os blocos do folder.
• Categorias e Preços - define os valores exibidos no bloco de preço por categoria.
• Visão Geral de Excursões - volta à listagem das viagens cadastradas.