mylittleparis / campaign-commander
Client for the Campaign Commander API (wrapper)
Installs: 2 019
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 33
Forks: 8
Open Issues: 0
Requires
- php: >=5.4.4
- ext-soap: *
- besimple/soap-client: 0.2.*
Requires (Dev)
- phpunit/phpunit: 3.7.*
- satooshi/php-coveralls: 0.6.*
This package is not auto-updated.
Last update: 2024-12-15 04:51:14 UTC
README
Campaign Commander is the stuff you need to manage your Campaign Commander.
About
PHP Campaign Commander is a library to communicate with the Campaign Commander API.
License
PHP Campaign Commander is BSD licensed.
Documentation
Requirements
- PHP >= 5.4.4
- soap extension
Installation through Composer
{ "require": { "mylittleparis/campaign-commander": "dev-master" }, }
Architecture
This library is structured on 2 layers:
- Low-level API clients : only SOAP (using BeSimple lib) clients are provided (one for standard requests, one for requests containing attachments)
- Mid-level API services : using low-level clients, they are mapped to CampaignCommander API methods and allow you to really work with CampaignCommander
Basic usage
Principle:
- Instantiate a mid-level service with an appropriate low-level API client factory
- Enjoy the service methods :)
Example : create an export from a segment
use BeSimple\SoapClient as Soap; use MyLittle\CampaignCommander\API\SOAP as Client; use MyLittle\CampaignCommander\Service as Service; $clientFactory = new Client\StandardClientFactory(new Soap\SoapClientBuilder(), 'login', 'password', 'key', 'http://emvapi.emv3.com'); $service = new Service\MemberExportService($clientFactory); try { $result = $service->createDownloadByMailinglist('ID_SEGMENT', 'ALL_MEMBERS', 'EMAIL,FIELD1', 'PIPE', 'true', 'EMAIL', 'true'); }
Testing
PHPUnit
this library comes with some unit tests. if you plan to run these tests, you can do it simply by running phpunit in the project root directory like that :
$ cd /path/to/lib
$ phpunit
For more information about PHPUnit, you can read the official documentation
The tests are located in the folder tests/
.