Download SDK Download Sample Plugin API Docs
iOS Simulator can neither subscribe nor receive push notifications. Android and Windows Phone emulator will work.
To integrate Pushwoosh with your Cordova application, follow these simple steps:
1. Install the Plugin source code into your app:
For Phonegap: phonegap plugin add pushwoosh-pgb-plugin
For Cordova: cordova plugin add pushwoosh-cordova-plugin
For Ionic: ionic plugin add pushwoosh-cordova-plugin
For Intel XDK: Add pushwoosh-intel-xdk-plugin
as Third-Party Plugin
2. Whitelist .pushwoosh.com domain in the config.xml file:
<access origin="*.pushwoosh.com" />
Do not forget to add cordova-plugin-whitelist plugin for android platform.
cordova plugin add cordova-plugin-whitelist
3. Get the google-services.json
from your Firebase console as described here and add it to your project.
4. Add the following section to your config.xml
:
<platform name="android"><resource-file src="google-services.json" target="app/google-services.json" />...</platform>
When building with Phonegap Build you will also need to use cordova-cli:8.0.0:
config.xml<preference name="phonegap-version" value="cli-8.0.0" />
5. Initialize plugin
Add the following function to your javascript file, enter the correct Pushwoosh App ID. For Android also enter the correct Google Project Number. serviceName is optional for Windows Phone (wp8)
function initPushwoosh() {var pushwoosh = cordova.require("pushwoosh-cordova-plugin.PushNotification");// Should be called before pushwoosh.onDeviceReadydocument.addEventListener('push-notification', function(event) {var notification = event.notification;// handle push open here});// Initialize Pushwoosh. This will trigger all pending push notifications on start.pushwoosh.onDeviceReady({appid: "PUSHWOOSH_APP_ID",projectid: "YOUR_FCM_SENDER_ID",serviceName: "MPNS_SERVICE_NAME"});}
initPushwoosh() {var pushNotification = (<any>window).plugins.pushNotification;//set push notifications handlerdocument.addEventListener('push-notification',function(event) {var message = (<any>event).notification.message;var userData = (<any>event).notification.userdata;alert("Push message opened: " + message);console.info(JSON.stringify((<any>event).notification));//dump custom data to the console if it existsif (typeof(userData) != "undefined") {console.warn('user data: ' + JSON.stringify(userData));}});document.addEventListener('push-receive',function (event) {var message = (<any>event).notification.message;var userData = (<any>event).notification.userdata;alert("Push message received: " + message);console.info(JSON.stringify((<any>event).notification));//dump custom data to the console if it existsif (typeof (userData) != "undefined") {console.warn('user data: ' + JSON.stringify(userData));}});//initialize Pushwoosh with projectid: "YOUR_FCM_SENDER_ID", appid : "PUSHWOOSH_APP_ID". This will trigger all pending push notifications on start.pushNotification.onDeviceReady({projectid: "YOUR_FCM_SENDER_ID",appid: "PUSHWOOSH_APP_ID",serviceName: ""});//register for push notificationsvar app = this;pushNotification.registerDevice(function(status) {alert("registered with token: " + status.pushToken);},function(status) {alert("failed to register: " + status);console.warn(JSON.stringify(['failed to register ', status]));});}
Call initPushwoosh();
on application start.
Example:
bindEvents: function() {document.addEventListener('deviceready', this.onDeviceReady, false);},// deviceready Event Handler//// The scope of 'this' is the event. In order to call the 'receivedEvent' function, we must explicitly call 'app.receivedEvent(...);'onDeviceReady: function() {app.receivedEvent('deviceready');initPushwoosh();},
angular.module('starter', ['ionic', 'starter.controllers', 'starter.services']).run(function($ionicPlatform) {$ionicPlatform.ready(function() {// Hide the accessory bar by default (remove this to show the accessory bar above the keyboard// for form inputs)if (window.cordova && window.cordova.plugins && window.cordova.plugins.Keyboard) {cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);cordova.plugins.Keyboard.disableScroll(true);}if (window.StatusBar) {// org.apache.cordova.statusbar requiredStatusBar.styleLightContent();}initPushwoosh();});})
function onAppReady() {if( navigator.splashscreen && navigator.splashscreen.hide ) { // Cordova API detectednavigator.splashscreen.hide() ;}initPushwoosh();}document.addEventListener("app.Ready", onAppReady, false) ;
6. Registering and handling push notifications
To register for push notifications call
pushwoosh.registerDevice(function(status) {var pushToken = status.pushToken;// handle successful registration here},function(status) {// handle registration error here});
For handling notificatios see the following snippet of code in initPushwoosh function
// should be called before pushwoosh.onDeviceReadydocument.addEventListener('push-notification', function(event) {var notification = event.notification;// handle push open here});
7. iOS platform
If you use cordova-ios
earlier than 4.3.0
, enable Push Notifications in Capabilities section in XCode project.
8. Android platform
Check out the latest Google Play services and Android Support libraries using Android SDK Manager.
Starting from version 8.0.0 of the plugin, Pushwoosh Android SDK uses Android X libraries instead of Android Support. To enable Android X in your android project, use cordova-plugin-androidx.
9. Windows platform
Pushwoosh plugin for windows platform uses WNS. Associate App with the Store in Visual Studio and set Notifications->Toast Capable; Please note that all UWP apps (Windows 10 and higher) are by default capable of sending toast notifications, without the need to declare such capability.
Pretty easy, isn't it!