segunda-feira, 25 de agosto de 2008

Envio de email no Mantis facil, facil

Uma duvida comum, mas um item muito necessário para o funcionamento e retorno da aplicação do Mantis é o envio de emails.
Sempre que inserimos um usuário, por padrão o Mantis envia um email para este usuário com um link para que ele possa cadastrar sua senha. Veremos como funciona esta forma e outra onde não necessitamos dessa intervenção do usuário.
Vamos seguir alguns passos básicos para a habilitação do envio de email e outras configurações relacionadas.
Nesse exemplo eu utilizo o Mantis 1.1.2 rodando sobre um WAMPServer.
Habilitando o envio de email
Para habilitar o envio de emails é necessário termos acesso a um endereço de smtp, usuário e
senha para ele. Partimos do principio que temos essa informação.
Acesse o diretório em que se encontra o Mantis, no meu caso é C:\wamp\www\mantis-1.1.2
e abra o arquivo
config_defaults_inc.php. Como já sabemos esse é o arquivo de configuração padrão do Mantis.
Copie as quatro variáveis que são as exibidas na imagem acima e cole no arquivo config_inf.php:
·
  • $$g_phpMailer_method
  • $g_smtp_host
  • $g_smtp_username
  • $g_smtp_passoword
·


Altere os valores das variáveis para os indicados na imagem.
Colocamos a variável
$g_phpMailer_method com o valor 2, pois ele é o valor referente ao envio de email por endereços SMTP.
Salve o arquivo e pronto! Sua configuração de email estará OK!
Como identificamos quando não está ou não OK?
Para testar, podemos criar um usuário com o seu email, para que você possa receber esse email de cadastro. Para isso crie um usuário no Mantis com o seu email.
Saberemos se ele não está OK se, obviamente, não recebermos o email de confirmação do cadastro e se é apresentado alguma mensagem de erro no topo da pagina para qualquer ação que envie emails (criação de usuário, reset de senha, alteração de status de projeto, cadastro de bugs).


Quando o email estiver OK receberemos um email informando sobre a ação executada. O exemplo
abaixo refere-se a validação de cadastro de um novo usuário.


Abaixo um exemplo de um email quando um bug é atribuído a uma pessoa:


Note na primeira imagem que recebemos um email de “Mantis Bug Tracker” com o assunto “[Nome_projeto + Codigo_projeto]: Sumario_projeto”
Dentro do email enviado temos todas as informações pertinentes ao bug.
Alterando alguns parâmetros referentes a bugs
Temos mais algumas variáveis dentro do arquivo config_defaults.php que trabalham alterando alguma configuração no email. São elas:
Linha do arquivo
Variável
Descrição
173
$g_allow_signup
Habilita os usuários a acessarem a aplicação por
suas contas
187
$g_send_reset_password
Quando ON o Mantis envia um email informando que a
troca de senha é necessária. Se OFF a senha é colocada em branco
221
$g_administrator_email
Endereço de email do administrador. É utilizado pelo
administrador do sistema para erros que possa requerer alguma ação do mesmo.
222
$g_webmaster_email
Email do webmaster. Este é apresentado sempre no rodapé da
aplicação
225
$g_from_email
O endereço de email para ser usado como a fonte de
todos os e-mails enviados por Mantis
228
$g_from_name
Nome do usuário de quem enviou. Por padrão vem
“Mantis Bug Tracker”
231
$g_return_path_email
E-mail para receber emails
236
$g_enable_email_notification
Defina ON para permitir notificações de e-mail, OFF
para desativá-los. O padrão é ON
278
$g_default_notify_flags
Configurações de envio de email quando um bug é
aberto. Geralmente não precisamos alterar este valor.
291
$g_notify_flags['new']
Envio de notificação quando bug é aberto. O que está
dentro de colchetes é o status que ira disparar o email e o array identifica
os tipos de ações.
295
$g_email_receive_own
Se deseja receber email da suas próprias ações na
ferramenta
298
$g_validate_email
Quando ON valida o email
299
$g_check_mx_record
Não utilizados no Windows (tbm não sei o que faz :P)
305
$g_allow_blank_email
Permite que o usuário não informe seu email durante
o cadastro
310
$g_limit_email_domain
Somente envia emails para usuários que tenham o
domínio especificado
313
$g_show_user_email_threshold
Especifica o nível de acesso necessário para lincar
usuários com links mailto:
318
$g_mail_priority
Especifica o nivel de prioridade. 1: Urgente, 5: Não
urgente e 0: Desabilitado
343
$g_email_send_using_cronjob
Sheduler que controla o envio de emails. Quando
executamos uma ação o envio de email é efetuado e depois o usuário pode
efetuar alguma ação. O scheduler envia os emails de 5 em 5 minutos
349
$g_email_set_category
Adiciona a Categoria do projeto no assunto do email
Mais informações sobre notificação de emails:
Como funciona as configurações de email na aplicação?
Dentro da aplicação depomos configurar quem recebe emails quando alguma ação é executada na
ferramenta. Basicamente temos quatro ações macros e os perfis de acesso. Acessamos a configuração de email no link “Manager Configuration/Email Notification
Se quiser, por exemplo que o usuário de perfil reporter receba um email quando uma nota for
adicionada é só marcar a caixa de seleção referente aos dois itens. Estas alterações só podem ser feitas pel administrador do Mantis.



