djanowski-facebooker 1.0.1

data/lib/facebooker/rails/publisher.rb

@@ -0,0 +1,492 @@
+module Facebooker
+  module Rails
+    # ActionMailer like module for publishing Facbook messages
+    # 
+    # To use, create a subclass and define methods
+    # Each method should start by calling send_as to specify the type of message
+    # Valid options are  :email and :notification, :user_action, :profile, :ref
+    # 
+    #
+    # Below is an example of each type
+    #
+    #   class TestPublisher < Facebooker::Rails::Publisher
+    #     # The new message templates are supported as well
+    #     # First, create a method that contains your templates:
+    #     # You may include multiple one line story templates and short story templates
+    #     # but only one full story template
+    #     #  Your most specific template should be first
+    #     #
+    #     # Before using, you must register your template by calling register. For this example
+    #     #  You would call TestPublisher.register_publish_action
+    #     #  Registering the template will store the template id returned from Facebook in the 
+    #     # facebook_templates table that is created when you create your first publisher
+    #     def publish_action_template
+    #       one_line_story_template "{*actor*} did stuff with {*friend*}"
+    #       one_line_story_template "{*actor*} did stuff"
+    #       short_story_template "{*actor*} has a title {*friend*}", render(:partial=>"short_body")
+    #       short_story_template "{*actor*} has a title", render(:partial=>"short_body")
+    #       full_story_template "{*actor*} has a title {*friend*}", render(:partial=>"full_body")    
+    #       action_links action_link("My text {*template_var*}","{*link_url*}")
+    #     end
+    #
+    #     # To send a registered template, you need to create a method to set the data
+    #     # The publisher will look up the template id from the facebook_templates table
+    #     def publish_action(f)
+    #       send_as :user_action
+    #       from f
+    #       data :friend=>"Mike"
+    #     end
+    #   
+    #  
+    #     # Provide a from user to send a general notification
+    #     # if from is nil, this will send an announcement
+    #     def notification(to,f)
+    #       send_as :notification
+    #       recipients to
+    #       from f
+    #       fbml "Not"
+    #     end
+    #  
+    #     def email(to,f)
+    #       send_as :email
+    #       recipients to
+    #       from f
+    #       title "Email"
+    #       fbml 'text'
+    #       text fbml
+    #     end
+    #     # This will render the profile in /users/profile.erb
+    #     #   it will set @user to user_to_update in the template
+    #     #  The mobile profile will be rendered from the app/views/test_publisher/_mobile.erb
+    #     #   template
+    #     def profile_update(user_to_update,user_with_session_to_use)
+    #       send_as :profile
+    #       from user_with_session_to_use
+    #       to user_to_update
+    #       profile render(:action=>"/users/profile",:assigns=>{:user=>user_to_update})
+    #       profile_action "A string"
+    #       mobile_profile render(:partial=>"mobile",:assigns=>{:user=>user_to_update})
+    #   end
+    #
+    #     #  Update the given handle ref with the content from a
+    #     #   template
+    #     def ref_update(user)
+    #       send_as :ref
+    #       from user
+    #       fbml render(:action=>"/users/profile",:assigns=>{:user=>user_to_update})
+    #       handle "a_ref_handle"
+    #   end
+    #
+    #
+    # To send a message, use ActionMailer like semantics
+    #    TestPublisher.deliver_action(@user)
+    #
+    # For testing, you may want to create an instance of the underlying message without sending it
+    #  TestPublisher.create_action(@user)
+    # will create and return an instance of Facebooker::Feeds::Action
+    #
+    # Publisher makes many helpers available, including the linking and asset helpers
+    class Publisher
+      def initialize
+        @controller = PublisherController.new        
+      end
+      
+      # use facebook options everywhere
+      def request_comes_from_facebook?
+        true
+      end
+      
+      class FacebookTemplate < ::ActiveRecord::Base
+        
+        
+        cattr_accessor :template_cache
+        self.template_cache = {}
+        
+        def self.inspect(*args)
+          "FacebookTemplate"
+        end
+        
+        def template_changed?(hash)
+          if respond_to?(:content_hash)
+            content_hash != hash 
+          else
+            false
+          end
+        end
+        
+        class << self
+          
+          def register(klass,method)
+            publisher = setup_publisher(klass,method)            
+            template_id = Facebooker::Session.create.register_template_bundle(publisher.one_line_story_templates,publisher.short_story_templates,publisher.full_story_template,publisher.action_links)
+            template = find_or_initialize_by_template_name(template_name(klass,method))
+            template.bundle_id = template_id
+            template.content_hash = hashed_content(klass,method) if template.respond_to?(:content_hash)
+            template.save!
+            cache(klass,method,template)
+            template
+          end
+          
+          def for_class_and_method(klass,method)
+            find_cached(klass,method) 
+          end
+          def bundle_id_for_class_and_method(klass,method)
+            for_class_and_method(klass,method).bundle_id
+          end
+          
+          def cache(klass,method,template)
+            template_cache[template_name(klass,method)] = template
+          end
+          
+          def clear_cache!
+            self.template_cache = {}
+          end
+          
+          def find_cached(klass,method)
+            template_cache[template_name(klass,method)] || find_in_db(klass,method)
+          end
+          
+          def find_in_db(klass,method)
+            template = find_by_template_name(template_name(klass,method))
+            if template and template.template_changed?(hashed_content(klass,method))
+              template.destroy
+              template = nil
+            end
+            
+            if template.nil?
+              template = register(klass,method)
+            end
+            template
+          end
+          
+          def setup_publisher(klass,method)
+            publisher = klass.new
+            publisher.send method + '_template'
+            publisher
+          end
+          
+          def hashed_content(klass, method)
+            publisher = setup_publisher(klass,method)
+            Digest::MD5.hexdigest [publisher.one_line_story_templates, publisher.short_story_templates, publisher.full_story_template].to_json
+          end
+          
+          
+          def template_name(klass,method)
+            "#{klass.name}::#{method}"
+          end
+        end
+      end
+      
+      class_inheritable_accessor :master_helper_module
+      attr_accessor :one_line_story_templates, :short_story_templates, :action_links
+      
+      cattr_accessor :skip_registry
+      self.skip_registry = false
+      
+      
+      class InvalidSender < StandardError; end
+      class UnknownBodyType < StandardError; end
+      class UnspecifiedBodyType < StandardError; end
+      class Email
+        attr_accessor :title
+        attr_accessor :text
+        attr_accessor :fbml
+      end
+  
+      class Notification
+        attr_accessor :fbml
+      end
+  
+      class Profile
+        attr_accessor :profile
+        attr_accessor :profile_action
+        attr_accessor :mobile_profile
+        attr_accessor :profile_main
+      end
+      class Ref
+        attr_accessor :handle
+        attr_accessor :fbml
+      end
+      class UserAction
+        attr_accessor :data
+        attr_accessor :target_ids
+        attr_accessor :body_general
+        attr_accessor :template_id
+        attr_accessor :template_name
+        
+        def target_ids=(val)
+          @target_ids = val.is_a?(Array) ? val.join(",") : val
+        end
+        
+      end
+      
+      cattr_accessor :ignore_errors
+      attr_accessor :_body
+
+      def recipients(*args)
+        if args.size==0
+          @recipients
+        else
+          @recipients=args.first
+        end
+      end
+      
+      def from(*args)
+        if args.size==0
+          @from
+        else
+          @from=args.first
+        end        
+      end
+
+
+      def send_as(option)
+        self._body=case option
+        when :action
+          Facebooker::Feed::Action.new
+        when :story
+          Facebooker::Feed::Story.new
+        when :templatized_action
+          Facebooker::Feed::TemplatizedAction.new
+        when :notification
+          Notification.new
+        when :email
+          Email.new
+        when :profile
+          Profile.new
+        when :ref
+          Ref.new
+        when :user_action
+          UserAction.new
+        else
+          raise UnknownBodyType.new("Unknown type to publish")
+        end
+      end
+      
+      def full_story_template(title=nil,body=nil,params={})
+        if title.nil?
+          @full_story_template
+        else
+          @full_story_template=params.merge(:template_title=>title, :template_body=>body)
+        end
+      end
+      
+      def one_line_story_template(str)
+        @one_line_story_templates ||= []
+        @one_line_story_templates << str
+      end
+      
+      def short_story_template(title,body,params={})
+        @short_story_templates ||= []
+        @short_story_templates << params.merge(:template_title=>title, :template_body=>body)
+      end
+      
+      def action_links(*links)
+        if links.blank?
+          @action_links
+        else
+          @action_links = links
+        end
+      end
+      
+      def method_missing(name,*args)
+        if args.size==1 and self._body.respond_to?("#{name}=")
+          self._body.send("#{name}=",*args)
+        elsif self._body.respond_to?(name)
+          self._body.send(name,*args)
+        else
+          super
+        end
+      end
+      
+      def image(src,target)
+        {:src=>image_path(src),:href=> target.respond_to?(:to_str) ? target : url_for(target)}
+      end
+      
+      def action_link(text,target)
+        {:text=>text, :href=>target}
+      end
+  
+      def requires_from_user?(from,body)
+        ! (announcement_notification?(from,body) or ref_update?(body) or profile_update?(body))
+      end
+      
+      def profile_update?(body)
+        body.is_a?(Profile)
+      end
+      
+      def ref_update?(body)
+        body.is_a?(Ref)
+      end
+  
+      def announcement_notification?(from,body)
+        from.nil? and body.is_a?(Notification)
+      end
+      
+      def send_message(method)
+        @recipients = @recipients.is_a?(Array) ? @recipients : [@recipients]
+        if from.nil? and @recipients.size==1 and requires_from_user?(from,_body)
+          @from = @recipients.first
+        end
+        # notifications can 
+        # omit the from address
+        raise InvalidSender.new("Sender must be a Facebooker::User") unless from.is_a?(Facebooker::User) || !requires_from_user?(from,_body)
+        case _body
+        when Facebooker::Feed::TemplatizedAction,Facebooker::Feed::Action
+          from.publish_action(_body)
+        when Facebooker::Feed::Story
+          @recipients.each {|r| r.publish_story(_body)}
+        when Notification
+          (from.nil? ? Facebooker::Session.create : from.session).send_notification(@recipients,_body.fbml)
+        when Email
+          from.session.send_email(@recipients, 
+                                             _body.title, 
+                                             _body.text, 
+                                             _body.fbml)
+        when Profile
+         # If recipient and from aren't the same person, create a new user object using the
+         # userid from recipient and the session from from
+         @from = Facebooker::User.new(Facebooker::User.cast_to_facebook_id(@recipients.first),Facebooker::Session.create) 
+         @from.set_profile_fbml(_body.profile, _body.mobile_profile, _body.profile_action, _body.profile_main)
+        when Ref
+          Facebooker::Session.create.server_cache.set_ref_handle(_body.handle,_body.fbml)
+        when UserAction
+          @from.session.publish_user_action(_body.template_id,_body.data||{},_body.target_ids,_body.body_general)
+        else
+          raise UnspecifiedBodyType.new("You must specify a valid send_as")
+        end
+      end
+
+      # nodoc
+      # needed for actionview
+      def logger
+        RAILS_DEFAULT_LOGGER
+      end
+
+      # nodoc
+      # delegate to action view. Set up assigns and render
+      def render(opts)
+        opts = opts.dup
+        body = opts.delete(:assigns) || {}
+        initialize_template_class(body.dup.merge(:controller=>self)).render(opts)
+      end
+
+
+      def initialize_template_class(assigns)
+        template_root = "#{RAILS_ROOT}/app/views"
+	      controller_root = File.join(template_root,self.class.controller_path)
+        #only do this on Rails 2.1
+	      if ActionController::Base.respond_to?(:append_view_path)
+  	      # only add the view path once
+	        ActionController::Base.append_view_path(controller_root) unless ActionController::Base.view_paths.include?(controller_root)
+	      end
+        returning ActionView::Base.new([template_root,controller_root], assigns, self) do |template|
+          template.controller=self
+          template.extend(self.class.master_helper_module)
+        end
+      end
+  
+      
+      self.master_helper_module = Module.new
+      self.master_helper_module.module_eval do
+        # url_helper delegates to @controller, 
+        # so we need to define that in the template
+        # we make it point to the publisher
+        include ActionView::Helpers::UrlHelper
+        include ActionView::Helpers::TextHelper
+        include ActionView::Helpers::TagHelper
+        include ActionView::Helpers::FormHelper
+        include ActionView::Helpers::FormTagHelper
+        include ActionView::Helpers::AssetTagHelper
+        include Facebooker::Rails::Helpers
+        
+        #define this for the publisher views
+        def protect_against_forgery?
+          @paf ||= ActionController::Base.new.send(:protect_against_forgery?)
+        end
+      end
+      ActionController::Routing::Routes.named_routes.install(self.master_helper_module)
+      include self.master_helper_module
+      class <<self
+        
+        def register_all_templates
+          all_templates = instance_methods.grep(/_template$/) - %w(short_story_template full_story_template one_line_story_template) 
+          all_templates.each do |template|
+            template_name=template.sub(/_template$/,"")
+            puts "Registering #{template_name}"
+            send("register_"+template_name)
+          end
+        end
+        
+        def method_missing(name,*args)
+          should_send = false
+          method = ''
+          if md = /^create_(.*)$/.match(name.to_s)
+            method = md[1]
+          elsif md = /^deliver_(.*)$/.match(name.to_s)
+            method = md[1]
+            should_send = true            
+          elsif md = /^register_(.*)$/.match(name.to_s)
+            return FacebookTemplate.register(self, md[1])
+          else
+            super
+          end
+      
+          #now create the item
+          (publisher=new).send(method,*args)
+          case publisher._body
+          when UserAction
+            publisher._body.template_name = method
+            publisher._body.template_id = FacebookTemplate.bundle_id_for_class_and_method(self,method)
+          end
+          
+          should_send ? publisher.send_message(method) : publisher._body
+        end
+    
+        def default_url_options
+          {:host => Facebooker.canvas_server_base + Facebooker.facebook_path_prefix}
+        end
+    
+        def controller_path
+          self.to_s.underscore
+        end
+        
+        def helper(*args)
+          args.each do |arg|
+            case arg
+            when Symbol,String
+              add_template_helper("#{arg.to_s.classify}Helper".constantize)              
+            when Module
+              add_template_helper(arg)
+            end
+          end
+        end
+        
+        def add_template_helper(helper_module) #:nodoc:
+          master_helper_module.send :include,helper_module
+          include master_helper_module
+        end
+
+    
+        def inherited(child)
+          super          
+          child.master_helper_module=Module.new
+          child.master_helper_module.__send__(:include,self.master_helper_module)
+          child.send(:include, child.master_helper_module)
+          FacebookTemplate.clear_cache!
+        end
+    
+      end
+      class PublisherController
+        include Facebooker::Rails::Publisher.master_helper_module
+        include ActionController::UrlWriter
+        
+        def self.default_url_options(*args)
+          Facebooker::Rails::Publisher.default_url_options(*args)
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/facebooker/rails/routing.rb

