dsvllc/laravel-sendy

This package is abandoned and no longer maintained. No replacement package was suggested.

Sendy API implementation for Laravel 8

1.3.0 2022-03-18 04:36 UTC

Requires

• php: ^7.3|^8.0
• laravel/framework: ^8.0|^9.0

Requires (Dev)

• phpunit/phpunit: ^8.5|^9.0

MIT

• Chris Van Cleve

• api
• newsletter
• email
• laravel
• Sendy

README

Laravel Sendy

A service provider for Sendy API in Laravel 9. Much thanks to Jozsef Hocza for the original Laravel 5 version.

Installation

composer require dsvllc/laravel-sendy

or append your composer.json with:

{
    "require": {
        "dsvllc/laravel-sendy": "^1.*"
    }
}

Add the following settings to the config/app.php for the Sendy:: facade

'aliases' => [
    // ...
    'Sendy' => 'Dsvllc\Sendy\Facades\Sendy',
]

Configuration

php artisan vendor:publish --provider="Dsvllc\Sendy\SendyServiceProvider"

It will create laravel-sendy.php within the config directory.

<?php

return [

    'api_key' => env('SENDY_API_KEY', ''),
    'list_id' => env('SENDY_LIST_ID', ''),
    'installation_url' => env('SENDY_INSTALLATION_URL', ''),
];

Usage

Subscribe:

$data = [
    'email' => '[e-mail]',
    '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 = '[e-mail]';
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 = '[e-mail]';
Sendy::status($email);

RESPONSE (Plain text)

Success:

• Subscribed
• Unsubscribed
• Unconfirmed
• Bounced
• Soft bounced
• Complained

Error:

• No data passed
• API key not passed
• Invalid API key
• Email not passed
• List ID not passed
• 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
• API key not passed
• Invalid API key
• List ID not passed
• List does not exist

Create campaign

<?php

$campaignOptions = [
    'from_name' => 'My Name',
    'from_email' => '[e-mail]',
    'reply_to' => '[e-mail]',
    'title' => 'My Campaign',
    'subject' => 'My Subject',
    'list_ids' => '1,2,3', // comma-separated, optional
    'brand_id' => 1,
    'query_string' => 'utm_source=sendy&utm_medium=email&utm_content=email%20newsletter&utm_campaign=email%20newsletter',
];
$campaignContent = [
    'plain_text' => 'My Campaign',
    'html_text' => View::make('mail.my-campaign'),
];
$send = false;

Sendy::createCampaign($campaignOptions, $campaignContent, $send);

RESPONSE (Plain text)

Success:

• Campaign created
• Campaign created and now sending

Error:

• No data passed
• API key not passed
• Invalid API key
• From name not passed
• From email not passed
• Reply to email not passed
• Subject not passed
• HTML not passed
• List ID(s) not passed
• One or more list IDs are invalid
• List IDs does not belong to a single brand
• Brand ID not passed
• Unable to create campaign
• Unable to create and send campaign

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
• More thorough documentation