facebooker2 0.0.1

data/lib/facebooker2/rails/controller.rb

@@ -0,0 +1,72 @@
+require "digest/md5"
+require "ruby-debug"
+module Facebooker2
+  module Rails
+    module Controller
+      
+      def self.included(controller)
+        controller.helper Facebooker2::Rails::Helpers
+        controller.helper_method :current_facebook_user
+        controller.helper_method :current_facebook_client
+      end
+      
+      def current_facebook_user
+        fetch_client_and_user_from_cookie
+        @_current_facebook_user
+      end
+      
+      def current_facebook_client
+        fetch_client_and_user_from_cookie
+        @_current_facebook_client
+      end
+      
+      def fetch_client_and_user_from_cookie
+        return if @_fb_user_fetched
+        app_id = Facebooker2.app_id
+        if (hash_data = fb_cookie_hash_for_app_id(app_id)) and
+          fb_cookie_signature_correct?(fb_cookie_hash_for_app_id(app_id),Facebooker2.secret)
+          client = Mogli::Client.new(hash_data["access_token"],hash_data["expires"].to_i)
+          user = Mogli::User.new(:id=>hash_data["uid"])
+          user.client = @_current_facebook_client
+          fb_sign_in_user_and_client(user,client)
+        end
+        @_fb_user_fetched = true
+      end
+      
+      def fb_sign_in_user_and_client(user,client)
+        @_current_facebook_user = user
+        @_current_facebook_client = client
+        @_fb_user_fetched = true
+      end
+      
+      def fb_cookie_hash_for_app_id(app_id)
+        return nil unless fb_cookie_for_app_id?(app_id)
+        hash={}
+        data = fb_cookie_for_app_id(app_id).gsub(/"/,"")
+        data.split("&").each do |str|
+          parts = str.split("=")
+          hash[parts.first] = parts.last
+        end
+        hash
+      end
+      
+      def fb_cookie_for_app_id?(app_id)
+        !fb_cookie_for_app_id(app_id).nil?
+      end
+      
+      def fb_cookie_for_app_id(app_id)
+        cookies["fbs_#{app_id}"]
+      end
+      
+      def fb_cookie_signature_correct?(hash,secret)
+        sorted_keys = hash.keys.reject {|k| k=="sig"}.sort
+        test_string = ""
+        sorted_keys.each do |key|
+          test_string += "#{key}=#{hash[key]}"
+        end
+        test_string += secret
+        Digest::MD5.hexdigest(test_string) == hash["sig"]
+      end
+    end
+  end
+end

data/lib/facebooker2/rails/helpers/facebook_connect.rb

@@ -0,0 +1,45 @@
+module Facebooker2
+  module Rails
+    module Helpers
+      module FacebookConnect 
+        #
+        # Render an <fb:login-button> element, similar to
+        # fb_login_button. Adds a js redirect to the onlogin event via rjs.
+        #
+        # ==== Examples
+        #
+        #   fb_login_and_redirect '/other_page'
+        #   => <fb:login-button onlogin="window.location.href = &quot;/other_page&quot;;"></fb:login-button>
+        #
+        # Like #fb_login_button, this also supports the :text option
+        #
+        #   fb_login_and_redirect '/other_page', :text => "Login with Facebook", :v => '2'
+        #   => <fb:login-button onlogin="window.location.href = &quot;/other_page&quot;;" v="2">Login with Facebook</fb:login-button>
+        #
+        def fb_login_and_redirect(url, options = {})
+          js = update_page do |page|
+            page.redirect_to url
+          end
+
+          text = options.delete(:text)
+          
+          content_tag("fb:login-button",text,options.merge(:onlogin=>js))
+        end
+        
+        #
+        # Logs the user out of facebook and redirects to the given URL
+        #  args are passed to the call to link_to_function
+        def fb_logout_link(text,url,*args)
+          function= "FB.logout(function() {window.location.href = '#{url}';})"
+          link_to_function text, function, *args
+        end
+        
+        def fb_server_fbml(style=nil,&proc)
+          style_string=" style=\"#{style}\"" if style
+          content = capture(&proc)
+          concat("<fb:serverFbml#{style_string}><script type='text/fbml'>#{content}</script></fb:serverFbml>")
+        end
+      end
+    end
+  end
+end

data/lib/facebooker2/rails/helpers/javascript.rb

@@ -0,0 +1,34 @@
+module Facebooker2
+  module Rails
+    module Helpers
+      module Javascript
+        def fb_connect_async_js(app_id,options={})
+          opts = Hash.new(true).merge!(options)
+          cookie = opts[:cookie]
+          status = opts[:status]
+          xfbml = opts[:xfbml]
+          js = <<-JAVASCRIPT
+          <div id="fb-root"></div>
+          <script>
+            window.fbAsyncInit = function() {
+              FB.init({
+                appId  : '#{app_id}',
+                status : #{status}, // check login status
+                cookie : #{cookie}, // enable cookies to allow the server to access the session
+                xfbml  : #{xfbml}  // parse XFBML
+              });
+            };
+
+            (function() {
+              var e = document.createElement('script');
+              e.src = document.location.protocol + '//connect.facebook.net/en_US/all.js';
+              e.async = true;
+              document.getElementById('fb-root').appendChild(e);
+            }());
+          </script>
+        JAVASCRIPT
+        end
+      end
+    end
+  end
+end

data/lib/facebooker2/rails/helpers/user.rb

@@ -0,0 +1,70 @@
+module Facebooker2
+  module Rails
+    module Helpers
+      module User
+        # Render an fb:name tag for the given user
+        # This renders the name of the user specified.  You can use this tag as both subject and object of 
+        # a sentence.  <em> See </em> http://wiki.developers.facebook.com/index.php/Fb:name for full description.  
+        # Use this tag on FBML pages instead of retrieving the user's info and rendering the name explicitly.
+        #
+        def fb_name(user, options={})
+          options = fb_transform_keys(options,FB_NAME_OPTION_KEYS_TO_TRANSFORM)
+          fb_assert_valid_keys(options, FB_NAME_VALID_OPTION_KEYS)
+          options.merge!(:uid => Facebooker2.cast_to_facebook_id(user))
+          content_tag("fb:name",nil, fb_stringify_vals(options))
+        end
+
+        FB_NAME_OPTION_KEYS_TO_TRANSFORM = {:first_name_only => :firstnameonly, 
+                                            :last_name_only => :lastnameonly,
+                                            :show_network => :shownetwork,
+                                            :use_you => :useyou,
+                                            :if_cant_see => :ifcantsee,
+                                            :subject_id => :subjectid}
+        FB_NAME_VALID_OPTION_KEYS = [:firstnameonly, :linked, :lastnameonly, :possessive, :reflexive, 
+                                     :shownetwork, :useyou, :ifcantsee, :capitalize, :subjectid]
+        
+        
+        def fb_profile_pic(user, options={})
+          options = options.dup
+          validate_fb_profile_pic_size(options)
+          options = fb_transform_keys(options,FB_PROFILE_PIC_OPTION_KEYS_TO_TRANSFORM)
+          fb_assert_valid_keys(options,FB_PROFILE_PIC_VALID_OPTION_KEYS)
+          options.merge!(:uid => Facebooker2.cast_to_facebook_id(user))
+          content_tag("fb:profile-pic", nil,fb_stringify_vals(options))
+        end
+
+        FB_PROFILE_PIC_OPTION_KEYS_TO_TRANSFORM = {:facebook_logo => 'facebook-logo'}
+        FB_PROFILE_PIC_VALID_OPTION_KEYS = [:size, :linked, 'facebook-logo', :width, :height]
+        VALID_FB_PROFILE_PIC_SIZES = [:thumb, :small, :normal, :square]
+        def validate_fb_profile_pic_size(options)
+          if options.has_key?(:size) && !VALID_FB_PROFILE_PIC_SIZES.include?(options[:size].to_sym)
+            raise(ArgumentError, "Unknown value for size: #{options[:size]}")
+          end
+        end
+
+        def fb_stringify_vals(hash)
+         result={}
+         hash.each do |key,value|
+           result[key]=value.to_s
+         end
+         result
+        end
+         def fb_transform_keys(options,transformation_hash)
+           new_hash = {}
+           options.each do |key,value|
+             new_key = transformation_hash[key]||key
+             new_hash[new_key]=value
+           end
+           new_hash
+         end
+         FB_ALWAYS_VALID_OPTION_KEYS = [:class, :style]
+       
+       def fb_assert_valid_keys(options,*valid_keys)
+         unknown_keys = options.keys - [valid_keys + FB_ALWAYS_VALID_OPTION_KEYS].flatten
+         raise(ArgumentError, "Unknown key(s): #{unknown_keys.join(", ")}") unless unknown_keys.empty?
+       end    
+       
+      end
+    end
+  end
+end

data/lib/facebooker2/rails/helpers.rb

@@ -0,0 +1,9 @@
+module Facebooker2
+  module Rails
+    module Helpers
+      include FacebookConnect
+      include Javascript
+      include User
+    end
+  end
+end

data/lib/facebooker2/rails.rb

@@ -0,0 +1,4 @@
+module Facebooker2
+  module Rails
+  end
+end

data/lib/facebooker2.rb

@@ -0,0 +1,50 @@
+# Facebooker2
+require "mogli"
+
+module Facebooker2
+  class NotConfigured < Exception; end
+  class << self
+    attr_accessor :api_key, :secret, :app_id
+  end
+    
+  def self.secret
+    @secret || raise_unconfigured_exception    
+  end
+  
+  def self.app_id
+    @app_id || raise_unconfigured_exception
+  end
+  
+  def self.raise_unconfigured_exception
+    raise NotConfigured.new("No configuration provided for Facebooker2. Either set the app_id and secret or call Facebooker2.load_facebooker_yaml in an initializer")
+  end
+  
+  def self.configuration=(hash)
+    self.api_key = hash[:api_key]
+    self.secret = hash[:secret]
+    self.app_id = hash[:app_id]
+  end
+  
+  def self.load_facebooker_yaml
+    config = YAML.load(File.read(File.join(::Rails.root,"config","facebooker.yml")))[::Rails.env]
+    raise NotConfigured.new("Unable to load configuration for #{::Rails.env} from facebooker.yml. Is it set up?") if config.nil?
+    self.configuration = config.with_indifferent_access
+  end
+  
+  def self.cast_to_facebook_id(object)
+    if object.kind_of?(Mogli::Profile)
+      object.id
+    elsif object.respond_to?(:facebook_id)
+      object.facebook_id
+    else
+      object
+    end
+  end
+end
+
+
+require "facebooker2/rails/controller"
+require "facebooker2/rails/helpers/facebook_connect"
+require "facebooker2/rails/helpers/javascript"
+require "facebooker2/rails/helpers/user"
+require "facebooker2/rails/helpers"

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: facebooker2
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Mike Mangino
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-05 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mogli
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.4
+    version: 
+description: Facebook Connect integration library for ruby and rails
+email: mmangino@elevatedrails.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/facebooker2/rails/controller.rb
+- lib/facebooker2/rails/helpers/facebook_connect.rb
+- lib/facebooker2/rails/helpers/javascript.rb
+- lib/facebooker2/rails/helpers/user.rb
+- lib/facebooker2/rails/helpers.rb
+- lib/facebooker2/rails.rb
+- lib/facebooker2.rb
+has_rdoc: true
+homepage: http://developers.facebook.com/docs/api
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Facebook Connect integration library for ruby and rails
+test_files: []
+