fotonauts-facebooker 1.0.67

data/lib/facebooker/models/education_info.rb

@@ -0,0 +1,11 @@
+module Facebooker
+  class EducationInfo
+    class HighschoolInfo
+      include Model
+      attr_accessor :hs1_id, :hs2_id, :grad_year, :hs1_name, :hs2_name
+    end
+    
+    include Model
+    attr_accessor :concentrations, :name, :year, :degree, :school_type
+  end
+end

data/lib/facebooker/models/event.rb

@@ -0,0 +1,28 @@
+require 'facebooker/model'
+module Facebooker
+  class Event
+    
+    ##
+    # The relationship between a Facebook user and an Event to which he or she has been
+    # invited and may or may not be attending (based on #rsvp_status)
+    class Attendance
+      include Model
+      attr_accessor :eid, :uid, :rsvp_status
+      
+      ##
+      # Get the full, populated Event object which this Attendance is associated with.
+      # First access will query the Facebook API (facebook.events.get).  Subsequent
+      # calls are retrieved from in-memory cache.
+      def event
+        @event ||= Event.from_hash(session.post('facebook.events.get', :eids => [eid]).first)
+      end
+      
+      #TODO: implement user() method
+    end
+    
+    include Model
+    attr_accessor :pic, :pic_small, :pic_big, :name, :creator, :update_time, :description, :tagline, :venue, :host, :event_type, :nid, :location, :end_time, :start_time, :event_subtype
+
+    id_is :eid
+  end
+end

data/lib/facebooker/models/family_relative_info.rb

@@ -0,0 +1,7 @@
+require 'facebooker/model'
+module Facebooker
+  class FamilyRelativeInfo
+    include Model
+    attr_accessor :relationship, :uid, :name, :birthday
+  end
+end

data/lib/facebooker/models/friend_list.rb

@@ -0,0 +1,16 @@
+require 'facebooker/model'
+module Facebooker
+  ##
+  # A simple representation of a friend list.
+  class FriendList
+    include Model
+    attr_accessor :name
+
+    id_is :flid
+
+    # We need this to be an integer, so do the conversion
+    def flid=(f)
+      @flid= ( f.nil? ? nil : f.to_i)
+    end
+  end
+end

data/lib/facebooker/models/group.rb

@@ -0,0 +1,36 @@
+require 'facebooker/model'
+module Facebooker
+  class Group
+    ##
+    # The model of a user's relationship to a group.  Users can occupy different positions within a group (e.g. 'owner')
+    class Membership
+      include Model
+      attr_accessor :position, :gid, :uid
+    end
+    include Model
+    attr_accessor :pic, :pic_small, :pic_big, :name, :creator, :recent_news, :update_time, :group_subtype, :group_type, :website, :office, :description, :venue, :nid, :privacy
+
+    id_is :gid
+
+    ##
+    # Get the full list of members as populated User objects.  First time fetches group members via Facebook API call.  
+    # Subsequent calls return cached values.
+    # This is a convenience method for getting all of the Membership instances and instantiating User instances for each Membership.
+    def members
+      @members ||= memberships.map do |membership|
+        User.new(membership.uid, session)
+      end
+    end
+    
+    ##
+    # Get a list of Membership instances associated with this Group.  First call retrieves the Membership instances via a Facebook
+    # API call.  Subsequent calls are retrieved from in-memory cache.
+    def memberships
+      @memberships ||= session.post('facebook.groups.getMembers', :gid => gid).map do |hash|
+        Membership.from_hash(hash) do |membership|
+          membership.gid = gid
+        end
+      end
+    end
+  end
+end

data/lib/facebooker/models/info_item.rb

@@ -0,0 +1,10 @@
+module Facebooker
+  class InfoItem
+    include Model
+    attr_accessor :label, :image, :description, :link, :sublabel
+    
+    def to_json
+      {:label => label, :image => image, :description => description, :link => link, :sublabel => sublabel}.to_json
+    end
+  end
+end

data/lib/facebooker/models/info_section.rb

@@ -0,0 +1,10 @@
+module Facebooker
+  class InfoSection
+    include Model
+    attr_accessor :field, :items
+    
+    def to_json
+      {:field => field, :items => items}.to_json
+    end
+  end
+end

data/lib/facebooker/models/location.rb

@@ -0,0 +1,8 @@
+module Facebooker
+  ##
+  # Representation of Location used in all places where a Location is specified.
+  class Location
+    include Model
+    attr_accessor :city, :zip, :country, :state
+  end
+end

data/lib/facebooker/models/message_thread.rb

@@ -0,0 +1,89 @@
+require 'facebooker/model'
+module Facebooker
+  class MessageThread
+    include Model
+    
+    id_is :thread_id
+    attr_accessor :subject, :updated_time, :recipients
+    attr_accessor :parent_message_id, :parent_thread_id, :message_count
+    attr_accessor :snippet, :snippet_author, :object_id, :unread
+    
+    class Message
+      include Model
+      
+      attr_accessor :message_id, :author_id, :body, :created_time, :attachment, :thread_id
+      
+      # An attachment can be a photo, a video, or a link
+      class Attachment
+        include Model
+        
+        attr_accessor :name, :href, :icon, :caption, :description
+        
+        # The Facebook messages API is in beta, this helper method is supposed to fail anytime soon
+        def video?
+          self.href =~ /\Ahttp:\/\/www\.facebook\.com\/video\/video\.php.*/
+        end
+        
+        # The Facebook messages API is in beta, this helper method is supposed to fail anytime soon
+        def photo?
+          self.href =~ /\Ahttp:\/\/www\.facebook\.com\/photo\.php.*/
+        end
+        
+        # The Facebook messages API is in beta, this helper method is supposed to fail anytime soon
+        def link?
+          !video? && !photo?
+        end
+      end
+      hash_settable_accessor :attachment, Facebooker::MessageThread::Message::Attachment
+    end
+    hash_settable_list_accessor :messages, Facebooker::MessageThread::Message
+    
+  end
+end
+
+# Example of attachments
+
+# -- Photo --
+
+# <attachment>
+#   <media list="true"/>
+#   <href>http://www.facebook.com/photo.php?pid=12345&amp;id=54321</href>
+#   <properties list="true"/>
+#   <icon>http://b.static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+#   <fb_object_type/>
+#   <fb_object_id/>
+#   <tagged_ids list="true"/>
+# </attachment>
+
+# -- Webcam video --
+
+# <attachment>
+#   <media list="true"/>
+#   <name>Feb 10, 2010 1:26pm</name>
+#   <href>http://www.facebook.com/video/video.php?v=12345</href>
+#   <properties list="true"/>
+#   <icon>http://static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+#   <fb_object_type/>
+#   <fb_object_id/>
+#   <tagged_ids list="true"/>
+# </attachment>
+
+# -- Link --
+
+# <attachment>
+#   <media list="true">
+#     <stream_media>
+#       <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.google.fr%252F&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+#       <type>link</type>
+#       <src>http://external.ak.fbcdn.net/safe_image.php?d=dd54bba6b6e6479a89bb8084573c02c8&amp;w=90&amp;h=90&amp;url=http%3A%2F%2Fwww.google.fr%2Fintl%2Ffr_fr%2Fimages%2Flogo.gif</src>
+#     </stream_media>
+#   </media>
+#   <name>Google</name>
+#   <href>http://www.facebook.com/l.php?u=http%253A%252F%252Fwww.google.fr%252F&amp;h=e46dd63cdbfadb74958fbe44e98f339c</href>
+#   <caption>www.google.fr</caption>
+#   <properties list="true"/>
+#   <icon>http://b.static.ak.fbcdn.net/rsrc.php/zB010/hash/9yvl71tw.gif</icon>
+#   <fb_object_type/>
+#   <fb_object_id/>
+#   <tagged_ids list="true"/>
+# </attachment>

data/lib/facebooker/models/notifications.rb

@@ -0,0 +1,17 @@
+module Facebooker
+  class Notifications
+    include Model
+    attr_accessor :messages, :group_invites, :pokes, :friend_requests, :event_invites, :shares
+    
+    [:Messages, :Pokes, :Shares].each do |notification_type|
+      const_set(notification_type, Class.new do
+        include Model
+        attr_accessor :unread, :most_recent
+      end)
+      attribute_name = "#{notification_type.to_s.downcase}"
+      define_method("#{attribute_name}=") do |value|
+        instance_variable_set("@#{attribute_name}", value.kind_of?(Hash) ? Notifications.const_get(notification_type).from_hash(value) : value)
+      end
+    end
+  end
+end

data/lib/facebooker/models/page.rb

@@ -0,0 +1,46 @@
+require 'facebooker/model'
+module Facebooker
+  class Page
+    
+    def initialize(*args)
+      if args.size == 1 and (args.first.is_a?(Integer) or args.first.is_a?(String))
+        self.page_id=args.first
+      else
+        super
+      end
+    end
+
+    class Genre
+      include Model
+      FIELDS = [ :dance, :party, :relax, :talk, :think, :workout, :sing, :intimate, :raunchy, :headphones ]
+      attr_accessor(*FIELDS)
+
+      def initialize(*args)
+        super
+
+        # convert '1'/'0' to true/false
+        FIELDS.each do |field|
+          self.send("#{field}=", self.send(field) == '1')
+        end
+      end
+    end
+
+    include Model
+    attr_accessor :page_id,:name,:pic_small,:pic_big,:pic_square,:pic,:pic_large,:type,:website,:has_added_app,:founded,:company_overview,:mission,:products,:location,:parking,:public_transit,:hours,:attire,:payment_options,:culinary_team,:general_manager,:price_range,:restaurant_services,:restaurant_specialties,:release_date,:genre,:starring,:screenplay_by,:directed_by,:produced_by,:studio,:awards,:plot_outline,:network,:season,:schedule,:written_by,:band_members,:hometown,:current_location,:record_label,:booking_agent,:artists_we_like,:influences,:band_interests,:bio,:affiliation,:birthday,:personal_info,:personal_interests,:members,:built,:features,:mpg,:general_info,:fan_count,:page_url
+    attr_reader :genre
+    
+    alias_method :id, :page_id
+    
+    def genre=(value)
+      @genre = value.kind_of?(Hash) ? Genre.from_hash(value) : value
+    end
+    
+    def user_is_admin?(user)
+      Session.current.post('facebook.pages.isAdmin', :page_id=>self.page_id, :uid=>Facebooker::User.cast_to_facebook_id(user))
+    end
+    
+    def user_is_fan?(user)
+      Session.current.post('facebook.pages.isFan', :page_id=>self.page_id, :uid=>Facebooker::User.cast_to_facebook_id(user))
+    end
+  end
+end

