diff options
| author | Arjun Roychowdhury <pliablepixels@gmail.com> | 2015-10-10 11:28:44 -0400 |
|---|---|---|
| committer | Arjun Roychowdhury <pliablepixels@gmail.com> | 2015-10-10 11:28:44 -0400 |
| commit | d0d3aaf7af63afa041e9af145267b0bb04ee729f (patch) | |
| tree | be718a451ed33afeead4d87c186fe231fe09a444 /plugins/de.appplant.cordova.plugin.badge/README.md | |
| parent | 7b0d282994db52cc4bc6b62b33ce05efbb522fae (diff) | |
Notifications now have a blop sound, also handling application badges
Diffstat (limited to 'plugins/de.appplant.cordova.plugin.badge/README.md')
| -rw-r--r-- | plugins/de.appplant.cordova.plugin.badge/README.md | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/plugins/de.appplant.cordova.plugin.badge/README.md b/plugins/de.appplant.cordova.plugin.badge/README.md new file mode 100644 index 00000000..e7f44ba9 --- /dev/null +++ b/plugins/de.appplant.cordova.plugin.badge/README.md @@ -0,0 +1,113 @@ + +[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FF6GG425KEQ3E "Donate once-off to this project using Paypal") +[](http://badge.fury.io/js/de.appplant.cordova.plugin.badge) +[](https://codeclimate.com/github/katzer/cordova-plugin-badge) + +Cordova Badge Plugin +==================== + +The essential purpose of badge numbers is to enable an application to inform its users that it has something for them — for example, unread messages — when the application isn’t running in the foreground. + +<img height="150px" align="right" hspace="19" vspace="12" src="http://4.bp.blogspot.com/-GBwBSN92DvU/UB8Kut7Oz0I/AAAAAAAAJKs/mJgBmj1RKqU/s1600/whatsapp+wp8+10.png"></img> + +### How they appear to the user +Users see notifications in the following ways: +- Badging the app’s icon + + +## Supported Platforms +The current 0.7 branch does support the following platforms: +- __Amazon FireOS__ +- __Android__ +- __Browser__ +- __iOS__ +- __Windows__ +- __WP8__ and __WP8.1 Silverlight__ + +Find out more informations [here][wiki_platforms] in our wiki. + + +## Installation +The plugin is installable from source and available on Cordova Plugin Registry and PhoneGap Build. + +Find out more informations [here][wiki_installation] in our wiki. + + +## I want to get a quick overview +All wiki pages contain samples, but for a quick overview the sample section may be the fastest way. + +Find out more informations [here][wiki_samples] in our wiki. + + +## I want to get a deep overview +The plugin allows you to set, get, clear, increase and decrease the badge number. For Android the plugin offers additional configuration flags. + +Find out more about how to set, increase or decrease the badge [here][wiki_set]. + +To get a deep overview we recommend to read about all the topics in this wiki and try out the [Kitchen Sink App][wiki_kitchensink] + + +## I want to see the plugin in action +The plugin offers a kitchen sink sample app. Check out the cordova project and run the app directly from your command line or preferred IDE. + +Find out more informations [here][wiki_kitchensink] in our wiki. + + +## What's new +We are proud to announce our newest release version 0.7.x. Beside the hard work at the office and at the weekends it contains a lot of goodies, new features and easy to use APIs. + +Find out more informations [here][wiki_changelog] in our wiki. + + +## Sample +The sample demonstrates how to set a fix badge number and how to increase the current badge number. + +```javascript +// Set 10 on device ready +document.addEventListener('deviceready', function () { + cordova.plugins.notification.badge.set(10); +}, false); +``` +```javascript +// Increase the badge each time on pause +document.addEventListener('pause', function () { + cordova.plugins.notification.badge.increase(); +}, false); +``` + +Find out more informations [here][wiki_samples] in our wiki. + + +## Supporting +Your support is needed. If you use the plugin please support us in order to ensure further development and send us a drop through the donation button. + +Thank you! + +[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FF6GG425KEQ3E "Donate once-off to this project using Paypal") + + +## Contributing + +1. Fork it +2. Create your feature branch (`git checkout -b my-new-feature`) +3. Commit your changes (`git commit -am 'Add some feature'`) +4. Push to the branch (`git push origin my-new-feature`) +5. Create new Pull Request + + +## License + +This software is released under the [Apache 2.0 License][apache2_license]. + +© 2013-2015 appPlant UG, Inc. All rights reserved + + +[cordova]: https://cordova.apache.org +[wiki]: https://github.com/katzer/cordova-plugin-badge/wiki +[wiki_platforms]: https://github.com/katzer/cordova-plugin-badge/wiki/01.-Platforms +[wiki_installation]: https://github.com/katzer/cordova-plugin-badge/wiki/02.-Installation +[wiki_kitchensink]: https://github.com/katzer/cordova-plugin-badge/tree/example +[wiki_set]: https://github.com/katzer/cordova-plugin-badge/wiki/03.-Set-Badge +[wiki_samples]: https://github.com/katzer/cordova-plugin-badge/wiki/07.-Samples +[wiki_changelog]: https://github.com/katzer/cordova-plugin-badge/wiki/08.-Changelog +[apache2_license]: http://opensource.org/licenses/Apache-2.0 |
