Laravel Email Tracker - Nova Plugin

A Laravel Nova v4/v5 admin panel plugin for Laravel Email Tracker. Provides resources for managing your email tracking data.

Table of Contents

• Features
• Requirements
• Installation
• Resources
• Configuration
• Customizing Resources
• Related Packages
• Contributing
• Credits
• License

Features

• Sent Emails Resource - Browse, search, and filter sent emails
• Bounces Resource - View bounce records with type badges
• Complaints Resource - Track spam complaints
• Provider Filtering - Filter by email provider
• Read-Only - Safe viewing without accidental modifications
• Nova v4 & v5 Compatible

Requirements

• PHP 8.2+
• Laravel 11.0+
• Laravel Nova 4.0+ or 5.0+
• r0bdiabl0/laravel-email-tracker ^1.0

Installation

First, install the main email tracker package if you haven't:

composer require r0bdiabl0/laravel-email-tracker
php artisan email-tracker:install

Then install the Nova plugin:

composer require r0bdiabl0/laravel-email-tracker-nova

The resources are auto-registered via the service provider.

Optionally publish the config:

php artisan vendor:publish --tag=email-tracker-nova-config

Resources

Sent Emails

Browse all tracked emails with:

• Search by recipient email or message ID
• Filter by provider (SES, Resend, Mailgun, etc.)
• Filter by delivery status
• View delivery, bounce, and complaint status

Bounces

View bounce records with:

• Permanent vs Transient type badges
• Provider filtering
• Link to original sent email

Complaints

View spam complaints with:

• Type badge (spam, abuse)
• Provider filtering
• Link to original sent email

Configuration

// config/email-tracker-nova.php

return [
    'navigation' => [
        'group' => 'Email Tracker',
    ],

    'resources' => [
        'sent_emails' => true,
        'bounces' => true,
        'complaints' => true,
    ],

    'default_days' => 30,
];

Customizing Resources

If you need to customize the resources, you can extend them:

namespace App\Nova;

use R0bdiabl0\EmailTrackerNova\Nova\SentEmail as BaseSentEmail;

class SentEmail extends BaseSentEmail
{
    public function fields(NovaRequest $request): array
    {
        return array_merge(parent::fields($request), [
            // Add your custom fields
        ]);
    }
}

Then register your custom resource instead in NovaServiceProvider:

public function resources()
{
    Nova::resources([
        \App\Nova\SentEmail::class,
        // ...
    ]);
}

Related Packages

• laravel-email-tracker - Main email tracking package (required)
• laravel-email-tracker-filament - Filament admin panel plugin

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Run composer test and composer format
5. Submit a pull request

For bugs and feature requests, please open an issue.

Credits

• Robert Pettique - Author and maintainer

License

The MIT License (MIT). Please see License File for more information.