Monzur Mailer wordpress plugin documentation

Monzur Mailer - Documentation

Version: 1.3.0 | Author: Monzur Rahman | Support: wordpress.org Forum

A) Introduction

Thank you for choosing Monzur Mailer! This comprehensive documentation will guide you through installing, configuring, and using the plugin to send professional emails directly from your WordPress dashboard.

Monzur Mailer is a robust email solution designed for WordPress administrators to compose and send styled emails with ease. It offers recipient targeting, reusable templates, SMTP support, and detailed logging, making it ideal for newsletters, announcements, and WooCommerce customer communication.

Successful email delivery depends on proper server configuration, DNS authentication (SPF, DKIM, DMARC), and a reliable SMTP service. This guide includes detailed setup instructions using NameSilo (DNS provider) and Brevo (SMTP provider) as references.

For support, visit our Wordpress item page. Ensure you review the Email Deliverability Setup section to maximize email success rates.

B) Key Features

C) Requirements & Dependencies

Minimum Requirements

Dependencies & Limitations

Monzur Mailer relies on external factors for successful email delivery:

Failure to configure DNS records or SMTP settings may result in emails being rejected or sent to spam. Follow the Email Deliverability Setup section carefully.

D) Installation

Before installing, ensure your server meets the requirements and download the plugin ZIP file from wordpress.org.

Method 1: WordPress Admin Upload (Recommended)

  1. Log in to your WordPress Dashboard.
  2. Go to Plugins > Add New.
  3. Click Upload Plugin at the top.
  4. Click Choose File and select monzurmailer.zip.
  5. Click Install Now.
  6. After installation, click Activate Plugin.

Method 2: FTP Upload

  1. Unzip monzurmailer.zip to get the monzurmailer folder.
  2. Connect to your server using an FTP client (e.g., FileZilla).
  3. Navigate to wp-content/plugins/ in your WordPress installation.
  4. Upload the monzurmailer folder.
  5. In your WordPress Dashboard, go to Plugins.
  6. Find monzurmailer and click Activate.
After activation, configure SMTP and DNS settings in the Email Deliverability Setup section to ensure emails are sent successfully.

E) Email Deliverability Setup

To ensure emails sent via Monzur Mailer reach recipients’ inboxes, you must configure DNS records (SPF, DKIM, DMARC) and an SMTP service. Email delivery generally will work after setup of SPF and DKIM. We recommend brevo.com or SendGrid (free plan: 100 emails/day). For SendGrid - Host: smtp.sendgrid.net, Port: 587, Username: apikey, Password: [Your API Key], Encryption: TLS. Alternatively, use Google Workspace (smtp.gmail.com, Port 587, TLS) for low-volume emails. Avoid "noreply" addresses in the From Email field above to improve deliverability. This section provides step-by-step instructions using NameSilo (DNS provider) and Brevo (SMTP provider) as examples. For other providers, consult their documentation, but the principles remain similar.

Since February 2024, Gmail, Yahoo, and other providers require SPF and DKIM for bulk senders. Misconfigured DNS or SMTP settings may cause emails to be rejected or marked as spam.

1. Setting Up SPF Record (NameSilo)

The SPF (Sender Policy Framework) record authorizes Brevo to send emails for your domain (e.g., onepagereview.com).

  1. Log in to NameSilo and go to Domain Management > Manage DNS for your domain.
  2. Click Add/Edit Record.
  3. Enter:
    • Type: TXT
    • Name: @ (or leave blank for root domain)
    • Text: v=spf1 include:_spf.sib.com ~all (Brevo only)
      OR
      v=spf1 include:_spf.sib.com include:_spf.mail.hostinger.com ~all (if using Hostinger email)
    • TTL: 3600 (default)
  4. Click Submit.
  5. Wait 24–48 hours for DNS propagation.
  6. Verify with MX Toolbox:
    • Search spf:yourdomain.com.
    • Ensure include:_spf.sib.com appears with no errors.
Only one SPF record is allowed per domain. Merge includes if using multiple email services (e.g., Hostinger and Brevo).

2. Setting Up DKIM Record (NameSilo & Brevo)

DKIM (DomainKeys Identified Mail) adds a digital signature to verify email authenticity. Brevo supports both manual and automatic domain authentication to set up DKIM.

Check the below tutorial for more details: Brevo Domain Authentication Guide

Note: DNS changes take 24–48 hours to propagate globally. Test deliverability only after this period. If automatic authentication fails, use the manual method or contact Brevo support.

3. Setting Up DMARC Record (NameSilo)

DMARC (Domain-based Message Authentication, Reporting, and Conformance) defines how to handle emails failing SPF/DKIM checks. Since February 2024, Gmail, Yahoo, and Microsoft require DMARC for bulk senders to ensure compliance and improve deliverability. If Brevo’s automatic authentication added a DMARC record, verify it in NameSilo’s DNS settings. If no DMARC record exists, add one manually.

  1. In NameSilo, go to Manage DNS and add:
    • Type: TXT
    • Name: _dmarc
    • Text: v=DMARC1; p=none; rua=mailto:rua@dmarc.brevo.com
    • TTL: 3600
  2. Click Submit.
  3. Wait 24–48 hours for DNS propagation.
  4. Verify with MX Toolbox:
    • Search dmarc:yourdomain.com.
    • Expect a valid DMARC record.
  5. Create dmarc-reports@yourdomain.com to receive reports.