@@ -0,0 +1,49 @@
+module Facebooker
+  module Rails
+    module Routing
+      module RouteSetExtensions
+        def self.included(base)
+          base.alias_method_chain :extract_request_environment, :facebooker
+        end
+
+        def extract_request_environment_with_facebooker(request)
+          env = extract_request_environment_without_facebooker(request)
+          env.merge :canvas => (request.parameters[:fb_sig_in_canvas]=="1")
+        end
+      end 
+      module MapperExtensions
+
+        # Generates pseudo-resource routes. Since everything is a POST, routes can't be identified
+        # using HTTP verbs. Therefore, the action is appended to the beginning of each named route,
+        # except for index.
+        #
+        # Example: 
+        #   map.facebook_resources :profiles
+        #
+        # Generates the following routes:
+        #
+        #     new_profile POST /profiles/new         {:controller=>"profiles", :action=>"new"}
+        #        profiles POST /profiles/index       {:controller=>"profiles", :action=>"index"}
+        #    show_profile POST /profiles/:id/show    {:controller=>"profiles", :action=>"show"}
+        #  create_profile POST /profiles/create      {:controller=>"profiles", :action=>"create"}
+        #    edit_profile POST /profiles/:id/edit    {:controller=>"profiles", :action=>"edit"}
+        #  update_profile POST /profiles/:id/update  {:controller=>"profiles", :action=>"update"}
+        # destroy_profile POST /profiles/:id/destroy {:controller=>"profiles", :action=>"destroy"}
+        #
+        def facebook_resources(name_sym)
+          name = name_sym.to_s
+
+          with_options :controller => name, :conditions => { :method => :post } do |map|
+            map.named_route("new_#{name.singularize}",     "#{name}/new",         :action => 'new')
+            map.named_route(name,                          "#{name}/index",       :action => 'index')
+            map.named_route("show_#{name.singularize}",    "#{name}/:id/show",    :action => 'show',    :id => /\d+/)
+            map.named_route("create_#{name.singularize}",  "#{name}/create",      :action => 'create')
+            map.named_route("edit_#{name.singularize}",    "#{name}/:id/edit",    :action => 'edit',    :id => /\d+/)
+            map.named_route("update_#{name.singularize}",  "#{name}/:id/update",  :action => 'update',  :id => /\d+/)
+            map.named_route("destroy_#{name.singularize}", "#{name}/:id/destroy", :action => 'destroy', :id => /\d+/)            
+          end
+        end
+      end
+    end
+  end      
+end

