Issue 3024 - Added opt-out to Chrome notifications

lib/notificationHelper.js

 /*
  * This file is part of Adblock Plus <https://adblockplus.org/>,
  * Copyright (C) 2006-2015 Eyeo GmbH
  *
  * Adblock Plus is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3 as
  * published by the Free Software Foundation.
  *
  * Adblock Plus is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
  * along with Adblock Plus.  If not, see <http://www.gnu.org/licenses/>.
  */
 
 /** @module notificationHelper */
 
 let {startIconAnimation, stopIconAnimation} = require("icon");
 let {Utils} = require("utils");
 let {Notification: NotificationStorage} = require("notification");
 let {stringifyURL} = require("url");
 let {initAntiAdblockNotification} = require("antiadblockInit");
 
 let activeNotification = null;
+let activeButtons = null;
 let defaultDisplayMethods = ["popup"];
 let displayMethods = Object.create(null);
 displayMethods.critical = ["icon", "notification", "popup"];
 displayMethods.question = ["notification"];
 displayMethods.normal = ["notification"];
 displayMethods.information = ["icon", "popup"];
 
 // Chrome on Linux does not fully support chrome.notifications until version 35
 // https://code.google.com/p/chromium/issues/detail?id=291485
 let canUseChromeNotifications = (function()
@@ skipping 19 matching lines @@
     notificationClosed();
   };
   if (animateIcon)
     startIconAnimation(activeNotification.type);
 }
 
 function openNotificationLinks()
 {
   if (activeNotification.links)
   {
-    activeNotification.links.forEach(function(link)
-    {
-      ext.windows.getLastFocused(function(win)
-      {
-        win.openTab(Utils.getDocLink(link));
-      });
-    });
+    for (let link of activeNotification.links)
+      ext.pages.open(Utils.getDocLink(link));
   }
 }
 
 function notificationButtonClick(buttonIndex)
 {
-  if (activeNotification.type == "question")
+  switch (activeButtons[buttonIndex].type)
   {
-    NotificationStorage.triggerQuestionListeners(activeNotification.id, buttonIndex == 0);
-    NotificationStorage.markAsShown(activeNotification.id);
-    activeNotification.onClicked();
-  }
-  else if (activeNotification.links && activeNotification.links[buttonIndex])
-  {
-    ext.windows.getLastFocused(function(win)
-    {
-      win.openTab(Utils.getDocLink(activeNotification.links[buttonIndex]));
-    });
+    case "link":
+      ext.pages.open(Utils.getDocLink(activeNotification.links[buttonIndex]));
+      break;
+    case "open-all":
+      openNotificationLinks();
+      break;
+    case "configure":
+      Prefs.notifications_showui = true;
+      ext.showOptions(function(page)
+      {
+        page.sendMessage({
+          type: "focus-section",
+          section: "notifications"
+        });
+      });
+      break;
+    case "question":
+      NotificationStorage.triggerQuestionListeners(activeNotification.id, buttonIndex == 0);
+      NotificationStorage.markAsShown(activeNotification.id);
+      activeNotification.onClicked();
+      break;
   }
 }
 
 function notificationClosed()
 {
   activeNotification = null;
 }
 
 function imgToBase64(url, callback)
 {
@@ skipping 40 matching lines @@
   if (activeNotification && activeNotification.id == notification.id)
     return;
 
   activeNotification = notification;
   if (shouldDisplay("notification", activeNotification.type))
   {
     let texts = NotificationStorage.getLocalizedTexts(notification);
     let title = texts.title || "";
     let message = texts.message ? texts.message.replace(/<\/?(a|strong)>/g, "") : "";
     let iconUrl = ext.getURL("icons/detailed/abp-128.png");
     let hasLinks = activeNotification.links && activeNotification.links.length > 0;

[Sebastian Noack, 2015/09/11 13:09:55]

I actually preferred the way you did it before using <|| []>. This isn't a
hotspot where you have to care about creating unnecessary objects.

[Thomas Greiner, 2015/09/11 14:03:44]

Done. Note that I merely reverted the changes from my previous patch here so
this is what's currently in the extension.

 
     if (canUseChromeNotifications)
     {
+      activeButtons = [];

[Sebastian Noack, 2015/09/11 13:09:55]

This function is becoming quite long. How about moving the logic to a separate
function getNotificationButtons()? I don't have a strong opinion here though.

[Thomas Greiner, 2015/09/11 14:03:44]

Done. I agree, should make it easier to comprehend.

       let opts = {
         type: "basic",
         title: title,
         message: message,
         buttons: [],
         priority: 2 // We use the highest priority to prevent the notification from closing automatically
       };
       if (activeNotification.type == "question")
       {
-        opts.buttons.push({title: ext.i18n.getMessage("overlay_notification_button_yes")});
-        opts.buttons.push({title: ext.i18n.getMessage("overlay_notification_button_no")});
+        activeButtons.push({
+          type: "question",
+          title: ext.i18n.getMessage("overlay_notification_button_yes")
+        });
+        activeButtons.push({
+          type: "question",
+          title: ext.i18n.getMessage("overlay_notification_button_no")
+        });
       }
       else
       {
         let regex = /<a>(.*?)<\/a>/g;
-        let plainMessage = texts.message || "";
         let match;
-        while (match = regex.exec(plainMessage))
-          opts.buttons.push({title: match[1]});
+        while (match = regex.exec(texts.message))
+        {
+          activeButtons.push({
+            type: "link",
+            title: match[1]
+          });
+        }
+
+        // Chrome only allows two notification buttons so we need to fall back
+        // to a single button to open all links if there are more than two.
+        let maxButtons = (activeNotification.type == "critical") ? 2 : 1;
+        if (activeButtons.length > maxButtons)
+        {
+          activeButtons = [
+            {
+              type: "open-all",
+              title: ext.i18n.getMessage("notification_open_all")
+            }
+          ];
+        }
+        if (activeNotification.type != "critical")
+        {
+          activeButtons.push({
+            type: "configure",
+            title: ext.i18n.getMessage("notification_configure")
+          });
+        }
       }
 
       imgToBase64(iconUrl, function(iconData)
       {
-        opts["iconUrl"] = iconData;
+        opts.buttons = activeButtons.map(function(button)

[Sebastian Noack, 2015/09/11 13:09:55]

Why not a for-of loop?

[Thomas Greiner, 2015/09/11 14:03:44]

No particular reason.

The way I use it now in the new patch, however, helps us avoid the creation of a
temporary variable.

[Sebastian Noack, 2015/09/11 14:15:39]

I see. However, much better with an arrow function now.

+        {
+          return {title: button.title};
+        });
+        opts.iconUrl = iconData;
         chrome.notifications.create("", opts, function() {});
       });
     }
     else if ("Notification" in window && activeNotification.type != "question")
     {
       if (hasLinks)
         message += " " + ext.i18n.getMessage("notification_without_buttons");
 
       imgToBase64(iconUrl, function(iconData)
       {
@@ skipping 66 matching lines @@
  * @return {boolean}
  */
 exports.shouldDisplay = shouldDisplay;
 function shouldDisplay(method, notificationType)
 {
   let methods = displayMethods[notificationType] || defaultDisplayMethods;
   return methods.indexOf(method) > -1;
 }
 
 NotificationStorage.addShowListener(showNotification);