osumionline/plugin-email-smtp

Plugin OEmailSMTP para Osumi Framework

3.1.0 2025-02-04 11:32 UTC

Requires

• php: >=8.2
• phpmailer/phpmailer: ^6.9.1

MIT

README

Osumi Framework Plugins: OEmailSMTP

Este plugin añade la clase OEmailSMTP al framework con la que se pueden enviar emails usando la librería PHPMailer. Usando esta librería se pueden realizar envíos mediante SMTP con servicios como, por ejemplo, GMail. La consiguración se realiza en el archivo Config.json general de la aplicación.

Configuración

{
  ...,
  "plugins": {
      "email_smtp": {
          "host": "smtp.gmail.com",
          "port": 587,
          "secure": "tls",
          "user": "[e-mail]",
          "pass": "password"
      }
  },
}

Uso del plugin

$email = new OEmailSMTP();

// Remitente
$email->setFromName('User name'); // La dirección del remitente se configura en Config.json
// Añadir destinatarios uno a uno
$email->addRecipient('[e-mail]');
$email->addRecipient('[e-mail]');
// Añadir destinatarios mediante un array
$email->setRecipients(['[e-mail]', '[e-mail]']);
// Añadir destinatario en copia
$email->setCC('[e-mail]');
// Añadir destinatario en copia oculta
$email->setBCC('[e-mail]');
// Asunto
$email->setSubject('Asunto');
// Contenido del email (con HTML)
$email->setMessage('Contenido del email<br>con HTML');
// Contenido del email (texto plano)
$email->setIsHtml(false);
$email->setMessage('Contenido del email con texto plano');
// Adjuntos (uno a uno)
$email->addAttachment('/path/to/file.pdf');
// Adjuntos mediante un array
$email->setAttachments(['/path/to/file.pdf', '/path/to/another_file.pdf']);

// Enviar email
$email->send();

// Tras realizar el envío se puede comprobar la lista de usuarios a los que se les ha enviado y aquellos que han dado error
$usuarios_correctos = $email->getResultOk();
$usuarios_error = $email->getResultError();