Por enquanto é só pessoal. Qualquer duvida postem um comentário. Abraços

10 comentários:

  1. Oi Elias!
    Eu to tentando resolver esse problema do envio de e-mails ha um tempo ><
    Eu fiz tudo isso que você falou, mas não deu certo :/
    Ele não dá erro, mas também não manda os e-mails!
    O que eu devo fazer?

    ResponderExcluir
  2. Oi Cindy!
    Tu tem que dar uma olhada se o servidor de emails tem conexão segura (SSL) ou utiliza a porta padrao (porta 25).
    No exemplo estou levando em consideração que o servidor usa as portas padrão para o envio de email.

    ResponderExcluir
  3. Oiii
    consegui!
    estava na porta padrão sim =D
    Só que eu escrevi errado o $g_smtp_host, aí claro que não ia dar hahaha
    Obrigada!

    ResponderExcluir
  4. Olá Elias!
    Estou testando o Mantis, instalado no Windows XP e no IIS, porém não consigo enviar e-mails.
    O servidor de emails não tem conexão SSL e a porta é a porta padrão.

    Já tentei todas as configurações possíveis. Você poderia me ajudar?

    ResponderExcluir
  5. Oi Elias! Li no início da sua postagem que existe uma outra forma de configurar a senha dos usuários do Mantis sem a intervenção destes (sem envio de emails?). Gostaria de aprender esta forma alternativa!
    Instalamos o Mantis numa máquina comum para funcionar como servidor, mas não temos nada configurado para o envio de emails. Agradeço toda ajuda!

    ResponderExcluir
  6. Lidy...
    No arquivo "config_defaults_inc.php" tem uma variável chamada "$g_send_reset_password". Copie essa variável para o arquivo "config_inc.php" e coloque o seu valor como "OFF".
    No momento da criação do usuário os campos de Senha e Confirmação de senha estarão presentes. Você pode colocar uma senha para ele ou simplesmente deixar em branco.
    Até mais!

    ResponderExcluir
  7. Olá Elias,

    Tenho dois problemas no mantis sobre o envio de emails.

    1-Seleciono as opções de Níveis de Acesso em Notificações por Email e o Mantis não está gravando.

    2-A empresa alterou o provedor de email do terra para o uol e fiz as alterações nos arquivos de configurações (PHP) porem quando o mantis envia um email de notificação, ele envia emails de casos antigos também.

    Você tem idéia do que está acontecendo ??? Me ajude por favor !!!

    Obrigado !!!

    Claudio.

    ResponderExcluir
  8. Oi Mukito,
    Sobre o Mantis não gravar os níveis de acesso em Notificação veja se a combo de "Who can change the notification" é realmente voce (seu grupo). senão tu não consegue alterar mesmo.

    Sobre o Mantis enviar e-mail dos casos antigos pode ser o que não foi enviado durante a tua alteração na configuração de emails.
    Estes emails sempre são enviados ou tu recebeu somente alguns?

    ResponderExcluir
  9. Olá Elias,

    Primeiramente agradeço sua ajuda.

    Os emails que estão sendo enviados pelo mantis, são antigos e realmente eles não foram enviados, quando realizei a alteração do provedor.
    Por acaso existe alguma maneira de parar com esses envios antigos ???

    Gostaria apenas de que o mantis enviasse os emails de hoje em diante !!!

    Em relação à pagina das notificações vou dar uma olhada no combo.

    Muito Obrigado.

    ResponderExcluir
  10. Oi mukito...
    Este é o ponto... todos antigos são enviados ou só os que estão dentro da data que tu alterou as configurações de e-mail?

    ResponderExcluir