Skip to content
This repository has been archived by the owner on Nov 1, 2021. It is now read-only.

Latest commit

 

History

History
203 lines (177 loc) · 5.17 KB

README.md

File metadata and controls

203 lines (177 loc) · 5.17 KB

PHP SDK for OneSignal RESTful API

OneSignal is a high volume and reliable push notification service for websites and mobile applications. We support all major native and mobile platforms by providing dedicated SDKs for each platform, a RESTful server API, and an online dashboard for marketers to design and send push notifications.

System requirements

  • PHP >= 5.5

Installation

Using Composer composer require namnv609/php-onesignal-sdk or you can include the following in your composer.json "namnv609/php-onesignal-sdk": "1.0"

Response format

{"status":true,"code":200,"response":<OneSignal result>}
$players = $player->all();

foreach ($players->response->players as $player) {
    echo $player->id . PHP_EOL;
}

Usage Instructions

First, create a new OneSignal instance to make configuring the library for usage.

use NNV\OneSignal\OneSignal;

$oneSignal = new OneSignal(<User Auth key> [, <App ID>, <App REST key>, <Extra options for GuzzleHttp Client>])

Once the OneSignal instance has been registered. You may use it like so:

Application body parameters: Create and Update

use NNV\OneSignal\API\App;

$app = new App($oneSignal);
  • View apps
$app->all();
  • View an app
$app->get("<App ID>");
  • Create an app
$appData = [
    'name' => '<App name>',
    'apns_env' => 'sandbox',
];

$app->create($appData);
  • Update an app
$appData = [
    'apns_env' => 'production',
];

$app->update("<App ID>", $appData);

Player (Device) body parameters: Create, Update, New session, New purchase, Increment session length and CSV export

use NNV\OneSignal\API\Player;

$player = new Player($oneSignal [, <App ID>, <App REST key>]);
  • View devices
$player->all([<Limit>, <Offset>]);
  • View device
$player->get("<Player ID>");
  • Add a device
use NNV\OneSignal\Constants\DeviceTypes;

$playerData = [
    'language' => 'en',
    'tags' => [
        'for' => 'bar',
        'this' => 'that'
    ]
];

$player->create(DeviceTypes::CHROME_WEBSITE, $playerData);
  • Edit device
use NNV\OneSignal\Constants\NotificationTypes;
use NNV\OneSignal\Constants\TestTypes;

$playerData = [
    'test_type' => TestTypes::DEVELOPMENT,
    'notification_types' => NotificationTypes::UNSUBSCRIBED
];

$player->update("<Player ID>", $playerData);
  • New session
$sessionData = [
    'tags' => [
        'new' => 'session',
    ],
];
$player->onSession("<Player ID>", $sessionData);
  • New purchase (Currently, i've support one item per request)
$purchaseData = [
    'sku' => 'SKU123',
    'iso' => 'USD',
    'amount' => '0.99',
];

$player->onPurchase("<Player ID>", $purchaseData, [<Is existing>]);
  • Increment session length
$focusData = [
    'state' => 'ping',
    'active_time' => 1,
];

$player->onFocus("<App ID>", $focusData);
  • CSV export
$extraFields = ['rooted'];

$player->csvExport($extraFields);

Notification body parameters: Create

use NNV\OneSignal\API\Notification;

$notification = new Notification($oneSignal[, <App ID>, <App REST key>]);
  • Create notification
$notificationData = [
    'included_segments' => ['All'],
    'contents' => [
        'en' => 'Hello, world',
    ],
    'headings' => [
        'en' => 'Hello',
    ],
    'buttons' => [
        [
            'id' => 'button_id',
            'text' => 'Button text',
            'icon' => 'button_icon',
        ],
    ],
    'filters' => [
        [
            'field' => 'tag',
            'key' => 'level',
            'relation' => '>',
            'value' => '10',
        ],
    ],
    'send_after' => 'Sep 24 2017 14:00:00 GMT-0700',
    'isChromeWeb' => true,
];

$notification->create($notificationData);
  • Cancel notification
$notification->cancel("<Notification ID>");
  • View notification
$notification->get("<Notification ID>");
  • View notifications
$notification->all([<Limit>, <Offset>]);
  • Track open
$notification->trackOpen("<Notification ID>");