Merge pull request #97 from ayazshakoor/issue/send_notification_to_external_user

Send notification by external user ids

Author: berkayk

README.md

@@ -137,6 +137,27 @@ Read https://documentation.onesignal.com/docs/web-push-tagging-guide for additio
 a `$url` parameter, users will be redirecting to that url.
 
 
+
+### Sending a Notification To A Specific external User (custom user id added by user)
+
+After storing a user's tokens in a table, you can simply send a message with
+
+```php
+    OneSignal::sendNotificationToExternalUser(
+        "Some Message",
+        $userId,
+        $url = null,
+        $data = null,
+        $buttons = null,
+        $schedule = null
+    );
+```
+
+`$userId` is the user's unique external id (custom id) added by the user where he/she is registered for notifications.
+Read https://documentation.onesignal.com/docs/web-push-tagging-guide for additional details.
+`$url` , `$data` , `$buttons` and `$schedule` fields are exceptional. If you provide
+a `$url` parameter, users will be redirecting to that url.
+
 ### Sending a Notification To Segment
 
 You can simply send a notification to a specific segment with

src/OneSignalClient.php

@@ -174,6 +174,57 @@ public function sendNotificationToUser($message, $userId, $url = null, $data = n
         $this->sendNotificationCustom($params);
     }
 
+    /**
+     * @param $message
+     * @param $userId
+     * @param null $url
+     * @param null $data
+     * @param null $buttons
+     * @param null $schedule
+     * @param null $headings
+     * @param null $subtitle
+     */
+    public function sendNotificationToExternalUser($message, $userId, $url = null, $data = null, $buttons = null, $schedule = null, $headings = null, $subtitle = null) {
+        $contents = array(
+            "en" => $message
+        );
+
+        $params = array(
+            'app_id' => $this->appId,
+            'contents' => $contents,
+            'include_external_user_ids' => is_array($userId) ? $userId : array($userId)
+        );
+
+        if (isset($url)) {
+            $params['url'] = $url;
+        }
+
+        if (isset($data)) {
+            $params['data'] = $data;
+        }
+
+        if (isset($buttons)) {
+            $params['buttons'] = $buttons;
+        }
+
+        if(isset($schedule)){
+            $params['send_after'] = $schedule;
+        }
+
+        if(isset($headings)){
+            $params['headings'] = array(
+                "en" => $headings
+            );
+        }
+
+        if(isset($subtitle)){
+            $params['subtitle'] = array(
+                "en" => $subtitle
+            );
+        }
+
+        $this->sendNotificationCustom($params);
+    }
     public function sendNotificationUsingTags($message, $tags, $url = null, $data = null, $buttons = null, $schedule = null, $headings = null, $subtitle = null) {
         $contents = array(
             "en" => $message