voronkovich/wordpress-mailer-dsn

This package is abandoned and no longer maintained. The author suggests using the https://github.com/PopArtDesign/wordpress-mailer-dsn package instead.

WordPress plugin to configure wp_mail() via MAILER_DSN environment variable.

v1.0.1 2024-09-10 09:08 UTC

This package is auto-updated.

Last update: 2024-09-10 09:14:09 UTC


README

CI

WordPress plugin to configure wp_mail() via MAILER_DSN environment variable.

Installation

Use the Composer:

composer require popartdesign/wordpress-mailer-dsn

Don't forget to activate the plugin, if you don't use the mu-plugins directory.

Define (in your .env file for example) the MAILER_DSN variable like this:

MAILER_DSN='mail://localhost'

Configuraton

Supported protocols:

  • mail
  • sendmail
  • qmail
  • smtp
  • smtps

Additional configuration could be applied via query string:

MAILER_DSN='mail://localhost?XMailer=SuperMailer&FromName=CoolSite'

PHPMailer configured by public properties, so you can use any of them. All allowed options could be found at PHPMailer Docs.

Examples

Sendmail

MAILER_DSN='sendmail://localhost?Sendmail=/usr/sbin/sendmail%20-oi%20-t'

SMTP

MAILER_DSN='smtp://user:password@localhost?SMTPDebug=3&Timeout=1000'

Gmail

MAILER_DSN='smtps://user@gmail.com:password@smtp.gmail.com:587'

Advanced

Sometimes it's not convinient to configure all options by the only one MAILER_DSN variable. For example, if you want to configure DKIM, you will end with very long unreadable DSN string. In this cases you can use one of MAILER_* variables:

  • MAILER_DEBUG
  • MAILER_DEBUG_OUTPUT
  • MAILER_FROM
  • MAILER_FROM_NAME
  • MAILER_SENDER
  • MAILER_DKIM_PRIVATE
  • MAILER_DKIM_PASSPHRASE
  • MAILER_DKIM_SELECTOR
  • MAILER_DKIM_IDENTITY
  • MAILER_DKIM_DOMAIN
  • and etc.

See source code for all available vars.

License

Copyright (c) Voronkovich Oleg. Distributed under the MIT.