Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The facebooker Rails plugin
Ruby
branch: master

This branch is 1 commit ahead, 611 commits behind mmangino:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
generators
lib
rails
templates
test
.gitignore
CHANGELOG.txt
COPYING
History.txt
Manifest.txt
README
README.txt
Rakefile
TODO.txt
facebooker.gemspec
init.rb
install.rb
setup.rb

README

Copyright (c) 2007 Chad Fowler, Patrick Ewing

= Facebooker

Facebooker is a Ruby wrapper over the Facebook[http://facebook.com] {REST API}[http://developer.facebook.com].  Its goals are:

* Idiomatic Ruby
* No dependencies outside of the Ruby standard library (This is true with Rails 2.1. Previous Rails versions require the JSON gem)
* Concrete classes and methods modeling the Facebook data, so it's easy for a Rubyist to understand what's available
* Well tested

= Installing (Non Rails)

The best way is:

  gem install facebooker

If, for some reason, you can't/won't use RubyGems, you can do:

  (sudo) ruby setup.rb

= Installing (Rails)

Facebooker can be installed as a Rails plugin by:

  script/plugin install git://github.com/mmangino/facebooker.git

If you don't have git, the plugin can be downloaded from http://github.com/mmangino/facebooker/tarball/master

Once the plugin is installed, you will need to configure your Facebook app in config/facebooker.yml. 

Your application users will need to have added the application in facebook to access all of facebooker's features. You enforce this by adding

  ensure_application_is_installed_by_facebook_user  

to your application controller.


== Work in Progress

I'm not saying it meets its goals fully yet.  Please help.  I'm especially interested in feedback and criticism re: Ruby style and design and testing.  RCov has the library (at the time of this writing) at 100% coverage.  I take that with a grain of salt, but it's a good start.

== Contribute

Please visit the {RubyForge project page}[http://rubyforge.org/projects/facebooker] to get the latest source via svn, write some tests, add/fix features, and submit a patch via the tracker.  If you submit a good patch, it's likely that I'll add you to the project for commit access if you want to be added.

Something went wrong with that request. Please try again.