Site - Hero Slides (Carrossel)

O que é

O Hero é o bloco do topo da página inicial do site público da agência. Quando a variante do Hero está configurada como Carrossel, ele exibe uma sequência rotativa de slides. Esta tela é o painel central para gerenciar tudo o que diz respeito a esse carrossel: a fonte dos slides (manual ou automática por excursões), a velocidade da rotação, o efeito de transição entre slides e, no modo manual, a lista completa de slides cadastrados com ordenação, status e exclusão.

Você normalmente chega aqui para revisar ou ajustar o que já está no ar: reordenar slides para destacar uma campanha nova, desligar temporariamente um slide sazonal sem perder os dados, mudar o tempo de exibição quando os textos ficaram longos ou trocar o modo do carrossel de manual para automático. Para cadastrar um slide novo, use o fluxo descrito no artigo Criar Slide do Hero.

Como usar

1. Vá em Site > Hero Slides no menu lateral (URL /admin/hero-slides).
2. No card Modo do Carrossel, escolha em Fonte dos Slides entre:
   • Excursões Automático - o carrossel monta sozinho com as próximas excursões publicadas. Define-se apenas a Quantidade de Excursões (1 a 10).
   • Manual - exibe somente os slides que você cadastrar abaixo.
3. Em Tempo de Exibição, escolha quanto tempo cada slide permanece visível: 3 segundos, 5 segundos, 7 segundos ou 10 segundos.
4. Em Efeito de Transição, escolha como os slides trocam de um para o outro:
   • Fade (dissolve suave)
   • Slide (desliza horizontal)
   • Flip (vira como página)
   • Cube (cubo 3D)
5. Clique em Salvar Configurações (botão verde no rodapé do card).
6. Se o modo for Manual, role até Slides Cadastrados para gerenciar os existentes:
   • Reordenar - use as setas para cima/baixo à esquerda de cada slide. As setas das extremidades ficam desativadas (o primeiro slide não sobe, o último não desce). Após cada movimento, a página recarrega para refletir a nova ordem.
   • Ativar/desativar - clique na pílula colorida ao lado direito do slide. O sistema alterna o status sem confirmar e recarrega a tela. Slides inativos continuam cadastrados mas não aparecem no site.
   • Editar imagem customizada - clique no ícone de lápis azul (disponível apenas em slides do tipo Imagem Customizada). Abre um modal para trocar imagem (com novo recorte 16:9), título, subtítulo, link e texto do botão.
   • Excluir - clique no ícone de lixeira vermelho e confirme no modal. A imagem associada também é removida do storage.

Casos especiais

Modo Excursões Automático

Quando o Modo do Carrossel está em Excursões Automático, os cards Adicionar Slide e Slides Cadastrados somem da tela - eles só existem no modo manual. No lugar aparece um card Preview com as miniaturas das próximas excursões publicadas (até o número definido em Quantidade de Excursões). O carrossel do site público usa automaticamente essas mesmas excursões, ordenadas por data_inicio crescente, sem necessidade de cadastro manual.

Carrossel não está ativo no Template

Se a variante do Hero no Template do Site não estiver em Carrossel, um alerta amarelo aparece no topo da página com a mensagem "Carrossel não está ativo". Você ainda pode cadastrar, reordenar e configurar os slides normalmente, mas eles não aparecem no site até alguém abrir Site > Template do Site, ir na seção Hero e selecionar a variante Carrossel. O próprio alerta tem o link Ir para configuração de Templates que leva direto a /admin/template#hero.

Slide do tipo Excursão não tem botão de editar

O ícone de lápis azul só aparece em slides do tipo Imagem Customizada. Em slides vinculados a uma excursão, imagem, título, subtítulo e link são puxados em tempo real da própria excursão (nome, subtítulo do conteúdo ou destino, e a URL pública da excursão). Para mudar qualquer dado de um slide do tipo excursão, edite a excursão de origem ou exclua o slide e cadastre de novo.

Reordenação envia tudo de uma vez

A reordenação por setas atualiza a ordem de todos os slides na mesma requisição (POST /admin/hero-slides/reorder). Não há salvar parcial nem desfazer - assim que você clica na seta, a nova ordem é persistida no banco e a página recarrega.

Excluir é irreversível

A exclusão remove o registro do slide e também o arquivo de imagem do storage público. Não há lixeira nem restauração - para esconder temporariamente, use o toggle Ativo/Inativo.

Erros comuns e como resolver

• Slides não aparecem no site mesmo cadastrados - Causa: o template não está com a variante Carrossel no Hero. Solução: clique em Voltar para Templates ou em Ir para configuração de Templates no alerta amarelo e selecione Carrossel na seção Hero.
• A página recarrega a cada clique nas setas - Comportamento esperado: a reordenação faz uma chamada AJAX e em seguida recarrega para refletir o novo estado do servidor. Não é erro.
• A lista some quando troco para Excursões Automático - Comportamento esperado: a lista Slides Cadastrados existe apenas no modo Manual. Os slides cadastrados continuam salvos no banco - basta voltar para Manual e clicar em Salvar Configurações para vê-los de novo.
• O slide do tipo Excursão sumiu do carrossel - Causa provável: a excursão vinculada deixou de estar com status = publicada ou a data_inicio ficou no passado. Solução: republicar a excursão ou substituir o slide por outro.
• Não consigo editar um slide específico - Causa: o slide é do tipo Excursão, que não tem botão de edição. Solução: exclua e cadastre de novo, ou ajuste os dados direto na excursão de origem.

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 reordenar, alternar status, editar, excluir ou salvar configurações
• Módulo necessário: nenhum

Veja também

• Criar Slide do Hero - cadastrar um novo slide manual com imagem customizada ou vinculado a excursão
• Template do Site - ativar a variante Carrossel no Hero
• Seções da Home - configurar os blocos exibidos abaixo do Hero
• Personalização do Site - visão geral das opções de aparência da vitrine