Merge pull request avivais#67 from quilligana/optional-multiple-notifications-android

Optional ability to override standard behaviour of a single notification in android notification tray

Author: taivo

README.md

@@ -61,6 +61,12 @@ Parse.Push plugin for Cordova/Phonegap/ionic. Works for both hosted Parse.com an
 
    *Android*: to prevent flooding the notification tray, this plugin retains only the last PN with the same `title` field. For messages without the `title` field, the application name is used. A count of unopened PNs is shown.
 
+   You can override this feature, however, by adding the following to `config.xml`:
+
+   ```xml
+   <preference name="ParseMultiNotifications" value="true" />
+   ```
+
 
 #### Foreground vs. Background
 
@@ -139,6 +145,13 @@ Create the following tags in `config.xml`:
       This is the same "senderId" to be used in your parse-server push configuration.
    -->
    <preference name="ParseGcmSenderId" value="gcm-sender-id" />
+
+   <!-- As standard, this plugin only shows the most recent PN in 
+      the android notifications tray along with a count of unopened 
+      PNs. If you would like to override this behaviour and show all 
+      PNs in the tray, then add this preference. 
+      If not, skip this preference -->
+   <preference name="ParseMultiNotifications" value="true" />
    ```
 
    - For legacy Parse.com
@@ -149,6 +162,13 @@ Create the following tags in `config.xml`:
 
    <!-- Do not replace this string value. It must be "PARSE_DOT_COM"-->
    <preference name="ParseServerUrl" value="PARSE_DOT_COM" />
+
+   <!-- As standard, this plugin only shows the most recent PN in 
+      the android notifications tray along with a count of unopened
+      PNs. If you would like to override this behaviour and show all
+      PNs in the tray, then add this preference. 
+      If not, skip this preference -->
+   <preference name="ParseMultiNotifications" value="true" />
    ```
 
 You're all set. The plugin takes care of initializing Parse platform using the `config.xml` preferences mentioned above. It also saves your installation to the database automatically.

src/android/ParsePushConfigReader.java

@@ -33,7 +33,6 @@ public final class ParsePushConfigReader {
    // ParseClientKey is not required by parse server, but can be required by some environments
    private static final String parseClientKeyKey = "ParseClientKey";
 
-
    private List<String> supportedKeys = new ArrayList(Arrays.asList(parseAppIdKey, parseServerUrlKey));
    private Map<String, String> configs;
 

src/android/ParsePushPluginReceiver.java

@@ -10,6 +10,9 @@
 import android.app.Notification;
 import android.app.NotificationManager;
 
+import github.taivo.parsepushplugin.ParsePushConfigReader;
+import github.taivo.parsepushplugin.ParsePushConfigException;
+
 import android.support.v4.app.NotificationCompat;
 
 import android.net.Uri;
@@ -40,15 +43,24 @@ protected void onPushReceive(Context context, Intent intent) {
  	      // relay the push notification data to the javascript
  		   ParsePushPlugin.jsCallback( getPushData(intent) );
       } else {
-		   //
-			// only create entry for notification tray if plugin/application is
-			// not running in foreground.
-			//
-			// use tag + notification id=0 to limit the number of notifications on the tray
-			// (older messages with the same tag and notification id will be replaced)
-			NotificationManager notifManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
-			notifManager.notify(getNotificationTag(context, intent), 0, getNotification(context, intent));
-
+       //
+       // only create entry for notification tray if plugin/application is
+       // not running in foreground.
+       //
+       // So first we check if the user has set the configuration to have multiple 
+       // notifications show in the tray (i.e. set <preference name="ParseMultiNotifications" value="true" />)
+       ParsePushConfigReader config = new ParsePushConfigReader(context, null, new String[] {"ParseMultiNotifications"});
+       String parseMulti = config.get("ParseMultiNotifications");
+       if(parseMulti != null && !parseMulti.isEmpty() && parseMulti.equals("true")){
+         // If the user wants multiple notifications in the tray, then we let ParsePushBroadcastReceiver
+         // handle it from here
+         super.onPushReceive(context, intent);
+       } else {
+    			// use tag + notification id=0 to limit the number of notifications in the tray
+    			// (older messages with the same tag and notification id will be replaced)
+    			NotificationManager notifManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+    			notifManager.notify(getNotificationTag(context, intent), 0, getNotification(context, intent));
+        }
          //
          // A user with Android 5.0.1 reports that notif is not created in tray when
          // app is off (not background), trying method described here