facebook_registration 0.0.1

data/CHANGELOG.rdoc

@@ -0,0 +1,3 @@
+=== 1.0 / 2011-02-01
+
+* Initial Release.

data/README.rdoc

@@ -0,0 +1,48 @@
+= Author
+Veerasundaravel Thirugnanasundaram <veerasundaravel@gmail.com>
+
+http://veerasundaravel.wordpress.com/2011/01/27/facebook-registration-plugin-in-rails/
+
+= Synopsis
+facebook_registration is a ruby library for displaying new Facebook Registration form and to parse to signed_request.
+[http://developers.facebook.com/docs/plugins/registration]
+
+
+=== Installation
+  sudo gem install facebook_registration
+
+
+=== Using Gem in Rails
+Once you installed the gem, you will need to configure your Facebook app in config/facebooker.yml.
+
+You can copy facebooker.yml file which one is already available in this Root directory.
+
+
+=== Initializing Registration Form
+
+  <%= init_fb_registration %>
+
+
+=== Displaying Facebook Registration Form
+
+  <%= fb_registration_form("fields" =>"name,email,password", "redirect-uri"=>"http://localhost:3000/fb_registration", "width" =>830) %>
+
+  or 
+  
+  <%= fb_registration_form("fields" =>"[{'name':'name'}, {'name':'email'}, {'name':'password'}, {'name':'username','description':'Username','type':'text'}, {'name':'like', 'description':'You like this Website', 'type':'checkbox', 'default':'checked'}]", "fb_only"=>false, "redirect-uri"=>"http://localhost:3000/fb_registration", "width" =>830) %>
+  
+  For more form field specifications refer this url: 
+    http://developers.facebook.com/docs/plugins/registration#named_fields 
+    http://developers.facebook.com/docs/plugins/registration#custom_fields
+
+
+=== Accessing profile informations
+  After displaying the form, you can register their details and they will be redirected to the url which one you have specified as redirect-uri. 
+  
+  So in our case, you can parse the Facebook profile informations in the action fb_registration as follows:
+  
+  FacebookRegistration::SignedRequest.parse(params["signed_request"])
+  
+  it will return the output as follows:
+  
+  {"expires"=>1295964000, "registration_metadata"=>{"fields"=>"[{'name':'name'}, {'name':'location'}, {'name':'email'}]"}, "algorithm"=>"HMAC-SHA256", "registration"=>{"name"=>"Veera Sundaravel", "location"=>{"name"=>"Chennai, Tamil Nadu", "id"=>000000000}, "email"=>"veeraa2003@gmail.com"}, "user_id"=>"111111111", "oauth_token"=>"1212121212|2.9vzjKsatvaser_dStgereokRhg__.360220.1295964000-daff1|rsfsfasdfasdfasd", "user"=>{"country"=>"us", "locale"=>"en_US"}, "issued_at"=>1295956965}

data/facebook_registration.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{facebook_registration}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Veerasundaravel Thirugnanasundaram"]
+  s.date = %q{2011-02-01}
+  s.description = %q{facebook_registration is a ruby library for displaying new Facebook Registration form and to parse to signed_request[http://developers.facebook.com/docs/plugins/registration].}
+  s.email = ["veerasundaravel@gmail.com"]
+  s.extra_rdoc_files = ["CHANGELOG.rdoc", "README.rdoc", ]
+  s.files = ["CHANGELOG.rdoc", "README.rdoc", "facebook_registration.gemspec", "facebooker.yml", "lib/facebook_registration.rb", "lib/helpers/helpers.rb", "lib/rails/signed_request.rb"]
+  s.homepage = %q{http://veerasundaravel.wordpress.com/2011/01/27/facebook-registration-plugin-in-rails/}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{facebook_registration}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{facebook_registration is a ruby library for displaying new Facebook Registration form and to parse to signed_request[http://developers.facebook.com/docs/plugins/registration]. by Veerasundaravel Thirugnanasundaram}
+  s.test_files = []
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 1
+    s.add_runtime_dependency(%q<yajl-ruby>, [">= 0.7.6"])
+  else
+    s.add_dependency(%q<yajl-ruby>, [">= 0.7.6"])
+  end
+end

data/facebooker.yml

@@ -0,0 +1,14 @@
+development:
+  app_id: 
+  api_key: 
+  secret_key: 
+  
+production:
+  app_id: 
+  api_key: 
+  secret_key: 
+      
+test:
+  app_id: 
+  api_key: 
+  secret_key: 

data/lib/facebook_registration.rb

@@ -0,0 +1,32 @@
+module FacebookRegistration
+@facebook_configuration = {}
+  @raw_facebook_configuration = {}
+  @current_adapter = nil
+  @set_asset_host_to_callback_url = true
+  @path_prefix = nil
+  @use_curl    = false
+
+  class << self
+
+    def load_configuration(facebook_yaml_file)
+      return false unless File.exist?(facebook_yaml_file)
+      @raw_facebook_configuration = YAML.load(ERB.new(File.read(facebook_yaml_file)).result)
+      if defined? RAILS_ENV
+        @raw_facebook_configuration = @raw_facebook_configuration[RAILS_ENV]
+      end
+      @raw_facebook_configuration
+    end
+
+    def facebook_config
+      @facebook_configuration
+    end
+  end
+end
+
+facebook_config = "#{RAILS_ROOT}/config/facebooker.yml"
+FACEBOOK_CONFIG = FacebookRegistration.load_configuration(facebook_config)
+
+if defined? Rails
+  require 'helpers/helpers'
+  require 'rails/signed_request'
+end

data/lib/helpers/helpers.rb

@@ -0,0 +1,29 @@
+module FacebookRegistration
+  def self.included(base)
+    base.send :include, InstanceMethods
+  end
+  
+    
+  module InstanceMethods
+  DefaultValues = {"fields" =>"name,email,password", "redirect-uri"=>"http://localhost:3000/fb_registration", "fb_only" => false, "width" => "100%", "height" => nil, "onvalidate" =>nil}
+  
+  def init_fb_registration
+    raise "Must set Application ID for initializing" unless defined?(FACEBOOK_CONFIG) && FACEBOOK_CONFIG["app_id"]
+    "<script src=\"http://connect.facebook.net/en_US/all.js#appId=#{FACEBOOK_CONFIG["app_id"]}&xfbml=1\"></script> \n <script src=\"http://code.jquery.com/jquery-1.4.4.min.js\"></script>"
+  end
+  
+  def fb_registration_form(options={})
+    options = DefaultValues.merge(options).delete_if { |key, value| value.nil? }
+    str = "<fb:registration"
+    options.each_pair do |key, value|
+      str += " #{key} = \"#{value}\""
+    end
+    str += "> </fb:registration>"
+  end
+end
+
+
+end
+
+ActionView::Base.send(:include, FacebookRegistration) if defined?(ActionView::Base)
+

data/lib/rails/signed_request.rb

@@ -0,0 +1,43 @@
+require 'rubygems'
+require 'openssl'
+require 'base64'
+require 'yajl'
+
+module FacebookRegistration
+class SignedRequest
+      def self.parse(params)
+        if params.is_a?(Hash)
+	  signed_request = params.delete('signed_request')
+        else
+	  signed_request  = params
+	end
+	
+        unless signed_request
+          raise "Missing signed_request param"
+        end
+
+        signature, signed_params = signed_request.split('.')
+
+        unless signed_request_is_valid?(FACEBOOK_CONFIG['secret_key'], signature, signed_params)
+          raise "Invalid signature"
+        end
+
+        signed_params = Yajl::Parser.new.parse(base64_url_decode(signed_params))
+
+	return signed_params
+      end
+
+      private
+
+        def self.signed_request_is_valid?(secret, signature, params)
+          signature = base64_url_decode(signature)
+          expected_signature = OpenSSL::HMAC.digest('SHA256', secret, params.tr("-_", "+/"))
+          return signature == expected_signature
+        end
+
+        def self.base64_url_decode(str)
+          str = str + "=" * (6 - str.size % 6) unless str.size % 6 == 0
+          return Base64.decode64(str.tr("-_", "+/"))
+        end
+    end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+name: facebook_registration
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Veerasundaravel Thirugnanasundaram
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-01 00:00:00 +05:30
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.7.6
+    version: 
+description: facebook_registration is a ruby library for displaying new Facebook Registration form and to parse to signed_request[http://developers.facebook.com/docs/plugins/registration].
+email: 
+- veerasundaravel@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- README.rdoc
+files: 
+- CHANGELOG.rdoc
+- README.rdoc
+- facebook_registration.gemspec
+- facebooker.yml
+- lib/facebook_registration.rb
+- lib/helpers/helpers.rb
+- lib/rails/signed_request.rb
+has_rdoc: true
+homepage: http://veerasundaravel.wordpress.com/2011/01/27/facebook-registration-plugin-in-rails/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+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: facebook_registration
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 1
+summary: facebook_registration is a ruby library for displaying new Facebook Registration form and to parse to signed_request[http://developers.facebook.com/docs/plugins/registration]. by Veerasundaravel Thirugnanasundaram
+test_files: []
+