Difference between revisions of "Features/Notification Urgency"

From Sugar Labs
Jump to navigation Jump to search
(Created page with "== Summary == Add 3 levels of urgency for notifications. == Owner == * Name: Sam P. * Email: samDELETEME@sugarlabs.org (You need to get rid of the DELETE...")
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<noinclude>[[Category:Feature|Notification Urgency]]</noinclude>
 
== Summary ==
 
== Summary ==
 
Add 3 levels of urgency for notifications.
 
Add 3 levels of urgency for notifications.
Line 13: Line 14:
  
 
== Benefit to Sugar ==
 
== Benefit to Sugar ==
* The ability to have silent notifications - eg: auto activity update notifications
+
* The ability to have silent notifications - e.g.: auto activity update notifications
* Compatibility with the rest of the Linux desktop work
+
* Compatibility with the rest of the Linux desktop world
  
 
== Scope ==
 
== Scope ==
Line 37: Line 38:
 
  notify_obj = bus.get_object(BUS_NAME,OBJ_PATH)
 
  notify_obj = bus.get_object(BUS_NAME,OBJ_PATH)
 
  notifications = dbus.Interface(notify_obj,IFACE_NAME)
 
  notifications = dbus.Interface(notify_obj,IFACE_NAME)
 
+
 
  # 0=low, 1=normal, 2=critical
 
  # 0=low, 1=normal, 2=critical
 
  # CHANGE ME!!!
 
  # CHANGE ME!!!
 
  urgency = 1
 
  urgency = 1
 
+
 
  notifications.Notify("Software Update", 0, "", "New activities are available!", "Please check your activities list", [], {'x-sugar-icon-name': 'module-updater', 'urgency': urgency}, -1)
 
  notifications.Notify("Software Update", 0, "", "New activities are available!", "Please check your activities list", [], {'x-sugar-icon-name': 'module-updater', 'urgency': urgency}, -1)
 
  
 
== Dependencies ==
 
== Dependencies ==
Line 52: Line 52:
  
 
== Documentation ==
 
== Documentation ==
''Is there upstream documentation on this feature, or notes you have written yourself?  Has this topic been discussed in the mailing list or during a meeting? Link to that material here so other interested developers can get involved.''
+
The standard: https://developer.gnome.org/notification-spec/#urgency-levels
  
 
== Release Notes ==
 
== Release Notes ==

Latest revision as of 19:42, 15 August 2014

Summary

Add 3 levels of urgency for notifications.

Owner

  • Email: samDELETEME@sugarlabs.org (You need to get rid of the DELETEME)

Current status

  • Targeted release: 0.104
  • Last updated: 10/Aug/2014
  • Percentage of completion: 50% - needs discussion

Benefit to Sugar

  • The ability to have silent notifications - e.g.: auto activity update notifications
  • Compatibility with the rest of the Linux desktop world

Scope

It is a small change that does not break compatibility.

UI Design

  • Normal notifications remain unchanged
  • Low priority notifications get no flashy icon popup corner thing - but they still get a place in the frame
  • Critical notifications get a flashy corner thing like this:

CriticalNotifications.png

How To Test

Run and change this in Pippy:

import dbus
BUS_NAME = 'org.freedesktop.Notifications'
OBJ_PATH = '/org/freedesktop/Notifications'
IFACE_NAME = 'org.freedesktop.Notifications'
bus = dbus.SessionBus()
notify_obj = bus.get_object(BUS_NAME,OBJ_PATH)
notifications = dbus.Interface(notify_obj,IFACE_NAME)

# 0=low, 1=normal, 2=critical
# CHANGE ME!!!
urgency = 1

notifications.Notify("Software Update", 0, "", "New activities are available!", "Please check your activities list", [], {'x-sugar-icon-name': 'module-updater', 'urgency': urgency}, -1)

Dependencies

None!

Contingency Plan

People are sad :(

Documentation

The standard: https://developer.gnome.org/notification-spec/#urgency-levels

Release Notes

Added notification urgency functionality.

Comments and Discussion

https://github.com/sugarlabs/sugar/pull/393