Sun Glassfish SocialSite Developer's Guide

Chapter 2 SocialSite Widgets

As an end-to-end solution that adds social networking features to existing host applications, the Sun Glassfish SocialSite software provides a library of social widgets that can be added to a web page. A SocialSite widget is an OpenSocial-compliant gadget that calls one or more SocialSite-specific extensions.

This chapter provides the following information for each SocialSite widget:

All Groups Widget

The All Groups widget shows a listing of all groups in the social graph. The All Groups widget uses the SocialSite REST API to obtain the listing.

Displayed Information

List of groups

Actions

Link to a group's homepage

Parameters

profileID

Person whose groups are to be displayed 

height

Height setting 

width

Width setting 

Dashboard Widget

The Dashboard widget provides a common page to access information about users, groups, activities, and message notifications.

Activities Tab

Displayed Information

Filtered list of activities 

Actions

List your activities 

List friend's activities 

Go to previous page 

Go to next page 

People Tab

Displayed Information

List of friends 

Filter search for all SocialSite users 

Filter search for all SocialSite users that are considered friends 

Filter search for all SocialSite users belonging to a specified group 

Actions

Specify user has no relationship 

Specify user has a contact relationship 

Specify user has a friend relationship 

Send e-mail to a user 

Invite a user to join a group 

Go to previous page 

Go to next page 

Groups Tab

Displayed Information

List of your groups 

Actions

Search for SocialSite groups 

Filter search by all SocialSite groups 

Filter search by SocialSite groups that you are a member 

Create group 

Go to previous page 

Go to next page 

Messages Tab

Displayed Information

List of notification messages 

Actions

Display received messages 

Display sent messages 

Accept request 

Ignore request 

Go to previous page 

Go to next page 

Parameters

height

Height setting 

width

Width setting 

Face Widget

The Face widget displays a photo of the user.

Displayed Information

Photo of user 

Actions

Save 

Cancel 

Parameters

height

Height setting 

width

Width setting 

Group Activities Widget

The Group Activities widget shows the most recent activities of a selected group.

Information Displayed

Icon associated with subject 

Link to a Person/Group Profile of subject 

Link to Person/Group Profile of object 

Time of activity 

Actions

Display activities. 

Parameters

groupID

View activities of this group 

height

Height setting 

width

Width setting 

Group Members Widget

The Group Members widget displays the members of a group.

Displayed Information

List of group members 

Actions

Show which group 

Send e-mail 

Parameters

handle

Group ID 

height

Height setting 

width

Width setting 

Group Profile Widget

The Group Profile widget displays the profile information of a group. The Group Profile widget uses the SocialSite REST API to obtain the group properties. The Group Profile widget uses the SocialSite REST API to send the Apply to Join request.

Displayed Information

Group logo 

Group name 

Group description 

Group properties (as determined by viewer's membership status) 

Actions

Apply-to-join group 

Leave group if member and leaving group is allowed 

Mail group 

Invite user to join group 

Parameters

handle

Group ID 

height

Height setting 

width

Width setting 

Owner's Activities

The Owner's Activities widget shows the most recent activities of a user. The Owner Activities widget retrieves user activities using the OpenSocial REST API (in JSON format).

Information Displayed

Activity content 

Icon associated with subject 

Time of activity 

Actions

Display activities 

Parameters

profileID

View activities of this user 

height

Height setting 

width

Width setting 

Owner's Friends Widget

The Owner's Friends widget displays the friends of the owner.

Displayed Information

List of user's friends 

Actions

Invite friend to join a group 

Send e-mail to a friend 

Parameters

profileID

View activities of this user 

height

Height setting 

width

Width setting 

Owner's Groups Widget

The Owner's Groups widget displays a listing of the groups that the owner is a member.

Displayed Information

List of groups 

Actions

Link to a group's homepage (visibility determined by the owner's membership) 

Invite user to join group 

Next/previous links if listing is more than one page 

Parameters

profileID

View activities of this user 

height

Height setting 

width

Width setting 

People Widget

The People widget browses all people in the social graph. The People widget uses the OpenSocial REST API to fetch the friend list.

Displayed Information

Name of user 

Next page/previous page buttons if more than one page of results 

Actions

Display profile (per user) 

Send e-mail message (per user) 

Add As Friend (per user) 

Parameters

height

Height setting 

width

Width setting 

Profile Editor Widget

The Profile Editor widget edits the profile of a user. The Displayed Information section displays the default values.

Displayed Information

Tab 

Attribute 

Field 

Identification 

Nickname  

Display Name  

Tags 

 

 

 

Name 

First Name 

Last Name 

Middle Name 

Subtitle 

Unstructured 

 

Web Sites 

 

Contact 

Primary E-mail  

Additional E-mail Addresses  

Instant Messenger Accounts  

Extended 

Current Location 

Street Address  

Extended Address  

City  

State  

ZIP code 

Country  

Type 

 

Additional Phone Numbers 

 

Addresses 

Personal 

About Me  

Gender  

Activities  

Interests  

Music  

Movies  

Books  

TV  

Humor  

Food  

Fashion  

Cars  

Sports  

Heroes  

Quotes  

Religion  

Political Views  

Happiest When  

Scared Of 

 

Song 

URL Link  

Title  

Type 

 

Video 

URL Link  

Title  

Type 

More Personal  

Age  

Birthday  

Relationship Status  

Children  

Drinker  

Smoker  

Romance Looking For  

Sexual Orientation  

Living Arrangement  

Turn Ons  

Turn Offs 

 

Body Type 

Build  

Eye Color  

Hair Color  

Height  

Weight 

Experience 

Interests  

Experiences 

Education 

Schools 

Privacy 

Actions

Save changes to profile settings 

Cancel changes to profile settings 

Parameters

profileID

Profile ID to be displayed 

height

Height setting 

width

Width setting 

Profile Viewer Widget

The Profile Viewer widget displays the profile of a user.

Displayed Information

Public profile summary 

Actions

Edit 

Parameters

profileID

Profile ID to be displayed 

height

Height setting 

width

Width setting 

Status Widget

The Status widget allows the status of a user to be updated.

Displayed Information

Text box for entering current status and an Update Status button  

Actions

Update status 

Parameters

height

Height setting 

width

Width setting 

Viewer and Friends Activities Widget

The Viewer and Friends Activities widget shows the most recent activities of a user and associated friends. The Viewer and Friends Activities widget retrieves user and friends activities using the OpenSocial REST API (in JSON format). The Viewer and Friends Activities widget retrieves group activities using the SocialSite REST API (in JSON format.)

Information Displayed

Icon associated with subject 

Link to a Person/Group Profile of subject (per activity) 

Link to Person/Group Profile of object (per activity) 

Time of activity  

Actions

Display activities.  

Parameters

profileID

View activities of this person 

groupID

View activities of this group 

height

Height setting 

width

Width setting 

Viewer's Friends Widget

The Viewer's Friends widget displays the friends of the viewer.

Displayed Information

List of viewer's friends  

Actions

Invite to join a group 

Send e-mail  

Parameters

profileID

View whose friends to display 

height

Height setting 

width

Width setting 

Viewer's Groups Widget

The Viewer's Groups widget displays a listing of the groups that the viewer is a member.

Displayed Information

List of groups  

Actions

Link to a group's homepage (visibility determined by the owner's membership) 

Invite user to join group 

Next Page/Previous Page links if listing is more than one page 

Parameters

profileID

Person whose groups to display 

height

Height setting 

width

Width setting