Changes

Created page with "== Summary == This adds a simple notification system for sugar that can be used in activities and by the system/ == Owner == * Name: SAMdroid * Email: sam..."
== Summary ==
This adds a simple notification system for sugar that can be used in activities and by the system/

== Owner ==
* Name: [[User:AcountName|SAMdroid]]
* Email: sam.parkinson3@gmail.com

== Current status ==
* Targeted release: Soon
* Last updated: 8th of Feb
* Percentage of completion: 90%

== Detailed Description ==
Based off http://wiki.sugarlabs.org/go/Design_Team/Proposals/Notifications
See some pictures:
http://pbrd.co/1ez277u
http://pbrd.co/1izNT4O

== Benefit to Sugar ==
This would be nice for chat, calenders...
It would help bring us into line with the other desktop environs.

== Scope ==
The stuff in the shell is done. It probably needs to be improved.

I haven't mad any activities use it, so yeah.

==UI Design==
http://wiki.sugarlabs.org/go/Design_Team/Proposals/Notifications

== How To Test ==
Here is an example activity: https://git.sugarlabs.org/~samdroid/hello-world/hello-notification-world
This shows you a notification after a delay.

The docs for using notifications in activities are https://github.com/SAMdroid-apps/sugar-toolkit-gtk3/blob/bfadc8648bb0c594d9b12160affdd2c2c8819164/src/sugar3/activity/activity.py#L641

For system notifications you can run this code:

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)
notifications.Notify("HelloWorld", 0, '', "Summary", "Body", [], {'x-sugar-icon-name': 'activity-journal'}, -1)
#You can change the icon above

== User Experience ==
I think this is usable?

== Contingency Plan ==
WORK HARDER

== Documentation ==
I've added the doc strings.

== Comments and Discussion ==

http://lists.sugarlabs.org/archive/sugar-devel/2014-February/047096.html