Skip to content

davidrukahu/edgemail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EdgeMail WordPress Plugin

Replace WordPress transactional email with Cloudflare Worker endpoint integration.

Description

EdgeMail intercepts WordPress outbound email (wp_mail()) and sends it via your Cloudflare Worker endpoint instead of using the default PHP mailer. Built to work with Cloudflare Email Service.

Features

  • Cloudflare Integration: Send emails through your Cloudflare Worker using the Email Service API
  • Safe Fallback: Automatically falls back to default WordPress email if Worker fails or plugin is not configured
  • Email Logging: Track all email attempts with status, HTTP codes, and responses
  • Easy Configuration: Simple settings page with Worker URL, API token, and default From fields
  • Test Email: Send test emails to verify your configuration
  • WooCommerce Status: View recent email logs and configuration status in WooCommerce → Status
  • Zero Downtime: Unconfigured installations continue to work normally

Installation

  1. Download or clone this repository
  2. Upload to your /wp-content/plugins/ directory
  3. Activate the plugin through the 'Plugins' menu in WordPress
  4. Go to Tools → EdgeMail in the WordPress admin
  5. Configure your Worker URL, API token, and default From fields
  6. Send a test email to verify your configuration

Configuration

In the EdgeMail settings page, you'll need to provide:

  • Worker URL: Your Cloudflare Worker endpoint (e.g., https://your-worker.your-subdomain.workers.dev)
  • API Token: Shared secret for authenticating with your Worker
  • Default From Name: Default sender name for emails
  • Default From Email: Default sender email (must be verified in Cloudflare Email Service)

Limitations

  • Attachments are not supported in v1
  • Requires WordPress 5.7+ (uses pre_wp_mail filter)

Requirements

  • WordPress 5.7 or higher
  • PHP 7.4 or higher

FAQ

What happens if my Worker is down?

EdgeMail automatically falls back to the default WordPress email sending mechanism. Your site will continue to send emails normally.

Can I use this without WooCommerce?

Yes! EdgeMail works on any WordPress installation. The settings page appears under Tools in the WordPress admin.

Do I need to create my own Cloudflare Worker?

Yes, you'll need to create a Cloudflare Worker that receives the email payload and uses the Email Service API to send emails. See Cloudflare documentation for details.

Changelog

1.0.0

  • Initial release
  • Email interception via pre_wp_mail filter
  • Cloudflare Worker integration
  • Settings page with test email functionality
  • Database logging
  • WooCommerce Status integration

License

GPLv2 or later

Author

DavidR - GitHub

Credits

Built to integrate with Cloudflare Email Service announced in September 2025.

About

Replace WordPress transactional email with Cloudflare Worker endpoint integration.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors