Commit bf7af5d4 authored by Sebastián Katzer's avatar Sebastián Katzer
Browse files

Update README.md

parent 6a13b250
Loading
Loading
Loading
Loading
+69 −1
Changes for README.md: 69 added lines, 1 removed line.
Original line number Diff line number Diff line
cordova-plugin-local-notifications
Cordova LocalNotification-Plugin
==================================

A bunch of local-notification plugins for Cordova 3.x.x

by Sebastián Katzer ([github.com/katzer](https://github.com/katzer))

## Supported Platforms ##
- **iOS**

## 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):
```
cordova plugin add https://github.com/katzer/cordova-plugin-local-notifications.git
```

## Release Notes ##
#### Version 0.1.0 (10.08.2013) ####
- Added iOS support

## Using the plugin ##
The plugin creates the object ```window.plugin.notification.local``` with three methods:

### add() ###
To add a custom notification:
```javascript
window.plugin.notification.local.add({
    date: date,// this expects a date object
    message: message, // the message that is displayed
    repeat: repeat, // has the options of 'weekly','daily','monthly','yearly')
    badge: badge, // displays number badge to notification
    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
    sound: sound // a sound to be played, the sound must be located in your project's resources and must be a caf file
});
```

### clear() ###
To clear a specific notification:
```javascript
window.plugin.notification.local.clear(__id__);
```

### clearAll() ###
To clear all notifications:
```javascript
window.plugin.notification.local.clearAll();
```

#### Example ####
```javascript
var now                  = new Date().getTime(),
    _60_seconds_from_now = new Date(now + 60*1000);

window.plugin.notification.local.add({
    date: _60_seconds_from_now,
    message: 'Hello world!',
    repeat: 'weekly', // will fire every week on this day
    badge: 1,
    foreground: 'foreground',
    background: 'background',
    sound: 'sub.caf'
});

function foreground (id) {
    console.log('I WAS RUNNING ID='+id)
}

function background (id) {
    console.log('I WAS IN THE BACKGROUND ID='+id)
}
```