Site - Criar Slide do Hero

O que é

O Hero é o bloco principal no topo da página inicial do site. Quando a variante do Hero está configurada como Carrossel, ele exibe uma sequência rotativa de slides, e esta tela é onde você cadastra esses slides e ajusta o comportamento do carrossel (modo de origem, quantidade, tempo de exibição e efeito de transição).

Você normalmente chega aqui depois de escolher a variante "Carrossel" em Site > Template do Site (seção Hero). Se a variante ainda não estiver ativa, um alerta amarelo aparece no topo da página avisando que os slides cadastrados aqui não serão exibidos no site até a variante ser trocada.

Como usar

1. Vá em Site > Hero Slides no menu lateral (URL /admin/hero-slides).
2. No card Modo do Carrossel, escolha Fonte dos Slides:
   • Excursões Automático - o carrossel mostra as próximas excursões publicadas (com data_inicio futura). Você só define quantas devem aparecer no campo Quantidade de Excursões (1 a 10).
   • Manual - você cadastra um a um os slides que quer exibir.
3. Ajuste Tempo de Exibição (3, 5, 7 ou 10 segundos) e Efeito de Transição (Fade, Slide, Flip ou Cube) e clique em Salvar Configurações.
4. Com o modo Manual selecionado, surge o card Adicionar Slide. No campo Tipo do Slide, escolha:
   • Excursão - depois escolha a excursão no select Selecione a excursão. Imagem, título e link serão herdados automaticamente da excursão escolhida.
   • Imagem Customizada - preencha os campos manualmente.
5. Para o tipo Imagem Customizada, preencha:
   • Imagem do Slide - faça upload via o componente de imagem (aspecto 16:9, recomendado 1920x1080px, JPG/PNG/WebP até 25MB). O recorte abre automaticamente.
   • Título - texto principal exibido sobre o banner.
   • Subtítulo - linha secundária menor.
   • Link (URL) - endereço completo para onde o botão do slide leva. Precisa começar com http:// ou https://.
   • Texto do Botão - rótulo do CTA (ex.: Saiba Mais, Ver Pacote). Se ficar vazio, o site usa "Saiba Mais" para imagens e "Ver Excursão" para slides do tipo excursão.
6. Clique em Adicionar Slide. O slide entra na última posição da lista Slides Cadastrados já como Ativo.
7. Na lista, use as setas para cima/baixo ao lado de cada slide para reordenar - a página recarrega após cada movimento.
8. Clique na pílula Ativo/Inativo para alternar a exibição sem precisar excluir o slide.

Casos especiais

Slide vinculado a excursão

No tipo Excursão, só aparece no select as excursões com status = publicada e data_inicio no futuro. Não é possível digitar título, subtítulo ou imagem nesse modo - o site puxa nome, subtítulo (ou destino) e imagem da própria excursão. O link também vai automaticamente para a página da excursão no site público.

Carrossel não está ativo

Se o template do site não estiver com a variante Carrossel no Hero, um alerta amarelo aparece no topo: "Carrossel não está ativo". Os slides continuam podendo ser cadastrados, mas só aparecem no site depois que você abrir Site > Template do Site, ir na seção Hero e selecionar a variante Carrossel. O link Ir para configuração de Templates no próprio alerta leva direto para /admin/template#hero.

Modo Excursões Automático

Quando o modo está em Excursões Automático, o card Adicionar Slide e a lista Slides Cadastrados ficam ocultos - o sistema monta o carrossel sozinho com as próximas excursões publicadas, e a tela mostra um Preview com as miniaturas das excursões selecionadas.

Editar slide existente

Slides do tipo Imagem Customizada podem ser editados pelo ícone de lápis azul à direita do item na lista - abre um modal com os mesmos campos, permitindo trocar a imagem (com novo recorte 16:9) ou alterar qualquer texto. Slides do tipo Excursão não têm botão de edição: para mudar, exclua e cadastre de novo.

Erros comuns e como resolver

• "O campo link url deve ser uma URL válida." - Causa: o campo Link (URL) foi preenchido sem http:// ou https://. Solução: cole a URL completa, incluindo o protocolo.
• "O campo excursão id é obrigatório quando tipo é excursão." - Causa: o tipo escolhido foi Excursão mas nenhuma foi selecionada no dropdown. Solução: escolha uma excursão publicada com data futura, ou troque o tipo para Imagem Customizada.
• "Tipo de arquivo não permitido. Use JPG, PNG ou WebP." - Causa: arquivo enviado é GIF, SVG ou outro formato. Solução: converta para JPG, PNG ou WebP antes do upload.
• "Arquivo muito grande. Máximo: 25MB." - Causa: imagem ultrapassa 25 MB. Solução: comprima a imagem mantendo a proporção 16:9 (1920x1080 é o recomendado).
• Slides cadastrados não aparecem no site - Causa: a variante do Hero ainda está em outro modo no Template. Solução: vá em Site > Template do Site, seção Hero, e selecione Carrossel.

Onde encontrar

• URL: /admin/hero-slides
• Caminho no menu: Site > Hero Slides
• Permissão necessária: ver as configurações para abrir, editar as configurações para criar, editar, reordenar, alternar ou excluir
• Módulo necessário: nenhum

Veja também

• Hero Slides (Carrossel) - visão geral, edição e exclusão de slides
• Template do Site - ativar a variante Carrossel no Hero
• Criar Seção da Home - adicionar outros blocos abaixo do Hero