SMTP Test

SMTP Test helps you proactively monitor email deliverability across multiple WordPress websites. Designed for developers and agencies, this plugin sends automated test emails from child sites to a parent site every week, then checks for delivery using IMAP.

🔹 Child Sites
Send a weekly test email containing a unique token to your chosen inbox.

🔹 Parent Site
Connect to your inbox and scan for test email tokens to confirm delivery.

🔹 Features

• Choose between Parent or Child mode
• Set the day and time to send test emails
• Manual test email trigger
• Encrypted Gmail app password storage (parent site)
• Email token tracking
• Server time display
• Simple, lightweight, and easy to set up

Ensure your emails don’t silently fail — get peace of mind knowing your SMTP setup is working reliably.

✅ How to Set Up SMTP Test (Agency/Freelancer Guide)

🧠 Overview

Install this plugin on your own WordPress site (the Parent) and on each of your client sites (the Children). Each child site will send a test email on a specific day each week to your email inbox. The parent site will check for those emails and report which ones arrived.

---

---

🔹 Step 1: Set Up Each Child Site (Client Site)

• Install and activate the SMTP Test plugin on the client’s site.
• Go to Settings > SMTP Test.
• Under Site Type, select Child Site.
• In Send Test Emails To, enter the same email address you used on the parent site.
• The plugin will automatically generate a Site Token (e.g. acme-co) and display it on the settings page.
  ➤ Copy this token, you’ll add it to your parent site’s token list in Step 2.
• Save changes.
• (Optional) Click the Send Test Email Now button to ensure it’s working.

---

🔹 Step 2: Set Up the Parent Site (Your Monitoring Hub)

• Install and activate the SMTP Test plugin on your own WordPress site.
• Go to Settings > SMTP Test.
• Under Site Type, select Parent Site.
• In the Send Test Emails To field, enter the email address you want to receive test emails at.
• Generate a Gmail App Password for that inbox
  👉 How to generate an app password
• Paste the app password into the Gmail App Password field.
• In Child Site Tokens, enter one token per line. A token is a slugified version of the child site’s name, this is displayed on each child site’s SMTP Test settings page (e.g. acme-co, west-side-sewing, etc.).
• Save changes.

🔹 Step 3: Configure the Weekly Email Day

• In the child site settings, you can select which day of the week the test email should be sent.
• By default, this is Friday.
• Emails are not sent at a specific time, but instead:
  • The site runs a scheduled check at 12:01 AM server time every day.
  • If the current day matches the selected day, the test email is sent as soon as someone visits the site (triggering WordPress cron).

🕐 This ensures the site has all day to trigger the email—even if traffic is low.

---

🔹 Step 4: Monitor Test Results on the Parent Site

• On your parent site, create a WordPress page with this shortcode: [check_email_token]
• On your chosen day (e.g. Friday afternoon), visit that page to see a report showing:
  • ✅ Which sites successfully sent their test email
  • ❌ Which sites did not (potential deliverability issue or no cron triggered yet)
• Due to the way WordPress cron works, you’ll want to check this later on in the day to make sure at least one person has visited each client site to trigger the WordPress cron.
  • If you’re feeling really fancy, you can use something like cron-job.org to make sure your clients sites get pinged on the appropriate day.