MXRoute Mailer

Route all WordPress email through MXRoute's API — HTTP for simple emails, SMTP for attachments.

Overview

MXRoute Mailer is a WordPress plugin that intercepts all emails sent via wp_mail() and routes them through MXRoute's API. Emails without attachments are sent via MXRoute's HTTP API, while emails with attachments are sent via SMTP. It works on any hosting environment, including those where outbound SMTP ports are blocked.

Features

• Smart-switch transport — Automatically selects API (port 443) for lightweight emails or SMTP for emails with attachments
• Email queue — Background processing via recurring WP-Cron (every 60 seconds) with configurable batch size
• File attachment support — Media library IDs, persistent paths, and temp files with intelligent storage
• Re-queue feature — Resend any failed or sent email directly from the logs
• Email logging — Full logs with search, filtering, pagination, and transport details
• Reply-To support — Preserves form sender addresses as Reply-To headers
• WP-CLI commands — Manage settings, logs, queue, and send emails from the command line
• Multisite support — Per-site settings and logs, network activate/deactivate
• Built-in test email tool — Verify configuration with a single click
• Dashboard widget — Queue stats and cron event history table with status icons and pass/fail counts under Dashboard
• WP-Cron history tracking — Every cron event tracked via MXRoute_Cron_Tracker with last run, pass/fail counts, and last 20 runs per hook — visible in the dashboard widget and status JSON
• Automatic updates — Apt-server-based updater; new versions appear in the WordPress dashboard like any other plugin update
• Works with any plugin or theme that uses wp_mail()

Requirements

• WordPress 5.0 or higher
• PHP 7.3 or higher
• A MXRoute account with API credentials

Quick Start

1. Download the latest release from GitHub Releases
2. Install and activate the plugin in WordPress
3. Go to Settings > MXRoute Mailer and enter your MXRoute credentials
4. Send a test email to verify the configuration

Updating

Via WordPress admin

1. Go to Plugins → Installed Plugins
2. If an update is available, you'll see an Update Now link under MXRoute Mailer
3. Click Update Now

Via WP-CLI

wp plugin update mxroute-mailer

Via GitHub release

1. Download the latest release from GitHub Releases
2. In WordPress admin, go to Plugins → Add New → Upload Plugin
3. Upload the new zip — WordPress will overwrite the existing installation
4. Reactivate the plugin if prompted

Automatic updates

MXRoute Mailer includes a built-in updater that checks the apt server for new versions. When an update is available, it appears in your WordPress dashboard like any other plugin update. See the Auto-Updates wiki page for details.

WP-CLI

MXRoute Mailer includes WP-CLI commands for command-line management:

# View all settings
wp mxroute settings get

# Get a specific setting
wp mxroute settings get server

# Update a setting
wp mxroute settings set batch_size 10

# List recent logs
wp mxroute logs list

# View a specific log
wp mxroute logs view 123

# Check queue status
wp mxroute queue count

# Send a test email through the queue
wp mxroute test user@example.com

See the CLI documentation for full details.

Multisite

MXRoute Mailer supports WordPress Multisite:

• Network activation — Activate once, available on all sites
• Per-site settings — Each site has its own MXRoute credentials and logging
• Per-site logs — Email logs are isolated per site
• Automatic table creation — New sites get the logs table automatically
• Network admin access — Site admins with manage_network_options capability can access settings

Documentation

• Installation
• Configuration
• Development
• Troubleshooting
• Auto-Updates

Local copies of the wiki pages are also kept in the wiki/ directory.

Contributing

See CONTRIBUTING.md and AGENTS.md for the branch workflow, coding standards, and AI-specific guidance.

Support

• GitHub Issues
• MXRoute

License

GPL v2 or later. See LICENSE for details.