data/lib/facebooker/models/photo.rb

@@ -0,0 +1,19 @@
+require 'facebooker/model'
+module Facebooker
+  class Photo
+    include Model
+    attr_accessor :aid, :owner, :title,
+                  :link, :caption, :created,
+                  :src, :src_big, :src_small,
+                  :story_fbid
+
+    id_is :pid
+    
+    #override the generated method for id_is to use a string
+    def pid=(val)
+      @pid = val
+    end
+    
+    alias :id= :pid=
+  end
+end

data/lib/facebooker/models/tag.rb

@@ -0,0 +1,12 @@
+require 'facebooker/model'
+module Facebooker
+  class Tag
+    include Model
+    attr_accessor :pid, :subject, :xcoord, :ycoord, :text, :created
+    
+    def coordinates
+      [xcoord, ycoord]
+    end
+    
+  end
+end

data/lib/facebooker/models/user.rb

@@ -0,0 +1,751 @@
+require 'facebooker/model'
+require 'facebooker/models/affiliation'
+require 'facebooker/models/work_info'
+require 'facebooker/models/family_relative_info'
+module Facebooker
+  #
+  # Holds attributes and behavior for a Facebook User
+  class User
+    include Model
+    class Status
+      include Model
+      attr_accessor :uid, :message, :time, :status_id, :source
+    end
+    FIELDS = [:status, :political, :pic_small, :name, :quotes, :is_app_user, :tv, :profile_update_time, :meeting_sex, :hs_info, :timezone, :relationship_status, :hometown_location, :about_me, :wall_count, :significant_other_id, :pic_big, :music, :work_history, :sex, :religion, :notes_count, :activities, :pic_square, :movies, :has_added_app, :education_history, :birthday, :birthday_date, :first_name, :meeting_for, :last_name, :interests, :current_location, :pic, :books, :affiliations, :locale, :profile_url, :proxied_email, :email_hashes, :allowed_restrictions, :pic_with_logo, :pic_big_with_logo, :pic_small_with_logo, :pic_square_with_logo, :online_presence, :verified, :profile_blurb, :username, :website, :is_blocked, :family, :email]
+    STANDARD_FIELDS = [:uid, :first_name, :last_name, :name, :timezone, :birthday, :sex, :affiliations, :locale, :profile_url, :proxied_email, :email]
+    populating_attr_accessor(*FIELDS)
+    attr_reader :affiliations
+    populating_hash_settable_accessor :current_location, Location
+    populating_hash_settable_accessor :hometown_location, Location
+    populating_hash_settable_accessor :hs_info, EducationInfo::HighschoolInfo
+    populating_hash_settable_list_accessor :affiliations, Affiliation
+    populating_hash_settable_list_accessor :education_history, EducationInfo
+    populating_hash_settable_list_accessor :work_history, WorkInfo
+    populating_hash_settable_list_accessor :family, FamilyRelativeInfo
+
+    populating_attr_reader :status
+
+    attr_accessor :request_locale
+
+    # Can pass in these two forms:
+    # id, session, (optional) attribute_hash
+    # attribute_hash
+    def initialize(*args)
+      @friends            = nil
+      @current_location   = nil
+      @pic                = nil
+      @hometown_location  = nil
+      @populated          = false
+      @session            = nil
+      @id                 = nil
+      if (args.first.kind_of?(String) || args.first.kind_of?(Integer)) && args.size==1
+        self.uid = args.shift
+        @session = Session.current
+      elsif (args.first.kind_of?(String) || args.first.kind_of?(Integer)) && args[1].kind_of?(Session)
+        self.uid = args.shift
+        @session = args.shift
+      end
+      if args.last.kind_of?(Hash)
+        populate_from_hash!(args.pop)
+      end
+    end
+
+    id_is :uid
+    alias :facebook_id :id
+
+    # Returns a user's events, params correspond to API call parameters (except UID):
+    # http://wiki.developers.facebook.com/index.php/Events.get
+    # E.g:
+    #  @user.events(:start_time => Time.now, :end_time => 1.month.from_now)
+    #  # => Returns events betwen now and a month from now
+    def events(params={})
+      @events ||= {}
+      [:start_time,:end_time].compact.each do |key|
+        params[key] = params[key].to_i
+      end
+#      puts @events[params.to_s].nil?
+      @events[params.to_s] ||= @session.post('facebook.events.get', {:uid => self.id}.merge(params)).map do |event|
+        Event.from_hash(event)
+      end
+    end
+
+    # Rsvp to an event with the eid and rsvp_status which can be 'attending', 'unsure', or 'declined'.
+    # http://wiki.developers.facebook.com/index.php/Events.rsvp
+    # E.g:
+    #  @user.rsvp_event('100321123', 'attending')
+    #  # => Returns true if all went well
+    def rsvp_event(eid, rsvp_status, options = {})
+      result = @session.post('facebook.events.rsvp', options.merge(:eid => eid, :rsvp_status => rsvp_status))
+      result == '1' ? true : false
+    end
+
+    #
+    # Set the list of friends, given an array of User objects.  If the list has been retrieved previously, will not set
+    def friends=(list_of_friends,flid=nil)
+      @friends_hash ||= {}
+       flid=cast_to_friend_list_id(flid)
+       #use __blank instead of nil so that this is cached
+       cache_key = flid||"__blank"
+
+      @friends_hash[cache_key] ||= list_of_friends
+    end
+
+    def cast_to_friend_list_id(flid)
+      case flid
+       when String
+         list=friend_lists.detect {|f| f.name==flid}
+         raise Facebooker::Session::InvalidFriendList unless list
+         list.flid
+       when FriendList
+         flid.flid
+       else
+         flid
+       end
+     end
+    ##
+    # Retrieve friends
+    def friends(flid = nil)
+       @friends_hash ||= {}
+       flid=cast_to_friend_list_id(flid)
+
+       #use __blank instead of nil so that this is cached
+       cache_key = flid||"__blank"
+       options = {:uid=>self.id}
+       options[:flid] = flid unless flid.nil?
+       @friends_hash[cache_key] ||= @session.post('facebook.friends.get', options,false).map do |uid|
+          User.new(uid, @session)
+      end
+      @friends_hash[cache_key]
+    end
+
+    def friend_ids
+      options = {:uid => self.id}
+      @session.post('facebook.friends.get', options, false)
+    end
+
+    ###
+    # Publish a post into the stream on the user's Wall and News Feed.  This
+    # post also appears in the user's friend's streams.  The +publish_stream+
+    # extended permission must be granted in order to use this method.
+    #
+    # See: http://wiki.developers.facebook.com/index.php/Stream.publish
+    #
+    # +target+ can be the current user or some other user.
+    #
+    # To publish to a Page on the Page's behave, specify the page id as
+    # :uid and set :post_as_page to 'true', use the current user as target
+    #
+    # Example:
+    #   # Publish a message to my own wall:
+    #   me.publish_to(me, :message => 'hello world')
+    #
+    #   # Publish to a friend's wall with an action link:
+    #   me.publish_to(my_friend,  :message => 'how are you?', :action_links => [
+    #     :text => 'my website',
+    #     :href => 'http://tenderlovemaking.com/'
+    #   ])
+    def publish_to(target, options = {})
+      @session.post('facebook.stream.publish', prepare_publish_to_options(target, options), false)
+    end
+
+    # Prepares options for the stream.publish
+    def prepare_publish_to_options(target, options)
+      opts = {:uid          => self.id,
+              :target_id    => target.id,
+              :message      => options[:message]}
+
+      if a = options[:attachment]
+        opts[:attachment] = convert_attachment_to_json(a)
+      end
+      if (links = options[:action_links] && Facebooker.json_encode(options[:action_links]))
+        opts[:action_links] = links
+      end
+      unless options[:uid].nil?
+        opts[:uid] = options[:uid]
+      end
+      if options[:post_as_page]
+        opts.delete(:target_id)
+      end
+      opts
+    end
+    
+    def convert_attachment_to_json(attachment)
+      a = attachment.respond_to?(:to_hash) ? attachment.to_hash : attachment
+      Facebooker.json_encode(a)
+    end
+
+    ###
+    # Publish a comment on a post
+    #
+    # See: http://wiki.developers.facebook.com/index.php/Stream.addComment
+    #
+    # +post_id+ the post_id for the post that is being commented on
+    # +comment+ the text of the comment
+    def comment_on(post_id, comment)
+      @session.post('facebook.stream.addComment', {:post_id=>post_id, :comment=>comment})
+    end
+
+
+    ###
+    # Publish a comment to a specific comment set by xid
+    #
+    # See: http://wiki.developers.facebook.com/index.php/Comments.add
+    #
+    # +xid+ the xid for the set of comments
+    # +text+ the text of the comment
+    def add_comment(xid, text,title=nil,url=nil,publish_to_stream=false)
+      @session.post('facebook.comments.add',{:xid=>xid,:text=>text,:title=>title,:url=>url,:publish_to_stream=>publish_to_stream})
+    end
+
+    ###
+    # Add a like on a post
+    #
+    # See: http://wiki.developers.facebook.com/index.php/Stream.addLike
+    #
+    # +post_id+ the post_id for the post that is being commented on
+    def add_like_on(post_id)
+      @session.post('facebook.stream.addLike', {:post_id=>post_id})
+    end
+
+     def friend_lists
+       @friend_lists ||= @session.post('facebook.friends.getLists').map do |hash|
+         friend_list = FriendList.from_hash(hash)
+         friend_list.session = session
+         friend_list
+       end
+     end
+    ###
+    # Retrieve friends with user info populated
+    # Subsequent calls will be retrieved from memory.
+    # Optional: list of fields to retrieve as symbols
+    def friends!(*fields)
+      @friends ||= session.post('facebook.users.getInfo', :fields => collect(fields), :uids => friends.map{|f| f.id}.join(',')).map do |hash|
+        User.new(hash['uid'], session, hash)
+      end
+    end
+
+    ###
+    # Retrieve profile data for logged in user
+    # Optional: list of fields to retrieve as symbols
+    def populate(*fields)
+      arguments = {:fields => collect(fields), :uids => id}
+      arguments[:locale]=request_locale unless request_locale.nil?
+      session.post('facebook.users.getInfo', arguments) do |response|
+        populate_from_hash!(response.first)
+      end
+    end
+
+    def friends_with?(user_or_id)
+      friends.map{|f| f.to_i}.include?(user_or_id.to_i)
+    end
+
+    def friends_with_this_app
+      @friends_with_this_app ||= friend_ids_with_this_app.map do |uid|
+        User.new(uid, session)
+      end
+    end
+
+    def friend_ids_with_this_app
+      @friend_ids_with_this_app ||= session.post('facebook.friends.getAppUsers')
+    end
+
+    def groups(gids = [])
+      args = gids.empty? ? {} : {:gids => gids}
+      @groups ||= session.post('facebook.groups.get', args).map do |hash|
+        group = Group.from_hash(hash)
+        group.session = session
+        group
+      end
+    end
+
+    ###
+    # Get threads in a folder
+    #
+    # See: http://wiki.developers.facebook.com/index.php/Message.getThreadsInFolder
+    #
+    # +options+ possible options are :folder_id, :limit and :offset
+    def threads(options = {})
+      options ||= {}
+      @threads = session.post('facebook.message.getThreadsInFolder', options) do |response|
+        response.map do |hash|
+          MessageThread.from_hash(hash)
+        end
+      end
+    end
+
+    def notifications
+      @notifications ||= Notifications.from_hash(session.post('facebook.notifications.get'))
+    end
+
+    def publish_story(story)
+      publish(story)
+    end
+
+    def publish_action(action)
+      publish(action)
+    end
+
+    def publish_templatized_action(action)
+      publish(action)
+    end
+
+    def albums
+      @albums ||= session.post('facebook.photos.getAlbums', :uid => self.id) do |response|
+        response.map do |hash|
+          Album.from_hash(hash)
+        end
+      end
+    end
+
+    ###
+    # Retrieve user's facebook stream
+    # See http://wiki.developers.facebook.com/index.php/Stream.get for options
+    #
+
+    def stream(options = {})
+      @stream = session.post('facebook.stream.get', prepare_get_stream_options(options)) do |response|
+        response
+      end
+    end
+
+    def create_album(params)
+      @album = session.post('facebook.photos.createAlbum', params) {|response| Album.from_hash(response)}
+    end
+
+    def profile_photos
+      session.get_photos(nil, nil, profile_pic_album_id)
+    end
+
+    # Upload a photo to the user's profile.
+    #
+    # In your view, create a multipart form that posts directly to your application (not through canvas):
+    #
+    #   <% form_tag photos_url(:canvas => false), :html => {:multipart => true, :promptpermission => 'photo_upload'} do %>
+    #     Photo: <%= file_field_tag 'photo' %>
+    #     Caption: <%= text_area_tag 'caption' %>
+    #     <%= submit_tag 'Upload Photo', :class => 'inputsubmit' %>
+    #   <% end %>
+    #
+    # And in your controller:
+    #
+    #   class PhotosController < ApplicationController
+    #     def create
+    #       file = Net::HTTP::MultipartPostFile.new(
+    #         params[:photo].original_filename,
+    #         params[:photo].content_type,
+    #         params[:photo].read
+    #       )
+    #
+    #       @photo = facebook_session.user.upload_photo(file, :caption => params[:caption])
+    #       redirect_to photos_url(:canvas => true)
+    #     end
+    #   end
+    #
+    # Options correspond to http://wiki.developers.facebook.com/index.php/Photos.upload
+    def upload_photo(multipart_post_file, options = {})
+      Photo.from_hash(session.post_file('facebook.photos.upload',
+        options.merge(nil => multipart_post_file)))
+    end
+
+    # Upload a video to the user's profile.
+    #
+    # In your view, create a multipart form that posts directly to your application (not through canvas):
+    #
+    #   <% form_tag videos_url(:canvas => false), :html => {:multipart => true, :promptpermission => 'video_upload'} do %>
+    #     Video: <%= file_field_tag 'video' %>
+    #     Title: <%= text_area_tag 'title' %>
+    #     Description: <%= text_area_tag 'description' %>
+    #     <%= submit_tag 'Upload Video', :class => 'inputsubmit' %>
+    #   <% end %>
+    #
+    # And in your controller:
+    #
+    #   class VideosController < ApplicationController
+    #     def create
+    #       file = Net::HTTP::MultipartPostFile.new(
+    #         params[:photo].original_filename,
+    #         params[:photo].content_type,
+    #         params[:photo].read
+    #       )
+    #
+    #       @video = facebook_session.user.upload_video(file, :description => params[:description])
+    #       redirect_to videos_url(:canvas => true)
+    #     end
+    #   end
+    #
+    # Options correspond to http://wiki.developers.facebook.com/index.php/Video.upload
+    def upload_video(multipart_post_file, options = {})
+      Video.from_hash(session.post_file('facebook.video.upload',
+        options.merge(nil => multipart_post_file, :base => Facebooker.video_server_base)))
+    end
+
+    def profile_fbml
+      session.post('facebook.profile.getFBML', :uid => id)
+    end
+
+    ##
+    # Set the profile FBML for this user
+    #
+    # This does not set profile actions, that should be done with profile_action=
+    def profile_fbml=(markup)
+      set_profile_fbml(markup, nil, nil, nil)
+    end
+
+    ##
+    # Set the mobile profile FBML
+    def mobile_fbml=(markup)
+      set_profile_fbml(nil, markup, nil,nil)
+    end
+
+    def profile_action=(markup)
+      set_profile_fbml(nil, nil, markup,nil)
+    end
+
+    def profile_main=(markup)
+     set_profile_fbml(nil,nil,nil,markup)
+    end
+
+    def set_profile_fbml(profile_fbml, mobile_fbml, profile_action_fbml, profile_main = nil)
+      parameters = {:uid => id}
+      parameters[:profile] = profile_fbml if profile_fbml
+      parameters[:profile_action] = profile_action_fbml if profile_action_fbml
+      parameters[:mobile_profile] = mobile_fbml if mobile_fbml
+      parameters[:profile_main] = profile_main if profile_main
+      session.post('facebook.profile.setFBML', parameters,false)
+    end
+
+    ## ** NEW PROFILE DESIGN ***
+    # Set a info section for this user
+    #
+    # Note: using set_profile_info as I feel using user.set_info could be confused with the user.getInfo facebook method.
+    #       Also, I feel it fits in line with user.set_profile_fbml.
+    def set_profile_info(title, info_fields, format = :text)
+      session.post('facebook.profile.setInfo', :title => title, :uid => id,
+        :type => format.to_s == "text" ? 1 : 5, :info_fields => info_fields.to_json)
+    end
+
+    def get_profile_info
+      session.post('facebook.profile.getInfo', :uid => id)
+    end
+
+    ##
+    # This DOES NOT set the status of a user on Facebook
+    # Use the set_status method instead
+    def status=(message)
+      case message
+      when String,Status
+        @status = message
+      when Hash
+        @status = Status.from_hash(message)
+      end
+    end
+
+
+    ##
+    # Return +limit+ statuses from the user
+    def statuses( limit = 50 )
+      session.post('facebook.status.get', {:uid => uid, :limit => limit}).collect { |ret| Status.from_hash(ret) }
+    end
+
+    ##
+    # Set the status for a user
+    # DOES NOT prepend "is" to the message
+    #
+    # requires extended permission.
+    def set_status(message)
+      self.status=message
+      session.post('facebook.users.setStatus',{:status=>message,:status_includes_verb=>1,:uid => uid}, false) do |ret|
+        ret
+      end
+    end
+
+    ##
+    # Checks to see if the user has enabled the given extended permission
+    def has_permission?(ext_perm) # ext_perm = email, offline_access, status_update, photo_upload, create_listing, create_event, rsvp_event, sms
+      session.post('facebook.users.hasAppPermission', {:ext_perm=>ext_perm, :uid => uid}, false) == "1"
+    end
+
+    ##
+    # Returns whether the user (either the session user or user specified by uid) has authorized the calling application
+    def app_user?
+      session.post('facebook.users.isAppUser', {:uid => self.id}, use_session_key = true)
+    end
+
+    ##
+    # Convenience method to check multiple permissions at once
+    def has_permissions?(ext_perms)
+      ext_perms.all?{|p| has_permission?(p)}
+    end
+
+    ##
+    ## Revoke any extended permission given by a user
+    def revoke_permission(ext_perm)
+      session.post('facebook.auth.revokeExtendedPermission', { :perm => ext_perm, :uid => uid }, false)
+    end
+
+    ##
+    # Convenience method to send email to the current user
+    def send_email(subject, text=nil, fbml=nil)
+      session.send_email([id], subject, text, fbml)
+    end
+
+    ##
+    # Convenience method to set cookie for the current user
+    def set_cookie(name, value, expires=nil, path=nil)
+      session.data.set_cookie(id, name, value, expires, path)
+    end
+
+    ##
+    # Convenience method to get cookies for the current user
+    def get_cookies(name=nil)
+      session.data.get_cookies(id, name)
+    end
+
+    ##
+    # Returns the user's id as an integer
+    def to_i
+      id
+    end
+
+    def to_s
+      id.to_s
+    end
+    
+    
+    ### NEW DASHBOARD API STUFF
+    
+    # facebook_session.user.dashboard_count
+    def dashboard_count
+      session.post('facebook.dashboard.getCount', :uid => uid)
+    end
+    
+    # facebook_session.user.dashboard_count = 5
+    def dashboard_count=(new_count)
+      session.post('facebook.dashboard.setCount', :uid => uid, :count => new_count)
+    end
+    
+    # facebook_session.user.dashboard_increment_count
+    def dashboard_increment_count
+      session.post('facebook.dashboard.incrementCount', :uid => uid)
+    end
+    
+    # facebook_session.user.dashboard_decrement_count
+    def dashboard_decrement_count
+      session.post('facebook.dashboard.decrementCount', :uid => uid)
+    end
+    
+    # The following methods are not bound to a specific user but do relate to Users in general,
+    #   so I've made them into class methods.
+    
+    # Facebooker::User.dashboard_multi_get_count ['1234', '5678']
+    def self.dashboard_multi_get_count(*uids)
+     Facebooker::Session.create.post("facebook.dashboard.multiGetCount", :uids => uids.flatten)
+    end
+    
+    # Facebooker::User.dashboard_multi_set_count({ '1234' => '11', '5678' => '22' })
+    def self.dashboard_multi_set_count(ids)
+      Facebooker::Session.create.post("facebook.dashboard.multiSetCount", :ids => ids.to_json)
+    end
+    
+    # Facebooker::User.dashboard_multi_increment_count ['1234', '5678']
+    def self.dashboard_multi_increment_count(*uids)
+      Facebooker::Session.create.post("facebook.dashboard.multiIncrementCount", :uids => uids.flatten.collect{ |uid| uid.to_s }.to_json)
+    end
+    
+    # Facebooker::User.dashboard_multi_decrement_count ['1234', '5678']
+    def self.dashboard_multi_decrement_count(*uids)
+      Facebooker::Session.create.post("facebook.dashboard.multiDecrementCount", :uids => uids.flatten.collect{ |uid| uid.to_s }.to_json)
+    end
+    
+    
+    
+    
+    def get_news(*news_ids)
+      params = { :uid => uid }
+      params[:news_ids] = news_ids.flatten if news_ids
+      
+      session.post('facebook.dashboard.getNews', params)
+    end
+    
+    # facebook_session.user.add_news [{ :message => 'Hey, who are you?', :action_link => { :text => "I-I'm a test user", :href => 'http://facebook.er/' }}], 'http://facebook.er/icon.png'
+    def add_news(news, image=nil)
+      params = { :uid => uid }
+      params[:news] = news
+      params[:image] = image if image
+      
+      session.post('facebook.dashboard.addNews', params)
+    end
+    
+    # facebook_session.user.clear_news ['111111']
+    def clear_news(*news_ids)
+      params = { :uid => uid }
+      params[:news_ids] = news_ids.flatten if news_ids
+      
+      session.post('facebook.dashboard.clearNews', params)
+    end
+    
+    # Facebooker::User.multi_add_news(['1234', '4321'], [{ :message => 'Hi users', :action_link => { :text => "Uh hey there app", :href => 'http://facebook.er/' }}], 'http://facebook.er/icon.png')
+    def self.multi_add_news(uids, news, image=nil)
+      params = { :uids => uids, :news => news }
+      params[:image] = image if image
+
+      Facebooker::Session.create.post("facebook.dashboard.multiAddNews", params)
+    end
+    
+    # Facebooker::User.multi_clear_news({"1234"=>["319103117527"], "4321"=>["313954287803"]})
+    def self.multi_clear_news(ids)
+      Facebooker::Session.create.post("facebook.dashboard.multiClearNews", :ids => ids.to_json)
+    end
+    
+    # Facebooker::User.multi_get_news({"1234"=>["319103117527"], "4321"=>["313954287803"]})
+    def self.multi_get_news(ids)
+      Facebooker::Session.create.post('facebook.dashboard.multiGetNews', :ids => ids.to_json)
+    end
+    
+    # facebook_session.user.get_activity '123'
+    def get_activity(*activity_ids)
+      params = {}
+      params[:activity_ids] = activity_ids.flatten if activity_ids
+      
+      session.post('facebook.dashboard.getActivity', params)
+    end
+    
+    # facebook_session.user.publish_activity({ :message => '{*actor*} rolled around', :action_link => { :text => 'Roll around too', :href => 'http://facebook.er/' }})
+    def publish_activity(activity)
+      session.post('facebook.dashboard.publishActivity', { :activity => activity.to_json })
+    end
+    
+    # facebook_session.user.remove_activity ['123']
+    def remove_activity(*activity_ids)
+      session.post('facebook.dashboard.removeActivity', { :activity_ids => activity_ids.flatten })
+    end
+    
+    
+    ##
+    # Two Facebooker::User objects should be considered equal if their Facebook ids are equal
+    def ==(other_user)
+      other_user.is_a?(User) && id == other_user.id
+    end
+
+
+    # register a user with Facebook
+    # users should be a hast with at least an :email field
+    # you can optionally provide an :account_id field as well
+
+    def self.register(users)
+      user_map={}
+      users=users.map do |h|
+        returning h.dup do |d|
+          if email=d.delete(:email)
+            hash = hash_email(email)
+            user_map[hash]=h
+            d[:email_hash]=hash
+          end
+        end
+      end
+      Facebooker::Session.create.post("facebook.connect.registerUsers",:accounts=>users.to_json) do |ret|
+        ret.each do |hash|
+          user_map.delete(hash)
+        end
+        unless user_map.empty?
+          e=Facebooker::Session::UserRegistrationFailed.new
+          e.failed_users = user_map.values
+          raise e
+        end
+        ret
+      end
+    end
+
+    # Get a count of unconnected friends
+    def getUnconnectedFriendsCount
+      session.post("facebook.connect.getUnconnectedFriendsCount")
+    end
+
+
+    # Unregister an array of email hashes
+    def self.unregister(email_hashes)
+      Facebooker::Session.create.post("facebook.connect.unregisterUsers",:email_hashes=>email_hashes.to_json) do |ret|
+        ret.each do |hash|
+          email_hashes.delete(hash)
+        end
+        unless email_hashes.empty?
+          e=Facebooker::Session::UserUnRegistrationFailed.new
+          e.failed_users = email_hashes
+          raise e
+        end
+        ret
+      end
+    end
+
+    # unregister an array of email addresses
+    def self.unregister_emails(emails)
+      emails_hash  = {}
+      emails.each {|e| emails_hash[hash_email(e)] = e}
+      begin
+        unregister(emails_hash.keys).collect {|r| emails_hash[r]}
+      rescue
+        # re-raise with emails instead of hashes.
+        e = Facebooker::Session::UserUnRegistrationFailed.new
+        e.failed_users = $!.failed_users.collect { |f| emails_hash[f] }
+        raise e
+      end
+    end
+
+    def self.hash_email(email)
+      email = email.downcase.strip
+      crc=Zlib.crc32(email)
+      md5=Digest::MD5.hexdigest(email)
+      "#{crc}_#{md5}"
+    end
+
+    def self.cast_to_facebook_id(object)
+      if object.respond_to?(:facebook_id)
+        object.facebook_id
+      else
+        object
+      end
+    end
+
+    def self.user_fields(fields = [])
+      valid_fields(fields)
+    end
+
+    def self.standard_fields(fields = [])
+      valid_fields(fields,STANDARD_FIELDS)
+    end
+
+    private
+    def publish(feed_story_or_action)
+      session.post(Facebooker::Feed::METHODS[feed_story_or_action.class.name.split(/::/).last], feed_story_or_action.to_params) == "1" ? true : false
+    end
+
+    def self.valid_fields(fields, allowable=FIELDS)
+      allowable.reject{|field_name| !fields.empty? && !fields.include?(field_name)}.join(',')
+    end
+
+    def collect(fields, allowable=FIELDS)
+      allowable.reject{|field_name| !fields.empty? && !fields.include?(field_name)}.join(',')
+    end
+
+    def profile_pic_album_id
+      merge_aid(-3, id)
+    end
+
+    def merge_aid(aid, uid)
+      (uid << 32) + (aid & 0xFFFFFFFF)
+    end
+
+    def prepare_get_stream_options(options)
+        opts = {}
+
+        opts[:viewer_id] = self.id
+        opts[:source_ids] = options[:source_ids] if options[:source_ids]
+        opts[:start_time] = options[:start_time].to_i if options[:start_time]
+        opts[:end_time] = options[:end_time].to_i if options[:end_time]
+        opts[:limit] = options[:limit] if options[:limit].is_a?(Integer)
+        opts[:metadata] = Facebooker.json_encode(options[:metadata]) if options[:metadata]
+        opts
+      end
+
+  end
+end