Download the PHP package sicaboy/laravel-newsletter without Composer

Manage newsletters in Laravel

This package provides an easy way to integrate MailChimp with Laravel 5. Behind the scenes v3 for the MailChimp API is used. Here are some examples of what you can do with the package:

Please note the at the time of this writing the default merge variables in MailChimp are named FNAME and LNAME. In our examples we use firstName and lastName for extra readability.

Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

Installation

You can install this package via composer using:

The package will automatically register itself.

To publish the config file to config/newsletter.php run:

This will publish a file newsletter.php in your config directory with the following contents:

Updating from 3.x to 4.x

There is a new name for our config file. We've changed the name from laravel-newsletter.php to newsletter.php.

If you are upgrading to 4.x, package is looking for the new config file name. In that case, you have to rename the file in your app\config folder.

Usage

After you've installed the package and filled in the values in the config-file working with this package will be a breeze. All the following examples use the facade. Don't forget to import it at the top of your file.

Switching to another account

Subscribing, updating and unsubscribing

Subscribing an email address can be done like this:

Let's unsubscribe someone:

You can pass some merge variables as the second argument:

Please note the at the time of this writing the default merge variables in MailChimp are named FNAME and LNAME. In our examples we use firstName and lastName for extra readability.

You can subscribe someone to a specific list by using the third argument:

That third argument is the name of a list you configured in the config file.

You can also subscribe and/or update someone. The person will be subscribed or updated if he/she is already subscribed:

You can subscribe someone to one or more specific group(s)/interest(s) by using the fourth argument:

Simply add false if you want to remove someone from a group/interest.

You can also unsubscribe someone from a specific list:

Deleting subscribers

Deleting is not the same as unsubscribing. Unlike unsubscribing, deleting a member will result in the loss of all history (add/opt-in/edits) as well as removing them from the list. In most cases you want to use unsubscribe instead of delete.

Here's how to perform a delete:

Getting subscriber info

You can get information on a subscriber by using the getMember function:

This will return an array with information on the subscriber. If there's no one subscribed with that e-mail address the function will return false

There's also a convenience method to check if someone is already subscribed:

In addition to this you can also check if a user is subscribed to your list:

Creating a campaign

This the signature of createCampaign:

Note the campaign will only be created, no mails will be sent out.

Handling errors

If something went wrong you can get the last error with:

If you just want to make sure if the last action succeeded you can use:

Need something else?

If you need more functionality you get an instance of the underlying MailChimp Api with:

Testing

Run the tests with:

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Postcardware

You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.

Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.

We publish all received postcards on our company website.

Credits

• Freek Van der Herten
• All Contributors

Support us

Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.

License

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