Facebook Beta Plugin

The Facebook plugin integrates the users' Facebook profiles into Clearspace while allowing each user to control how (or if) their Facebook information is shown. A reduced set of Facebook features is displayed including Profile, Education and Work, Photos, Friends, Groups, and Other information. The user can choose exactly which piece of information is displayed by changing the settings under "Choose Facebook Details". Users can also disconnect their Facebook profile from Clearspace if they no longer want to share it. After installing, each user profile will have a Facebook Profile tab; for those users not participating, the tab will include a message stating that "No Facebook profile information is available for this user".

Beta Disclaimer

This is beta code, so expect a few bugs and use it at your own risk. We are interested in your feedback about this plugin.

What's Included

The source code and the jar file for the Facebook plugin.

Building and Deploying the Code

You can deploy the plugin a number of ways. Here are 2 options:

• Just copy the plugin JAR file into the <jiveHome>/plugins directory. Your running Clearspace instance will deploy it automatically.

• Open the admin console and navigate to System > Settings > Plugins, then browse for your plugin JAR file.

Using the Facebook Plugin

• From the "Your Stuff" drop down, you should now see a Facebook Profile option at the bottom.

• Clicking on the Facebook Profile option will prompt you to "Log in to Facebook"

• Make sure you select the checkbox next to "Allow Clearspace to access my information"

• Click the link to Refresh to view your Facebook details

• You should now see your Facebook profile and a new Facebook profile tab on your profile page

Credits

Thanks to Face It! for doing the initial development of this plugin. Jive engineers will be performing bug fixes and maintaining the plugin.  Let us know if you find any bugs.

Download

• The source code can be found in the Jivespace svn instance.

• The jar file is attached below.

<h2>Licenses and Notices</h2>

<p>Except where explicitly stated otherwise, this plugin is Copyright 2007 Jive Software Licensed under the Apache License, Version 2.0. (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. </p>

Some files in this distribution are covered under the license below.

+---------------------------------------------------------------------------+
 | Facebook Development Platform Java Client                                 |
 +---------------------------------------------------------------------------+
 | Copyright (c) 2007 Facebook, Inc.                                         |
 | All rights reserved.                                                      |
 |                                                                           |
 | Redistribution and use in source and binary forms, with or without        |
 | modification, are permitted provided that the following conditions        |
 | are met:                                                                  |
 |                                                                           |
 | 1. Redistributions of source code must retain the above copyright         |
 |    notice, this list of conditions and the following disclaimer.          |
 | 2. Redistributions in binary form must reproduce the above copyright      |
 |    notice, this list of conditions and the following disclaimer in the    |
 |    documentation and/or other materials provided with the distribution.   |
 |                                                                           |
 | THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR      |
 | IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
 | OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.   |
 | IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,          |
 | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT  |
 | NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
 | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY     |
 | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT       |
 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF  |
 | THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.         |
 +---------------------------------------------------------------------------+
 | For help with this library, contact developers-help@facebook.com          |
 +---------------------------------------------------------------------------+