data/lib/facebooker/rails/test_helpers.rb

@@ -0,0 +1,88 @@
+module Facebooker
+  module Rails
+    module TestHelpers
+      def assert_facebook_redirect_to(url)
+        assert_response :success
+        assert_not_nil facebook_redirect_url
+        assert_equal url, facebook_redirect_url
+      end
+
+      def follow_facebook_redirect!
+        facebook_post facebook_redirect_url
+      end
+      
+      def facebook_get(path,params={})
+        facebook_verb(:get,path,params)
+      end
+      
+      def facebook_post(path,params={})
+        facebook_verb(:post,path,params)
+      end
+      
+      def facebook_put(path,params={})
+        facebook_verb(:put,path,params)
+      end
+      def facebook_delete(path,params={})
+        facebook_verb(:delete,path,params)
+      end
+      
+      def facebook_verb(verb,path, params={})
+        params = default_facebook_parameters.update(params)
+        params.merge!(:fb_sig => generate_signature(facebook_params(params).stringify_keys))
+
+        params = params.update(:canvas => true).update(params)
+        send verb, path, params
+      end
+      
+      def facebook_post(path, params={}, fb_params=facebook_parameters)
+        params = fb_params.merge(:canvas => true).merge(params)
+        post path, params    
+      end
+      
+      def facebook_parameters(overrides=nil)
+        overrides ||= {}
+        params = default_facebook_parameters.merge(overrides)
+        params.merge(:fb_sig => generate_signature(params.stringify_keys))
+      end
+
+      private
+
+      def default_facebook_parameters
+        {
+          :fb_sig_added => "1", 
+          :fb_sig_session_key => "facebook_session_key", 
+          :fb_sig_user => "1234", 
+          :fb_sig_expires => "0",
+          :fb_sig_in_canvas => "1",
+          :fb_sig_time => Time.now.to_f
+        }
+      end
+
+      def facebook_params(params)
+        params.inject({}) do |fb_params, pair| 
+          unless pair.first.to_s.match(/^fb_sig_/).nil?
+            fb_params[pair.first] = pair.last
+          end
+          fb_params
+        end
+      end
+
+      def facebook_redirect_url
+        match = @response.body.match(/<fb:redirect url="([^"]+)"/)
+        match.nil? ? nil : match.captures[0]
+      end
+
+      def generate_signature(facebook_params)
+        facebook_sig_params = facebook_params.inject({}) do |collection, pair|
+          collection[pair.first.sub(/^fb_sig_/, '')] = pair.last
+          collection
+        end
+
+        raw_string = facebook_sig_params.map{ |*args| args.join('=') }.sort.join
+        Digest::MD5.hexdigest([raw_string, Facebooker::Session.secret_key].join)
+      end
+      
+    end
+  end
+end
+        

