IOS8 Support

CHANGELOG.md

 ## ChangeLog
+
+#### Version 0.7.5 (29.10.2014)
+- [enhancement:] __iOS8 Support__
+- [feature:] New method `hasPermission` to ask if the user has granted to display local notifications.
+- [feature:] New method `promptForPermission` to promt the user to grant permission to display local notifications.
+
 #### Version 0.7.4 (22.03.2014)
 - [bugfix:] Platform specific properties were ignored.
 - [bugfix:] `cancel` may throw an error if the OS returns NIL values (iOS).

README.md

@@ -19,7 +19,7 @@ The purpose of the plugin is to create an platform independent javascript interf
 
 
 ## Supported Platforms
-- **iOS**<br>
+- **iOS** *(including iOS8)*<br>
 See [Local and Push Notification Programming Guide][ios_notification_guide] for detailed informations and screenshots.
 
 - **Android** *(SDK >=11)*<br>
@@ -42,12 +42,12 @@ The plugin can either be installed into the local development environment or clo
 Through the [Command-line Interface][CLI]:
 ```bash
 # ~~ from master ~~
-cordova plugin add https://github.com/katzer/cordova-plugin-local-notifications.git && cordova prepare
+cordova plugin add https://github.com/katzer/cordova-plugin-local-notifications.git
 ```
 or to use the last stable version:
 ```bash
 # ~~ stable version ~~
-cordova plugin add de.appplant.cordova.plugin.local-notification && cordova prepare
+cordova plugin add de.appplant.cordova.plugin.local-notification@0.7.5
 ```
 
 ### Removing the Plugin from your project
@@ -63,11 +63,22 @@ Add the following xml to your config.xml to always use the latest version of thi
 ```
 or to use an specific version:
 ```xml
-<gap:plugin name="de.appplant.cordova.plugin.local-notification" version="0.7.2" />
+<gap:plugin name="de.appplant.cordova.plugin.local-notification" version="0.7.5" />
 ```
 More informations can be found [here][PGB_plugin].
 
 
+## ChangeLog
+
+#### Version 0.7.5 (29.10.2014)
+- [enhancement:] __iOS8 Support__
+- [feature:] New method `hasPermission` to ask if the user has granted to display local notifications.
+- [feature:] New method `promptForPermission` to promt the user to grant permission to display local notifications.
+
+#### Further informations
+- See [CHANGELOG.md][changelog] to get the full changelog for the plugin.
+
+
 ## Using the plugin
 The plugin creates the object ```window.plugin.notification.local``` with the following methods:
 
@@ -80,6 +91,30 @@ document.addEventListener('deviceready', function () {
 }, false);
 ```
 
+### Determine if the app does have the permission to show local notifications
+If the permission has been granted through the user can be retrieved through the `notification.badge.hasPermission` interface.<br/>
+The method takes a callback function as its argument which will be called with a boolean value. Optional the scope of the callback function ca be defined through a second argument.
+
+#### Further informations
+- The method is supported on each platform, however its only relevant for iOS8 and above.
+
+```javascript
+window.plugin.notification.local.hasPermission(function (granted) {
+    // console.log('Permission has been granted: ' + granted);
+});
+```
+
+### Prompt the user to grant permission for local notifications
+The user can be prompted to grant the required permission through the `notification.badge.promptForPermission` interface.
+
+#### Further informations
+- The method is supported on each platform, however its only relevant for iOS8 and above.
+- The user will only get a prompt dialog for the first time. Later its only possible to change the setting via the notification center.
+
+```javascript
+window.plugin.notification.local.promptForPermission();
+```
+
 ### Schedule local notifications
 Local notifications can be scheduled through the `notification.local.add` interface.<br>
 The method takes a hash as an argument to specify the notification's properties and returns the ID for the notification.<br>
@@ -90,6 +125,7 @@ All properties are optional. If no date object is given, the notification pops-u
 If the ID has an invalid format, it will be ignored, but canceling the notification will fail.
 
 #### Further informations
+- The notification can only be sheduled if the user has previously granted the [required permission][prompt_permission].
 - See the [onadd][onadd] event of how a listener can be registered to be notified when a local notification has been scheduled.
 - See the [ontrigger][ontrigger] event of how a listener can be registered to be notified when a local notification has been triggered.
 - See the [onclick][onclick] event of how a listener can be registered to be notified when the user has been clicked on a local notification.