Start with p=none for testing. After confirming deliverability, consider p=quarantine or p=reject for stricter enforcement. DNS changes take 24–48 hours to propagate.

4. Verifying Sender Email (Brevo)

Brevo requires verifying the sender email to authorize sending.

  1. In Brevo, go to Account Dropdown > Senders, Domains & IP > Senders.
  2. Click Add a sender.
  3. Enter From Email (e.g., no-reply@yourdomain.com) and From Name (e.g., “Your Site Name”).
  4. Click Save.
  5. Check your email for a 6-digit code and enter it in Brevo.
  6. Confirm a green checkmark next to the sender.
sender email setup
If DKIM is set up, sender verification may be optional. Use the same From Email as in Monzur Mailer Settings tab.

5. Configuring SMTP in Monzur Mailer

Enable SMTP in Monzur Mailer for reliable email delivery.

  1. In Brevo, go to Account Dropdown > SMTP & API.
  2. Copy SMTP Login and SMTP Key (regenerate if needed).
  3. In WordPress, go to Monzur Mailer > Settings.
  4. Check Enable SMTP and enter:
    • Host: smtp-relay.brevo.com
    • Port: 587 (or 465 for SSL, 2525 as fallback)
    • Username: [Brevo SMTP Login]
    • Password: [Brevo SMTP Key]
    • Encryption: TLS
  5. Click Save Changes.
  6. Send a test email from Settings > Send Test Email to verify.
Contact your hosting provider to ensure ports 587, 465, and 2525 are open for smtp-relay.brevo.com.

F) Getting Started - The Admin Interface

After installation and deliverability setup, configure Monzur Mailer via the Monzur Mailer menu in your WordPress dashboard. The plugin has four tabs: Composer, Settings, Email Logs, and Templates.

1. Composer Tab

Compose and send emails using the rich text editor.

composer tab

2. Settings Tab

Configure global email settings and SMTP.

settings tab

3. Email Logs Tab

View the last 50 sent emails.

Email logs

4. Templates Tab

Create and manage reusable email templates.

N.B.: The html and body tags are eliminated automatically when saving an email template. You are suggested to use the code of between body tag . i.e. <body> This Code only</body> when using code in the Message portion and in code editor.

G) For Developers (Hooks & Filters)

Monzur Mailer includes WordPress filters for customization. Add these to your theme’s functions.php or a custom plugin.

Filter: wpqm_mail_subject

Modify the email subject before sending.

add_filter('wpqm_email_subject', 'prepend_sitename_to_subject', 10, 1);
function prepend_sitename_to_subject($subject) {
    $site_name = get_bloginfo('name');
    return '[' . $site_name . '] ' . $subject;
}

Filter: wpqm_mail_message

Modify the email body.

add_filter('wpqm_email_message', 'add_custom_disclaimer_to_message', 10, 1);
function add_custom_disclaimer_to_message($message) {
    $disclaimer = "
This email is confidential.
";
    return $message . $disclaimer;
}

Filter: wpqm_mail_headers

Modify email headers.

add_filter('wpqm_email', 'add_custom_mail_header', 10, 1);
function add_custom_mail_header($headers) {
    $headers[] = 'X-Mailer: monzurmailer-Custom';
    return $headers;
}
Use filters cautiously to avoid breaking email functionality.

H) Troubleshooting Questions & Answers

Q: Why are my emails going to spam folders?

This is usually due to missing DNS records or SMTP configuration, poor sender reputation, spammy content, or low engagement/unfamiliar sender/domain.

Q: I used Brevo’s automatic authentication, but emails aren’t sending or are going to spam. What’s wrong?

Automatic authentication simplifies DNS setup, but issues may still occur.

Q: I see “Failed” in Email Logs. Why?

This indicates wp_mail() couldn’t send the email, likely due to server or SMTP issues.

Q: Can I test the Spammyness of my Emails or setup?

Verify email setup in Monzur Mailer's settings and test with a free tools like Mail-Tester.

We don't guarantee the service of those third party tools but we found it working

Q: Can I use Monzur Mailer without SMTP?

Yes, but PHP mail() is less reliable and often blocked by hosts or filtered by recipients. SMTP (e.g., Brevo) is strongly recommended.

Q: Why is my test email not sending?

Possible causes: incorrect SMTP settings, blocked ports, or unverified sender/domain. Follow the Email Deliverability Setup section and check logs.

I) Changelog

--- 1.3.0 (Current) ---

--- 1.2.0 ---

J) Support

We don't offer dedicated support via wordpress.org forum comments and support sections for Monzur Mailer.

Include the following when requesting support:

Check the Troubleshooting/FAQ section before contacting support.

K) Credits

Monzur Mailer was developed with passion, adhering to WordPress coding standards and leveraging core functions like wp_mail().

About Author: I’m a passionate web developer who loves making WordPress premium features accessible for free. I work as a freelance web developer and WordPress expert, and I’ve been exploring WordPress for over a decade. Still learning every day, I enjoy working with WordPress, cPanel, and website maintenance. if you face any technical difficulties when using this plugin you can contact me: monzurbcc@gmail.com . I will try to help you when i get a chance. But remember that's not the guarantee of this plugin, just friendly little work .