Add push/one, alias and testing support

Author: AbdullahDiaa

README.md

@@ -35,24 +35,69 @@ require 'vendor/autoload.php';
 use Pushbots\PushbotsClient;
 
 $client = new PushbotsClient("APPLICATION_ID", "APPLICATION_SECRET");
+
+//Sample sending campaign to all users
 $client->campaign->send([
 	//Platforms
-	"platform" => [0,1,2], 
+	//0 => iOS
+	//1 => Android
+	//2 => Chrome
+	//3 => Firefox
+	//4 => Safari
+	"platform" => [0,1,2,3,4], 
 	//Message
-	"msg" => "test",
+	"msg" => "Notification message"
 	//Badge [iOS only]
 	"badge"	=> "+1",
 	//Notification payload
 	"payload"=>[
 		"key"=> "value"
 	]
 ]);
+
+```
+
+Alias
+------------
+
+```php
+//Sample sending campaign to an alias
+$client->campaign->alias("ALIAS", "Notification message");
 ```
 
 
+Test notification
+------------
+
+```php
+//Sample sending campaign to an alias
+$client->campaign->test();
+```
+
+Sending to one device [Transactional]
+------------
+
+```php
+//Sample sending campaign to an alias
+$client->transactional->send([
+	// iOS and Android only supported
+	//0 => iOS
+	//1 => Android
+	"platform" => 0, 
+	//token
+	"token" => "71e7aef2f01d055b11c958dc48d06a655541b054196dd33b071777e1557dcb48",
+	//Message
+	"msg" => "Notification message"
+]);
+```
 
 Changelog
 -------------
 
+Version 1.1.0
+ * Add testing notification.
+ * Add Push/one support.
+ * Add alias support.
+
 Version 1.0.0
  * Release PushBots PHP package

src/.htaccess

@@ -31,4 +31,29 @@ public function send($options)
     {
         return $this->_client->post("push/all", $options);
     }
+	
+    /**
+     * Sends a notification using alias [v1]
+     *
+     * @param  string $alias Alias
+     * @param  string $msg Notification message
+     * @param  string $payload
+     * @return mixed
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     */
+    public function alias($alias, $msg, $payload = [])
+    {
+        return $this->_client->post("push/all", ["platform" => [0,1,2,3,4], "alias" => $alias, "msg" => $msg, "payload"=> $payload]);
+    }
+	
+    /**
+     * Sends a test notification to test devices [v1]
+     *
+     * @return mixed
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     */
+    public function test()
+    {
+        return $this->_client->post("push/all", ["platform" => [0,1,2,3,4], "alias" => "PB_TESTING_DEVICE", "msg" => "Testing notification from PushBots"]);
+    }
 }

src/PushbotsCampaign.php

@@ -41,6 +41,10 @@ class PushbotsClient
      */
     public $campaign;
 
+    /**
+     * @var PushbotsTransactional $$transactional Sends a notification to single user using Pushbots API.
+     */
+    public $transactional;
 
     /**
      * PushbotsClient constructor.
@@ -52,6 +56,7 @@ public function __construct($applicationId, $applicationSecret)
     {
         $this->_setClient();
         $this->campaign = new PushbotsCampaign($this);
+        $this->transactional = new PushbotsTransactional($this);
 
         $this->applicationId = $applicationId;
         $this->applicationSecret = $applicationSecret;

src/PushbotsClient.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Pushbots;
+
+class PushbotsTransactional
+{
+    /**
+     * @var PushbotsTransactional
+     */
+    private $_client;
+
+    /**
+     * PushbotsTransactional constructor.
+     *
+     * @param PushbotsClient $client
+     */
+    public function __construct($client)
+    {
+        $this->_client = $client;
+    }
+
+    /**
+     * Sends a notification [v1]
+     *
+     * @see    https://developer.pushbots.com/api/v2/#/Devices/pushOne
+     * @param  array $options
+     * @return mixed
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     */
+    public function send($options)
+    {
+        return $this->_client->post("push/one", $options);
+    }
+}

src/PushbotsTransactional.php

@@ -0,0 +1,21 @@
+<?php
+	
+use Pushbots\PushbotsTransactional;
+use Pushbots\PushbotsClient;
+use GuzzleHttp\Client;
+use GuzzleHttp\Handler\MockHandler;
+use GuzzleHttp\Psr7\Response;
+use GuzzleHttp\HandlerStack;
+use GuzzleHttp\Middleware;
+	
+class PushbotsTransactionalTest extends PHPUnit_Framework_TestCase
+{
+	public function testCampaignSend()
+	{
+		$stub = $this->getMockBuilder('Pushbots\PushbotsClient')->disableOriginalConstructor()->getMock();
+		$stub->method('send')->willReturn(null);
+	
+		$campaign = new PushbotsTransactional($stub);
+		$this->assertEquals(null, $campaign->send([]));
+	}
+}