Requirements
PHP 5.4 and later., (*1)
Composer
You can install the library via Composer. Add this to your composer.json
:, (*2)
{
"require": {
"jgodish/mblox-mms-xml-client": "1.*"
}
}
Then install via:, (*3)
composer install
To use the library, use Composer's autoload:, (*4)
require_once('vendor/autoload.php');
Getting Started
Usage example:, (*5)
$mblox = \Mblox\Mms\Xml\Client('your_api_key', 'short_code');
$slide = (new \Mblox\Mms\Xml\Slide)->setImage('http://www.yoursite.com/images/1.jpg')->setMessageText('This is some text for your slide');
$response = $mblox->mms()->send('mytestmms', '15555555555', [$slide], 'This is some fallback text');
Handling API Response's
$mblox = \Mblox\Mms\Xml\Client('your_api_key', 'short_code');
$slide = (new \Mblox\Mms\Xml\Slide)->setImage('http://www.yoursite.com/images/1.jpg')->setMessageText('This is some text for your slide');
$response = $mblox->mms()->send('mytestmms', '15555555555', [$slide], 'This is some fallback text');
// Check for successful response
$response->isSuccessful();
// Convert response to an array
$response->toArray();
// Get string representation of the response
$response->toString();
Available Methods
Save MMS
$mblox = \Mblox\Mms\Xml\Client('your_api_key', 'short_code');
$slide = (new \Mblox\Mms\Xml\Slide)->setImage('http://www.yoursite.com/images/1.jpg')->setMessageText('This is some text for your slide');
$mblox->mms()->save('mytestmms', 'Message Subject', [$slide]);
Send Saved MMS
$mblox = \Mblox\Mms\Xml\Client('your_api_key', 'short_code');
$ddm = new \Mblox\Mms\Xml\DeviceDiscovery('This message is free of charge and will allow us to deliver your content nice and smooth');
$mblox->mms()->sendSaved('mms_id', '15555555555', 'This is some fallback text', $ddm);
Send MMS
$mblox = \Mblox\Mms\Xml\Client('your_api_key', 'short_code');
$slide = (new \Mblox\Mms\Xml\Slide)->setImage('http://www.yoursite.com/images/1.jpg')->setMessageText('This is some text for your slide');
$mblox->mms()->send('mytestmms', '15555555555', [$slide], 'This is some fallback text');
Delete MMS
$mblox = \Mblox\Mms\Xml\Client('your_api_key', 'short_code');
$mblox->mms()->delete('mms_id');
Get MMS Templates
$mblox = \Mblox\Mms\Xml\Client('your_api_key', 'short_code');
$mblox->mms()->getTemplates();
Slides
The following methods can be used when creating slides, (*6)
- setMessageText($text)
- setDuration($duration)
- setImage($url)
- setAudio($url)
- setVideo($url)
- setVcard($url)
- setIcal($url)
- setPdf($url)
- setPassbook($url)
- toArray()