A simple package to create and send digest emails every certain period or when the amount reaches a certain threshold. Usage Examples:
- Sending a digest email to website administrator every new 100 registrations on the website.
- Sending a daily email with logged error messages on the website.
- Sending users a monthly newsletter that contains all posts issued in the month.
Via Composer
composer require hmones/laravel-digestTo publish the package configuration
php artisan vendor:publish --tag=laravel-digest-configThe configuration file contains the following parameters:
method: the method that you would like to use to send emails, it takes two values,queueorsend- Env variable:
DIGEST_METHOD - Default value:
queue
- Env variable:
frequency.enabledwhether you would like to enable sending emails every certain period, if not enabled emails will not be scheduled- Env variable:
DIGEST_FREQUENCY_ENABLED - Default value:
true
- Env variable:
frequency.daily.timeif frequency is enabled this parameter is used as the time to send the daily digest emails- Env variable:
DIGEST_DAILY_TIME - Default value:
00:00
- Env variable:
frequency.weekly.timeif frequency is enabled this parameter is used as the time to send the weekly digest emails- Env variable:
DIGEST_WEEKLY_TIME - Default value:
00:00
- Env variable:
frequency.monthly.timeif frequency is enabled this parameter is used as the time to send the monthly digest emails- Env variable:
DIGEST_MONTHLY_TIME - Default value:
00:00
- Env variable:
frequency.weekly.dayif frequency is enabled this parameter is used as the day to send the weekly digest emails (1 is Sunday and 7 is Saturday)- Env variable:
DIGEST_WEEKLY_DAY - Default value:
1
- Env variable:
frequency.monthly.dayif frequency is enabled this parameter is used as the day to send the monthly digest emails- Env variable:
DIGEST_MONTHLY_DAY - Default value:
1
- Env variable:
frequency.customyou can set as much custom frequency definitions as you want and the parameter takes a valid cron expressionamount.enabledwhether you would like to enable sending emails every certain amount per batch- Env variable:
DIGEST_AMOUNT_ENABLED - Default value:
true
- Env variable:
amount.thresholdthe number of emails after which an digest email should be sent.- Env variable:
DIGEST_AMOUNT_THRESHOLD - Default value:
10
- Env variable:
To create an email digest, make sure you have the following first:
- A mailable, configured with the sending addresses and email views and subject.
- The mailable should accept an array variable in its constructor, this array variable will contain all the records of data passed to individual emails concatenated and sent automatically by the package to the mailable to compile the views for sending the digest.
Example: Sending a digest email every time 10 new users register on the website with a summary of their names.
- Adjust the configuration variable in
config\laravel-digest.phpby settingamount.enabled => trueandfrequency.enabled => false - Create the following mailable
<?php
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
class UserCreatedMailable extends Mailable
{
use Queueable, SerializesModels;
public $data;
public function __construct(array $data)
{
$this->data = $data;
}
public function build(): Mailable
{
return $this->view('userCreated')->subject('10 new users are registered')->to('email@test.com');
}
}- Create a view to render the names of the users
resources\userCreated.blade.php
<html>
<head><title>Sample Email</title></head>
<body>
<h1>The following users have just registered:</h1>
<ol>
@foreach($data as $record)
<li>{{$record['name']}}</li>
@endforeach
</ol>
</body>
</html>- Create an observer for user creation and add an record to the digest every time a user is created:
<?php
namespace App\Observers;
use App\Mail\UserCreatedMailable;
use App\Models\User;
use Hmones\LaravelDigest\Facades\Digest;
class UserObserver
{
public function created(User $user)
{
$batchId = 'userCreated';
$mailable = UserCreatedMailable::class;
//Data can also be set to null if you don't want to attach any data to the email
$data = ['name' => $user->name];
//Frequency can take values such as daily, weekly, monthly, custom or an integer threshold 10, 20 ...etc
$frequency = 10;
Digest::add($batchId, $mailable, $data, $frequency);
}
}- The package will take care of everything else and send emails once the number of registered users reach 10.
Please see the changelog for more information on what has changed recently.
composer testPlease see contributing.md for details and a todolist.
If you discover any security related issues, please email author email instead of using the issue tracker.
Please see the license file for more information.