Achou algo que não funciona como deveria num dos temas ou extensões? Obrigado por avisar! Um bom relato é metade da correção. Este guia mostra o que incluir para que o bug possa ser reproduzido e consertado rápido.
Antes de reportar
- Atualize. Confira se você está na versão mais recente do projeto: o bug pode já ter sido corrigido. Os changelogs ficam nas tags filhas Corrigido de cada projeto, como em Canela e Chat.
- Limpe o cache. Rode
php flarum cache:clear e recarregue a página com Ctrl + F5.
- Isole. Desabilite as outras extensões e veja se o problema continua. Se ele sumir, conte qual extensão estava em conflito.
- Pesquise. Se já existe uma discussão sobre o mesmo bug, clique em ✋ Eu também e acrescente só o que for novo.
O que incluir
- Título específico: "A linha do tempo some ao abrir uma discussão pelo celular" ajuda mais que "Bug no tema".
- Versões: do projeto, do Flarum e do PHP (o
php flarum info mostra tudo).
- Passos para reproduzir: numerados, a partir de uma página que qualquer pessoa consiga abrir.
- O que você esperava e o que aconteceu.
- Erros: o console do navegador (F12, aba Console) e o log do PHP em
storage/logs/. Cole o texto, não só o print.
- Ambiente: navegador, sistema e se acontece no computador, no celular ou nos dois.
- Prints ou um vídeo curto, quando o problema é visual.
Modelo para copiar
**Projeto e versão:**
**Flarum / PHP:**
**Navegador e dispositivo:**
**Passos para reproduzir:**
1.
2.
3.
**Esperado:**
**Aconteceu:**
**Erros do console ou do log:**
Falhas de segurança
Se o problema expõe dados ou deixa alguém fazer o que não deveria (ver conteúdo privado, passar por cima de permissões, executar código), não poste os detalhes em público. Mande uma mensagem direta para o Ramon pelo chat, e o assunto é tratado antes de ficar visível.
Depois de reportar
Fique de olho nas notificações: posso pedir mais detalhes ou um teste. Quando a correção sair, ela aparece no changelog do projeto.
Pronto? Abra uma discussão em Bugs.
