- Will Rossiter <will (at) fullscreen (dot) io>
- SilverStripe 2.4 or newer.
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.
-
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 %>
-
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:
function foo() { // returns the likes
$likes = $this->getFacebook()->api('/me/likes');}
-
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/setup
-
Once you have registered your app then set the following in your mysite/_config.php file. Replace the values with the ones you should get after registering your app
FacebookConnect::set_api_key('api-key'); FacebookConnect::set_api_secret('api-secret'); FacebookConnect::set_app_id('api-id'); FacebookConnect::set_lang('en_US');
You need to add the fb: namespace to your Page.ss file. For example your tag at the top should look like
<html lang="en" xmlns:fb="https://www.facebook.com/2008/fbml">
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
// 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();
Released under the BSD License.