Summer of Code/2013/Social Sugar project/Documentation - Revision history

Axitkhurana: /* Code */ Add moksaya fork link

2013-09-24T16:06:56Z

Code: Add moksaya fork link

← Older revision		Revision as of 12:06, 24 September 2013
Line 99:		Line 99:
	* [https://github.com/axitkhurana/sugar-gmoksaya Sugar GMoksaya]		* [https://github.com/axitkhurana/sugar-gmoksaya Sugar GMoksaya]

	(Requires moksaya setup on local machine, social-sugar branch will use Rahul's deployed server making it easy to set up)		(Requires [https://github.com/axitkhurana/moksaya moksaya] setup on local machine, social-sugar branch will use Rahul's deployed server making it easy to set up)

	=== Testing ===		=== Testing ===

Axitkhurana: /* Mini Profiles */ Added youtube videos

2013-09-24T15:36:25Z

Mini Profiles: Added youtube videos

← Older revision		Revision as of 11:36, 24 September 2013
Line 80:		Line 80:
	==== Videos ====		==== Videos ====

	* Setup and sharing journal projects:

	* View latest projects in Group View:		* <div class="NavFrame collapsed"><div class="NavHead">[http://www.youtube.com/watch?v=o0Svzqqintw Setup and sharing journal projects] </div><div class="NavContent">{{#widget:YouTube
			\|id=o0Svzqqintw
			}}</div></div>

			* <div class="NavFrame collapsed"><div class="NavHead">[http://www.youtube.com/watch?v=ANzPpFJkOjI View latest projects in Group View] </div><div class="NavContent">{{#widget:YouTube
			\|id=ANzPpFJkOjI
			}}</div></div>

	=== Code ===		=== Code ===

Axitkhurana: /* Mini Profiles */ More details!

2013-09-24T15:30:31Z

Mini Profiles: More details!

← Older revision		Revision as of 11:30, 24 September 2013
Line 15:		Line 15:
	==== BuddyModel ====		==== BuddyModel ====
	* Each Buddy used to have properties like nick, color and current activity		* Each Buddy used to have properties like nick, color and current activity
	* We add another property `social_ids` to the BaseBuddyModel which are populated initially from all webservice accounts.		* We add another property <code>social_ids</code> to the <code>BaseBuddyModel</code> which are populated initially from all webservice accounts.
	* social_ids is a dictionary of `service name`: `public id` pairs. E.g. {'gmoksaya': 'a454', 'gpaste': 'adsfq524325'}		* social_ids is a dictionary of `service name`: `public id` pairs. E.g.<code> {'gmoksaya': 'a454', 'gpaste': 'adsfq524325'}</code>
	* As are other properties like color, serialized social_ids are broadcasted to other online Sugar users via Telepathy.		* As are other properties like color, serialized social_ids are broadcasted to other online Sugar users via Telepathy.

	==== WebServices Account Interface ====		==== WebServices Account Interface ====
	* Two new methods: `get_public_id()` and `get_latest_post()` are added to Account class. (webservice.account.Account)		* Two new methods: <code>get_public_id()</code> and <code>get_latest_post()</code> are added to Account class. (webservice.account.Account)
	* `get_public_id` returns the public id associated with that account.		* <code>get_public_id</code> returns the public id associated with that account.
	** It is used to populate social_ids property initially		** It is used to populate social_ids property initially
	** Public ids are used to fetch posts from the external webservice, e.g. latest project uploaded on Project Sharing Website. (This is implemented in the service specific extension.)		** Public ids are used to fetch posts from the external webservice, e.g. latest project uploaded on Project Sharing Website. (This is implemented in the service specific extension.)
	* `get_latest_post` returns the latest post on the service.		* <code>get_latest_post</code> returns the latest post on the service.

	=== New Classes ===		=== New Classes ===

	==== WebServicePost ====		==== WebServicePost ====
	* This is an abstract class for WebService posts returned by `get_latest_post`		* This is an abstract class for WebService posts returned by <code>get_latest_post</code>
	* Has unimplemented methods for title, message, image and hyperlink.		* Has unimplemented methods for title, message, image and hyperlink.

