README

A connector SDK library for applications integrating with Acoustic, formerly Silverpop, including the Universal Behavior API.

Latest Version

Release versions are available as a tagged release. If you'd prefer the latest ongoing development version, it's in the master branch.

Installation

You can install using composer or from source.

Composer

If you don't have Composer install it:

$ curl -s https://getcomposer.org/installer | php

Add this to your composer.json:

{
	"require": {
		"mrmarkfrench/silverpop-php-connector": "*"
	}
}

Refresh your dependencies:

$ php composer.phar update

Then make sure to require the autoloader:

<?php
require_once(__DIR__ . '/vendor/autoload.php');
...

Source

Download the silverpop-php-connector source:

$ git clone https://github.com/mrmarkfrench/silverpop-php-connector

And then require all bootstrap files:

<?php
require_once "vendor/autoload.php";
...

Quickstart

curl -s http://getcomposer.org/installer | php

echo '{
	"require": {
		"mrmarkfrench/silverpop-php-connector": "*"
	}
}' > composer.json

php composer.phar install

curl https://raw.githubusercontent.com/mrmarkfrench/silverpop-php-connector/master/apiTest.php > apiTest.php

# Replace indicated values with your own credentials
echo '[silverpop]
baseUrl       = "http://api.pilot.silverpop.com"
client_id     = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
refresh_token = "YOUR_REFRESH_TOKEN"
username      = "YOUR_USERNAME"
password      = "YOUR_PASSWORD"
notify_email  = "EMAIL_ADDRESS_TO_NOTIFY"
[sftp_config]
sftpUrl       = "YOUR_SFTP_URL.silverpop.com"
mail_from     = "YOUR_EMAIL_FROM"
mail_to       = "SEND_EMAIL_TO"
mail_cc       = ""
mail_bcc      = ""' > authData.ini

php apiTest.php

Contributions and Adding Functionality

The SDK currently supports only a subset of the API endpoints offered by Silverpop. New endpoints are added as the primary author's projects need them, but you are welcome to add your own! If your project requires an endpoint not yet supported, please feel free to fork this repository and add functions as necessary. The existing functions should give you a solid framework to build on, and your pull requests are welcome.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request