README

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

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.

Fork the repository
Create a feature branch
Make your changes with tests
Run composer test and composer format
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.

r0bdiabl0 / laravel-email-tracker-nova

Maintainers

Details