Files
zulip/static/js/notifications.js
Jessica McKellar 06566b3776 Don't receive notifications for messages on muted topics.
This doesn't address the more complicated case of someone @-mentioning
you on a muted topic, which consensus is you do want to get
information for, but we need to develop some infrastructure to present
that case to users clearly.

(imported from commit a4bc1e89c108fa8ba6eccc0a198eabf2231326ab)
2013-10-18 14:38:31 -04:00

375 lines
12 KiB
JavaScript

var notifications = (function () {
var exports = {};
var notice_memory = {};
// When you start Zulip, window_has_focus should be true, but it might not be the
// case after a server-initiated reload.
var window_has_focus = document.hasFocus && document.hasFocus();
var asked_permission_already = false;
var names;
var supports_sound;
var unread_pms_favicon = '/static/images/favicon/favicon-pms.png';
var current_favicon;
var previous_favicon;
var flashing = false;
function browser_desktop_notifications_on () {
return (window.webkitNotifications &&
// Firefox on Ubuntu claims to do webkitNotifications but its notifications are terrible
$.browser.webkit &&
// 0 is PERMISSION_ALLOWED
window.webkitNotifications.checkPermission() === 0) ||
// window.bridge is the desktop client
(window.bridge !== undefined);
}
function cancel_notification_object (notification_object) {
// We must remove the .onclose so that it does not trigger on .cancel
notification_object.onclose = function () {};
notification_object.onclick = function () {};
notification_object.cancel();
}
exports.initialize = function () {
$(window).focus(function () {
window_has_focus = true;
_.each(notice_memory, function (notice_mem_entry) {
cancel_notification_object(notice_mem_entry.obj);
});
notice_memory = {};
// Update many places on the DOM to reflect unread
// counts.
process_visible_unread_messages();
}).blur(function () {
window_has_focus = false;
});
if ($.browser.mozilla === true && typeof Notification !== "undefined") {
Notification.requestPermission(function () {
asked_permission_already = true;
});
}
if (window.bridge !== undefined) {
supports_sound = true;
return;
}
var audio = $("<audio>");
if (audio[0].canPlayType === undefined) {
supports_sound = false;
} else {
supports_sound = true;
$("#notifications-area").append(audio);
if (audio[0].canPlayType('audio/ogg; codecs="vorbis"')) {
audio.append($("<source>").attr("type", "audio/ogg")
.attr("loop", "yes")
.attr("src", "/static/audio/humbug.ogg"));
} else {
audio.append($("<source>").attr("type", "audio/mpeg")
.attr("loop", "yes")
.attr("src", "/static/audio/humbug.mp3"));
}
}
if (window.webkitNotifications) {
$(document).click(function () {
if (!page_params.desktop_notifications_enabled || asked_permission_already) {
return;
}
if (window.webkitNotifications.checkPermission() !== 0) { // 0 is PERMISSION_ALLOWED
window.webkitNotifications.requestPermission(function () {});
asked_permission_already = true;
}
});
}
};
// For web pages, the initial favicon is the same as the favicon we
// set for no unread messages and the initial page title is the same
// as the page title we set for no unread messages. However, for the
// OS X app, the dock icon does not get its badge updated on initial
// page load. If the badge icon was wrong right before a reload and
// we actually have no unread messages then we will never execute
// bridge.updateCount() until the unread count changes. Therefore,
// we ensure that bridge.updateCount is always run at least once to
// synchronize it with the page title. This can be done before the
// DOM is loaded.
if (window.bridge !== undefined) {
window.bridge.updateCount(0);
}
exports.update_title_count = function (new_message_count) {
// Update window title and favicon to reflect unread messages in current view
var n;
var new_title = (new_message_count ? ("(" + new_message_count + ") ") : "")
+ page_params.realm_name + " - Zulip";
if (document.title === new_title) {
return;
}
document.title = new_title;
// IE doesn't support PNG favicons, *shrug*
if (! $.browser.msie) {
// Indicate the message count in the favicon
if (new_message_count) {
// Make sure we're working with a number, as a defensive programming
// measure. And we don't have images above 99, so display those as
// 'infinite'.
n = (+new_message_count);
if (n > 99) {
n = 'infinite';
}
current_favicon = previous_favicon = '/static/images/favicon/favicon-'+n+'.png';
} else {
current_favicon = previous_favicon = '/static/favicon.ico?v=2';
}
util.set_favicon(current_favicon);
}
if (window.bridge !== undefined) {
// We don't use 'n' because we want the exact count. The bridge handles
// which icon to show.
window.bridge.updateCount(new_message_count);
}
};
function flash_pms() {
// When you have unread PMs, toggle the favicon between the unread count and
// a special icon indicating that you have unread PMs.
if (unread.get_counts().private_message_count > 0) {
if (current_favicon === unread_pms_favicon) {
util.set_favicon(previous_favicon);
current_favicon = previous_favicon;
previous_favicon = unread_pms_favicon;
} else {
util.set_favicon(unread_pms_favicon);
previous_favicon = current_favicon;
current_favicon = unread_pms_favicon;
}
// Toggle every 2 seconds.
setTimeout(flash_pms, 2000);
} else {
flashing = false;
// You have no more unread PMs, so back to only showing the unread
// count.
util.set_favicon(current_favicon);
}
}
exports.update_pm_count = function (new_pm_count) {
if (window.bridge !== undefined && window.bridge.updatePMCount !== undefined) {
window.bridge.updatePMCount(new_pm_count);
}
if (!flashing) {
flashing = true;
flash_pms();
}
};
exports.window_has_focus = function () {
return window_has_focus;
};
function in_browser_notify(message, title, content) {
var notification_html = $(templates.render('notification', {gravatar_url: ui.small_avatar_url(message),
title: title,
content: content}));
$('.top-right').notify({
message: { html: notification_html },
fadeOut: {enabled:true, delay: 4000}
}).show();
}
function process_notification(notification) {
var i, notification_object, key, content, other_recipients;
var message = notification.message;
var title = message.sender_full_name;
var msg_count = 1;
// Convert the content to plain text, replacing emoji with their alt text
content = $('<div/>').html(message.content);
ui.replace_emoji_with_text(content);
content = content.text();
if (message.type === "private") {
key = message.display_reply_to;
other_recipients = message.display_reply_to;
// Remove the sender from the list of other recipients
other_recipients = other_recipients.replace(", " + message.sender_full_name, "");
other_recipients = other_recipients.replace(message.sender_full_name + ", ", "");
} else {
key = message.sender_full_name + " to " +
message.stream + " > " + message.subject;
}
if (content.length > 150) {
// Truncate content at a word boundary
for (i = 150; i > 0; i--) {
if (content[i] === ' ') {
break;
}
}
content = content.substring(0, i);
content += " [...]";
}
if (window.bridge === undefined && notice_memory[key] !== undefined) {
msg_count = notice_memory[key].msg_count + 1;
title = msg_count + " messages from " + title;
notification_object = notice_memory[key].obj;
cancel_notification_object(notification_object);
}
if (message.type === "private" && message.display_recipient.length > 2) {
// If the message has too many recipients to list them all...
if (content.length + title.length + other_recipients.length > 230) {
// Then count how many people are in the conversation and summarize
// by saying the conversation is with "you and [number] other people"
other_recipients = other_recipients.replace(/[^,]/g, "").length +
" other people";
}
title += " (to you and " + other_recipients + ")";
}
if (message.type === "stream") {
title += " (to " + message.stream + " > " + message.subject + ")";
}
if (window.bridge === undefined && notification.webkit_notify === true) {
var icon_url = ui.small_avatar_url(message);
notice_memory[key] = {
obj: window.webkitNotifications.createNotification(
icon_url, title, content),
msg_count: msg_count,
message_id: message.id
};
notification_object = notice_memory[key].obj;
notification_object.onclick = function () {
notification_object.cancel();
window.focus();
};
notification_object.onclose = function () {
delete notice_memory[key];
};
notification_object.show();
} else if (notification.webkit_notify === false && typeof Notification !== "undefined" && $.browser.mozilla === true) {
Notification.requestPermission(function (perm) {
if (perm === 'granted') {
Notification(title, {
body: content,
iconUrl: ui.small_avatar_url(message)
});
} else {
in_browser_notify(message, title, content);
}
});
} else if (notification.webkit_notify === false) {
in_browser_notify(message, title, content);
} else {
// Shunt the message along to the desktop client
window.bridge.desktopNotification(title, content);
}
}
exports.close_notification = function (message) {
_.each(Object.keys(notice_memory), function (key) {
if (notice_memory[key].message_id === message.id) {
cancel_notification_object(notice_memory[key].obj);
delete notice_memory[key];
}
});
};
exports.speaking_at_me = function (message) {
if (message === undefined) {
return false;
}
return message.mentioned;
};
function message_is_notifiable(message) {
// Based purely on message contents, can we notify the user about
// the message?
// First, does anything disqualify it from being notifiable?
if (message.sent_by_me) {
return false;
}
if ((message.type === "stream") &&
!stream_data.in_home_view(message.stream)) {
return false;
}
if ((message.type === "stream") &&
muting.is_topic_muted(message.stream, message.subject)) {
return false;
}
// Then, do any properties make it notifiable?
if (message.type === "private") {
return true;
}
if (exports.speaking_at_me(message)) {
return true;
}
if ((message.type === "stream") &&
subs.receives_notifications(message.stream)) {
return true;
}
if (alert_words.notifies(message)) {
return true;
}
// Nope.
return false;
}
exports.received_messages = function (messages) {
_.each(messages, function (message) {
if (!message_is_notifiable(message)) {
return;
}
if (!unread.message_unread(message)) {
return;
}
if (page_params.desktop_notifications_enabled &&
browser_desktop_notifications_on()) {
process_notification({message: message, webkit_notify: true});
} else {
process_notification({message: message, webkit_notify: false});
}
if (page_params.sounds_enabled && supports_sound) {
if (window.bridge !== undefined) {
window.bridge.bell();
} else {
$("#notifications-area").find("audio")[0].play();
}
}
});
};
$(function () {
// Shim for Cocoa WebScript exporting top-level JS
// objects instead of window.foo objects
if (typeof(bridge) !== 'undefined' && window.bridge === undefined) {
window.bridge = bridge;
}
});
return exports;
}());