Merge pull request #43 from ivkos/alldevices

Method for targeting all devices for pushing

Author: ivkos

README.md

@@ -69,6 +69,12 @@ $pb->device("Galaxy S4")->getPhonebook();
 ```
 Returns an array of `PhonebookEntry` objects with names and phone numbers.
 
+To target all available devices for pushing:
+```php
+$pb->allDevices()->pushAddress("Google HQ", "1600 Amphitheatre Parkway");
+```
+This will send the address to all devices, and return a `Push` object.
+
 ### Push Notifications
 You can use `push*` methods for `Contact`, `Channel` and `Device` objects. Every `push*` method returns a `Push` object. If an object cannot be pushed to, a `NotPushableException` will be thrown.
 

src/Pushbullet/Pushbullet.php

@@ -5,7 +5,7 @@
 /**
  * Pushbullet
  *
- * @version 3.0.0
+ * @version 3.1.0
  */
 class Pushbullet
 {
@@ -116,6 +116,20 @@ public function device($idenOrNickname)
         throw new Exceptions\NotFoundException("Device not found.");
     }
 
+    /**
+     * Target all devices for pushing. This method returns a pseudo-device object that can only be pushed to. It
+     * does not support SMS, has no phonebook, and cannot be deleted.
+     *
+     * @return Device A pseudo-device that targets all available devices for pushing.
+     */
+    public function allDevices() {
+        return new Device([
+            "iden" => "",
+            "pushable" => true,
+            "has_sms" => false
+        ], $this->apiKey);
+    }
+
     /**
      * Create a new contact.
      *