Download the PHP package oltrematica/laravel-pulse-mail without Composer

Laravel Pulse Mail

Track and monitor emails sent from your Laravel application directly in your Laravel Pulse dashboard.

This package provides a custom Pulse widget that displays sent emails with details including recipients, subjects, mailable classes, and send counts. Perfect for monitoring email activity and debugging mail-related issues in production.

Features

• 📧 Track all sent emails - Automatically records emails sent via Laravel Mail
• 🎯 Detailed information - Shows recipient, subject, mailable class, and send count
• ⚙️ Configurable filtering - Exclude specific emails or mailables from tracking
• 📊 Sample rate control - Track a percentage of emails for high-volume applications
• 🕐 Time-based filtering - Uses Pulse's built-in date filtering
• 🎨 Consistent UI - Matches Pulse's design language

Requirements

• PHP 8.3+
• Laravel 10.x, 11.x, or 12.x
• Laravel Pulse 1.x

Installation

Step 1: Install the Package

Install the package via Composer:

Step 2: Publish Configuration Files

Publish the package configuration file:

If you haven't already published the Pulse dashboard view, publish it as well:

Step 3: Configure Pulse Recorder

Add the mail recorder to your config/pulse.php file in the recorders array:

Step 4: Add Widget to Dashboard

Add the mail-sent widget to your Pulse dashboard in resources/views/vendor/pulse/dashboard.blade.php:

You can customize the widget size using the cols and rows attributes. Common configurations:

• cols="full" - Full width
• cols="8" - 2/3 width
• cols="6" - Half width
• cols="4" - 1/3 width

Configuration

The config/pulse-mail.php file provides several options:

Usage

Once installed and configured, the package will automatically start tracking emails sent through Laravel's Mail facade or Mailable classes. The widget will display:

• To: Email recipient address(es)
• Subject: Email subject line
• Mailable: The Mailable class used (if applicable)
• Count: Number of times this email was sent during the selected period

Filtering

The widget respects Pulse's time-based filtering. Use the Pulse dashboard controls to filter emails by time period (last hour, 24 hours, 7 days, etc.).

Ignoring Specific Emails

To exclude certain emails from tracking, add them to the configuration:

Sample Rate

For high-volume applications, you can track only a percentage of emails:

Viewing Emails in Real-Time

Laravel Pulse uses an ingest system that processes recorded data asynchronously. After sending emails, you need to run the Pulse ingest process to see them in the dashboard:

Option 1: Manual Ingest (Development)

Run this command to process pending data once:

Option 2: Automatic Ingest (Recommended)

Run the Pulse worker in the background to automatically process data:

For development environments, add pulse:work to your concurrent processes. For example, if using concurrently in your composer dev script:

Option 3: Production Setup

In production, configure a supervisor process to keep pulse:work running continuously. See the Laravel Pulse documentation for details.

Code Quality

The project includes automated tests and tools for code quality control.

Rector

Rector is a tool for automating code refactoring and migrations. It can be run using the following command:

PhpStan

PhpStan is a tool for static analysis of PHP code. It can be run using the following command:

Pint

Pint is a tool for formatting PHP code. It can be run using the following command:

Automated Tests

The project includes automated tests and tools for code quality control.

Contributing

Feel free to contribute to this package by submitting issues or pull requests. We welcome any improvements or bug fixes you may have.