Added facebook connect module

Author: Stig Lindqvist

facebookconnect/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2010, Will Rossiter
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name of the organization nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY WILL ROSSITER ''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 Will Rossiter 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.

facebookconnect/README.md

@@ -0,0 +1,116 @@
+# Facebook Connect Integration Module
+
+## Maintainer Contact 
+ * Will Rossiter 
+   <will (at) fullscreen (dot) io>
+	
+## Requirements
+ * SilverStripe 3.0 
+
+## Overview
+
+The module provides a **basic** interface for implementing Facebook connect on 
+a website. Facebook connect allows users to login to your website using their 
+Facebook account. This module integrates that single sign-on within the existing 
+SilverStripe member system.
+
+This has been designed to use the Javascript SDK rather than the OAuth interface.
+
+### What it provides
+
+ * Loads and setups Facebook Connect for Single Sign on via the Javascript SDK
+
+ * Authenticates users visiting the site - if they are logged into Facebook then 
+ you can access their information via the following controls. You can also 
+ optionally set whether to save visitors information as members on your site 
+ (for example if you need to cache their information)
+	
+   If you haven't disabled the FacebookConnect::$create_member variable you can 
+   access the Facebook's member information by using:
+
+    ```
+	<% control CurrentMember %>
+		$FirstName $LastName $Avatar(small)
+	<% end_control %>
+	```
+
+   If you have disabled the creation of members you can use the Facebook specific 
+   member control. This still returns a member object the only difference is that 
+   it won't save the information to the database
+
+    ```
+	<% control CurrentFacebookMember %>
+		$FirstName $LastName $Avatar(small)
+	<% end_control %>
+    ```
+	
+### What it does not provide (yet)
+
+  * This current iteration only provides the backbone. In future updates I am aiming 
+  to integrate things like publishing stories to a users wall, interacting with events, 
+  groups and other things like friends.
+  * More controls over the logged in members information (eg status updates, events, 
+  groups). If you need this functionality you can build this on top of the Facebook API 
+  which is exposed:
+
+    ```php
+	function foo() {
+		// returns the likes		
+		$likes = $this->getFacebook()->api('/me/likes');
+	}
+    ```
+	
+### How to use
+
+  * To setup Facebook connect your first need to download this and put it in your 
+  SilverStripe sites root folder. 
+  * You need to register your website / application at 
+  https://developers.facebook.com/apps/?action=create
+  * Once you have registered your app set the following in your mysite/_config.php 
+  file. Replace the values with the ones you should get after registering your app.
+
+    ```php
+    FacebookConnect::set_app_id('app-id');
+    FacebookConnect::set_api_secret('api-secret');
+    FacebookConnect::set_lang('en_US');
+    ```
+
+  * Update the database by running `/dev/build` to add the additional fields to 
+  the `Member` table.
+
+  * Include the `ConnectInit.ss` template in the `<body>` part of every site you 
+  wish to call a Facebook function. This includes the Facebook JavaScript SDK. 
+  E.g. on `FrontendPage.ss`
+
+    ```
+    <body>
+        <% include ConnectInit %>
+    ```
+
+Once you have done that you should be able to use the includes provided in this module.
+
+```
+<% if CurrentFacebookMember %>
+	<p>Hi $CurrentFacebookMember.FirstName</p>
+	<% include ConnectLogout %>
+<% else %>
+	<% include ConnectLogin %>
+<% end_if %>
+```
+
+You can also access the Facebook member information in your PHP code. The Facebook API 
+connection and current member are cached on the controller object. So for example if 
+this is in your Page_Controller class
+
+```php
+// returns the current facebook member (wrapped in a SS Member Object)	
+$this->getCurrentFacebookMember();
+
+// returns the API connection which you can use to write your own query
+$this->getFacebook(); 
+```
+	
+### License
+
+Released under the BSD License. 
+	

facebookconnect/_config.php

@@ -0,0 +1,17 @@
+<?php
+
+// configuration for facebook connect. You should not edit any of these
+// values and instead override from the mysite/_config file
+
+require_once(dirname(__FILE__) . "/thirdparty/facebook-php-sdk/src/facebook.php");
+
+// adds an extension hook to member
+DataObject::add_extension('Member', 'FacebookMember');
+
+// adds the authenticator to the built in login form
+Authenticator::register('FacebookAuthenticator');
+
+// add the facebook controller
+DataObject::add_extension('Controller', 'FacebookConnect');
+
+// don't forget to add Facebook App Keys to mysite/_config.php

facebookconnect/code/FacebookAuthenticator.php

@@ -0,0 +1,39 @@
+<?php
+
+/**
+ * Facebook Connect Authenicator. Provides a tab in {@link Security::login()}
+ *
+ * @package facebookconnect
+ */
+
+class FacebookAuthenticator extends Authenticator {
+	
+	/**
+	 * Authentication is handled by Facebook rather than us this needs to 
+	 * return the new member object which is created. Creation of the member
+	 * is handled by {@link FacebookConnect::onBeforeInt()}
+	 *
+	 * @return false|Member
+	 */
+	public static function authenticate($RAW_data, Form $form = null) {
+		return ($member = Member::currentMember()) ? $member : false;
+	}
+
+	/**
+	 * Return the facebook login form
+	 *
+	 * @return Form
+	 */
+	public static function get_login_form(Controller $controller) {
+    	return Object::create("FacebookLoginForm", $controller, "FacebookLoginForm");
+	}
+
+	/**
+	 * Return the name for the facebook tab
+	 *
+	 * @return String
+	 */
+	public static function get_name() {
+		return _t('FacebookAuthenicator.TITLE', "Facebook Connect");
+	}
+}