Line 55:		Line 55:

	==== Technical details for the cloud content implementation ====		==== Technical details for the cloud content implementation ====
	* ~~Small cloud icon~~ inherits `sugar3.graphics.icon.CanvasIcon` which gives it the color matching that of the buddy.		* SmallCloudIcon inherits <code>sugar3.graphics.icon.CanvasIcon</code> which gives it the color matching that of the buddy.
	* CloudContent is placed on top of the LargeCloudIcon using Gtk.Overlay		* CloudContent is placed on top of the LargeCloudIcon using Gtk.Overlay
	* LargeCloudIcon inherits `sugar3.graphics.icon.EventIcon`		* LargeCloudIcon inherits <code>sugar3.graphics.icon.EventIcon</code>
	* The button-release-event is bound to SmallCloudIcon, whose callback draws the Gtk.Overlay containing LargeCloudIcon and CloudContent.		* The button-release-event is bound to SmallCloudIcon, whose callback draws the Gtk.Overlay containing LargeCloudIcon and CloudContent.
	* Cloud content consists of a VBox of service icon, a label and HBox containing close and pause icons.		* Cloud content consists of a VBox of service icon, a label and HBox containing close and pause icons.


			=== Sugar-GMoksaya ===

			Sugar-GMoksaya is a webservice extension which allows us to post journal projects to Moksaya, the Project Sharing Website. Addition of Mini Profile code allows us to view latest projects from our friends in Group View.

			==== Details ====

			* Moksaya needs username and api key for any request. Also, we need public id of the moksaya user to fetch latest projects.
			** We ask for username and password from the user in Settings > WebService.
			** These are used to fetch the api key and public id.
			** api key, username and public id are stored in GConf for future use. Passwords are not stored.
			* Sharing is same as in webservice extension, from Journal > Copy to > GMoksaya
			* If Gmoksaya account is also configured in your friends' Sugar, then they will send you their public ids.
			* Our extension fetches latest post from friends account and keeps it in memory.
			** If the cloud is expanded, the latest post is displayed followed by <code>get_latest_post()</code> calls to other services and looping back to this service.
			** Powered by [https://github.com/axitkhurana/gmoksaya GMoksaya] and [https://github.com/axitkhurana/grestful gRESTful]

			==== Videos ====

			* Setup and sharing journal projects:

			* View latest projects in Group View:

			=== Code ===
			social-sugar branch on:

			* [https://github.com/axitkhurana/sugar Sugar]
			* [https://github.com/axitkhurana/sugar-toolkit-gtk3 Sugar Toolkit GTK 3]
			* [https://github.com/axitkhurana/sugar-artwork Sugar Artwork]

			master branch on:
			* [https://github.com/axitkhurana/sugar-gmoksaya Sugar GMoksaya]

			(Requires moksaya setup on local machine, social-sugar branch will use Rahul's deployed server making it easy to set up)

	=== Testing ===		=== Testing ===

Axitkhurana: /* Detailed Description */ Technical details for the cloud content implementation

2013-09-24T15:03:18Z

Detailed Description: Technical details for the cloud content implementation

← Older revision		Revision as of 11:03, 24 September 2013
Line 11:		Line 11:
	For identification of a user on a webservice such as Project Sharing Website, or Fedora pastebin, a unique id will be used. The API of the webservice should allow posting/fetching resources related to the user via this UID (and if required authentication credentials such as API token).		For identification of a user on a webservice such as Project Sharing Website, or Fedora pastebin, a unique id will be used. The API of the webservice should allow posting/fetching resources related to the user via this UID (and if required authentication credentials such as API token).

	Changes to Sugar:		=== Changes to Sugar ===

	==== BuddyModel ====		==== BuddyModel ====
Line 26:		Line 26:
	* `get_latest_post` returns the latest post on the service.		* `get_latest_post` returns the latest post on the service.

	New Classes:		=== New Classes ===

	==== WebServicePost ====		==== WebServicePost ====
Line 32:		Line 32:
	* Has unimplemented methods for title, message, image and hyperlink.		* Has unimplemented methods for title, message, image and hyperlink.

	UI additions:		=== UI additions ===
	All additions are in Group view. (F2)		All additions are in Group view. (F2)

Line 54:		Line 54:
	[[File:MiniprofileScreenshot6.gif\|260 px\|Large cloud icon]]		[[File:MiniprofileScreenshot6.gif\|260 px\|Large cloud icon]]

			==== Technical details for the cloud content implementation ====
			* Small cloud icon inherits `sugar3.graphics.icon.CanvasIcon` which gives it the color matching that of the buddy.
			* CloudContent is placed on top of the LargeCloudIcon using Gtk.Overlay
			* LargeCloudIcon inherits `sugar3.graphics.icon.EventIcon`
			* The button-release-event is bound to SmallCloudIcon, whose callback draws the Gtk.Overlay containing LargeCloudIcon and CloudContent.
			* Cloud content consists of a VBox of service icon, a label and HBox containing close and pause icons.

	=== Testing ===		=== Testing ===

Axitkhurana: /* Mini Profiles */ User interface additions

2013-09-24T14:38:01Z

Mini Profiles: User interface additions

← Older revision		Revision as of 10:38, 24 September 2013
Line 31:		Line 31:
	* This is an abstract class for WebService posts returned by `get_latest_post`		* This is an abstract class for WebService posts returned by `get_latest_post`
	* Has unimplemented methods for title, message, image and hyperlink.		* Has unimplemented methods for title, message, image and hyperlink.

			UI additions:
			All additions are in Group view. (F2)

			==== Small Cloud Icon ====
			* A small cloud shaped icon is displayed over your friend when you both have a social sugar extension installed.
			* This icon can be clicked to view latest posts from web service account of your friend.

			[[File:MiniprofileScreenshot.jpg\|260 px\|Small cloud icon in friends view.]]

			==== Large Cloud Icon ====
			* On clicking the small cloud icon, it expands to a larger cloud
			* This Icon acts as a placeholder for the latest post from webservice.
			* The cloud has a speech bubble like pointer to the buddy.
			* The content on this icon:
			** is provided by fetching latest posts from all the webservice accounts of my friend.
			** is rotated after a fixed time to make the interface interactive and responsive.
			** can be paused using the pause icon for kids who can take longer to read a message.
			** can have a small icon (of the service) and upto 180 characters of text.
			* Large cloud is closed by clicking on the cross (x) button which automatically suspends auto fetching/rotating of the latest posts.

			[[File:MiniprofileScreenshot6.gif\|260 px\|Large cloud icon]]

Axitkhurana: /* Mini Profiles */ Update docs with initial description

2013-09-24T14:21:19Z

Mini Profiles: Update docs with initial description

@@ Line 5: / Line 5: @@
 == Mini Profiles ==
-Mini Profiles extend [[WebServices|Web Service]] code adding stubs to Account factory class for getting public id and getting latest posts from web service.
+Mini Profiles extend [[WebServices|Web Service]] code adding minimal changes to the existing models to support social features such as fetching latest posts from multiple webservices and displaying it in Group View.
 === Testing ===

Axitkhurana: Introduction and simple instructions for testing

2013-07-31T19:48:59Z

Introduction and simple instructions for testing

New page

= Social Sugar =
[[Summer of Code/2013/Social Sugar|Social Sugar]] project involves development of GUI components that can help bring user's social interactions on external platforms into Sugar.

The first component we've are working on are the [[Summer of Code/2013/Social Sugar project#Mini_Profiles|mini profiles]].

== Mini Profiles ==
Mini Profiles extend [[WebServices|Web Service]] code adding stubs to Account factory class for getting public id and getting latest posts from web service.

=== Testing ===
You can test the current implementation by following these steps:

# Set up your [http://developer.sugarlabs.org/dev-environment.md.html Sugar development environment]
# Clone the social-sugar branch from following repositories replacing the appropriate modules in your sugar-build code:
## [https://github.com/axitkhurana/sugar Sugar]
## [https://github.com/axitkhurana/sugar-toolkit-gtk3 Sugar Toolkit GTK 3]
## [https://github.com/axitkhurana/sugar-artwork Sugar Artwork]
# Clone the contents of [https://github.com/axitkhurana/mock-service mock-service] repository inside <code>~/.sugar/default</code>. You'll end up with the [[#Directory Structure|directory structure]] as shown below.
# Build Sugar and add Akshit Khurana (or other people running the service) as a friend from the neighbourhood view(F1). You can use the search to find people.
# Checkout the Friend view(F2).
## Click on the small cloud icon over the buddy icon, to view my latest mock-post!
## You should see something like: "Designed from the ground up especially for children, Sugar offers an alternative to traditional "office-desktop" software. Id: 458" in a giant speech bubble like cloud.
# Congratulations! You've got mock service running on Mini Profiles.

==== Directory Structure ====
<pre>
~/.sugar/default/extensions/webservice/
├── __init__.py
└── mock-service
├── __init__.py
├── account.py
├── mock-service
│ ├── __init__.py
│ └── mock-service.py
└── icons
└── mock-service.svg

~/.sugar/default/extensions/cpsection/
├── __init__.py
└── webaccount
├── __init__.py
└── services
├── __init__.py
└── mock-service
├── __init__.py
└── service.py
</pre>