๐ Sendy PHP API Wrapper: Complete API interfacing.
With this Sendy PHP API Wrapper
you can do the following:
SUBSCRIBERS
- Subscribe.
- Unsubscribe.
- Delete subscriber.
- Subscription status.
LISTS
- Active subscriber count.
CAMPAIGNS
- Create.
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.
-
Download the library class-sendy-php-api.php
curl -O https://git.io/vyFbs
-
Composer Install
composer require ahmadawais/sendy-php-api
// Define the global var to avoid direct access to the library class.
define( 'Sendy_PHP_API_Wrapper', TRUE );
require_once( 'class-sendy-php-api.php' );
$config = array(
'installation_url' => 'http://send.yourdomain.com', // Your Sendy installation URL (without trailing slash).
'api_key' => 'XXXXXXXXXXXXXXXXXXXXXXXXXX', // Your API key. Aavailable in Sendy Settings.
'list_id' => 'XXXXXXXXXXXXXXXXXXXXXXXXXX',
);
$sendy = new \SENDY\Sendy_PHP_API( $config );
// Method #1: Subscribe.
$result_array = $sendy->subscribe( array(
'name' => 'Name',
'email' => '[email protected]', // This is the only field required by sendy.
'custom' => 'field' // You can custom fields as well.
));
// Method #2: Unsubscribe.
$result_array = $sendy->unsubscribe( '[email protected]' );
// Method #3: Subscriber Status.
$result_array = $sendy->substatus( '[email protected]' );
// Method #4: Delete Subscriber.
$result_array = $sendy->delete( '[email protected]' );
// Method #5: Subscriber Count of a list.
$result_array = $sendy->subcount();
// Method #6: Campaign โ Draft And/Or Send as well.
$result_array = $sendy->campaign( array(
'from_name' => 'Your Name',
'from_email' => '[email protected]',
'reply_to' => '[email protected]',
'subject' => 'Your Subject',
'plain_text' => 'An Amazing campaign', // (optional).
'html_text' => '<h1>Amazing campaign</h1>',
'brand_id' => 0, // Required only if you are creating a 'Draft' campaign.
'send_campaign' => 0 // Set to 1 if you want to send the campaign as well and not just create a draft. Default is 0.
'list_ids' => 'your_list_id', // Required only if you set send_campaign to 1.
'query_string' => 'some', // Eg. Google Analytics tags.
) );
// Method #7: Change the `list_id` you are referring to at any point.
$sendy->set_list_id( "XXXXXXX" );
// Method #7: Get the `list_id` you are referring to at any point.
$sendy->get_list_id( "XXXXXXX" );
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.
status
is eithertrue
orfalse
.message
is based on the type of action being performed
// E.g. SUCCESS response.
array(
'status' => true,
'message' => 'Already Subscribed'
)
// E.g. FAIL response.
array(
'status' => false,
'message' => 'Some fields are missing.'
)
- First version
- Basic methods for all API routes.
The code is licensed under MIT and a huge props to Jacob Bennett for his initial work on the lib. Requires at least PHP 5.3.0 (otherwise remove the namespace).