/* * LICENSE * * POCKET MARKS * * Notwithstanding the permitted uses of the Software (as defined below) pursuant to the license set forth below, "Pocket," "Read It Later" and the Pocket icon and logos (collectively, the “Pocket Marks”) are registered and common law trademarks of Read It Later, Inc. This means that, while you have considerable freedom to redistribute and modify the Software, there are tight restrictions on your ability to use the Pocket Marks. This license does not grant you any rights to use the Pocket Marks except as they are embodied in the Software. * * --- * * SOFTWARE * * 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. */ /* * Pocket UI module * * Handles interactions with Pocket buttons, panels and menus. * */ // TODO : Get the toolbar icons from Firefox's build (Nikki needs to give us a red saved icon) // TODO : [needs clarificaiton from Fx] Firefox's plan was to hide Pocket from context menus until the user logs in. Now that it's an extension I'm wondering if we still need to do this. // TODO : [needs clarificaiton from Fx] Reader mode (might be a something they need to do since it's in html, need to investigate their code) // TODO : [needs clarificaiton from Fx] Move prefs within pktApi.s to sqlite or a local file so it's not editable (and is safer) // TODO : [nice to have] - Immediately save, buffer the actions in a local queue and send (so it works offline, works like our native extensions) Cu.import("resource://gre/modules/XPCOMUtils.jsm"); XPCOMUtils.defineLazyModuleGetter(this, "AppConstants", "resource://gre/modules/AppConstants.jsm"); XPCOMUtils.defineLazyModuleGetter(this, "PrivateBrowsingUtils", "resource://gre/modules/PrivateBrowsingUtils.jsm"); XPCOMUtils.defineLazyModuleGetter(this, "ReaderMode", "resource://gre/modules/ReaderMode.jsm"); var pktUI = (function() { // -- Initialization (on startup and new windows) -- // var inited = false; var _currentPanelDidShow; var _currentPanelDidHide; var _isHidden = false; var _notificationTimeout; // Init panel id at 0. The first actual panel id will have the number 1 so // in case at some point any panel has the id 0 we know there is something // wrong var _panelId = 0; var prefBranch = Services.prefs.getBranch("browser.pocket.settings."); var overflowMenuWidth = 230; var overflowMenuHeight = 475; var savePanelWidth = 350; var savePanelHeights = {collapsed: 153, expanded: 272}; /** * Initalizes Pocket UI and panels */ function onLoad() { if (inited) return; // Install the button (Only on first run, if a user removes the button, you do not want to restore it) // TODO, only do this if in a certain language // TODO - Ask Mozilla what the best way is to have this update when a user restores browser defaults // TODO - this needs to run only on a main window - if the first run happens on a window without the toolbar, then it will never try to run it again if (!prefBranch.prefHasUserValue('installed')) { // If user has social add-on installed, uninstall it if (Social.getManifestByOrigin("https://getpocket.com")) { Social.uninstallProvider("https://getpocket.com", function(){ /* callback */ }); } // if user has legacy pkt add-on installed, flag it so we can handle it correctly prefBranch.setBoolPref('hasLegacyExtension', hasLegacyExtension()); var id = "pocket-menu-button"; var toolbar = document.getElementById("nav-bar"); var before = null; // Is the bookmarks button in the toolbar? if (toolbar.currentSet.match("bookmarks-menu-button")) { var elem = document.getElementById("bookmarks-menu-button"); if (elem) before = elem.nextElementSibling; } // Otherwise, just add it to the end of the toolbar (because before is null) toolbar.insertItem(id, before); toolbar.setAttribute("currentset", toolbar.currentSet); document.persist(toolbar.id, "currentset"); prefBranch.setBoolPref('installed', true); } // Context Menu Event document.getElementById('contentAreaContextMenu').addEventListener("popupshowing", contextOnPopupShowing, false); // Hide the extension based on certain criteria hideIntegrationIfNeeded(); inited = true; } /** * Mark all Pocket integration chrome elements as hidden if certain criteria apply (ex: legacy Pocket extension users or unsupported languages) */ function hideIntegrationIfNeeded() { var hideIntegration = false; // Check if the user had the legacy extension the last time we looked if (prefBranch.getBoolPref('hasLegacyExtension')) { if (hasLegacyExtension()) { hideIntegration = true; // they still have it, hide new native integration } else { // if they originally had it, but no longer do, then we should remove the pref so we no longer have to check prefBranch.setBoolPref('hasLegacyExtension', false); } } // TODO // If language other than launch languages (en-US currently) { // hideIntegration = true; //} // Hide the integration if needed if (hideIntegration) { // Note, we don't hide the context menus here, that's handled in contextOnPopupShowing var elements = ['pocket-menu-button', 'BMB_openPocketWebapp']; for(var i=0; i -1) { startheight = 460; if (fxasignedin == '1') { startheight = 406; } } else { if (fxasignedin == '1') { startheight = 436; } } var variant; if (inOverflowMenu) { variant = 'overflow'; } else { variant = pktApi.getSignupAB(); } var panelId = showPanel("chrome://browser/content/pocket/panels/signup.html?pockethost=" + Services.prefs.getCharPref("browser.pocket.site") + "&fxasignedin=" + fxasignedin + "&variant=" + variant + '&inoverflowmenu=' + inOverflowMenu + "&locale=" + getUILocale(), { onShow: function() { }, onHide: panelDidHide, width: inOverflowMenu ? overflowMenuWidth : 300, height: startheight }); }); } /** * Show the logged-out state / sign-up panel */ function saveAndShowConfirmation(url, title) { // Validate input parameter if (typeof url !== 'undefined' && url.startsWith("about:reader?url=")) { url = ReaderMode.getOriginalUrl(url); } var isValidURL = (typeof url !== 'undefined' && (url.startsWith("http") || url.startsWith('https'))); var inOverflowMenu = isInOverflowMenu(); var startheight = pktApi.isPremiumUser() && isValidURL ? savePanelHeights.expanded : savePanelHeights.collapsed; if (inOverflowMenu) { startheight = overflowMenuHeight; } var panelId = showPanel("chrome://browser/content/pocket/panels/saved.html?pockethost=" + Services.prefs.getCharPref("browser.pocket.site") + "&premiumStatus=" + (pktApi.isPremiumUser() ? '1' : '0') + '&inoverflowmenu='+inOverflowMenu + "&locale=" + getUILocale(), { onShow: function() { var saveLinkMessageId = 'saveLink'; // Send error message for invalid url if (!isValidURL) { // TODO: Pass key for localized error in error object var error = { message: 'Only links can be saved', localizedKey: "onlylinkssaved" }; pktUIMessaging.sendErrorMessageToPanel(panelId, saveLinkMessageId, error); return; } // Check online state if (!navigator.onLine) { // TODO: Pass key for localized error in error object var error = { message: 'You must be connected to the Internet in order to save to Pocket. Please connect to the Internet and try again.' }; pktUIMessaging.sendErrorMessageToPanel(panelId, saveLinkMessageId, error); return; } // Add url var options = { success: function(data, request) { var item = data.item; var successResponse = { status: "success", item: item }; pktUIMessaging.sendMessageToPanel(panelId, saveLinkMessageId, successResponse); }, error: function(error, request) { // If user is not authorized show singup page if (request.status === 401) { showSignUp(); return; } // If there is no error message in the error use a // complete catch-all var errorMessage = error.message || "There was an error when trying to save to Pocket."; var panelError = { message: errorMessage} // Send error message to panel pktUIMessaging.sendErrorMessageToPanel(panelId, saveLinkMessageId, panelError); } } // Add title if given if (typeof title !== "undefined") { options.title = title; } // Send the link pktApi.addLink(url, options); }, onHide: panelDidHide, width: inOverflowMenu ? overflowMenuWidth : savePanelWidth, height: startheight }); } /** * Open a generic panel */ function showPanel(url, options) { // Add new panel id _panelId += 1; url += ("&panelId=" + _panelId); // We don't have to hide and show the panel again if it's already shown // as if the user tries to click again on the toolbar button the overlay // will close instead of the button will be clicked var iframe = getPanelFrame(); // Register event handlers registerEventMessages(); // Load the iframe iframe.setAttribute('src', url); // Uncomment to leave panel open -- for debugging // panel.setAttribute('noautohide', true); // panel.setAttribute('consumeoutsideclicks', false); // // For some reason setting onpopupshown and onpopuphidden on the panel directly didn't work, so // do it this hacky way for now _currentPanelDidShow = options.onShow; _currentPanelDidHide = options.onHide; resizePanel({ width: options.width, height: options.height }); return _panelId; } /** * Resize the panel * options = { * width: , * height: , * animate [default false] * } */ function resizePanel(options) { var iframe = getPanelFrame(); var subview = getSubview(); if (subview) { // Use the subview's size iframe.style.width = "100%"; iframe.style.height = subview.clientHeight + "px"; } else { // Set an explicit size, panel will adapt. iframe.style.width = options.width + "px"; iframe.style.height = options.height + "px"; } } /** * Called when the signup and saved panel was hidden */ function panelDidHide() { } /** * Register all of the messages needed for the panels */ function registerEventMessages() { var iframe = getPanelFrame(); // Only register the messages once var didInitAttributeKey = 'did_init'; var didInitMessageListener = iframe.getAttribute(didInitAttributeKey); if (typeof didInitMessageListener !== "undefined" && didInitMessageListener == 1) { return; } iframe.setAttribute(didInitAttributeKey, 1); // When the panel is displayed it generated an event called // "show": we will listen for that event and when it happens, // send our own "show" event to the panel's script, so the // script can prepare the panel for display. var _showMessageId = "show"; pktUIMessaging.addMessageListener(_showMessageId, function(panelId, data) { // Let panel know that it is ready pktUIMessaging.sendMessageToPanel(panelId, _showMessageId); }); // Open a new tab with a given url and activate if var _openTabWithUrlMessageId = "openTabWithUrl"; pktUIMessaging.addMessageListener(_openTabWithUrlMessageId, function(panelId, data) { // Check if the tab should become active after opening var activate = true; if (typeof data.activate !== "undefined") { activate = data.activate; } var url = data.url; openTabWithUrl(url, activate); pktUIMessaging.sendResponseMessageToPanel(panelId, _openTabWithUrlMessageId, url); }); // Close the panel var _closeMessageId = "close"; pktUIMessaging.addMessageListener(_closeMessageId, function(panelId, data) { getPanel().hidePopup(); }); // Send the current url to the panel var _getCurrentURLMessageId = "getCurrentURL"; pktUIMessaging.addMessageListener(_getCurrentURLMessageId, function(panelId, data) { pktUIMessaging.sendResponseMessageToPanel(panelId, _getCurrentURLMessageId, getCurrentUrl()); }); var _resizePanelMessageId = "resizePanel"; pktUIMessaging.addMessageListener(_resizePanelMessageId, function(panelId, data) { resizePanel(data); }); // Callback post initialization to tell background script that panel is "ready" for communication. pktUIMessaging.addMessageListener("listenerReady", function(panelId, data) { }); pktUIMessaging.addMessageListener("collapseSavePanel", function(panelId, data) { if (!pktApi.isPremiumUser() && !isInOverflowMenu()) resizePanel({width:savePanelWidth, height:savePanelHeights.collapsed}); }); pktUIMessaging.addMessageListener("expandSavePanel", function(panelId, data) { if (!isInOverflowMenu()) resizePanel({width:savePanelWidth, height:savePanelHeights.expanded}); }); // Ask for recently accessed/used tags for auto complete var _getTagsMessageId = "getTags"; pktUIMessaging.addMessageListener(_getTagsMessageId, function(panelId, data) { pktApi.getTags(function(tags, usedTags) { pktUIMessaging.sendResponseMessageToPanel(panelId, _getTagsMessageId, { tags: tags, usedTags: usedTags }); }); }); // Ask for suggested tags based on passed url var _getSuggestedTagsMessageId = "getSuggestedTags"; pktUIMessaging.addMessageListener(_getSuggestedTagsMessageId, function(panelId, data) { pktApi.getSuggestedTagsForURL(data.url, { success: function(data, response) { var suggestedTags = data.suggested_tags; var successResponse = { status: "success", value: { suggestedTags: suggestedTags } } pktUIMessaging.sendResponseMessageToPanel(panelId, _getSuggestedTagsMessageId, successResponse); }, error: function(error, response) { pktUIMessaging.sendErrorResponseMessageToPanel(panelId, _getSuggestedTagsMessageId, error); } }) }); // Pass url and array list of tags, add to existing save item accordingly var _addTagsMessageId = "addTags"; pktUIMessaging.addMessageListener(_addTagsMessageId, function(panelId, data) { pktApi.addTagsToURL(data.url, data.tags, { success: function(data, response) { var successResponse = {status: "success"}; pktUIMessaging.sendResponseMessageToPanel(panelId, _addTagsMessageId, successResponse); }, error: function(error, response) { pktUIMessaging.sendErrorResponseMessageToPanel(panelId, _addTagsMessageId, error); } }); }); // Based on clicking "remove page" CTA, and passed unique item id, remove the item var _deleteItemMessageId = "deleteItem"; pktUIMessaging.addMessageListener(_deleteItemMessageId, function(panelId, data) { pktApi.deleteItem(data.itemId, { success: function(data, response) { var successResponse = {status: "success"}; pktUIMessaging.sendResponseMessageToPanel(panelId, _deleteItemMessageId, successResponse); }, error: function(error, response) { pktUIMessaging.sendErrorResponseMessageToPanel(panelId, _deleteItemMessageId, error); } }) }); } // -- Browser Navigation -- // /** * Open a new tab with a given url and notify the iframe panel that it was opened */ function openTabWithUrl(url) { let recentWindow = Services.wm.getMostRecentWindow("navigator:browser"); if (!recentWindow) { if (this.AppConstants.platform == "macosx") { let hiddenWindow = Services.appShell.hiddenDOMWindow; // If there are no open browser windows, open a new one. hiddenWindow.openDialog("chrome://browser/content/", "_blank", "chrome,all,dialog=no", url); } return; } // If the user is in permanent private browsing than this is not an issue, // since the current window will always share the same cookie jar as the other // windows. if (!PrivateBrowsingUtils.isWindowPrivate(recentWindow) || PrivateBrowsingUtils.permanentPrivateBrowsing) { recentWindow.openUILinkIn(url, "tab"); return; } let windows = Services.wm.getEnumerator("navigator:browser"); while (windows.hasMoreElements()) { let win = windows.getNext(); if (!PrivateBrowsingUtils.isWindowPrivate(win)) { win.openUILinkIn(url, "tab"); return; } } // If there were no non-private windows opened already. recentWindow.openUILinkIn(url, "window"); } // -- Helper Functions -- // function getCurrentUrl() { return getBrowser().currentURI.spec; } function getCurrentTitle() { return getBrowser().contentTitle; } function getPanel() { var frame = getPanelFrame(); var panel = frame; while (panel && panel.localName != "panel") { panel = panel.parentNode; } return panel; } function getPanelFrame() { var frame = document.getElementById('pocket-panel-iframe'); if (!frame) { var frameParent = document.getElementById("PanelUI-pocketView").firstChild; frame = document.createElement("iframe"); frame.id = 'pocket-panel-iframe'; frame.setAttribute("type", "content"); frameParent.appendChild(frame); } return frame; } function getSubview() { var frame = getPanelFrame(); var view = frame; while (view && view.localName != "panelview") { view = view.parentNode; } if (view && view.getAttribute("current") == "true") return view; return null; } function isInOverflowMenu() { var subview = getSubview(); return !!subview; } function hasLegacyExtension() { return !!document.getElementById('RIL_urlbar_add'); } function isHidden() { return _isHidden; } function getFirefoxAccountSignedInUser(callback) { fxAccounts.getSignedInUser().then(userData => { callback(userData); }).then(null, error => { callback(); }); } function getUILocale() { var locale = Cc["@mozilla.org/chrome/chrome-registry;1"]. getService(Ci.nsIXULChromeRegistry). getSelectedLocale("browser"); return locale; } /** * Toolbar animations */ function showPocketAnimation() { // Borrowed from bookmark star animation: // https://dxr.mozilla.org/mozilla-central/source/browser/base/content/browser-places.js#1568 // TODO : Clean-up : Probably don't need all of this since the css animation does most of the heavy lifting // TODO : Do not show when saving from context menu -- or get really fancy and launch the icon from the link that was saved into the bookmark menu function getCenteringTransformForRects(rectToPosition, referenceRect) { let topDiff = referenceRect.top - rectToPosition.top; let leftDiff = referenceRect.left - rectToPosition.left; let heightDiff = referenceRect.height - rectToPosition.height; let widthDiff = referenceRect.width - rectToPosition.width; return [(leftDiff + .5 * widthDiff) + "px", (topDiff + .5 * heightDiff) + "px"]; } if (_notificationTimeout) { clearTimeout(this._notificationTimeout); } var button = document.getElementById('pocket-menu-button'); var bookmarksButton = document.getElementById('bookmarks-menu-button'); var notifier = document.getElementById("pocketed-notification-anchor"); var dropmarkerNotifier = document.getElementById("bookmarked-notification-dropmarker-anchor"); // If the Pocket button is not immediately after the bookmark button, then do not do the animation // (because it's hard-coded for the positions right now) // TODO - double check this in small and large toolbar button sizes if (bookmarksButton.nextElementSibling != button) return; if (notifier.style.transform == '') { // Get all the relevant nodes and computed style objects let dropmarker = document.getAnonymousElementByAttribute(bookmarksButton, "anonid", "dropmarker"); let dropmarkerIcon = document.getAnonymousElementByAttribute(dropmarker, "class", "dropmarker-icon"); let dropmarkerStyle = getComputedStyle(dropmarkerIcon); // Check for RTL and get bounds let isRTL = getComputedStyle(button).direction == "rtl"; // need this? let buttonRect = button.getBoundingClientRect(); let notifierRect = notifier.getBoundingClientRect(); let dropmarkerRect = dropmarkerIcon.getBoundingClientRect(); let dropmarkerNotifierRect = dropmarkerNotifier.getBoundingClientRect(); // Compute, but do not set, transform for pocket icon let [translateX, translateY] = getCenteringTransformForRects(notifierRect, buttonRect); let starIconTransform = "translate(" + (translateX) + ", " + translateY + ")"; if (isRTL) { starIconTransform += " scaleX(-1)"; } // Compute, but do not set, transform for dropmarker [translateX, translateY] = getCenteringTransformForRects(dropmarkerNotifierRect, dropmarkerRect); let dropmarkerTransform = "translate(" + translateX + ", " + translateY + ")"; // Do all layout invalidation in one go: notifier.style.transform = starIconTransform; dropmarkerNotifier.style.transform = dropmarkerTransform; let dropmarkerAnimationNode = dropmarkerNotifier.firstChild; dropmarkerAnimationNode.style.MozImageRegion = dropmarkerStyle.MozImageRegion; dropmarkerAnimationNode.style.listStyleImage = dropmarkerStyle.listStyleImage; } let isInOverflowMenu = button.getAttribute("overflowedItem") == "true"; if (!isInOverflowMenu) { notifier.setAttribute("notification", "finish"); button.setAttribute("notification", "finish"); dropmarkerNotifier.setAttribute("notification", "finish"); } _notificationTimeout = setTimeout( () => { notifier.removeAttribute("notification"); dropmarkerNotifier.removeAttribute("notification"); button.removeAttribute("notification"); dropmarkerNotifier.style.transform = ''; notifier.style.transform = ''; }, 1000); } /** * Public functions */ return { onLoad: onLoad, getPanelFrame: getPanelFrame, openTabWithUrl: openTabWithUrl, pocketButtonOnCommand: pocketButtonOnCommand, pocketPanelDidShow: pocketPanelDidShow, pocketPanelDidHide: pocketPanelDidHide, pocketContextSaveLinkOnCommand, pocketContextSavePageOnCommand, pocketBookmarkBarOpenPocketCommand, tryToSaveUrl: tryToSaveUrl }; }()); // -- Communication to Background -- // // https://developer.mozilla.org/en-US/Add-ons/Code_snippets/Interaction_between_privileged_and_non-privileged_pages var pktUIMessaging = (function() { /** * Prefix message id for message listening */ function prefixedMessageId(messageId) { return 'PKT_' + messageId; } /** * Register a listener and callback for a specific messageId */ function addMessageListener(messageId, callback) { document.addEventListener(prefixedMessageId(messageId), function(e) { // ignore to ensure we do not pick up other events in the browser if (e.target.tagName !== 'PKTMESSAGEFROMPANELELEMENT') { return; } // Pass in information to callback var payload = JSON.parse(e.target.getAttribute("payload"))[0]; var panelId = payload.panelId; var data = payload.data; callback(panelId, data); // Cleanup the element e.target.parentNode.removeChild(e.target); }, false, true); } /** * Remove a message listener */ function removeMessageListener(messageId, callback) { document.removeEventListener(prefixedMessageId(messageId), callback); } /** * Send a message to the panel's iframe */ function sendMessageToPanel(panelId, messageId, payload) { if (!isPanelIdValid(panelId)) { return; }; var panelFrame = pktUI.getPanelFrame(); if (!isPocketPanelFrameValid(panelFrame)) { return; } var doc = panelFrame.contentWindow.document; var documentElement = doc.documentElement; // Send message to panel var panelMessageId = prefixedMessageId(panelId + '_' + messageId); var AnswerEvt = doc.createElement("PKTMessage"); AnswerEvt.setAttribute("payload", JSON.stringify([payload])); documentElement.appendChild(AnswerEvt); var event = doc.createEvent("HTMLEvents"); event.initEvent(panelMessageId, true, false); AnswerEvt.dispatchEvent(event); } function sendResponseMessageToPanel(panelId, messageId, payload) { var responseMessageId = messageId + "Response"; sendMessageToPanel(panelId, responseMessageId, payload); } /** * Helper function to package an error object and send it to the panel * iframe as a message response */ function sendErrorMessageToPanel(panelId, messageId, error) { var errorResponse = {status: "error", error: error}; sendMessageToPanel(panelId, messageId, errorResponse); } function sendErrorResponseMessageToPanel(panelId, messageId, error) { var errorResponse = {status: "error", error: error}; sendResponseMessageToPanel(panelId, messageId, errorResponse); } /** * Validation */ function isPanelIdValid(panelId) { // First check if panelId has a valid value > 0. We set the panelId to // 0 to start. But if for some reason the message is attempted to be // sent before the panel has a panelId, then it's going to send out // a message with panelId 0, which is never going to be heard. If this // happens, it means some race condition occurred where the panel was // trying to communicate before it should. if (panelId === 0) { console.warn("Tried to send message to panel with id 0.") return false; } return true } function isPocketPanelFrameValid(panelFrame) { // Check if panel is available if not throw a warning and bailout. // We likely try to send to a panel that is not visible anymore if (typeof panelFrame === "undefined") { console.warn("Pocket panel frame is undefined"); return false; } var contentWindow = panelFrame.contentWindow; if (typeof contentWindow == "undefined") { console.warn("Pocket panel frame content window is undefined"); return false; } var doc = contentWindow.document; if (typeof doc === "undefined") { console.warn("Pocket panel frame content window document is undefined"); return false; } var documentElement = doc.documentElement; if (typeof documentElement === "undefined") { console.warn("Pocket panel frame content window document document element is undefined"); return false; } return true; } /** * Public */ return { addMessageListener: addMessageListener, removeMessageListener: removeMessageListener, sendMessageToPanel: sendMessageToPanel, sendResponseMessageToPanel: sendResponseMessageToPanel, sendErrorMessageToPanel: sendErrorMessageToPanel, sendErrorResponseMessageToPanel: sendErrorResponseMessageToPanel } }());