Download the PHP package jiririedl/php-sendy without Composer

PHP sendy client

PHP interface for Sendy api (http://sendy.co/) with full support Sendy API (http://sendy.co/api)

Installation

Using composer

Simply add new require jiririedl/php-sendy to your composer.json.

and update in console

Using autoload (alternative dirty way)

If you don't use Composer (for some reasons) you can download and include library bootstrap into your project manually. This wil add spl_autoload for SendyPHP namespace.

Using autoload method (alternative dirty dirty way)

If you have your own solution of class autoloading, there is prepared autload function in /src/autoload.php. Calling includes requested class from SendyPHP namespace or returns FALSE

Usage

Create instance of \SendyPHP\Sendy with URL of your Sendy installation and API key. Your API key is located in sendy - login as Admin and go to "Settings" (/settings) - your key is located in right side under topic "Your API key" beware of white spaces!

Some request doesn't need API key for work (f.e. unsubscribe()) so setting api key is optional. You can also set api key by using setURL().

Methods

Sendy API Requests

All requests uses curl library for calling Sendy API. If you have installed library by using Composer, curl was checked automatically, otherwise you can check this in your phpinfo, or just try to call some method from curl (http://php.net/manual/en/ref.curl.php).

Subscribe

This method adds a new subscriber to a list. You can also use this method to update an existing subscriber.

Parameters

• $listID - the list id you want to subscribe a user to. This encrypted & hashed id can be found under View all lists section named ID
• $email - user's email
• $name <string|null> - optional -user's name is optional
• $customFields - optional - associative array of custom fields and their values f.e. array('salutation'=>'Mr.','userLevel'=>'VIP+')
• $statusMessage <string|null> - optional - here will be returned status message f.e. if you get FALSE again, and again, here you can find why

Example

Exceptions

All exceptions are extended from \SendyPHP\Exception so you can easily catch just this parent class

• \SendyPHP\Exception\InvalidEmailException is thrown if email address is not valid
• \SendyPHP\Exception\DomainException is thrown if $listID is empty
• \SendyPHP\Exception\CurlException is thrown if cURL library could not handle your request

Return values

Returns TRUE on success or FALSE on failure.

UnSubscribe

This method unsubscribes a user from a list.

Parameters

• $listID - the list id you want to unsubscribe a user from. This encrypted & hashed id can be found under View all lists section named ID
• $email - user's email
• $statusMessage <string|null> - optional - here will be returned status message f.e. if you get FALSE again, and again, here you can find why

Example

Exceptions

All exceptions are extended from \SendyPHP\Exception so you can easily catch just this parent class

• \SendyPHP\Exception\InvalidEmailException is thrown if email address is not valid
• \SendyPHP\Exception\DomainException is thrown if $listID is empty
• \SendyPHP\Exception\CurlException is thrown if cURL library could not handle your request

Return values

Returns TRUE on success or FALSE on failure.

Delete

This method deletes a subscriber off a list (only supported in Sendy version 2.1.1.4 and above).

Parameters

• $listID - the list id you want to delete a user from. This encrypted & hashed id can be found under View all lists section named ID
• $email - user's email
• $statusMessage <string|null> - optional - here will be returned status message f.e. if you get FALSE again, and again, here you can find why

Example

Exceptions

All exceptions are extended from \SendyPHP\Exception so you can easily catch just this parent class

• \SendyPHP\Exception\InvalidEmailException is thrown if email address is not valid
• \SendyPHP\Exception\DomainException is thrown if $listID is empty
• \SendyPHP\Exception\CurlException is thrown if cURL library could not handle your request

Return values

Returns TRUE on success or FALSE on failure.

Get active subscriber count

This method gets the total active subscriber count.

Parameters

• $listID - the list id you want to subscribe a user to. This encrypted & hashed id can be found under View all lists section named ID
• $statusMessage <string|null> - optional - here will be returned status message f.e. if you get FALSE again, and again, here you can find why

Example

Exceptions

All exceptions are extended from \SendyPHP\Exception so you can easily catch just this parent class

• \SendyPHP\Exception\DomainException is thrown if $listID is empty
• \SendyPHP\Exception\CurlException is thrown if cURL library could not handle your request

Return values

Returns number of active subscribers or FALSE on failure.

Get subscribtion status

This method gets the current status of a subscriber (eg. subscribed, unsubscribed, bounced, complained).

Parameters

• $listID - the list id you want to subscribe a user to. This encrypted & hashed id can be found under View all lists section named ID
• $email - user's email

Example

Exceptions

All exceptions are extended from \SendyPHP\Exception so you can easily catch just this parent class

• \SendyPHP\Exception\DomainException is thrown if $listID is empty
• \SendyPHP\Exception\InvalidEmailException is thrown if email address is not valid
• \SendyPHP\Exception\CurlException is thrown if cURL library could not handle your request

Return values

\SendyPHP\Response\SubscriptionStatus returned object has many of usable methods (see phpdoc) f.e. by calling success() are you able to check if API returns some subscribers status.

Create campaign

Creates draft of campaign

Parameters

• $brandID - Brand IDs can be found under 'Brands' page named ID
• $campaign <\SendyPHP\Model\Campaign> - configured campaign
• $statusMessage <string|null> - optional - here will be returned status message f.e. if you get FALSE again, and again, here you can find why

Example

Exceptions

All exceptions are extended from \SendyPHP\Exception so you can easily catch just this parent class

• \SendyPHP\Exception\CurlException is thrown if cURL library could not handle your request

Return values

Returns TRUE on success or FALSE on failure.

Send campaign

Creates draft and automatically sends campaign

Parameters

• $listIDs <number[]> - The encrypted & hashed ids can be found under View all lists section named ID.
• $campaign <\SendyPHP\Model\Campaign> - configured campaign
• $statusMessage <string|null> - optional - here will be returned status message f.e. if you get FALSE again, and again, here you can find why

Example

Exceptions

All exceptions are extended from \SendyPHP\Exception so you can easily catch just this parent class

• \SendyPHP\Exception\CurlException is thrown if cURL library could not handle your request
• \SendyPHP\Exception\DomainException is thrown if $listIDs array is empty

Return values

Returns TRUE on success or FALSE on failure.

Other methods

Set cURL option

Sets cURL option You can set cURL options f.e. CURLOPT_SSL_VERIFYPEER or CURLOPT_SSL_VERIFYHOST some parameters (\CURLOPT_RETURNTRANSFER, \CURLOPT_POST, \CURLOPT_POSTFIELDS) are used, if you try to set one of these exception is thrown. See http://php.net/manual/en/function.curl-setopt.php for more informations.

Parameters

• $option - use \CURLOPT_* constant
• $value mixed

Exceptions

\SendyPHP\Exception\UnexpectedValueException is thrown if you try to set one of predefined options (\CURLOPT_RETURNTRANSFER, \CURLOPT_POST and \CURLOPT_POSTFIELDS).

Clear cURL option

Sets cURL option Clears user defined cURL options

Set URL

Sets sendy installation URL Clears user defined cURL options

Exceptions

\SendyPHP\Exception\InvalidURLException is thrown if URL is invalid.

Set API key

Sets api key

Parameters

• $apiKey - sendy API key - your API key is available in sendy Settings

Exceptions

\SendyPHP\Exception\DomainException is thrown if API key is not string.