Mail logging – WP Mail Catcher Plugin
Stop from ever losing your emails again! This fast, lightweight plugin (under 140kb in size!) is also useful for debugging or backing up your messages
Logging your mail will stop you from ever losing your emails again! This fast, lightweight plugin (under 140kb in size!) is also useful for debugging or backing up your messages.
Just install and activate then all of your contact form emails will be logged and saved to your DB with no additional configuration required.
View and manage all your form submissions through the default WordPress interface. An email failed to send? With a single click you can resend the backed up email.
Send emails out directly from the WordPress interface. Also includes support for attachments.
Immediately find out if your contact form submission was successfully sent.
Features
- Zero setup required – just install and away you go
- Minimalistic – no overbloated features you never use weighing your site down – under 140kb in size!
- Bulk export emails to CSV for easy inclusion into Excel or any other program
- Compose new emails with the WordPress controls you’re already familiar with
- Resend your emails in bulk
- Debugging – see exactly which file and code line was responsible for sending the email, along with any errors encountered
- Manage what user permissions can see the logs
- Routinely have your logs cleared out at a specified time – or keep them forever
- Need to be notified when there’s a problem sending your mail? We’ve got hooks that allow you to do just that
- Completely free
Hooks and actions
wp_mail_catcher_mail_success
is triggered when a message is sent and logged successfully. It has a single argument that is an array containing the log id
related to the id in the mail_catcher_logs
MySQL tabletime
relative, readable time to when the log was savedemail_to
the email address(es) that the message was sent tosubject
the subject line of the messagemessage
the contents of the messagestatus
an integer depicting if the message was sent successfully or not (1 = sent successfully. 0 = sending failed)error
the error that occurred – if anybacktrace_segment
a json_encoded object that shows which file and line the mail was initially triggered fromattachments
a list of any attachments that were sent along with the emailadditional_headers
a list of any headers that were sentattachment_file_paths
a list of the location of any attachments that were senttimestamp
a unix timestamp of when the email was sentis_html
a boolean, that will be true if the message is a html email and false if notemail_from
the from value of the email
wp_mail_catcher_mail_failed
is triggered when a message failed to send and logged successfully. It has a single argument that is an array containing the log (same as the arguments for wp_mail_catcher_mail_success
)wp_mail_catcher_deletion_intervals
is a filter that should return an array where each key is an amount of time in seconds, and the value is the label. Used to determine when a message has expired and should be deletedwp_mail_catcher_before_success_log_save
is a filter that is called just before a successful log is saved. It has a single argument that is the transformed log that will be saved – use this to alter the log before it’s saved. Returning false
will stop the log from being saved. Also note that this is fired even when an email has errored, because all logs are initially saved as “successful” before being possibly updated with an error (if applicable). This is because of the way the wp_mail
and wp_mail_failed
are implemented in WordPress. time
a unix timestamp of when the email was sentemail_to
the email address(es) that the message was sent tosubject
the subject line of the messagemessage
the contents of the messagebacktrace_segment
an array that shows which file and line the mail was initially triggered from
wp_mail_catcher_before_error_log_save
time
a unix timestamp of when the email was sentemail_to
the email address(es) that the message was sent tosubject
the subject line of the messagemessage
the contents of the messagebacktrace_segment
an array that shows which file and line the mail was initially triggered fromerror
the error that occurred
Screenshots
Send a quick email from your dashboard
Basic, no clutter options page
The table supports: sorting, exporting and resending
Supports column customisation and pagination
FAQ
Is this really free? Yup, completely 100% free, no premium add-ons or anything like that.
Does that include adverts/nagging Yes, there are no adverts/annoying messages asking you to “upgrade to pro” or anything similar, 100% of the features are available.
What plugins are supported? Anything that doesn’t unhook the native wp_mail function is supported, this includes but not limited to:
* WooCommerce
* Contact Form 7
* MailGun
* SparkPost
* Easy WP SMTP (excluding their test email function)
* SendGrid
* BuddyPress
Click here for a full list
What plugins are currently not supported - WP Mail Bank (unhooks wp_mail filters)
- Post SMTP (overrides wp_mail function and doesn’t implement the same actions/filters)
If you’d like to see support for these plugins or any other plugins please leave a feature request in our GitHub tracker
I’ve found an issue!/I have a great idea on how to improve this Great! Please leave a note in our (GitHub tracker)
Changelog
2.1.9
- Fix: When stopped a log from being saved via
wp_mail_catcher_before_success_log_save
, it now returns the unaltered mail
2.1.8
- New: Added new hook
wp_mail_catcher_before_success_log_save
- New: Added new hook
wp_mail_catcher_before_error_log_save
2.1.7
- Security: Added additional nonce checks to setting actions
2.1.6
- Fix: Logs not appearing in WP versions under 6.2
2.1.5
- Fix: Html emails are now decoded before being rendered
- Fix: Updated serialisation to use maybe_unserialize for extra compatibility
2.1.4
- Security: Fixed Injection vulnerability, reported by Muhammad Daffa via Patchstack
2.1.3
- Fix: Improved HTML email detection
- Fix: Improved XSS filtering
2.1.2
- Fix: Escaping no longer mangles exports
2.1.1
- Security: Fixed XSS vulnerability, reported by Alex Thomas of Wordfence
2.1.0
- New: Added support for viewing encoded non-ASCII characters in the subject line on the log table
- New: Added resend link inside of details modal
- Deprecation: Increased supported PHP version from 7.2 to 7.4
2.0.5
- Fix: Improved error handling when attempting to save a log without running the migration
- New: Added ability to force rerun database migrations
- Improvement: Database migrations will now happen automatically on plugin upgrade
2.0.4
- Fix: Resolved memory leak when saving a new log
2.0.3
- Fix: Auto deleting clearing all logs
2.0.2
- Improvement: Reduced memory usage when deleting expired logs
- Fix: Emails sent with the to address formatted with angled brackets are now escaped
- Possible fix: Aligned wp_mail handling to be much closer to older version as some people reported issues
2.0.1
- Fix: Bulk actions (delete, export, resend) now works
2.0.0
- Deprecation: Increased supported PHP version from 5.6 to 7.2
- New: Added partial lazy loading to reduce database strain
- New: Can now manually trigger removing of old logs
- New: Added support for wp_mail_content_type filter
- New: Implemented database upgrade system
- Fix: Old logs not being automatically deleted
- Fix: Pagination now works on search results or other filters
- Fix: BuddyPress error exception
- Fix: Re-implemented resending HTML emails
- Fix: PHP notice appearing on settings page under certain circumstances
- Fix: Scrolling not working correctly on mobile and tablets
1.5.4
- Fix: Auto delete wasn’t always deleting Logs
- Fix: Fixed header syncing issue
1.5.3
- Fix: Cron job issue preventing logs from being auto deleted
- Fix: v1.5.0 broke compatibility with some other mail plugins
1.5.2
- Fix: PHP notice that appears if additional_headers column is corrupted
1.5.1
- Fix: Auto deleting timer isn’t pulled through on settings page. Thanks to @oginomizuho
1.5.0
- New: Added beta BuddyPress support
- New: Can now auto delete messages that are over a specific age
- Fix: Minute/seconds being slightly off in export
1.4.1
- Fix: Log exports now show the correct date and time
1.4.0
- New: Refreshed log table UI
- New: Added 2 new actions
wp_mail_catcher_mail_success
and wp_mail_catcher_mail_failed
1.3.10
- Performance: Email previews are now loaded lazily
1.3.9
- Fix: Auto delete notification is always shown regardless of settings
1.3.8
- Fix: Logs per page screen option was being ignored
- Compatibility: Added support for WordPress 5.5
1.3.7
- New: Can now see raw html code of an email if it’s html enabled (open a message and go to the Debug tab)
- Update: npm dependencies updated
1.3.6
- Fix: Object serialization issue stability when a third party modifies the object
- Fix: Minor typo
1.3.5
1.3.4
- New: Added search functionality, supports partial and exact matching for: to, subject, message, attachment names and email headers
1.3.3
- Fix: Improved support for multisite
1.3.2
- Fix: Child CSS class not matching parent
1.3.1
- Fix: Improved clarity of ‘from’ header
- Fix: Fixed issue with bulk deletion
1.3.0
- New: ‘From’ column now included in admin table
- New: Screen options have been added that allow you to pick which columns are visible along with the number of logs per page
- Fix: Fixed an issue adding an attachment in the ‘new message’ modal
- Fix: Fixed custom headers being rendered incorrectly in the ‘new message’ modal
- Fix: Fixed bug whereby tables were not dropped when deleting a multi-site
1.2.4
- New: Exact time (including timestamp) mail was sent can now be seen in the debug panel and when you hover over the value in the sent column of the table
- Improvement: Significantly reduced file size of plugin
- Fix: Fixed error when calling wp_mail and passing an attachment as a string
- Fix: Namespaced CSS
- Fix: Fixed incorrect time being rendered
- Fix: Sorting columns now works
1.2.3
- New: When the number of logs exceeds a specific value (currently set to 100) then a warning appears. Upon trying to do an ‘export all’ a dialog opens to batch the exporting
- Fix: Fixed an issue with interacting with messages beyond the first page
- Fix: Non-html emails now have their spacing rendered correctly
1.2.2
- New: Added new filtering system that allows only successful or failed messages to be seen
- New: Added ‘export all’ button
- Improvement: Removed carbon dependency, reducing the plugin size significantly from 322kb to 53kb (zipped)
- Improvement: Added basic caching system so repeated, identical database calls are avoided
1.2.1
- Fix: Hotfix for html emails not rendering correctly
1.2.0
- New: Added support for foreign characters
- New: Added link to settings page from the plugins page
- Fix: Fixed issue where non-html emails lost their line breaks
1.1.0
- Fix: ‘Failed security check’ message appearing when trying to perform any bulk actions
- Fix: Exporting with no attachments but with additional headers causes the wrong column to be populated
- Fix: HTML emails cause modal styling problem
- Fix: Long file names cause the content to spill over modal
- Fix: Admin notices makes ‘New Message’ button fall out of alignment