# MailerooTrack

## Description
MailerooTrack is a WordPress plugin that tracks and manages bounced emails from the Maileroo SMTP service. It helps you monitor failed deliveries, export data to CSV, and keep your email lists clean.

Developed by MemberSavi, this plugin provides a clean and professional interface for handling email bounce events through Maileroo's webhook system.

## Features
- **Real-time bounce tracking**: Capture failed, rejected, and deferred emails in real-time
- **Comprehensive dashboard**: View statistics and detailed bounce information in one place
- **Export capabilities**: Export bounce data to CSV files for further analysis
- **Email notifications**: Get notified when bounce events occur
- **Customizable settings**: Configure which event types to track and set data retention policies
- **Secure webhook handling**: Validate webhook authenticity with a shared secret

## Installation
1. Upload the `mailerootrack` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure the plugin settings at MailerooTrack > Settings

## Setting Up Maileroo Webhooks
1. Go to MailerooTrack > Settings in your WordPress admin
2. Copy your Webhook URL and Webhook Secret
3. Log in to your Maileroo Dashboard and navigate to the Events section
4. Add your WordPress site's Webhook URL as the callback URL
5. Enter the Webhook Secret from the plugin settings
6. Choose which event types you want to track (we recommend at least "failed", "rejected", and "deferred")
7. Save your settings in Maileroo

## Usage
### Dashboard
The MailerooTrack dashboard provides an overview of your email bounce events:
- Top statistics: Total bounces, failed, rejected, deferred, and last 24 hours count
- Filterable event list: Search and filter by event type or email address
- View detailed information about each bounce event

### Settings
Configure the plugin's behavior:
- **Webhook Secret**: Secure your webhook endpoint
- **Event Types**: Choose which types of events to track and store
- **Data Retention**: Set how long to keep bounce data before automatic cleanup
- **Notification Settings**: Configure email notifications for bounce events
- **Uninstall Settings**: Choose whether to preserve data when uninstalling the plugin

### Export
Export bounce data for external analysis:
- Filter by event type, date range, and email address
- Download CSV files with detailed event information
- Manage previously exported files

## Understanding Bounce Events
Maileroo provides several types of email events:

| Event Type | Description |
|------------|-------------|
| accepted   | Email successfully received by Maileroo for sending |
| delivered  | Email successfully delivered to the recipient |
| rejected   | Email not accepted by Maileroo (suppression) |
| deferred   | Email delivery temporarily delayed |
| failed     | Permanent failure in delivering the email (bounce) |
| opened     | Recipient has opened the email |
| clicked    | Recipient clicked a link within the email |
| complained | Email marked as spam or reported by the recipient |

## Bounce Handling Best Practices
1. **Monitor your bounce rate**: A high bounce rate can affect your sender reputation
2. **Remove persistent bounces**: If an email bounces multiple times, consider removing it from your list
3. **Check for patterns**: Look for common domains or issues in your bounce data
4. **Export regularly**: Maintain clean records by exporting and analyzing bounce data
5. **Investigate issues**: Use the detailed reason information to troubleshoot delivery problems

## Support
For support, please contact [[email protected]](mailto:[email protected]) or visit our [website](https://membersavi.com).

## Changelog

### 1.0.0
- Initial release
- Added dashboard for viewing bounce events
- Added export functionality
- Added webhook endpoint for Maileroo integration
- Added notification system for bounce events

## Credits
MailerooTrack is developed and maintained by [MemberSavi](https://membersavi.com).

## License
This plugin is licensed under the GPL v2 or later.

```
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
```