Site - Textos do Site

O que é

A página Textos do Site centraliza a edição de todos os textos curtos que aparecem no site público da sua empresa: rótulos de botões, títulos de seção, placeholders de busca, mensagens de erro/sucesso, badges e o microcopy em geral. Os textos ficam organizados em 13 grupos temáticos (Global, Menu de Navegação, Rodapé, Página Inicial, Excursões, Ingressos, Contato, Sobre Nós, Depoimentos, Perguntas Frequentes, Vídeos, Guias e Mensagens do Sistema), cada um navegado por uma aba separada.

O proprietário ou gerente costuma chegar aqui quando quer adequar o tom de voz do site à marca, traduzir termos genéricos para o vocabulário do nicho da empresa (por exemplo, trocar "Reservar Agora" por "Garantir Vaga"), ou ajustar mensagens automáticas que aparecem em momentos sensíveis - como excursão esgotada, alerta de últimas vagas ou confirmação de reserva. Na primeira visita a você, a página cria automaticamente o conjunto completo de textos padrão.

Como usar

1. Vá em Vitrine > Textos do Site no menu lateral. A URL é /admin/textos.
2. Escolha o grupo que quer editar nas abas no topo. A aba ativa fica destacada em azul. Em mobile, use o seletor único acima do conteúdo.
3. Para cada texto exibido na grade (dois por linha em telas grandes, ocupando linha inteira para textos longos), edite o valor no campo:
   • Texto curto - input de uma linha.
   • Texto longo / HTML - textarea de três linhas.
4. Para reverter um texto ao valor original, clique no ícone de seta circular ao lado do rótulo. O campo recebe o valor padrão e fica destacado em azul por 1 segundo (a alteração ainda não foi salva - é necessário confirmar no passo seguinte).
5. Clique em Salvar Alterações na barra inferior. O botão só fica habilitado depois de detectar mudança em algum campo. Após salvar, o cache de textos da sua empresa é reconstruído automaticamente e as alterações já aparecem no site público.

Casos especiais

Placeholders dinâmicos {total}, {vagas} e outros

Alguns textos aceitam tokens entre chaves que são substituídos pelo sistema na renderização do site. Os principais são {total} (total de excursões realizadas, usado no badge do hero da home) e {vagas} (número de vagas restantes, usado no alerta "Últimas {vagas} vagas!" do grupo Mensagens do Sistema). Manter o token na frase é obrigatório para o número aparecer - se você apagar {vagas}, o site mostra a frase sem o número.

Primeira vez na sua empresa (textos padrão)

Quando uma empresa ainda não tem nenhum registro em site_textos, abrir esta página dispara a criação automática de todos os textos padrão (mais de 100 entradas distribuídas pelos 13 grupos). Não é preciso rodar seeder nem comando - a página se encarrega disso na primeira visita.

Grupo sem textos cadastrados

Se um grupo aparecer vazio (situação rara, apenas após edição manual no banco), a tela mostra o estado "Nenhum texto cadastrado" com o ícone de documento. Para repovoar, basta navegar para qualquer outro grupo e voltar - o controlador checa o total de textos da sua empresa e recria os padrões quando necessário.

Campos em branco

Se você apagar todo o conteúdo de um texto e salvar, o sistema grava string vazia (o campo valor na tabela é NOT NULL - o controlador converte null para '' automaticamente). Isso pode quebrar visualmente seções do site que esperam um valor. Use o ícone de restaurar padrão para recuperar o texto original em vez de salvar vazio.

Cache de textos

Após salvar, o método SiteTexto::reconstruirCache() limpa todas as chaves de cache da sua empresa (site_texto:*, site_textos_grupo:*, site_textos_todos:* e o legado tenant_textos_*). Os helpers do frontend (t(), texto()) reabastecem o cache na próxima requisição. Se uma alteração não aparecer no site, force um hard refresh (Ctrl+Shift+R) - o navegador pode estar com a página antiga em cache.

Erros comuns e como resolver

• "Esta ação não é autorizada." - Causa: usuário não tem a permissão de editar as configurações (necessária para o PUT /admin/textos). Solução: o proprietário precisa conceder a permissão em Sistema > Perfis de Acesso ou usar um usuário com papel Proprietário ou Gerente.
• Botão "Salvar Alterações" não habilita - Causa: o componente x-form-actions só ativa o salvar quando detecta diferença em algum campo. Solução: edite efetivamente algum texto ou clique no ícone de restaurar padrão de qualquer item para forçar a detecção.
• Texto salvo mas o site ainda mostra o antigo - Causa: cache do navegador ou CDN. Solução: faça hard refresh (Ctrl+Shift+R) no site público ou aguarde alguns segundos - o cache do servidor já foi invalidado automaticamente ao salvar.
• {vagas} ou {total} aparecem literais no site - Causa: o token foi escrito errado (sem as chaves, com espaço dentro, ou removido). Solução: restaure o padrão do texto e copie o token tal como aparece ({vagas}, {total}) na nova versão.
• Aba escolhida volta sozinha para "Global" ao recarregar - Causa: a URL não tem ?grupo=, então o controlador assume global por padrão. Solução: salve o link com ?grupo=NOMEDOGRUPO (ex.: ?grupo=footer) para abrir sempre no grupo desejado.

Onde encontrar

• URL: /admin/textos
• Caminho no menu: Vitrine > Textos do Site
• Permissão necessária: ver as configurações (visualizar) e editar as configurações (salvar)
• Módulo necessário: nenhum

Veja também

• Menu do Site
• Páginas Customizadas
• Seções da Home
• Personalização do Site
• Identidade Visual