...
Originally written in 2007 by Matt Young and Ren Provey of Duke University and presented in the 2007 JA-SIG conference. Updated by Gary Weaver in 2011 to use the latest Facebook Javascript API.
Requirements for Usage
- While some modification of this portlet may in use at one or more institutions running an earlier version of uPortal, it may require significant additional work in coding/configuration to be functional.
Features
- lets you login to facebook via link to facebook login then kicks back into portal
- shows the following at top bar:
- Friend Req.: 3
- Event Invites: 0
- New Messages: 2
- Pokes: 0
- Disconnect from Facebook (link)
- Facebook.com (link)
- shows friend requests with their pictures and names (which link to profiles)
Notes
Discussion on portlet-dev on 5/20/2009:
- "Hi Cris, My understanding of the Duke FB portlet is that it displays a friend list with pictures and shows the notification count, buy Gary might be able to expand on the functionality a bit more than I. It also uses a login mechanism that only works in uP versions < 3.0, because it relies on a hack to allow the portlet to read the full query string. This hack doesn't work in uP 3.0 or greater and this is why I wrote the new version which uses the newer "Facebook Connect" login mechanism. Functionally, the new one doesn't display pictures of friends, but does show notifications and adds the ability to update your FB status. Hope that clears it up some." - Erik
- "Hi Erik, I believe the Duke FB portlet should actually work in uPortal 3.0.x, as of revision 43702 (last May)." - Jen
- "Hmm. I did extensive testing and couldn't get it to work on 3.0.1. It still relies on a dirty cast of PortletRequest to HttpServletRequest to get access to the query string when it does work. This was the only way to do it before Facebook Connect was released however, so it couldn't be avoided." -ErikLets you login/logout of Facebook with a button
- Show number of user's friend notifications and requests
- Displays last 5 messages in user's news feed (note: may not be the same messages that the user would see in their Facebook news page)
- Allows user to post status to Facebook
Usage Documentation
- FacebookPortlet User Manual
Gallery
...
- Needs review: Is it a standards-compliant JSR-168 portlet? - Not completely, due to Facebook Javascript SDK requirement to have a div with the id "fb-root".
- Needs review: Does it have what JA-SIG would consider to be modular design and APIs?
- Needs review: Uses Spring PortletMVC and appropriate Spring practices (It uses Spring, but haven't checked on PortletMVC or if Spring use is appropriate for uPortal.)- think so
- Builds with AntNeeds (more) unit testsMaven
- Tests: Since primarily javascript, not much benefit in unit testing
Cultural
- A collaborative open source project under the auspices of JA-SIG
- Can be used commercially and non-commercially
- Produces actual production-ready releases, not just a code drop or a project that exclusively lives in SVN (Note: for now we would appreciate some help in this, and Jen of Yale offered to help until Duke has time to help develop it)
Participants
- ~bourey
- ~gary.weaver@duke.edu
- ~bourey
- (feel free to add yourself here if you'd like to participate!)
- ...
...
Here are enumerated the people believed to be committers for this project:
- ~bourey
- ~gary.weaver@duke.edu
- ~bourey
- (feel free to add yourself here if you'd like to contribute!)
...
Action Item | Assignee | Status | |
---|---|---|---|
Give garysweaver svn commit access | Done | ||
Create a sandbox SVN module https://www.ja-sig.org/svn/sandbox/FacebookPortlet | Done | ||
Document intent to move to SVN portlets/ directory as of first RC | ? | Not started ~gary.weaver@duke.edu | Ok with me to move to incubation if accepted |
Create child pages of Portlets wiki space for this portlet content | Done | ||
Build out this page with more info | Done (added user manual, copied from http://dukepass.oit.duke.edu/portlets/docs/) | ||
Document this projectlet on the JA-SIG Clearinghouse Contributions page | ? | Not started ~gary.weaver@duke.edu | Is this still applicable? |
Create a Jira project in the portlets group | ? | Not started ~gary.weaver@duke.edu | Done |
Does this need its own dev and user mailing lists? | ? | Not started ~gary.weaver@duke.edu | No, can use existing portlet-dev, portlet-user, uportal-user lists |