facebooker-micah 1.0.74

data/lib/facebooker/adapters/adapter_base.rb

@@ -0,0 +1,91 @@
+module Facebooker
+
+  class AdapterBase
+    class UnableToLoadAdapter < Exception; end
+    require 'active_support/inflector'
+    include  ActiveSupport::CoreExtensions::String::Inflections
+    def facebook_path_prefix
+      "/" + (@facebook_path_prefix || canvas_page_name || ENV['FACEBOOK_CANVAS_PATH'] || ENV['FACEBOOKER_RELATIVE_URL_ROOT'])
+    end
+
+    def facebook_path_prefix=(prefix)
+      @facebook_path_prefix = prefix
+    end
+
+    def facebooker_config
+      @config
+    end
+
+    def api_server_base_url
+      "http://" + api_server_base
+    end
+
+    def is_for?(application_context)
+      raise "SubClassShouldDefine"
+    end
+
+    def initialize(config)
+      @config = config
+      @facebook_path_prefix = nil
+    end
+
+    def  self.facebooker_config
+      Facebooker.facebooker_config
+    end
+
+
+    def self.load_adapter(params)
+
+      config_key_base = params[:config_key_base] # This allows for loading of a aspecific adapter
+      config_key_base += "_" if config_key_base && config_key_base.length > 0
+
+      unless api_key = (params[:fb_sig_api_key] || facebooker_config["#{config_key_base}api_key"])
+        raise Facebooker::AdapterBase::UnableToLoadAdapter
+      end
+
+      unless facebooker_config
+        return self.default_adapter(params)
+      end
+
+      facebooker_config.each do |key,value|
+        next unless value == api_key
+
+        key_base = key.match(/(.*)[_]?api_key/)[1]
+
+        adapter_class_name = if !key_base || key_base.length == 0
+           "FacebookAdapter"
+        else
+          facebooker_config[key_base + "adapter"]
+        end
+
+        adapter_class = "Facebooker::#{adapter_class_name}".constantize
+
+        # Collect the rest of the configuration
+        adapter_config = {}
+        facebooker_config.each do |key,value|
+          if (match = key.match(/#{key_base}[_]?(.*)/))
+            adapter_config[match[1]] = value
+          end
+        end
+        return adapter_class.new(adapter_config)
+      end
+
+      return self.default_adapter(params)
+
+    end
+
+    def self.default_adapter(params = {})
+      if facebooker_config.nil? || (facebooker_config.blank? rescue nil)
+        config = { "api_key" => ENV['FACEBOOK_API_KEY'], "secret_key" =>  ENV['FACEBOOK_SECRET_KEY']}
+      else
+        config = facebooker_config
+      end
+     FacebookAdapter.new(config)
+    end
+
+    [:canvas_page_name, :api_key,:secret_key].each do |key_method|
+      define_method(key_method){ return facebooker_config[key_method.to_s]}
+    end
+
+  end
+end

data/lib/facebooker/adapters/bebo_adapter.rb

@@ -0,0 +1,77 @@
+module Facebooker
+  class BeboAdapter < AdapterBase
+
+    def canvas_server_base
+      "apps.bebo.com"
+    end
+
+    def api_server_base
+      'apps.bebo.com'
+    end
+
+    def api_rest_path
+      "/restserver.php"
+    end
+
+    def is_for?(application_context)
+      application_context == :bebo
+    end
+
+    def www_server_base_url
+      "www.bebo.com"
+    end
+
+
+    def login_url_base
+      "http://#{www_server_base_url}/SignIn.jsp?ApiKey=#{api_key}&v=1.0"
+    end
+
+    def install_url_base
+      "http://#{www_server_base_url}/c/apps/add?ApiKey=#{api_key}&v=1.0"
+    end
+  end
+end
+
+# Things that don't actually work as expected in BEBO
+module Facebooker
+  class User
+    def set_profile_fbml_with_bebo_adapter(profile_fbml, mobile_fbml, profile_action_fbml, profile_main = nil)
+      if(Facebooker.is_for?(:bebo))
+        self.session.post('facebook.profile.setFBML', :uid => @id, :markup => profile_fbml)
+      else
+        set_profile_fbml_without_bebo_adapter(profile_fbml,mobile_fbml, profile_action_fbml, profile_main)
+      end
+    end
+    alias_method :set_profile_fbml_without_bebo_adapter, :set_profile_fbml
+    alias_method :set_profile_fbml, :set_profile_fbml_with_bebo_adapter
+
+    private
+
+    BEBO_FIELDS = FIELDS - [:meeting_sex, :wall_count, :meeting_for]
+
+    remove_method :collect
+
+    def collect(fields)
+      if(Facebooker.is_for?(:bebo) )
+         BEBO_FIELDS.reject{|field_name| !fields.empty? && !fields.include?(field_name)}.join(',')
+      else
+         FIELDS.reject{|field_name| !fields.empty? && !fields.include?(field_name)}.join(',')
+      end
+    end
+  end
+
+
+  class PublishTemplatizedAction < Parser#:nodoc:
+    class <<self
+      def process_with_bebo_adapter(data)
+        if(Facebooker.is_for?(:bebo))
+          element('feed_publishTemplatizedAction_response', data).content
+        else
+          process_without_bebo_adapter(data)
+        end
+      end
+      alias_method :process_without_bebo_adapter, :process
+      alias_method :process, :process_with_bebo_adapter
+    end
+  end
+end

data/lib/facebooker/adapters/facebook_adapter.rb

@@ -0,0 +1,60 @@
+module Facebooker
+  
+   
+  class FacebookAdapter < AdapterBase
+      
+    def canvas_server_base
+      "apps.facebook.com"
+    end
+      
+    def api_server_base
+       "api.facebook.com"
+    end
+    
+    def video_server_base
+      "api-video.facebook.com"
+    end
+    
+    def www_server_base_url
+      "www.facebook.com"
+    end
+    
+    def api_rest_path
+      "/restserver.php"
+    end
+    
+    def api_key
+      ENV['FACEBOOK_API_KEY'] || super      
+    end
+    
+    def secret_key
+      ENV['FACEBOOK_SECRET_KEY'] || super
+    end
+      
+    def is_for?(application_context)
+      application_context == :facebook
+    end
+       
+  
+       
+    def login_url_base
+      "http://#{www_server_base_url}/login.php?api_key=#{api_key}&v=1.0"
+    end
+       
+    def install_url_base
+      "http://#{www_server_base_url}/install.php?api_key=#{api_key}&v=1.0"
+    end
+
+    def connect_permission_url_base
+      "http://#{www_server_base_url}/connect/prompt_permissions.php?api_key=#{api_key}&v=1.0"      
+    end
+
+    def permission_url_base
+      "http://#{www_server_base_url}/authorize.php?api_key=#{api_key}&v=1.0"
+    end
+    
+  end
+  
+end
+
+

data/lib/facebooker/admin.rb

@@ -0,0 +1,42 @@
+module Facebooker
+  class Admin
+    def initialize(session)
+      @session = session
+    end
+    
+    # ** BETA ***
+    # +properties+: Hash of properties you want to set
+    def set_app_properties(properties)
+      properties = properties.respond_to?(:to_json) ? properties.to_json : properties
+      (@session.post 'facebook.admin.setAppProperties', :properties => properties) == '1'
+    end
+    
+    # ** BETA ***
+    # +properties+: Hash of properties you want to view.
+    def get_app_properties(*properties)
+      json = @session.post('facebook.admin.getAppProperties', :properties => properties.to_json)
+      hash = Facebooker.json_decode(CGI.unescapeHTML(json))
+      @properties = ApplicationProperties.from_hash(hash)
+    end
+    
+    # ** BETA ***
+    # +restrictions+: Hash of restrictions you want to set.
+    def set_restriction_info(restrictions)
+      restrictions = restrictions.respond_to?(:to_json) ? restrictions.to_json : restrictions
+      (@session.post 'facebook.admin.setRestrictionInfo', :restriction_str => restrictions) == '1'
+    end
+    
+    # ** BETA ***
+    def get_restriction_info(*restrictions)
+      json = @session.post('facebook.admin.getRestrictionInfo')
+      hash = Facebooker.json_decode(CGI.unescapeHTML(json))
+      @restrictions = ApplicationRestrictions.from_hash(hash)
+    end
+  
+    # Integration points include..
+    #   :notifications_per_day, :requests_per_day, :emails_per_day, :email_disable_message_location
+    def get_allocation(integration_point)
+      @session.post('facebook.admin.getAllocation', :integration_point_name => integration_point.to_s).to_i
+    end    
+  end
+end

data/lib/facebooker/application.rb

@@ -0,0 +1,37 @@
+module Facebooker
+  class Application
+    def initialize(session)
+      @session = session
+    end
+    
+    # +properties+: Hash of properties of the desired application. Specify exactly one of: application_id, application_api_key or application_canvas_name 
+    # eg: application.get_public_info(:application_canvas_name => ENV['FACEBOOKER_RELATIVE_URL_ROOT'])
+    def get_public_info(properties)
+      (@session.post 'facebook.application.getPublicInfo', properties)
+    end
+    
+    # facebook_session.application.add_global_news [{ :message => 'Hi all users', :action_link => { :text => "Hi application", :href => 'http://facebook.er/' }}], 'http://facebook.er/icon.png'
+    def add_global_news(news, image=nil)
+      params = {}
+      params[:news] = news
+      params[:image] = image if image
+      @session.post('facebook.dashboard.addGlobalNews', params)
+    end
+    
+    # currently bugged on Facebook; returns all
+    # facebook_session.application.get_global_news '310354202543'
+    def get_global_news(*news_ids)
+      params = {}
+      params[:news_ids] = news_ids.flatten if news_ids
+      @session.post('facebook.dashboard.getGlobalNews', params)
+    end
+    
+    # facebook_session.application.clear_global_news '310354202543'
+    def clear_global_news(*news_ids)
+      params = {}
+      params[:news_ids] = news_ids.flatten if news_ids
+      @session.post('facebook.dashboard.clearGlobalNews', params)
+    end
+    
+  end
+end

data/lib/facebooker/attachment.rb

@@ -0,0 +1,59 @@
+class Facebooker::Attachment
+  
+  def initialize
+    @storage = {}
+  end
+  
+  def self.hash_populating_accessor(*names)
+    names.each do |name|
+      define_method(name) do
+        @storage[name]
+      end
+      define_method("#{name}=") do |val|
+        @storage[name]=val
+      end
+    end
+  end
+  
+  hash_populating_accessor :name,:href, :comments_xid, :description, :caption
+  
+  def add_media(hash)
+    @storage[:media]||=[]
+    @storage[:media] << hash
+  end
+  
+  def add_image(source,href)
+    add_media({:type=>"image",:src=>source,:href=>href})
+  end
+  
+  def add_mp3(source,title=nil,artist=nil,album=nil)
+    params = {:src=>source,:type=>"mp3"}
+    params[:title] =  title unless title.nil?
+    params[:artist] =  artist unless artist.nil?
+    params[:album] =  album unless album.nil?
+    add_media(params)
+  end
+  
+  def add_flash(swfsource, imgsource, width=nil, height=nil, expanded_width=nil, expanded_height=nil)
+    params={:type=>"flash",:swfsrc=>swfsource,:imgsrc=>imgsource}
+    params[:width] = width unless width.nil?
+    params[:height] = height unless height.nil?
+    params[:expanded_width] = expanded_width unless expanded_width.nil?
+    params[:expanded_height] = expanded_height unless expanded_height.nil?
+    add_media(params)
+  end
+
+  
+  def add_property(key, value)
+    @storage[:properties] ||= {}
+    @storage[:properties][key] = value
+  end
+
+
+  
+  def to_hash
+    @storage
+  end
+  
+  
+end

data/lib/facebooker/batch_request.rb

@@ -0,0 +1,45 @@
+module Facebooker
+  class BatchRequest
+    instance_methods.each { |m| undef_method m unless m =~ /(^__|^nil\?$|^send$|proxy_|^respond_to\?$|^new|object_id$)/ }
+    attr_reader :uri
+    attr_reader :method
+    class UnexecutedRequest < StandardError; end
+    def initialize(params,proc)
+      @exception  = nil
+      @result     = nil
+      @method     = params[:method]
+      @uri        = params.map{|k,v| "#{k}=#{CGI.escape(v.to_s)}"}.join("&")
+      @proc       = proc
+    end
+
+    def result=(result_object)
+      @result = @proc.nil? ? result_object : @proc.call(result_object)
+    end
+
+    def exception_raised=(ex)
+      @exception=ex
+    end
+
+    def exception_raised?
+      @exception.nil? ? false : raise(@exception)
+    end
+
+    def respond_to?(name)
+      super || @result.respond_to?(name)
+    end
+
+    def ===(other)
+      other === @result
+    end
+
+    def method_missing(name,*args,&proc)
+      if @exception
+        raise @exception
+      elsif @result.nil?
+        raise UnexecutedRequest.new("You must execute the batch before accessing the result: #{@uri}")
+      else
+        @result.send(name,*args,&proc)
+      end
+    end
+  end
+end

data/lib/facebooker/data.rb

@@ -0,0 +1,57 @@
+module Facebooker
+  class Data
+    def initialize(session)
+      @session = session
+    end
+
+    ##
+    # ** BETA ***
+    # Sets a cookie on Facebook
+    # +user+ The user for whom this cookie needs to be set.
+    # +name+ Name of the cookie
+    # +value+ Value of the cookie
+    # Optional:
+    # +expires+ Time when the cookie should expire. If not specified, the cookie never expires.
+    # +path+ Path relative to the application's callback URL, with which the cookie should be associated. (default value is /?
+    def set_cookie(user, name, value, expires=nil, path=nil)
+      @session.post('facebook.data.setCookie',
+        :uid => User.cast_to_facebook_id(user),
+        :name => name,
+        :value => value,
+        :expires => expires,
+        :path => path) {|response| response == '1'}
+    end
+
+    ##
+    # ** BETA ***
+    # Gets a cookie stored on Facebook
+    # +user+	The user from whom to get the cookies.
+    # Optional:
+    # +name+ The name of the cookie. If not specified, all the cookies for the given user get returned.
+    def get_cookies(user, name=nil)
+      @cookies = @session.post(
+        'facebook.data.getCookies', :uid => User.cast_to_facebook_id(user), :name => name) do |response|
+          response.map do |hash|
+            Cookie.from_hash(hash)
+          end
+      end
+    end
+
+    ##
+    # ** BETA ***
+    # Gets a preference stored on Facebook
+    # +pref_id+	The id of the preference to get
+    def get_preference(pref_id)
+      @session.post('facebook.data.getUserPreference', :pref_id=>pref_id)
+    end
+
+    ##
+    # ** BETA ***
+    # Sets a preference on Facebook
+    # +pref_id+	The id of the preference to set
+    # +value+ The value to set for this preference
+    def set_preference(pref_id, value)
+      @session.post('facebook.data.setUserPreference', :pref_id=>pref_id, :value=>value)
+    end
+  end
+end