Download the PHP package spatie/laravel-newsletter without Composer

On this page you can find all versions of the php package spatie/laravel-newsletter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-newsletter

Manage newsletters in Laravel

Latest Version GitHub Workflow Status Check & fix styling Total Downloads

This package provides an easy way to integrate subscriptions to email lists of various email services.

Currently this package support:

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Installation

You can install this package via composer using:

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:

Using Mailcoach

To let this package work with Mailcoach, you need to install the Mailcoach SDK.

Next, you must provide values for the API key, endpoint and list.subscribers.id in the config file. You'll find the API key and endpoint in the Mailcoach settings screen. The value for list.subscribers.id must be the UUID of an email list on Mailcoach. You'll find this value on the settings screen of an email list

Using MailChimp

To use MailChimp, install this extra package.

The driver key of the newsletter config file must be set to Spatie\Newsletter\Drivers\MailChimpDriver::class.

Next, you must provide values for the API key and list.subscribers.id. You'll find these values in the MailChimp UI.

The endpoint config value must be set to null.

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.

Subscribing, updating and unsubscribing

Subscribing an email address can be done like this:

Let's unsubscribe someone:

For Mailcoach, you can pass extra attributes as the second argument:

For MailChimp you can pass merge variables as the second argument:

You can subscribe someone to a specific list by passing a list name:

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:

For MailChimp, 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.

Here's how to 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:

For MailCoach, this will return an instance of Spatie\Mailcoach\Resources|Subscriber For MailChimp, 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:

Need something else?

If you need more functionality you get an instance of the underlying API with

If you're having troubles getting the MailChimp integration, you can see the last error 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.

Credits

License

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


All versions of laravel-newsletter with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
spatie/laravel-package-tools Version ^1.13
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package spatie/laravel-newsletter contains the following files

Loading the files please wait ....