Package Data | |
---|---|
Maintainer Username: | bonsi |
Maintainer Contact: | telluur@gmail.com (Bonsi) |
Package Create Date: | 2016-07-26 |
Package Last Update: | 2020-07-14 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-19 03:26:06 |
Package Statistics | |
---|---|
Total Downloads: | 1,304 |
Monthly Downloads: | 0 |
Daily Downloads: | 0 |
Total Stars: | 1 |
Total Watchers: | 3 |
Total Forks: | 2 |
Total Open Issues: | 2 |
Fork of the awesome [] "Beter goed gejat dan slecht verzonnen" :)
This package provides an easy way to integrate GetResponse with Laravel 5. Behind the scenes v3 for the GetResponse API is used. Here are some examples of what you can do with the package:
Newsletter::subscribe('rincewind@discworld.com');
Newsletter::unsubscribe('the.luggage@discworld.com');
//Merge variables can be passed as the second argument
Newsletter::subscribe('sam.vines@discworld.com', ['firstName'=>'Sam', 'lastName'=>'Vines']);
//Subscribe someone to a specific list by using the third argument:
Newsletter::subscribe('nanny.ogg@discworld.com', ['firstName'=>'Nanny', 'lastName'=>'Ogg'], 'Name of your list');
//Get some member info, returns an array described in the official docs
Newsletter::getMember('lord.vetinari@discworld.com');
//Returns a boolean
Newsletter::hasMember('greebo@discworld.com');
//If you want to do something else, you can get an instance of the underlying API:
Newsletter::getApi();
You can install this package via Composer using:
composer require bonsi/laravel-newsletter-getresponse
You must also install this service provider.
// config/app.php
'providers' => [
...
Bonsi\GetResponse\Newsletter\NewsletterServiceProvider::class,
...
];
If you want to make use of the facade you must install it as well.
// config/app.php
'aliases' => [
..
'Newsletter' => Bonsi\GetResponse\Newsletter\NewsletterFacade::class,
];
To publish the config file to app/config/laravel-newsletter-getresponse.php
run:
php artisan vendor:publish --provider="Bonsi\GetResponse\Newsletter\NewsletterServiceProvider"
This wil publish a file laravel-newsletter-getresponse.php
in your config directory with the following contents:
return [
/*
* The api key of a GetResponse account. You can find yours here:
* https://us10.admin.mailchimp.com/account/api-key-popup/
*/
'apiKey' => env('GETRESPONSE_APIKEY'),
/*
* When not specifying a listname in the various methods,
* this list name will be used.
*/
'defaultListName' => 'subscribers',
/*
* Here you can define properties of the lists you want to
* send campaigns.
*/
'lists' => [
/*
* This key is used to identify this list. It can be used
* in the various methods provided by this package.
*
* You can set it to any string you want and you can add
* as many lists as you want.
*/
'subscribers' => [
/*
* A getresponse campaign id. Check the mailchimp docs if you don't know
* how to get this value:
* http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id
*/
'id' => env('GETRESPONSE_DEFAULT_LIST_ID'),
],
],
];
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.
use Newsletter;
Subscribing an email address can be done like this:
use Newsletter;
Newsletter::subscribe('rincewind@discworld.com');
Let's unsubcribe someone:
Newsletter::unsubscribe('the.luggage@discworld.com');
You can pass some merge variables as the second argument:
Newsletter::subscribe('rincewind@discworld.com', ['firstName'=>'Rince', 'lastName'=>'Wind']);
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:
Newsletter::subscribe('rincewind@discworld.com', ['firstName'=>'Rince', 'lastName'=>'Wind'], 'subscribers');
That third argument is the name of a list you configured in the config file.
You can also unsubscribe someone from a specific list:
Newsletter::unsubscribe('rincewind@discworld.com', 'subscribers');
You can get information on a subscriber by using the getMember
-function:
Newsletter::getMember('lord.vetinari@discworld.com');
This will return an array with information on the subscriber. If there's no one subscribed with that
e-mailaddress the function will return false
There's also a convience method to check if some in subscribed:
Newsletter::hasMember('nanny.ogg@discworld.com'); //returns a bool
This is how you create a campaign:
/**
* @param string $fromName
* @param string $replyTo
* @param string $subject
* @param string $html
* @param string $listName
* @param array $options
* @param array $contentOptions
*
* @return array|bool
*
* @throws \Bonsi\GetResponse\Newsletter\Exceptions\InvalidNewsletterList
*/
public function createCampaign($fromName, $replyTo, $subject, $html = '', $listName = '', $options = [], $contentOptions = [])
Note the campaign will only be created, no mails will be sent out.
If something went wrong you can get the last error with
Newsletter::getLastError();
If you just want to make sure if the last action succeeded you can to this:
Newsletter::lastActionSucceeded();
If you need more functionality you get an instance of the underlying GetResponse Api with:
$api = Newsletter::getApi();
Run the tests with:
vendor/bin/phpunit
The MIT License (MIT). Please see License File for more information.