facebook_oauth 0.1.1 → 0.2.0

data/README.textile

@@ -8,6 +8,8 @@ h2. Using the gem
 
 To make authorized requests with the client library you'll need to "create a Facebook Application":http://www.facebook.com/developers/createapp.php.
 
+See "http://facebook-oauth.heroku.com/":http://facebook-oauth.heroku.com/ for a full integration example.
+
 h2. Authorized request example
 
 To use the full power of the Facebook API you need to authorize your application and a valid Facebook user via OAuth.
@@ -33,20 +35,19 @@ In your application your user would be redirected to Facebook to authorize the a
 client.me.info # returns your user information
 </code></pre>
 
-Now if you keep hold of the access_token.token (usually in the database) for this user you won't need to re-authorize them next time.  When you create an instance of the client you can just pass in the access token and secret that you have stored.
+Now if you keep hold of the access_token.token (usually in the database) for this user you won't need to re-authorize them next time.  When you create an instance of the client you can just pass in the access token that you have stored.
 
 <pre><code>access_token = @user.access_token # assuming @user
+
 client = FacebookOAuth::Client.new(
     :application_id => 'YOUR_APPLICATION_ID',
     :application_secret => 'YOUR_APP_SECRET_KEY',
-    :callback => 'http://example.com/facebook/callback',
     :token => access_token
 )
 
 client.me.info # returns your user information
 </code></pre>
 
-
 h2. Supported objects
 
     * Me (a special object that represents the current authorized user)
@@ -63,8 +64,24 @@ h2. Supported objects
     * User
     * Video
 
-You can access any object listed above in the same way via the API.  For example, event attendees would be:
+You can access any object listed above in the same way via the API.  For example:
+
+<pre><code>client.me.home    # the authorized users news feed
+client.event('event_id').attending    # event attendees
+client.group('group_id').members    # group members
+client.photo('photo_id').comments  # comments on a photo
+</code></pre> 
+
+Check out the "Facebook API Reference":http://developers.facebook.com/docs/reference/api/ to see what methods are available.
+
+h2. Publishing options
+
+In order to publish content to a user you need to have the correct permissions.  For example, to publish to a users wall you need the <code>publish_stream</code> permission.  You specify the permissions you want to have for the authorizing user when you generate the authorize url like this:
+
+<pre><code>client.authorize_url(:scope => 'publish_stream')</code></pre>
+
+The scope is a comma-separated list of permissions.  See the "Facebook Permissions page":http://developers.facebook.com/docs/authentication/permissions for more information.
 
-<code>client.event('event_id').attending</code> 
+With the correct permissions you can now post to a users wall like this:
 
-Check out the "Facebook API Reference":http://developers.facebook.com/docs/reference/api/ to see what methods are available.
+<pre><code>client.me.feed(:create, :message => 'Testing writing to your wall...')</pre></code>

data/lib/facebook_oauth/client.rb

@@ -11,7 +11,7 @@ module FacebookOAuth
     end
   
     def authorize_url(options = {})
-      options[:scope] ||= 'email,offline_access'
+      options[:scope] ||= 'offline_access,publish_stream'
       consumer.web_server.authorize_url(
         :redirect_uri => options[:callback] || @callback,
         :scope => options[:scope]
@@ -45,8 +45,8 @@ module FacebookOAuth
         JSON.parse(oauth_response)
       end
 
-      def _post(url, body = '', headers = {})
-        oauth_response = access_token.post(url, body, headers)
+      def _post(url, params={}, headers={})
+        oauth_response = access_token.post(url, params, headers)
         JSON.parse(oauth_response)
       end
 

data/lib/facebook_oauth/objects.rb

@@ -50,7 +50,7 @@ module FacebookOAuth
     end
     
   end
-  
+    
   class FacebookObject
     def initialize(oid, client)
       @oid = oid
@@ -61,9 +61,12 @@ module FacebookOAuth
       @client.send(:_get, @oid)
     end
     
-    def method_missing(a)
-      puts a.inspect
-      @client.send(:_get, "#{@oid}/#{a.to_s}")
+    def method_missing(method, *args)
+      if args.first and args.first == :create
+        @client.send(:_post, "/#{@oid}/#{method.to_s}", args.last)
+      else
+        @client.send(:_get, "/#{@oid}/#{method.to_s}")
+      end
     end
     
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: facebook_oauth
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors: 
 - Richard Taylor
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-06 00:00:00 +01:00
+date: 2010-05-07 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -65,7 +65,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: "0"
     version: 
-description: facebook_oauth is a Ruby client library for facebook using the oauth method.
+description: facebook_oauth is a Ruby client library for the Facebook OAuth Graph API
 email: moomerman@gmail.com
 executables: []
 
@@ -107,6 +107,6 @@ rubyforge_project: facebook_oauth
 rubygems_version: 1.3.5
 signing_key: 
 specification_version: 2
-summary: facebook_oauth is a Ruby client library for facebook using the oauth method.
+summary: facebook_oauth is a Ruby client library for the Facebook OAuth Graph API
 test_files: []