Excursões - Conteúdo da Excursão

O que é

A página Conteúdo da Excursão centraliza tudo o que será exibido na página pública da excursão no site da sua empresa: imagem de capa, dados básicos, descritivo completo, atrações, regras, itens inclusos e não inclusos, galeria de fotos, vídeos, links relacionados, ingressos vinculados (quando o módulo está ativo) e meta tags de SEO.

O usuário normalmente chega aqui após criar a excursão pelo wizard, clicando na aba Conteúdo dentro da página de edição da excursão. O conteúdo pode ser construído de duas formas: Estruturado (campos separados por tipo, melhor para SEO) ou Texto Livre (editor rico com blocos prontos para conteúdo mais flexível).

Como usar

1. Vá em Excursões no sidebar, abra a excursão desejada e clique na aba Conteúdo na barra de navegação superior da excursão.
2. Expanda o bloco Banner/Capa (sempre aberto por padrão) e arraste a imagem de capa ou clique para selecionar do dispositivo. Em seguida, escolha o Modo de Exibição do Banner entre Padrão do Site, Hero, Vitrine, Split ou Minimal.
3. Em Dados Básicos, preencha:
   • Título - usado no topo da página pública (default: nome da excursão).
   • Subtítulo - exibido nos cards de listagem e no banner hero.
   • Resumo - texto curto para previews e listagens.
4. Em Modo de Conteúdo, selecione Estruturado (recomendado) para preencher campo a campo ou Texto Livre para usar o editor TinyMCE com blocos prontos.
5. No modo Estruturado, expanda cada accordion conforme necessário:
   • Descrição Completa - editor de texto rico com a narrativa principal.
   • Atrações - lista de pontos turísticos com legenda de seção opcional.
   • O que Esperar - itens de experiência (paisagens, guia, paradas).
   • Regras e Normas - políticas e exigências.
   • O que Levar - sugestões práticas ao passageiro.
   • Inclusos / Não Inclusos - duas colunas paralelas (verde/vermelho).
6. Em cada lista, use Adicionar para incluir um item por vez ou Inserir em Lote para colar várias linhas de uma vez (uma por linha).
7. Adicione Vídeos (URLs do YouTube), Links Relacionados (título + URL) e, se o módulo Ingressos estiver ativo, marque os ingressos que fazem parte da excursão no bloco dedicado.
8. Em Galeria de Fotos, arraste imagens ou clique no dropzone para enviar. As fotos são otimizadas automaticamente para WebP. Use os ícones que aparecem no hover de cada thumbnail para editar legenda, marcar como Destaque (estrela) ou remover. Arraste as miniaturas para reordenar.
9. Em SEO, opcionalmente clique em Gerar com IA para que o Gemini sugira Meta Title, Meta Description e Meta Keywords a partir dos dados já preenchidos. Revise os textos antes de salvar.
10. Use Preview (cabeçalho, ao lado de Análise por IA) para visualizar a página pública. Se houver alterações não salvas, será exibido um modal perguntando se deseja Salvar e Visualizar, Ver sem salvar ou cancelar.
11. Clique em Salvar Conteúdo na barra de ações fixa no rodapé. O conteúdo permanece como rascunho até ser publicado pelo controlador (endpoint publicar/despublicar).

Casos especiais

Modo Texto Livre com blocos prontos

Ao selecionar Texto Livre no bloco 3, o accordion estruturado é substituído por um único bloco com editor TinyMCE. O botão Inserir Bloco Pronto abre o modal de templates configurados em PaginaTemplateService, permitindo colar trechos pré-formatados (HTML completo, tabelas, calls-to-action) que podem ser editados livremente em seguida.

Galeria com limite de 10 fotos

O limite é fixo em 10 fotos por excursão. Ao atingir esse número, o dropzone some e aparece um aviso amarelo Limite de 10 fotos atingido. Remova uma foto para adicionar outra.. Para liberar espaço, abra o overlay da foto e clique no ícone de lixeira vermelho.

Vincular Ingressos do módulo

O bloco Ingressos só aparece quando você tem o módulo ingressos ativo (tenant_has_addon('ingressos')). Sem nenhum ingresso cadastrado ainda, o bloco mostra o atalho Gerenciar Ingressos que leva para /admin/ingressos. Com ingressos cadastrados, usa um seletor com busca por nome e cidade.

Foto de destaque única

Marcar uma foto como Destaque (ícone de estrela no overlay) remove automaticamente o destaque das demais fotos da mesma excursão. Apenas uma foto pode estar marcada como destaque por vez.

SEO com cooldown de 10s

Após cada clique em Gerar com IA, o botão entra em cooldown de 10 segundos exibindo Aguarde Xs para evitar requisições em sequência ao Gemini. Se a integração não estiver configurada, retorna Integração com IA não configurada.

Erros comuns e como resolver

• "Limite máximo de 10 fotos atingido." - Causa: galeria já tem 10 fotos. Solução: remover uma foto existente (lixeira no hover) antes de subir nova imagem.
• "Integração com IA não configurada." - Causa: chave do Gemini ausente nas configurações. Solução: configurar a integração de IA antes de usar o botão Gerar com IA no bloco SEO.
• "Conteúdo não encontrado." - Causa: tentativa de remover item/link via JS antes de o registro ExcursaoConteudo ter sido criado. Solução: salvar o formulário pelo menos uma vez para garantir a existência do conteúdo.
• Capa de 5 MB excedida - A validação do upload de capa rejeita arquivos com image|max:5120 (5 MB). Solução: comprimir a imagem antes ou enviá-la como foto da galeria (que aceita 10 MB).
• Foto de galeria acima de 10 MB - Validação image|max:10240. Solução: reduzir resolução da imagem original (recomendado 1920x1080 ou menor).

Onde encontrar

• URL: /admin/excursoes/{excursao}/conteudo
• Caminho no menu: Excursões > abrir excursão > aba Conteúdo
• Permissão necessária: editar as viagens
• Módulo necessário: nenhum (bloco de Ingressos depende do módulo ingressos)

Veja também

• Criar uma Excursão
• Wizard de Criação de Excursão
• Visão Geral de Excursões