SMTP Setup Testing and Monitoring

1. Procedure Title

Name of the Process: Setting Up WP Mail SMTP Plugin in WordPress

2. Purpose

Brief Description: To configure the WP Mail SMTP plugin in WordPress for ensuring reliable email delivery from your website. This document includes step-by-step instructions, configurations, and troubleshooting tips for common issues.

3. Scope

Involved Areas: WordPress Administration

4. Responsibilities

Roles and Responsibilities:

• Site Administrator: Responsible for configuring and testing the WP Mail SMTP plugin.
• IT Support: Assists with resolving potential issues related to email d

5. Definitions and Key Terms

Glossary:

• SMTP (Simple Mail Transfer Protocol): A protocol for sending emails over the internet.
• OAuth: A secure authentication method used by email providers.
• SPF/DKIM/DMARC: Email authentication protocols to improve email deliverability and prevent spoofing.

6. Procedure Details

6.1. Preparation and Prerequisites

• Access to the WordPress Admin Dashboard.
• An email service provider (e.g., Gmail, Outlook, etc.).
• Email server credentials or API keys (depending on the service).
• Installed and activated WP Mail SMTP plugin.

6.2 Timeline for Task Completion

• Estimated Time: 20-30 minutes.
• Frequency: Once during setup or as needed for updates.
• Review Schedule: Annually or when plugin updates occur.

6.3. Step-by-Step Procedure

Install and Activate WP Mail SMTP

1. Log in to your WordPress Admin Dashboard.
2. Navigate to Plugins>Add New Plugin>Upload.
3. Make sure to have the SMTP plugin file. You can get it from the GPL Vault account. https://www.gplvault.com/ 
4. Upload the plugin file and then Activate.

Configure WP Mail SMTP Settings

1. Go to WP Dashboard>WP Mail SMTP>Settings in the WordPress Admin Dashboard.
   

 

1. Fill out the following sections:
   a. From Email– Enter the email address you want to send emails from (e.g., [email protected]).
   – Optionally check the box “Force From Email” to ensure all emails use this address.

b. From Name

• Enter the name that should appear as the sender.
• Optionally check the box “Force From Name” to enforce this sender name

c. Mailer Configuration

• Choose a mailer from the following options:
  • Default (PHP) (Not recommended for reliability).
  • SMTP (Requires SMTP server details).
  • Gmail (Requires OAuth configuration).
  • Outlook (Requires OAuth configuration).
  • SendGrid (Requires API key).
  • Mailgun (Requires API key and domain).

Set Up Specific Mailer Configuration

a. SMTP Configuration

1. Select the SMTP option.

2. Fill out the following fields:

   • SMTP Host: Your SMTP server address (e.g., smtp.gmail.com, smtp.office365.com).

   • Encryption: Choose SSL or TLS based on your SMTP provider’s requirements.

   • SMTP Port: Typically 465 for SSL or 587 for TLS.

   • Authentication: Check the box for authentication.

   • SMTP Username: Enter the email address for the SMTP account.

   • SMTP Password: Enter the SMTP password or application-specific password.

b. Gmail Configuration

1. Select the Gmail option.

2. Click Enable OAuth.

3. Create a Google Cloud Platform project:

   • Visit the Google Cloud Console.

   • Create a new project and enable the Gmail API.

   • Set up OAuth consent and credentials.

   • Copy the Client ID and Client Secret.

4. Paste the Client ID and Client Secret into the plugin’s Gmail settings.

5. Save settings and authenticate the plugin with your Google account.

For more instructions in setting up Google Mailer SMTP, follow this documentation:

https://wpmailsmtp.com/docs/how-to-set-up-the-gmail-mailer-in-wp-mail-smtp/ 

c. Outlook Configuration

1. Select the Outlook option.

2. Visit the Microsoft Azure Portal.

3. Register a new application and configure API permissions for Microsoft Graph.

4. Note the Client ID, Tenant ID, and Client Secret.

5. Enter these values in the plugin’s Outlook settings.

6. Save settings and authenticate the plugin with your Microsoft account.

For more instructions in setting up Microsoft 365/Outlook SMTP, follow this documentation:

https://wpmailsmtp.com/docs/how-to-set-up-the-outlook-mailer-in-wp-mail-smtp/

Test Email Functionality

1. Go to WP Mail SMTP > Tools > Email Test.

2. Enter a recipient email address.

3. Click Send Email.

4. Check the inbox of the recipient email to confirm receipt.

6.4. Tools and Resources

• WordPress Admin Dashboard.
• WP Mail SMTP plugin.
• Email provider credentials.
• Documentation: https://wpmailsmtp.com/wordpress-smtp-settings/

7. Safety and Compliance Measures

Applicable Regulations:

• Ensure compliance with organizational email policies.
• Adhere to email provider’s authentication protocols to prevent account suspension.

8. Quality Control and Evaluation Metrics

Performance Indicators:

• Successful email delivery confirmed via test emails.
• Reduced instances of emails landing in spam.

9. Exception and Problem Handling

Common Issues and Solutions:

1. Emails Not Sending

   • Cause: Incorrect SMTP or API configuration.

   • Solution: Double-check the mailer settings and ensure all credentials are correct.

2. Gmail/Outlook Authentication Errors

   • Cause: OAuth credentials are incorrect or not properly configured.

   • Solution: Verify Client ID, Client Secret, and redirect URIs. Reauthenticate the plugin.

3. Emails Going to Spam

   • Cause: Poor email authentication (SPF, DKIM, DMARC not set).

   • Solution: Set up SPF, DKIM, and DMARC records for your domain.

4. Plugin Compatibility Issues

   • Cause: Conflict with another plugin.

   • Solution: Deactivate other email-related plugins and test functionality.

5. SSL/TLS Connection Errors

   • Cause: Outdated SSL certificates or server issues.

   • Solution: Verify that your web host has up-to-date SSL certificates and check the SMTP provider’s requirements.

10. Documentation and Record Keeping

Documentation Requirements:

• Maintain a log of plugin settings and mailer configurations.
• Record test email results and any troubleshooting actions taken.

11. Procedure Review and Update

Review Frequency:

• Annually or when updates are made to WP Mail SMTP or email provider settings.