data/lib/facebooker/rails/utilities.rb

@@ -0,0 +1,22 @@
+module Facebooker
+  module Rails
+    class Utilities
+      class << self
+        def refresh_all_images(session)
+          Dir.glob(File.join(RAILS_ROOT,"public","images","*.{png,jpg,gif}")).each do |img|
+            refresh_image(session,img)
+          end
+        end
+        
+        def refresh_image(session,full_path)
+          basename=File.basename(full_path)
+          base_path=ActionController::Base.asset_host
+          base_path += "/" unless base_path.ends_with?("/")
+          image_path=base_path+"images/#{basename}"
+          puts "refreshing: #{image_path}"
+          session.server_cache.refresh_img_src(image_path)
+        end
+      end
+    end
+  end
+end

data/lib/facebooker/server_cache.rb

@@ -0,0 +1,24 @@
+module Facebooker
+  class ServerCache
+    def initialize(session)
+      @session = session
+    end
+    
+    # 
+    # Stores an FBML reference on the server for use 
+    # across multiple users in FBML
+    def set_ref_handle(handle_name, fbml_source)
+      (@session.post 'facebook.fbml.setRefHandle', {:handle => handle_name, :fbml => fbml_source},false) == '1'
+    end
+    
+    ##
+    # Fetches and re-caches the content stored at the given URL, for use in a fb:ref FBML tag.
+    def refresh_ref_url(url)
+      (@session.post 'facebook.fbml.refreshRefUrl', {:url => url},false) == '1'
+    end
+    
+    def refresh_img_src(url)
+      (@session.post 'facebook.fbml.refreshImgSrc', {:url => url},false) == '1'
+    end
+  end
+end