Site - Páginas Customizadas

O que é

Esta é a tela central de gestão das páginas institucionais do site público da sua empresa. Aqui ficam listadas tanto as páginas que já vêm prontas com o sistema (como "Termos de Uso" e "Política de Privacidade") quanto as que o próprio empresa cria (como "Sobre Nós", "Quem Somos", "Como Funciona", "Contato"). Cada página é classificada em um de três tipos: Sistema (não editáveis), Padrão (editáveis, mas não deletáveis) e Customizada (totalmente editáveis e deletáveis).

O usuário normalmente chega aqui pelo sidebar em Vitrine > Páginas, seja para criar uma nova página, ajustar o conteúdo de uma existente, publicar/despublicar conteúdo do site ou apagar uma página customizada que não é mais necessária. Cada salvamento de página gera automaticamente uma versão histórica (PaginaVersao), permitindo restaurar conteúdos anteriores na tela de edição.

Como usar

1. No sidebar, vá em Vitrine > Páginas.
2. (Opcional) Filtre a lista usando a barra de filtros logo abaixo do header:
   • Buscar por título... - pesquisa por trecho do título da página.
   • Tipo - filtra entre Sistema, Padrão ou Customizada.
   • Status - mostra apenas Ativas ou Inativas.
3. Para cada página da lista, use os botões de atalho no rodapé do card ou o dropdown de ações (três pontinhos no canto direito):
   • Editar - abre o editor de conteúdo (título, slug, ícone, conteúdo). Aparece bloqueado em páginas do tipo Sistema.
   • Ver página / Visualizar - abre a página real no site público, em nova aba. Só disponível para páginas Ativas.
   • Ativar / Desativar - alterna a publicação no site. Páginas desativadas somem do site mas continuam salvas no admin.
   • Excluir - remove a página permanentemente. Disponível apenas para páginas Customizadas. Abre um modal de confirmação.
4. Para criar uma nova página, clique em Nova Página (botão azul redondo no canto superior direito do header).

Casos especiais

Tipos de página e o que cada um permite

A legenda abaixo da lista resume os tipos:

• Sistema (roxo) - páginas internas do sistema. Não podem ser editadas nem excluídas. O botão "Editar" aparece como "Editar (bloqueado)" com cadeado.
• Padrão (azul) - páginas que já vêm prontas com você (ex: Termos de Uso, Política de Privacidade). Podem ser editadas, mas não podem ser excluídas. O slug e o ícone também ficam fixos - só título, conteúdo e status são editáveis.
• Customizada (cinza) - páginas criadas por você. Totalmente editáveis (incluindo slug e ícone) e podem ser excluídas.

Estado vazio com filtros aplicados

Quando os filtros ativos não retornam nenhuma página, a tela mostra o ícone de lupa com a mensagem "Nenhum resultado encontrado" e um link Limpar filtros que volta para a listagem completa. Quando não há nenhuma página cadastrada (sem filtros), aparece o ícone de documento com a mensagem "Nenhuma página cadastrada" e o link Cadastrar primeira página.

Versionamento automático ao editar

Toda vez que uma página é salva na tela de edição, o sistema cria uma nova entrada em PaginaVersao com o conteúdo anterior. Isso permite restaurar versões antigas direto na tela de edição (não nesta listagem). A listagem em si não mostra o número de versões, mas as ações de reordenar ou alternar status não geram nova versão.

Reordenação de páginas

O controller expõe um endpoint reordenar que aceita um array de IDs e atualiza o campo ordem em lote, usado pela ordem que aparece no menu público. A tela atual lista as páginas em ordem fixa (por ordem ASC, depois por título), mas não traz, por enquanto, controle visual de arrastar-e-soltar nesta listagem - a reordenação acontece via outras áreas que consomem o mesmo endpoint.

Cache do menu do site

Ativar, desativar, editar ou excluir uma página dispara uma limpeza do cache tenant_paginas_{tenant_id} para que o menu do site público reflita o novo estado na próxima requisição. Se você acabou de mudar uma página e ela ainda aparece do jeito antigo no site, force um refresh - não é necessário limpar nada manualmente.

Erros comuns e como resolver

• "Esta página não pode ser editada." - Causa: tentativa de editar uma página do tipo Sistema (campo editavel = false). Solução: páginas de Sistema são fixas; se o conteúdo precisa mudar, crie uma página Customizada equivalente.
• "Esta página não pode ser excluída." - Causa: a página é do tipo Sistema ou Padrão (campo deletavel = false). Solução: apenas páginas Customizadas podem ser excluídas; em vez de apagar uma página Padrão, desative-a com o botão Desativar para tirá-la do site.
• "Página ativada com sucesso!" / "Página desativada com sucesso!" - Não é erro, é a confirmação do toggle. Se mesmo após ativar a página não aparecer no site, confira se ela está incluída no menu (Vitrine > Menu do Site) ou aguarde o cache do navegador.

Onde encontrar

• URL: /admin/paginas
• Caminho no menu: Vitrine > Páginas
• Permissão necessária: ver as configurações (para excluir, ativar/desativar e editar é necessário também editar as configurações)
• Módulo necessário: nenhum

Veja também

• Criar Página
• Editar Página
• Menu do Site
• Personalização do Site