Commit 6b3f426b by Sebastián Katzer

Merge branch 'master' of github.com:katzer/cordova-plugin-local-notifications

parents 0c3f71e1 189e6340
...@@ -5,11 +5,11 @@ A bunch of local notification plugins for Cordova 3.x.x ...@@ -5,11 +5,11 @@ A bunch of local notification plugins for Cordova 3.x.x
by Sebastián Katzer ([github.com/katzer](https://github.com/katzer)) by Sebastián Katzer ([github.com/katzer](https://github.com/katzer))
## Supported Platforms ## ## Supported Platforms
- **iOS**<br> - **iOS**<br>
See [Local and Push Notification Programming Guide](http://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/WhatAreRemoteNotif.html) for detailed informations and screenshots. See [Local and Push Notification Programming Guide](http://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/WhatAreRemoteNotif.html) for detailed informations and screenshots.
## Adding the Plugin to your project ## ## Adding the Plugin to your project
Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface): Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface):
``` ```
cordova plugin add https://github.com/katzer/cordova-plugin-local-notifications.git cordova plugin add https://github.com/katzer/cordova-plugin-local-notifications.git
...@@ -21,55 +21,53 @@ Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/gui ...@@ -21,55 +21,53 @@ Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/gui
cordova plugin rm de.appplant.cordova.plugin.local-notifications cordova plugin rm de.appplant.cordova.plugin.local-notifications
``` ```
## Release Notes ## ## Release Notes
#### Version 0.2.0 (11.08.2013) #### #### Version 0.2.0 (11.08.2013)
- Added iOS support<br> - Added iOS support<br>
*Based on the LocalNotifications iOS plugin made by* ***Rodrigo Moyle*** *Based on the LocalNotifications iOS plugin made by* ***Rodrigo Moyle***
## Using the plugin ## ## Using the plugin
The plugin creates the object ```window.plugin.notification.local``` with three methods: The plugin creates the object ```window.plugin.notification.local``` with three methods:
### add() ### ### add()
All settings are optional. If no date object is given, the notification will popup immediately. All settings are optional. If no date object is given, the notification will popup immediately.
To add a custom notification: To add a custom notification:
```javascript ```javascript
window.plugin.notification.local.add({ window.plugin.notification.local.add({
date: date,// this expects a date object date: date, // this expects a date object
message: message, // the message that is displayed message: message, // the message that is displayed
repeat: repeat, // has the options of 'weekly','daily','monthly','yearly') repeat: repeat, // has the options of 'weekly','daily','monthly','yearly')
badge: badge, // displays number badge to notification badge: badge, // (only iOS) displays number badge to notification
foreground: forground, // a javascript function to be called if the app is running foreground: forground, // a javascript function to be called if the app is running
background: background, // a javascript function to be called if the app is in the background background: background, // a javascript function to be called if the app is in the background
sound: sound // a sound to be played, the sound must be located in your project's resources and must be a caf file sound: sound // (only iOS) a sound to be played, the sound must be located in your project's resources and must be a caf file
}); });
``` ```
### clear() ### ### cancel()
To clear a specific notification: To cancel a specific notification:
```javascript ```javascript
window.plugin.notification.local.clear(__id__); window.plugin.notification.local.cancel(__id__);
``` ```
### clearAll() ### ### cancelAll()
To clear all notifications: To cancel all notifications:
```javascript ```javascript
window.plugin.notification.local.clearAll(); window.plugin.notification.local.cancelAll();
``` ```
#### Example #### #### Example
```javascript ```javascript
var now = new Date().getTime(), var now = new Date().getTime(),
_60_seconds_from_now = new Date(now + 60*1000); _60_seconds_from_now = new Date(now + 60*1000);
window.plugin.notification.local.add({ window.plugin.notification.local.add({
date: _60_seconds_from_now, date: _60_seconds_from_now,
message: 'Hello world!', message: 'Hello world!',
repeat: 'weekly', // will fire every week on this day repeat: 'weekly', // will fire every week on this day
badge: 1,
foreground: 'foreground', foreground: 'foreground',
background: 'background', background: 'background'
sound: 'sub.caf'
}); });
function foreground (id) { function foreground (id) {
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment