A simple facebook connect library for ruby
Switch branches/tags
Nothing to show
Pull request Compare This branch is 4 commits ahead, 61 commits behind mmangino:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Provides rails helpers for interfacing with Facebook's OpenGraph Javascript API.

Requires the mogli gem.


0- Prerequisite: You need a facebook app. Have your API Key, Application Secret, and Application ID handy.

1- Install facebooker2 as a plugin in your rails app.

2- Create config/facebooker.yml with the appropriate environment.

  app_id: <your application id>
  secret: <your application secret>
  api_key: <your application key>

3- Create config/initializers/facebooker2.rb and place the following line in it


4- Add the following line to your app/controllers/application_controller.rb (add it right after the line class ApplicationController < ActionController::Base so as to add the Facebooker2 instance methods to the Application controller)

include Facebooker2::Rails::Controller

5- Update your rails applications to use the rails helpers. This could be in a shared login partial.

<%= fb_connect_async_js %>
<% if current_facebook_user %>
  <%= "Welcome #{current_facebook_user.first_name} #{current_facebook_user.last_name}!" %>
  <%= "Hello #{fb_name(current_facebook_user, :useyou => false)}!" # link to facebook profile %>
  <%= fb_logout_link("Logout of fb", request.url) %><br />
<% else
   # you must explicitly request permissions for facebook user fields.
   # here we instruct facebook to ask the user for permission for our website
   # to access the user's facebook email and birthday
  <%= fb_login_and_redirect('<your URL here>', :perms => 'email,user_birthday') %>
<% end %>

Facebook canvas applications

If you are building an application that runs inside a Facebook canvas, all the coming requests from Facebook to your iframe will be POST requests.

You can use the PostCanvas rack middleware to turn the Facebook POST requests back to GET requests and keep your app restful as described in this blog post. If you are using Rails 3, put this line of code inside your config.ru file :

use Rack::PostCanvas


Unit tests use rspec and require the following environment configuration to run: rails 2.3.10 rspec 1.3.1 rspec-rails 1.3.3 json 1.4.0

Invoke tests on Mac/Linux by running rake spec from this directory

Invoke tests on Windows by running spec spec/ from this directory

Copyright (c) 2010 Mike Mangino, released under the MIT license