SMTP Mailer Setup

Nathan Paton edited this page Feb 10, 2016 · 3 revisions

Improve email delivery or send emails from a remote mail server with the included SMTP Mailer module. You can install this module from the Administration Panel => Modules => Add & Manage.

Why use the SMTP Mailer?

Dolphin sends emails via PHP's mail() function by default. This works 99% of the time, but means the sender is unauthenticated, which many mail servers frown upon and treat differently. This can impact delivery time or lead to some messages being delivered into spam folders.

To resolve this, Dolphin can connect directly to the SMTP server via the SMTP Mailer and send emails as an authenticated user instead.

Another reason to use the SMTP Mailer is if your email is handled on a remote server (e.g., FastMail or Google Apps), or if you want to use a different provider for site emails, like SendGrid. The SMTP Mailer makes this easy to setup and use.

Crash Course

Let's dive into the options available in the module. After installing, open from the Administration Panel => Modules => SMTP Mailer:

Unknown-1.png

  • Enable SMTP Mailer: Turn the SMTP Mailer on or off. Great for if you need to temporarly send emails via PHP mail() instead of the SMTP connection (e.g., if the remote SMTP server is down).
  • SMTP Authentication: Most SMTP servers and accounts will require you to authenticate with the email address and password. If unsure, Check.
  • SMTP Username: Your account username. This is usually the full email address, such as admin@mydomain.com.
  • SMTP Password: Your account password. If "SMTP Authentication" is checked (and it normally is), this must be filled in.
  • SMTP Server: The hostname or IP address of the SMTP server. If you're hosting Dolphin on the same server as the email account, use localhost. If not, check with your host or email provider for the correct information.
  • SMTP Port Number: The SMTP port number. This is normally 25 for standard SMTP (unencrypted). For SSL, use 465. For TLS, use 587. (See below for encryption options.) Some providers may use a non-standard port, such as 26. Check with your host or email provider if unsure.
  • Secure Connection: Whether or not the SMTP connection is encrypted. For standard, unencrypted SMTP, select "Not Secure". For SSL, select "SSL." For TLS, select "TLS." Make sure to also set the correct port number.
  • From Name: The "From" sender of the email, e.g., "Bob Loblaw". It's recommended to set this to your site name if unsure.
  • Default Sender Address: You can optionally have the sender appear as a different address (e.g., a reply-to address). This is normally not recommended, and should be set to the "SMTP Username" address.
  • Attach Files: You can have the SMTP Mailer attach whatever files are in the modules/boonex/smtpmailer/data/attach directory to all emails. This is normally not needed, so should be kept disabled.

After making all adjustments to the above options, click the blue "Save" button. You should be all setup. To check if everything is correct, use the test form below the module options to send out a test email:

Screen Shot 2016-02-10 at 12.33.37 AM.png


Common Setups

Here are some common setups for use with some popular email providers.

FastMail

  • SMTP Authentication: Checked
  • SMTP Username: [email address]
  • SMTP Password: [password]
  • SMTP Server: mail.messagingengine.com
  • SMTP Port Number: 465
  • Secure Connection: SSL
  • Default Sender Address: [email address]

Note: Replace these with your real FastMail address and password. More information on connection settings is available here.

Gmail

  • SMTP Authentication: Checked
  • SMTP Username: [email address]
  • SMTP Password: [password]
  • SMTP Server: smtp.gmail.com
  • SMTP Port Number: 587
  • Secure Connection: TLS
  • Default Sender Address: [email address]

Note: Replace these with your real Gmail address and password. Google has limits on the amount of email that can be sent per day. More information is available here.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.