O painel é onde o site é tocado no dia a dia: post escrito, texto trocado, imagem enviada, lead lido. Ninguém desenha ele. O Velk gera o painel a partir do theme/site.json: cada página, tipo de conteúdo, formulário e grupo de opções declarado ali vira uma tela, e cada campo vira um campo de edição com o rótulo que você deu. Mudou o arquivo, mudou o painel.
Ele fica em /admin no endereço do site (no seu computador, http://localhost:8080/admin), com o e-mail e a senha criados na instalação.
O que tem no menu lateral
| Área | O que guarda |
|---|---|
| Painel | Quantos itens cada tipo de conteúdo tem, com atalhos para as páginas e as categorias. |
| Estrutura | Páginas (as do site.json e as que o cliente cria quando o tema oferece modelos de página) e Mídia, a biblioteca de imagens e arquivos. |
| Conteúdo | Uma entrada por tipo de conteúdo (blog, cases, serviços), com a contagem e, embaixo, as categorias e tags dele. |
| Formulários | Cada formulário com o número de leads: envios, destinatários, spam e exportação. |
| Loja | Os pedidos, quando a loja está ligada. |
| Opções | Os grupos do site inteiro que o tema declara, como contato, rodapé e menu. |
| Configurações | Usuários e Scripts (códigos de rastreamento), e ainda Membros, Planos & Assinaturas e Idiomas, com a tradução dos textos fixos do tema, quando o site usa. |
Rascunho e publicação
Os itens de um tipo de conteúdo são Rascunho ou Publicado. Num item novo, Criar publica e Salvar rascunho deixa fora do site; depois disso, quem decide é o campo de status. Um visitante que abre o endereço de um rascunho recebe “não encontrado”, enquanto você, logado, vê a página: uma prévia antes de publicar. Página não tem rascunho: o que você salva já está no ar.
As listas abrem com o mais novo primeiro, com busca por título ou endereço e filtro por status. A edição de cada página, e de cada item com endereço próprio, termina numa seção SEO & compartilhamento (veja SEO e sitemap).
Excluir e ordenar
- Exclusão em massa. Nas listas de conteúdo e de categorias, o ícone de lixeira liga um modo de seleção: marque as linhas, ou todas, e exclua de uma vez, depois de uma confirmação. Nada vai para uma lixeira de onde se recupera: apagou, foi.
- Uma ordem escolhida por você. Conteúdo sai do mais novo para o mais antigo, e categorias em ordem alfabética. Para equipe, perguntas frequentes ou uma vitrine de produtos, peça ordem manual: desde a v3.7.5 aparece uma alça de arrastar naquela lista, e o site segue a ordem que você arrasta. As listas mostram 50 linhas por página, e uma linha se move dentro da sua página.
- Dentro da edição. Linhas repetidas (uma lista de serviços) e blocos de página se reordenam arrastando, e a tela de Scripts ordena os scripts do mesmo jeito, dentro de cada posição.
Peça à IA
A página da equipe deve seguir a ordem que a gente escolher, não a data de publicação. Liga a ordem manual no tipo de conteúdo Equipe e confere se o site segue a ordem do painel.
A IA põe o manual_order no site.json. Na primeira vez que a lista abre, a ordem que está na tela é mantida, e o cliente arrasta a partir dali.
No celular
Desde a v3.8.0, o painel funciona no celular: o menu abre por um botão numa barra no topo, os campos de uma linha ficam um embaixo do outro e as tabelas largas rolam para o lado dentro da própria caixa. Desde a v3.9.0, a barra de ferramentas do editor de texto é uma linha só, que rola para o lado, e fica presa no topo da tela enquanto você rola um texto longo.
Usuários e papéis
Os usuários do painel são as pessoas que entram nele. Eles não são os membros do site: quem se cadastra numa área de membros tem o próprio login no site e nunca chega ao painel, e tanto administradores quanto editores podem gerenciar esses membros.
- Administrador: acesso total, incluindo gerenciar usuários.
- Editor: o mesmo acesso, menos gerenciar outros usuários; o editor só vê a própria conta.
Cada conta pode ligar a verificação em duas etapas: além da senha, um código de 6 dígitos enviado ao e-mail da conta. Confirme antes que esse e-mail recebe mensagens; um administrador pode desligar se alguém perder o acesso. A tela de login também tem o link “Esqueci minha senha”, que manda por e-mail um link de redefinição válido por 60 minutos. Os dois dependem do envio de e-mail do site.
Peça à IA
Cria um usuário do painel para a Marina Lopes, marina@lopesarquitetura.example. Gera uma senha temporária forte e me mostra uma vez só; ela troca na conta dela.
A IA roda o bin/velk user:create, que sempre cria um Administrador. Para ela ficar como Editor, troque o papel em Configurações › Usuários.
Idioma e endereço do painel
O painel fala português, inglês e espanhol. O ADMIN_LOCALE, no .env, define o padrão (inglês numa instalação nova; pt deixa em português), e cada usuário pode escolher o próprio idioma na conta dele. Desde a v3.9.1, os campos de SEO embutidos e a tela de Planos & Assinaturas também seguem o idioma do painel.
O ADMIN_PREFIX muda o painel de /admin para um endereço que você escolher. O seu computador e o servidor têm cada um o seu .env: faça a mudança em cada um que você usa.
Peça à IA
A equipe do cliente fala português. Deixa o painel em português para todo mundo e muda o endereço de /admin para /gestao. Depois me diz o novo endereço de login.
A IA muda o ADMIN_LOCALE e o ADMIN_PREFIX no .env. Avise quem edita: os favoritos antigos param de funcionar.
O cliente consegue quebrar o site pelo painel?
O painel preenche os campos que você declarou; a estrutura e o visual ficam no tema, fora do alcance dele. O que o cliente consegue é apagar conteúdo, sem lixeira para recuperar, então mantenha backups.
Esqueci a senha e o site não manda e-mail.
Peça para a IA criar outro administrador com o bin/velk user:create. Entre com ele e defina uma senha nova para a sua conta em Usuários.