@@ -268,6 +304,8 @@ window.plugin.notification.local.add({
 });
 ```
 
+__Note:__ The notification can only be sheduled if the user has granted the [required permission][prompt_permission].
+
 ### Scheduling an immediately triggered local notification
 The example below shows how to schedule a local notification which will be triggered immediatly.
 
@@ -448,6 +486,9 @@ This software is released under the [Apache 2.0 License](http://opensource.org/l
 [CLI]: http://cordova.apache.org/docs/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface
 [PGB]: http://docs.build.phonegap.com/en_US/3.3.0/index.html
 [PGB_plugin]: https://build.phonegap.com/plugins/413
+[changelog]: CHANGELOG.md
+[has_permission]: #determine-if-the-app-does-have-the-permission-to-show-local-notifications
+[prompt_permission]: #prompt-the-user-to-grant-permission-for-local-notifications
 [onadd]: #get-notified-when-a-local-notification-has-been-scheduled
 [onclick]: #get-notified-when-the-user-has-been-clicked-on-a-local-notification
 [oncancel]: #get-notified-when-a-local-notification-has-been-canceled

plugin.xml

@@ -9,7 +9,7 @@
 
     <description>A bunch of local-notification plugins for Cordova 3.x.x</description>
     <repo>https://github.com/katzer/cordova-plugin-local-notifications.git</repo>
-    <keywords>notification, local notification, alarm, scheduler, tile, live tiles, ios, android, windows phone 8, wp8</keywords>
+    <keywords>notification, local notification, alarm, scheduler, tile, live tiles, ios, android, windows phone 8, wp8, iOS8</keywords>
     <license>Apache 2.0</license>
 
     <author>Sebastián Katzer</author>

src/android/LocalNotification.java

@@ -120,6 +120,15 @@ public class LocalNotification extends CordovaPlugin {
             return true;
         }
 
+        if (action.equalsIgnoreCase("hasPermission")) {
+            hasPermission(callbackContext);
+            return true;
+        }
+
+        if (action.equalsIgnoreCase("promptForPermission")) {
+            return true;
+        }
+
         if (action.equalsIgnoreCase("deviceready")) {
             cordova.getThreadPool().execute( new Runnable() {
                 public void run() {
@@ -266,6 +275,25 @@ public class LocalNotification extends CordovaPlugin {
     }
 
     /**
+     * Informs if the app has the permission to show notifications.
+     *
+     * @param callback
+     *      The function to be exec as the callback
+     */
+    private void hasPermission (final CallbackContext callback) {
+        cordova.getThreadPool().execute(new Runnable() {
+            @Override
+            public void run() {
+                PluginResult result;
+
+                result = new PluginResult(PluginResult.Status.OK, true);
+
+                callback.sendPluginResult(result);
+            }
+        });
+    }
+
+    /**
      * Persist the information of this alarm to the Android Shared Preferences.
      * This will allow the application to restore the alarm upon device reboot.
      * Also this is used by the cancelAll method.

src/ios/APPLocalNotification.h

@@ -36,5 +36,9 @@
 - (void) isScheduled:(CDVInvokedUrlCommand*)command;
 // Retrieves a list of ids from all currently pending notifications
 - (void) getScheduledIds:(CDVInvokedUrlCommand*)command;
+// Informs if the app has the permission to show notifications
+- (void) hasPermission:(CDVInvokedUrlCommand *)command;
+// Ask for permission to show notifications
+- (void) promptForPermission:(CDVInvokedUrlCommand *)command;
 
 @end

src/ios/APPLocalNotification.m

@@ -210,6 +210,67 @@
 }
 
 /**
+ * Informs if the app has the permission to show
+ * badges and local notifications.
+ *
+ * @param callback
+ *      The function to be exec as the callback
+ */
+- (void) hasPermission:(CDVInvokedUrlCommand *)command
+{
+    [self.commandDelegate runInBackground:^{
+        CDVPluginResult* result;
+        BOOL hasPermission = [self hasPermissionToSheduleNotifications];
+
+        result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK
+                                     messageAsBool:hasPermission];
+
+        [self.commandDelegate sendPluginResult:result
+                                    callbackId:command.callbackId];
+    }];
+}
+
+/**
+ * Ask for permission to show badges.
+ *
+ * @param callback
+ *      The function to be exec as the callback
+ */
+- (void) promptForPermission:(CDVInvokedUrlCommand *)command
+{
+#ifdef __IPHONE_8_0
+    UIUserNotificationType types =
+    UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound;
+
+    UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types
+                                                                             categories:nil];
+
+    [self.commandDelegate runInBackground:^{
+        [[UIApplication sharedApplication]
+         registerUserNotificationSettings:settings];
+    }];
+#endif
+}
+
+/**
+ * If the app has the permission to show badges.
+ */
+- (BOOL) hasPermissionToSheduleNotifications
+{
+#ifdef __IPHONE_8_0
+    UIUserNotificationSettings *settings = [[UIApplication sharedApplication]
+                                                currentUserNotificationSettings];
+
+    UIUserNotificationType requiredTypes =
+    UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound;
+
+    return (settings.types & requiredTypes);
+#else
+    return YES;
+#endif
+}
+
+/**
  * Schedules a new local notification and fies the coresponding event.
  *
  * @param {NSMutableDictionary} properties

src/wp8/LocalNotification.cs

@@ -132,6 +132,26 @@ namespace Cordova.Extension.Commands
             DispatchCommandResult();
         }
 
+        /// <summery>
+        /// Informs if the app has the permission to show notifications.
+        /// </summery>
+        public void hasPermission(string args)
+        {
+            PluginResult result;
+
+            result = new PluginResult(PluginResult.Status.OK, true);
+
+            DispatchCommandResult(result);
+        }
+
+        /// <summery>
+        /// Ask for permission to show notifications.
+        /// </summery>
+        public void promptForPermission(string args)
+        {
+            DispatchCommandResult();
+        }
+
         /// <summary>
         /// Informs that the device is ready and the deviceready event has been fired
         /// </summary>

www/local-notification.js

@@ -169,6 +169,29 @@ LocalNotification.prototype = {
     },
 
     /**
+     * Informs if the app has the permission to show badges.
+     *
+     * @param {Function} callback
+     *      The function to be exec as the callback
+     * @param {Object?} scope
+     *      The callback function's scope
+     */
+    hasPermission: function (callback, scope) {
+        var fn = function (badge) {
+            callback.call(scope || this, badge);
+        };
+
+        cordova.exec(fn, null, 'LocalNotification', 'hasPermission', []);
+    },
+
+    /**
+     * Ask for permission to show badges if not already granted.
+     */
+    promptForPermission: function () {
+        cordova.exec(null, null, 'LocalNotification', 'promptForPermission', []);
+    },
+
+    /**
      * Occurs when a notification was added.
      *
      * @param {String} id    The ID of the notification