== 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 http://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.
Your awsome facebook connected app
<%= stylesheet_link_tag 'application' %>
<%= javascript_include_tag :defaults %>
<%= flash[:notice] %>
<%= fb_connect_javascript_tag %>
<%= init_fb_connect "XFBML" %>
<%= yield %>
=== 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.