README.md

Sendy Package for Laravel 4

A service provider for Sendy API in Laravel 4.

(For Laravel 5, use the original package)

Installation

Update your composer.json with:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/shanecp/sendy-laravel"
    }
],
"require": {
        "hocza/sendy": "dev-laravel4"
    },

Add the following settings to the config/app.php

Service provider:

'providers' => [
	...
	'Hocza\Sendy\SendyServiceProvider',
]

For the Sendy:: facade

'aliases' => [
	...
	'Sendy' => 'Hocza\Sendy\Facades\Sendy',
]

Configuration

php artisan config:publish --path="vendor/hocza/sendy/config/" hocza/sendy

It will create sendy.php within the config\hocza\sendy directory.

<?php
return array(
    'list_id' => '',
    'installation_url' => '',
    'api_key' => ''
);

Usage

###Subscribe:

$data = [
	'email' => '[email protected]',
	'name' => 'John Doe',
	'any_custom_column' => 'value'
];
Sendy::subscribe($data);

RESPONSE (array)

In case of success:

['status' => true, 'message' => 'Subscribed']
['status' => true, 'message' => 'Already subscribed']

In case of error:

['status' => false, 'message' => 'The error message']

###Unsubscribe:

$email = '[email protected]';
Sendy::unsubscribe($email);

RESPONSE (array)

In case of success:

['status' => true, 'message' => 'Unsubscribed']

In case of error:

['status' => false, 'message' => 'The error message']

###Subscription status

$email = '[email protected]';
Sendy::status($email);

RESPONSE (Plain text)

Success: Subscribed

Success: Unsubscribed

Success: Unconfirmed

Success: Bounced

Success: Soft bounced

Success: Complained

Error: No data passed

Error: API key not passed

Error: Invalid API key

Error: Email not passed

Error: List ID not passed

Error: Email does not exist in list

###Active subscriber count

Sendy::count();
#To check other list:
Sendy::setListId($list_id)->count();

RESPONSE (Plain text)

Success: You'll get an integer of the active subscriber count

Error: No data passed

Error: API key not passed

Error: Invalid API key

Error: List ID not passed

Error: List does not exist

###Create campaign

Sendy::createCampaign($mailOptions, $mailContent);

###Change list ID

To change the default list ID simply prepend with setListId($list_id)
Examples:
Sendy::setListId($list_id)->subscribe($data);
Sendy::setListId($list_id)->unsubscribe($email);
Sendy::setListId($list_id)->status($email);
Sendy::setListId($list_id)->count();

Todo

• Implementing the rest of the API. :)
• better documentation - in progress as you can see :)