🚀 Sendy PHP API Wrapper: Complete API interfacing.
With this Sendy PHP API Wrapper you can do the following:
| SUBSCRIBERS | LISTS | CAMPAIGNS |
|---|---|---|
| Subscribe | Set List | Create |
| Unsubscribe | Get List | Draft |
| Delete subscriber | Active subscriber count | Send |
| Subscription status | List Segments handling | Assign to brands |
Getting started is easy. Here's how you do it. You can check the example.php file as well. Obviously, you'll have to download the wrapper to your current setup. Several ways to do that.
Git clone this repo and include ./src/Sendy.php in your project.
Composer Install is the preferred method.
composer require ahmadawais/sendy-php-api// New way using PSR4 Standard autoloader. Recommended
require_once . '/vendor/autoload.php';
// Old way of requiring all files manually. Not recommended.
require_once( 'API.php' );// 2. Configuration.
$config = [
'sendyUrl' => 'https://send_installation_url.com', // Your Sendy installation URL (without trailing slash).
'apiKey' => 'XXXXXXXXXXXXXXXX', // Your API key. Available in Sendy Settings.
'listId' => 'XXXXXXXXXXXXXXXX',
];use AhmadAwais\Sendy\API as Sendy;
$sendy = new Sendy( $config );- Method:
subscribe(). - Method:
unsubscribe(). - Method:
subStatus(). - Method:
delete(). - Method:
subCount(). - Method:
campaign().
// Method #1: Subscribe.
$responseArray = $sendy->subscribe(
[
'email' => '[email protected]', // This is the only field required by sendy.
'name' => 'Name', // User name (optional).
'custom' => 'Field Value', // You can custom fields as well (optional).
'country' => 'US', // User 2 letter country code (optional).
'ipaddress' => 'XX.XX.XX.XXX', // User IP address (optional).
'referrer' => 'https://AhmadAwais.com/', // URL where the user signed up from (optional).
'gdpr' => true, // GDPR compliant? Set this to "true" (optional).
]
);$responseArray = $sendy->unsubscribe( '[email protected]' );$responseArray = $sendy->subStatus( '[email protected]' );$responseArray = $sendy->delete( '[email protected]' );$responseArray = $sendy->subCount();// Method #6: Campaign — Draft And/Or Send as well.
$responseArray = $sendy->campaign(
array(
'from_name' => 'Your Name',
'from_email' => '[email protected]',
'reply_to' => '[email protected]',
'title' => 'Title', // the title of your campaign.
'subject' => 'Your Subject',
'plain_text' => 'An Amazing campaign', // Optional.
'html_text' => '<h1>Amazing campaign</h1>',
'brand_id' => 1, // Required only if you are creating a 'Draft' campaign. That is `send_campaign` set to 0.
'send_campaign' => 0, // SET: Draft = 0 and Send = 1 for the campaign.
// Required only if you set send_campaign to 1 and no `segment_ids` are passed in.. List IDs should be single or comma-separated.
'list_ids' => 'XXXXXXXX, XXXXXXXX',
// Required only if you set send_campaign to 1 and no `list_ids` are passed in. Segment IDs should be single or comma-separated.
'segment_ids' => '1',
// Lists to exclude. List IDs should be single or comma-separated. (optional).
'exclude_list_ids' => '',
// Segments to exclude. Segment IDs should be single or comma-separated. (optional).
'exclude_segments_ids' => '',
'query_string' => 'XXXXXXXX', // Eg. Google Analytics tags.
)
);// Method #7: Change the `XXXXXXX` you are referring to at any point.
$sendy->setListId( 'XXXXXXX' );// Method #7: Get the `XXXXXXX` you are referring to at any point.
$sendy->getListId();The response of this PHP wrapper is custom-built. At the moment, it always returns a PHP Array. This array has the status of your action and an appropriate message in the response.
statusis eithertrueorfalse.messageis based on the type of action being performed
// E.g. SUCCESS response.
[
'status' => true,
'message' => 'Already Subscribed'
];
// E.g. FAIL response.
[
'status' => false,
'message' => 'Some fields are missing.'
];
KEY: 📦 NEW, 👌 IMPROVE, 🐛 FIX, 📖 DOC, 🚀 RELEASE, and ✅ TEST
I use Emoji-log, you should try it and simplify your git commits.
- MIT © Ahmad Awais
- Code of Conduct
- Props to Jacob Bennett for his initial work on the lib.
- Requires at least PHP 5.3.0 (otherwise remove the namespaces).
Me (Ahmad Awais) and my incredible wife (Maedah Batool) are two engineers who fell in love with open source and then with each other. You can read more about me here. If you or your company use any of my projects or like what I’m doing then consider backing me. I'm in this for the long run. An open-source developer advocate.
