Site - Editar Página

O que é

A tela Editar Página concentra a atualização de uma página do site da agência: título, slug (URL), ícone exibido no menu, conteúdo HTML montado pelo editor visual e o status de publicação. É aqui que você ajusta o texto da página Sobre Nós, atualiza a Política de Cancelamento, troca o banner da página Quem Somos ou tira do ar uma página temporária.

Você costuma chegar nessa tela vinda da listagem Vitrine > Páginas, ao clicar no ícone de edição da linha da página, ou logo após criar uma página nova (quando escolhe Salvar e Continuar Editando no formulário de criação). A cada salvamento o sistema arquiva automaticamente o estado anterior em um histórico de versões - você pode voltar a qualquer versão anterior sem perder o conteúdo atual.

Como usar

1. Vá em Vitrine > Páginas no menu lateral.
2. Localize a página e clique no ícone de lápis na linha correspondente (você cai em /admin/paginas/{pagina}/edit).
3. No bloco principal, ajuste o que precisar:
   • Título - obrigatório, aparece no topo da página pública e na aba do navegador.
   • Slug (URL) - só editável em páginas customizadas; aceita apenas letras minúsculas, números e hífens. Em páginas do sistema e padrão o campo aparece desabilitado com a mensagem "O slug de páginas padrão não pode ser alterado."
   • Ícone do Menu - só aparece em páginas customizadas. Selecione um dos 20 ícones do grid; o ícone marcado fica destacado em azul.
4. Use o editor visual no campo Conteúdo para montar a página:
   • Arraste blocos prontos do painel lateral esquerdo (categorias como hero, texto, galeria, CTA, FAQ etc.).
   • Formate textos pelo grupo de botões da barra superior (negrito, itálico, alinhamento, listas, links).
   • Use Desktop / Tablet / Mobile no canto superior esquerdo para ver como a página fica em cada largura.
   • Use Desfazer / Refazer (Ctrl+Z, Ctrl+Y) para reverter mudanças no editor antes de salvar.
   • Clique em Tela cheia para focar só no editor.
5. Marque ou desmarque o toggle Página ativa no fim do bloco para publicar ou despublicar a página.
6. Confira o painel inferior com Tipo, Criada em, Atualizada em e Status atuais.
7. Clique em Salvar Alterações (volta para a listagem) ou em Salvar e Continuar (recarrega o mesmo formulário). O sistema arquiva uma versão antes de aplicar a mudança e limpa o cache de páginas para o menu público refletir o novo estado.

Casos especiais

Páginas do sistema e padrão

Páginas marcadas como Sistema (ex: páginas internas obrigatórias) ou Padrão (Termos de Uso, Política de Privacidade, Política de Cancelamento, Sobre Nós) exibem uma faixa amarela no topo do formulário:

• Sistema: "Esta é uma página do sistema. Apenas o conteúdo e status podem ser alterados." - campos de slug e ícone ficam ocultos ou bloqueados.
• Padrão: "Esta é uma página padrão. O slug não pode ser alterado." - você edita conteúdo e título normalmente, mas a URL original permanece.

Se a página tem editavel = false, o sistema bloqueia a edição e mostra "Esta página não pode ser editada." ao tentar abrir o formulário.

Visualizar a página pública

Quando a página está com Página ativa marcado, aparece o botão Visualizar (ícone de olho) no cabeçalho. Ele abre /{slug} em uma nova aba para você conferir o resultado final, com placeholders já resolvidos (WhatsApp da sua empresa, nome da empresa, telefone, e-mail e título da página são substituídos automaticamente no HTML).

Histórico de versões e restauração

O botão Versões (ícone de relógio) na barra superior do editor abre o modal Histórico de Versões, que lista até 15 versões salvas com número sequencial, autor e data. O fluxo de restauração:

1. Clique em Versões na barra do editor.
2. No modal, clique em uma versão para abrir o painel de pré-visualização (aparece à direita com o conteúdo daquela versão dentro de um iframe).
3. Confira o conteúdo. Se for o que você quer, clique em Restaurar esta versão (botão verde no rodapé do painel).
4. Confirme no modal de aviso "Tem certeza que deseja restaurar esta versão? O conteúdo atual será substituído."
5. O sistema arquiva uma nova versão do estado atual (para você poder desfazer a restauração depois), aplica o conteúdo restaurado e atualiza o editor.

O sistema mantém no máximo 15 versões por página. Ao criar a 16ª, a versão mais antiga é apagada automaticamente.

Editor visual (GrapeJS)

A rota alternativa /admin/paginas/{pagina}/edit-visual abre o editor GrapeJS - uma experiência drag-and-drop mais robusta para usuários que preferem montar a página como em um construtor visual. O salvamento usa o mesmo endpoint PUT /admin/paginas/{pagina} e dispara o mesmo versionamento e limpeza de cache.

Publicar e despublicar sem editar conteúdo

Se você só quer tirar do ar ou voltar a publicar, não precisa abrir o editor: na listagem, use o toggle de status da linha (chama o endpoint PATCH /admin/paginas/{pagina}/toggle). A mudança limpa o cache do menu imediatamente.

Páginas com placeholders dinâmicos

O conteúdo HTML pode incluir placeholders que o sistema substitui em tempo de exibição (não no editor): {{TITULO_PAGINA}}, {{EMPRESA_NOME}}, {{EMPRESA_TELEFONE}}, {{EMPRESA_EMAIL}}, {{WHATSAPP_LINK}}, {{WHATSAPP_NUMERO}} e {{WHATS_TENANT}} (link de WhatsApp já com mensagem "Gostaria de tirar uma dúvida sobre [título da página]"). Os placeholders aparecem como texto no editor, mas viram valores reais quando o cliente abre a página pública.

Erros comuns e como resolver

• "O título é obrigatório." - Causa: o campo Título ficou vazio. Solução: preencher o título antes de salvar.
• "O conteúdo é obrigatório." - Causa: o editor visual está sem nenhum bloco/texto. Solução: arrastar pelo menos um bloco ou digitar texto antes de salvar.
• "O slug deve conter apenas letras minúsculas, números e hífens." - Causa: o slug informado tem espaço, acento ou caractere especial. Solução: ajustar para algo como politica-cancelamento.
• "Este slug já está em uso." - Causa: outra página da mesma agência já ocupa esse slug. Solução: escolher outro slug ou deixar em branco para o sistema gerar um único a partir do título.
• "Esta página não pode ser editada." - Causa: a página tem editavel = false (geralmente páginas de sistema internas). Solução: abrir a versão pública e ajustar pelo módulo correspondente, ou liberar a edição via banco/seed (somente desenvolvedor).
• "Versão não encontrada" - Causa: tentativa de restaurar uma versão que pertence a outra página (link manipulado). Solução: voltar pelo botão Versões e escolher uma da lista exibida.

Onde encontrar

• URL: /admin/paginas/{pagina}/edit
• Editor visual alternativo: /admin/paginas/{pagina}/edit-visual
• Caminho no menu: Vitrine > Páginas > ícone de lápis na linha da página
• Permissão necessária: editar as configurações (a listagem exige ver as configurações)
• Módulo necessário: nenhum

Veja também

• Criar Página
• Páginas Customizadas
• Menu do Site