Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

...

  • 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

...

Here are enumerated the people believed to be committers for this project:

...

Action Item

Assignee

Status

Give garysweaver svn commit access

~awp9

Done

Create a sandbox SVN module https://www.ja-sig.org/svn/sandbox/FacebookPortlet

~gary.weaver@duke.edu

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

~gary.weaver@duke.edu

Done

Build out this page with more info

~gary.weaver@duke.edu

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