kalasjocke / authlogic_facebook_connect
watch download tarball
public
Forks22Right
Watchers170Right
Description: Extension of the Authlogic library to add Facebook Connect support built upon the excellent facebooker gem
Homepage:
Clone URL: git://github.com/kalasjocke/authlogic_facebook_connect.git
name age
history
message
file README.rdoc Sun Sep 06 05:55:53 -0700 2009 Documentation about the before_connect hook. [kalasjocke]
file init.rb Mon May 04 11:28:07 -0700 2009 Please add content. [kalasjocke]
directory lib/ Fri Nov 13 05:01:04 -0800 2009 Merge branch 'master' of git://github.com/matte... [kalasjocke]
README.rdoc

Install and use

1. Install the facebooker gem and make Rails use it

  $ sudo gem install facebooker

Make sure that you have setup you config/facebooker.yml to match your facebook application, make you application depended on the facebooker gem 

  config.gem "facebooker"

and run the xd_receiver generator to create the cross domain scripting bridge to make it possible for your application to communicate with facebook 

  $ script/generate xd_receiver

For more information on the facebooker gem checkout it’s readme github.com/mmangino/facebooker/tree/master

2. Install the Authlogic Facebook Connect plugin

  $ script/plugin install git://github.com/kalasjocke/authlogic_facebook_connect.git

This plugin should soon be packed inside a gem.

3. Make some changes to your database

  class AddFacebookConnectFieldsToUser < ActiveRecord::Migration
    def self.up
      add_column :users, :name, :string
      add_column :users, :facebook_uid, :integer, :limit => 8
    end

    def self.down
      remove_column :users, :facebook_uid
      remove_column :users, :name
    end
  end

4. Make your layout look something like this

The important parts are the facebook html namespace, facebook javascript include and the facebook helper calls to init the facebooker gem. 

  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
         "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

  <html xmlns="http://www.w3.org/1999/xhtml" xmlns:fb="http://www.facebook.com/2008/fbml">
  <head>
    <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
    <title>Your awsome facebook connected app</title>

    <%= stylesheet_link_tag 'application' %>
    <%= javascript_include_tag :defaults %>

    <script src="http://static.ak.connect.facebook.com/js/api_lib/v0.4/FeatureLoader.js.php" type="text/javascript"></script>
  </head>
  <body>

  <p style="color: green"><%= flash[:notice] %></p>

  <%= fb_connect_javascript_tag %>
  <%= init_fb_connect "XFBML" %>

  <%= yield %>

  </body>
  </html>

5. Add the Facebook Connect button to your login form

  <%= authlogic_facebook_login_button %>

Notes

If you want to save some user data when connecting to facebook you can use the before_connect hook in your user model. 

  def before_connect(facebook_session)
    self.name = facebook_session.user.name
  end

For more information about what you can get form the facebook_session checkout the Facebooker gem rdoc.