PHPackages                             simmatrix/laravel-mass-mailer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. simmatrix/laravel-mass-mailer

ActiveLibrary

simmatrix/laravel-mass-mailer
=============================

Mass Mailer Package for Laravel

177123[1 issues](https://github.com/simmatrix/laravel-mass-mailer/issues)PHP

Since Apr 5Pushed 9y agoCompare

[ Source](https://github.com/simmatrix/laravel-mass-mailer)[ Packagist](https://packagist.org/packages/simmatrix/laravel-mass-mailer)[ RSS](/packages/simmatrix-laravel-mass-mailer/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Mass Mailer Package for Laravel
===============================

[](#mass-mailer-package-for-laravel)

Sending mass mails in your Laravel applications with ease. This is a wrapper for different mail service providers.

> Currently supports the sending of mass mails using Laravel's default Mail facade and [Mailgun's Official SDK](https://github.com/mailgun/mailgun-php)

> It is recommended to use third party mail service such as Mailgun instead of depending on Laravel's default Mail facade because with Laravel's Mail facade, in order to protect the privacy of all subscribers, the field "BCC" is being used instead of "TO"

### Features Included

[](#features-included)

- **Sending mass emails with queue**: Without bogging down your app's web request speed
- **Multiple Mailgun domains**: Good for apps that need to send mass mails using multiple Mailgun domains
- **Privacy properly handled**: Subscribers' emails would not be exposed to one another
- **Easily integrate with your frontend application**: You can pull JSON data, populate it, then pass it back to the backend to be processed
- **Post-delivery Report**: Easily fetch the number of clicks, opens, bounces, unsubscribes, complains, delivers, drops etc.
- **Draft**: Save and retrieve mass mail drafts
- **Subscriber Listings**: Retrieve the list of subscribers from 3rd party email service providers, such as Mailgun

Installation
------------

[](#installation)

Add this package to your project's `composer.json` file by running the following command

```
composer require simmatrix/laravel-mass-mailer

```

Add both of the service providers below to your `config/app.php` file, in the `providers` array.

```
Simmatrix\MassMailer\Providers\MassMailerServiceProvider::class,

```

Publish the config file and blade view template file to your application

```
php artisan vendor:publish --provider="Simmatrix\MassMailer\Providers\MassMailerServiceProvider"

```

Configuration
-------------

[](#configuration)

[How to do basic config](https://github.com/simmatrix/laravel-mass-mailer/blob/master/CONFIGURATION.md)

### Running Queue in your server

[](#running-queue-in-your-server)

[How to do basic setup](https://github.com/simmatrix/laravel-mass-mailer/blob/master/RUNNING_QUEUES.md)

Usage
-----

[](#usage)

### 1(i). Sending the Attributes to the Frontend

[](#1i-sending-the-attributes-to-the-frontend)

> Attributes represents the HTML elements

Retrieve the key-value pairs using the command below:

```
return MassMailer::getAttributes();

```

Here's the sample response. Each HTML element in your frontend is represented in key-value form.

```
{
  "data": {
    "ApplyTemplate": true,
    "MessageContent": "",
    "RecipientList": "",
    "SendToAllSubscribers": false,
    "SenderEmail": "noreply@nuffnang.com",
    "SenderName": "Nuffnang",
    "Subject": "",
    "Title": "",
    "Instagram": false,
  }
}

```

> The purpose of creating an attirbute to represent your HTML element is so that it can be easily parsed when it returned from your frontend application.

### 1(ii). Creating Your Own Attributes

[](#1ii-creating-your-own-attributes)

These are the required attributes that comes with the package *by default*:

- "Subject" Field
- "Title" Field
- "Sender Name" Field
- "Sender Email" Field
- "Recipient List" Field
- "Message Content" Field
- "Apply Template" Option
- "Send to All Subscribers" Option

To add additional fields:

```
php artisan make:mass-mailer-attribute YourNewFieldName

```

Generated file is located at `app/MassMailer/Attributes/` directory

### 1(iii). \[Advanced\] Fetching Additional Data

[](#1iii-advanced-fetching-additional-data)

If you have some extra logic to add to your attribute, write it in the `getValue()` function within your attribute file.

```
public function getValue()
{
    // Do all necessary steps to call to Instagram API to pull the postings, then return the result
    return $instagram_postings;
}

```

### 1(iv). Reading the Value from the Attribute

[](#1iv-reading-the-value-from-the-attribute)

You can easily read the user's input from the attribute with:

```
$has_instagram = MassMailerAttribute::getUserInput( $params, 'Instagram' )

```

If you did `Step 1(iii)` above, then you can easily get the value that you have retrieved using:

```
$instagram_posts = MassMailerAttribute::getInternallyPulledData( $params, 'Instagram' )

```

### 2(i). Sending Mass Emails

[](#2i-sending-mass-emails)

In your controller, pass in that `$request` parameter into `MassMailer::getParams()`, which will churn out a digestible object called `MassMailerParams` that can be fed into the function `MassMailer::send()`.

```
// YourController.php

public function send(Request $request)
{
    MassMailer::send( MassMailer::getParams( $request ) );
}

```

### 2(ii). \[Advanced\] Sending Mass Emails

[](#2ii-advanced-sending-mass-emails)

If you have created your own blade view template and need to use it for the mass mail, or if you need to blast mass mails using different Mailgun domains, or to different mailing list, you can pass in the **mailer options**.

Currently this supports the overwriting of 3 custom mailer options, namely

- `presenter`: Specify the class name of the *Presenter* that handles your new blade template here.
- `mailing_list`: Without this, the backend will read the data from the `mailing_list` key in your `app/config/mass_mailer.php`
- `mailgun_domain`: Without this, the backend will read the data from the `MAILGUN_DOMAIN` key in your `.env` file

```
// YourController.php

public function send(Request $request)
{
  $mailer_options = MassMailer::createMailerOptions([
    'mailing_list' => 'xxx',
    'mailgun_domain' => 'xxx@xxx.com',
    'presenter' => \App\MassMailer\Presenters\YourCustomPresenter::class,
  ]);

  // Pass it to your options to the getParams()
  MassMailer::send( MassMailer::getParams( $request, $mailer_options ) );
}

```

### 3(i). Creating Your Custom Presenter

[](#3i-creating-your-custom-presenter)

You need this when you want to use your own nice newsletter layout design.

> This class holds all the parameters that you intended to pass them to your blade view template, and the name of the blade view template itself

To generate:

```
php artisan make:mass-mailer-presenter YourCustomPresenter

```

The console will prompt you to enter the name of your template.

- **If you place your template file in**: `resources/views/vendor/simmatrix/mass-mailer/lorem.blade.php`
- **Then key in this into the console**: `vendor.simmatrix.mass-mailer.lorem`
- **A new presenter will be generated at**: `app/MassMailer/Presenters/YourCustomPresenter.php`

### 3(ii). Adding Data into Your Custom Presenter

[](#3ii-adding-data-into-your-custom-presenter)

Open the file and start writing those parameters that you wish to pass to your blade view template in the `setParameters()` function.

```
private function setParameters( MassMailerParams $params )
  parent::setViewParameters([
    'lorem' => 'ipsum',
    'testing' => 'success'
  ]);
}

```

In your newsletter HTML layout, you can display the value in such a way:

```
{{ $lorem }}
{{ $testing }}

```

### 4. Getting Post-Delivery Report

[](#4-getting-post-delivery-report)

Details such as the number of bounces, clicks, complains, deliveries, drops, opens, submits, unsubscribes can be obtained by calling this method.

```
return MassMailer::getReport();

```

### 5. Saving Draft

[](#5-saving-draft)

You may save up the draft by passing the `$request` parameter into the `MassMailer::saveDraft()`.

```
MassMailer::saveDraft( $request );

```

### 6. Retrieving Draft

[](#6-retrieving-draft)

You may retrieve all of the drafts by calling this method.

```
return MassMailer::getDrafts();

```

You may retrieve individual draft by passing an ID into the method below.

```
return MassMailer::getDraft( $id );

```

### 7. Retrieving the Subscribers

[](#7-retrieving-the-subscribers)

You may retrieve all of the subscribers by calling this method.

```
return MassMailer::getSubscribers();

```

Acknowledgements
----------------

[](#acknowledgements)

Thanks [Chalcedonyt](https://github.com/chalcedonyt) for the feedback given and for the useful [Value Object](https://github.com/chalcedonyt/laravel-valueobject) Laravel package

License
-------

[](#license)

MIT

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/bb1717ab9ff6795c5502dda102364a5cdbfdfd61e41b410f43fc9702da137050?d=identicon)[simmatrix](/maintainers/simmatrix)

### Embed Badge

![Health badge](/badges/simmatrix-laravel-mass-mailer/health.svg)

```
[![Health](https://phpackages.com/badges/simmatrix-laravel-mass-mailer/health.svg)](https://phpackages.com/packages/simmatrix-laravel-mass-mailer)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)