Site - Editar Seção da Home

O que é

A página de edição de seção da Home permite alterar um bloco já cadastrado que aparece na página inicial do site público da sua empresa. Cada seção tem um tipo de conteúdo (Imagem, HTML, Editor de Blocos ou Componentes) e uma posição relativa aos blocos nativos do template (Hero, Excursões, Ingressos, Diferenciais, Depoimentos e CTA).

O usuário costuma chegar aqui depois de criar uma seção e querer ajustar o conteúdo, trocar a posição, ativar/desativar para teste, ou afinar o visual (largura total, espaçamento, cor de fundo). A mesma tela é usada para todos os tipos - os campos de conteúdo trocam dinamicamente conforme o tipo selecionado.

Como usar

1. Vá em Vitrine > Seções da Home no sidebar.
2. Localize a seção desejada na lista e clique no ícone de editar.
3. Ajuste os campos do Card Principal:
   • Título - nome interno da seção, obrigatório. Só aparece no site se a opção "Mostrar título no site" estiver ativa.
   • Tipo de Conteúdo - clique em um dos quatro cartões (Imagem, HTML, Editor de Blocos, Componentes). O bloco de campos abaixo muda conforme a escolha.
   • Posição na Página Inicial - define entre quais blocos nativos a seção aparece (Após o Hero, Após Excursões, Após Ingressos, Após Diferenciais, Após Depoimentos, Após CTA).
4. Preencha os campos de conteúdo conforme o tipo escolhido (ver "Casos especiais" abaixo).
5. No Card Opções de Exibição, ajuste:
   • Mostrar título no site - exibe o Título como heading da seção.
   • Largura total - a seção ocupa 100% da largura da tela (ideal para banners). Ao ativar, libera o toggle de Espaçamento interno.
   • Espaçamento interno - adiciona padding lateral e vertical mesmo com largura total ligada.
   • Cor de fundo - abre o seletor de cor; clique em Limpar para voltar ao fundo transparente padrão.
   • Seção ativa - toggle final. Seções inativas ficam salvas mas não aparecem no site.
6. Confirme em Salvar Alterações na barra inferior. Use Salvar e continuar editando para gravar sem sair da tela.

Casos especiais

Tipo Imagem

Mostra os campos de upload de Imagem (Desktop) e Imagem (Mobile) - Opcional, mais Link (opcional) e Abrir link em (mesma aba ou nova aba). A imagem mobile, se preenchida, substitui a desktop nas telas pequenas. Resoluções recomendadas: 1920x600px para banner full-width, 1200x400px para container, 768x600px para mobile.

Tipo HTML

Abre o editor TinyMCE com botão Inserir Bloco Pronto acima, que dispara o modal de blocos prontos do template para inserir HTML pré-formatado direto no editor.

Tipo Editor de Blocos

Renderiza o componente <x-visual-editor> em modo drag-and-drop dentro de um canvas de 600px, com a barra lateral de blocos disponíveis.

Tipo Componentes

Permite escolher um sub-tipo: Galeria de Fotos (grid ou slider com lightbox), Cards com Imagem, Carrossel de Logos ou Lista de Serviços (ícone + título + descrição). Cada sub-tipo tem seus próprios controles (máximo de colunas, intervalo do slider, altura do logo, etc.). O conteúdo é serializado em JSON no campo oculto conteudo_componente no momento do submit.

Ativar ou desativar sem abrir a edição

Na listagem Seções da Home, o toggle de status chama a rota PATCH /admin/secoes-home/{secaoHome}/toggle e inverte o campo ativo, mostrando o toast "Seção ativada!" ou "Seção desativada!" sem precisar abrir o formulário.

Reordenar seções

A ordem dentro de cada posição é definida arrastando os itens na listagem. O drag-and-drop envia POST /admin/secoes-home/reordenar com a nova sequência de IDs, que reescreve o campo ordem de cada seção da mesma posição.

Excluir seção

A exclusão pela listagem chama DELETE /admin/secoes-home/{secao}. Antes de remover o registro, o sistema apaga também os arquivos imagem e imagem_mobile do disco público. A ação é definitiva.

Preservação de conteúdo no save

Se o tipo da seção não mudou e o conteúdo recebido chega vazio (por falha de serialização do JavaScript, por exemplo), o controller mantém o conteúdo anterior em vez de gravar vazio, registrando um warning em log. Para tipo Componentes, o conteúdo só é aceito se for JSON válido.

Erros comuns e como resolver

• "O título é obrigatório." - Causa: o campo Título ficou em branco. Solução: preencher antes de salvar.
• "O tipo de conteúdo é obrigatório." - Causa: o tipo não chegou no submit (geralmente por manipulação do DOM). Solução: clicar de novo em um dos quatro cartões de tipo.
• "A posição é obrigatória." - Causa: o select de Posição na Página Inicial está vazio ou com valor inválido. Solução: escolher uma das opções listadas.
• "Não foi possível salvar: o conteúdo do componente está vazio ou inválido. Recarregue a página e tente novamente." - Causa: o JSON do tipo Componentes não foi serializado a tempo do submit. Solução: recarregar a página e reconfigurar o componente.

Onde encontrar

• URL: /admin/secoes-home/{secaoHome}/edit
• Caminho no menu: Vitrine > Seções da Home > (selecionar seção) > Editar
• Permissão necessária: ver as configurações para abrir a tela; editar as configurações para salvar, ativar/desativar, reordenar e excluir
• Módulo necessário: nenhum

Veja também

• Seções da Home
• Criar Seção da Home
• Hero Slides - Carrossel
• Template do Site