Browse Source

Update README.md

Sebastián Katzer 12 years ago
parent
commit
bf7af5d46b
1 changed files with 69 additions and 1 deletions
  1. 69 1
      README.md

+ 69 - 1
README.md

@@ -1,4 +1,72 @@
-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)
+}
+```