Todos os artigos
Tutorial

Como publicar um artigo na Central de Ajuda

Registre o catálogo, a categoria, a Blade, a imagem e os testes antes do deploy para que o artigo seja encontrável e seguro.

Atualizado em 18/08/2026

Uso interno: a Central de Ajuda não possui tela administrativa para criar artigo. A publicação é feita no código e só fica completa quando catálogo, navegação, Blade, imagens, testes e deploy estiverem alinhados.

Antes de começar

Perfil ou permissão: Técnico com acesso ao projeto e ao processo de deploy.

Caminho: Projeto C Controle > config/ajuda_central.php; views/site/ajuda/artigos; tests/Feature/SiteHelpCenterTest.php.

  • Título, público, caminho real, passo a passo e armadilhas revisados.
  • Capturas reais salvas em public/assets/img/ajuda, quando houver tela útil para documentar.
  • Slug em minúsculas, com hífens e sem caracteres especiais.

Os quatro pontos obrigatórios

  1. Catálogo: registre o slug em config/ajuda_central.php, com título, resumo, categoria, palavras-chave, rotas de referência e artigos relacionados.
  2. Navegação: cite o slug em uma seção da categoria. Sem isso o artigo fica órfão: a URL pode existir, mas ele não aparece na categoria.
  3. Conteúdo: crie resources/views/site/ajuda/artigos/{slug}.blade.php no padrão editorial, com pré-requisitos, caminho, passos, alerta e figura real existente.
  4. Testes: atualize os contadores e contratos em tests/Feature/SiteHelpCenterTest.php. A contagem é intencional e protege o catálogo contra publicação incompleta.
Página inicial da Central de Ajuda do C Controle
O artigo precisa aparecer na categoria e na busca, não apenas responder pela URL direta.
Página inicial da Central de Ajuda com busca e categorias no desktop
Print real da Central: depois do deploy, valide a busca, a categoria correta e o card do artigo. Uma URL que abre sozinha não confirma que a publicação está navegável para o cliente.

Imagens e texto

Use somente PNGs presentes em public/assets/img/ajuda/, com legenda e texto alternativo que descrevam a tela. Não use captura de outro fluxo como prova de uma ação e não invente rótulos. Se não houver captura fiel, prefira um passo a passo claro a uma imagem enganosa.

Verificação antes do deploy

  1. Rode php artisan test tests/Feature/SiteHelpCenterTest.php.
  2. Abra a URL do artigo, a categoria e a busca pelo termo principal.
  3. Confirme se o sitemap inclui a nova rota depois da geração normal do projeto.
  4. Rode php artisan ajuda:indexar para o assistente (chat) da Central conhecer o artigo novo. Sem isso, o índice se reconstrói sozinho na primeira visita após o deploy — funciona, mas deixa essa visita lenta.
  5. Faça o deploy somente com os testes da Central aprovados e todos os arquivos necessários incluídos.
Falhas comuns: Blade sem registro resulta em rota não encontrada; registro sem Blade quebra a página; slug sem seção não fica navegável; imagem inexistente quebra o contrato visual. Sempre revise os quatro pontos juntos.

Revisado em: 24/08/2026.

Esse artigo foi útil?

Obrigado pelo retorno!

Sem problemas — fale direto com o nosso suporte que a gente resolve com você:

Chamar no WhatsApp ou ligue (32) 3721-6702