[Plugin] email_samp for SA-MP and open.mp — SMTP straight from the server

[NullSablex]

? email_samp 1.0.0

E-mail (SMTP) direto do servidor — SA-MP e open.mp, o mesmo binário
Email (SMTP) straight from the server — SA-MP and open.mp, the same binary

Download · GitHub · Documentação

?? Código de registro, recuperação de senha, aviso para a staff: sempre deu para fazer, mas nunca de dentro do servidor. Era requisição HTTP para um script PHP, PHPMailer do outro lado, um serviço externo no meio — três coisas para manter no ar só para mandar um e-mail. Este plugin fala SMTP e TLS por conta própria, e o envio cabe em uma linha.

?? Registration codes, password resets, staff alerts: always doable, never from inside the server. It meant an HTTP request to a PHP script, PHPMailer on the other end, some external service in between — three moving parts just to send one mail. This plugin speaks SMTP and TLS itself, and sending fits on one line.

Code:

email_setup();  // credenciais do .env, do ambiente ou do smtp.ini email_send_to("[email protected]", "Bem-vindo", "Sua conta esta pronta.");

?? Nada trava. Toda native retorna na hora: o e-mail sai em threads separadas e o resultado volta num callback, então relay lento não segura o tick.
?? Nothing blocks. Every native returns at once: mail leaves on worker threads and the result comes back in a callback, so a slow relay never holds the tick.

Code:

email_send_to(email, "Bem-vindo", corpo, "OnMailSent", "d", playerid); Email::OnMailSent(success, playerid) {     SendClientMessage(playerid, -1, success ? ("E-mail enviado.") : ("Falhou."));     return 1; }

---

? Instalar é copiar um arquivo / Installing is copying one file

?? Sem PHPMailer, sem sendmail, sem OpenSSL no sistema: SMTP e TLS estão compilados dentro do binário. Funciona em host compartilhado, onde você não instala nada. E é um arquivo só para os dois servidores:
?? No PHPMailer, no sendmail, no system OpenSSL: SMTP and TLS are compiled into the binary. Works on shared hosting, where you install nothing. One file, both servers:

• SA-MP — ?? em plugins/, nome no server.cfg / ?? in plugins/, name in server.cfg
  
• open.mp nativo — ?? em components/, encontrado sozinho / ?? in components/, auto-discovered
  
• open.mp legacy — ?? o mesmo arquivo em plugins/ / ?? same file in plugins/
  

?? Dois includes: <email_samp> em snake_case e <email_samp_omp> no estilo Email_SendTo, para quem não quer misturar convenção no gamemode.
?? Two includes: <email_samp> in snake_case and <email_samp_omp> in Email_SendTo style.

---

✉️ O texto do e-mail fica num arquivo / The wording lives in a file

?? Quem já mandava e-mail pelo PHP tem o .html pronto — ele serve como está. Ou use um .tpl, que carrega assunto, versão texto e versão HTML juntos:
?? If you already sent mail from PHP, your .html works as-is. Or use a .tpl, which carries subject, text and HTML together:

Code:

[subject] Seu codigo e {codigo} [text] Ola {nome}, seu codigo de verificacao e {codigo}.

Code:

new msg = email_new(); email_add_to(msg, email); email_set_template(msg, "mail/registro.tpl"); email_set_var(msg, "nome", nome); email_set_var(msg, "codigo", "%d", codigo); email_send(msg);

?? Editou o arquivo, o próximo e-mail já sai com o texto novo — sem recompilar, sem reiniciar. E o valor que veio do jogador é escapado sozinho no HTML: nick com <script> chega como texto.
?? Edit the file and the next mail uses it — no recompile, no restart. Player-supplied values are escaped automatically in the HTML part.

---

? E ainda / And also

• ?? Anexo e imagem embutida / ?? Attachments and inline images — ?? arquivo, texto gerado no gamemode, ou imagem que aparece dentro do HTML / ?? a file, data built in the gamemode, or an image shown inside the HTML
  
• ?? Ritmo de envio / ?? Paced for real providers — ?? e-mails por minuto, prioridade e nova tentativa em falha temporária: mailing para a base inteira não atrasa o reset de senha de quem está esperando / ?? rate limit, priorities and retries, so a mailing never delays a password reset
  
• ?? Seguro com o que o jogador digita / ?? Safe with player input — ?? quebra de linha em cabeçalho é recusada (senão um nick vira um Bcc: escondido), endereço é validado de verdade e anexo não sai da pasta do servidor / ?? header injection refused, addresses parsed, attachments sandboxed
  
• ?? TLS obrigatório / ?? TLS required — ?? se o STARTTLS não subir, o envio falha em vez de mandar a senha em texto claro / ?? if STARTTLS fails, the send fails instead of leaking the password
  
• ?? Acentuação intacta / ?? Accents survive — ?? nick acentuado chega certo, não como Jo?o / ?? no more Jo?o
  
• ?? Modo de teste / ?? Dry-run — ?? escreve cada mensagem como .eml em logs/dry-run/ e não conecta: dá para mexer no gamemode sem gastar cota nem mandar e-mail para jogador de verdade / ?? writes each message as an .eml and sends nothing
  

?? Credenciais ficam fora do código: um .env (via env_samp), variáveis de ambiente, uma URL SMTP ou um smtp.ini — as mesmas chaves em qualquer fonte, e nenhuma delas precisa ir para o repositório.
?? Credentials stay out of the source: a .env, the process environment, an SMTP URL or an smtp.ini — the same keys from any source, and none of them has to reach your repo.

---

? Links

• Documentação — ?? instalação, configuração, envio, templates, erros e segurança / ?? installation, configuration, sending, templates, errors, security
  
• Referência da API — ?? as 34 natives, uma a uma / ?? all 34 natives
  
• Exemplos — ?? comece pelo 00_ready_to_send: um gamemode pronto, com o arquivo do e-mail junto / ?? start with 00_ready_to_send
  

?? Projeto independente, mantido por uma pessoa. Não é afiliado, endossado nem patrocinado pelo SA-MP, pelo open.mp ou por qualquer provedor de e-mail citado.
?? Independent project, maintained by one person. Not affiliated with or endorsed by SA-MP, open.mp or any email provider mentioned.

?? Dúvidas, sugestões e relatos de bug são bem-vindos — aqui no tópico ou nas issues.
?? Questions, suggestions and bug reports are welcome — here or on GitHub issues.

⭐ github.com/NullSablex/email-samp