Phonegap StatusBarNotification plugin for Android (plugman compatible)

plugman --platform android --project --plugin git://github.com/rstets/StatusBarNotification.git

StatusBarNotification plugin for Cordova

This plugin allows you to display notifications in the status bar from your Cordova application. On Android you have to explicitly add things to the status bar (as opposed to iOS where push notifications automatically get displayed in the UI). The Android status bar is the UI component at the top of the screen that has a bunch of little icons. You can also drag the status bar down to view a list of notifications.

Adding the Plugin to your project

Using this plugin requires Android Cordova.

1. You will need to

• add an import line like this to the .java files (see commented out lines inside the files):

  import com.my.app.R;

• or use grunt to insert that import automatically. to do so run inside the plugin dir after installation:

  • npm install
  • env $PACKAGE_NAME=com.your_domain.AppName grunt preprocess

2. If you need the notification to stick, you can pass a paramter to notify function. E.g.: window.plugins.statusBarNotification.notify("Put your title here", "Put your sticky message here", Flag.FLAG_NO_CLEAR); //you can then use clear function to remove it. window.plugins.statusBarNotification.clear();

Using the plugin

The plugin creates the object window.plugins.statusBarNotification.

Sample use:

window.plugins.statusBarNotification.notify("Put your title here", "Put your message here");

License

Copyright (C) 2011 Dmitry Savchenko [email protected] Copyright (C) 2012 Max Ogden [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.