Class Facebooker::User
In: lib/facebooker/adapters/bebo_adapter.rb
lib/facebooker/models/user.rb
Parent: Object

Holds attributes and behavior for a Facebook User

Methods

==   add_comment   add_like_on   add_news   albums   app_user?   cast_to_facebook_id   cast_to_friend_list_id   clear_news   comment_on   convert_attachment_to_json   create_album   dashboard_count   dashboard_count=   dashboard_decrement_count   dashboard_increment_count   dashboard_multi_decrement_count   dashboard_multi_get_count   dashboard_multi_increment_count   dashboard_multi_set_count   events   friend_ids   friend_ids_with_this_app   friend_lists   friends   friends!   friends=   friends_with?   friends_with_this_app   getUnconnectedFriendsCount   get_activity   get_cookies   get_news   get_profile_info   groups   has_permission?   has_permissions?   hash_email   mobile_fbml=   multi_add_news   multi_clear_news   multi_get_news   new   notifications   populate   prepare_publish_to_options   profile_action=   profile_fbml   profile_fbml=   profile_main=   profile_photos   publish_action   publish_activity   publish_story   publish_templatized_action   publish_to   register   remove_activity   remove_like_on   revoke_permission   rsvp_event   send_email   set_cookie   set_profile_fbml   set_profile_fbml   set_profile_fbml_with_bebo_adapter   set_profile_info   set_status   standard_fields   status=   statuses   stream   threads   to_i   to_s   unregister   unregister_emails   upload_photo   upload_video   user_fields  

Included Modules

Model

Classes and Modules

Class Facebooker::User::Status

Constants

BEBO_FIELDS = FIELDS - [:meeting_sex, :wall_count, :meeting_for]
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]

External Aliases

set_profile_fbml -> set_profile_fbml_without_bebo_adapter
id -> facebook_id

Attributes

affiliations  [R] 
request_locale  [RW] 

Public Class methods

[Source]

# File lib/facebooker/models/user.rb, line 711
    def self.cast_to_facebook_id(object)
      if object.respond_to?(:facebook_id)
        object.facebook_id
      else
        object
      end
    end

Facebooker::User.dashboard_multi_decrement_count [‘1234’, ‘5678’]

[Source]

# File lib/facebooker/models/user.rb, line 566
    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

Facebooker::User.dashboard_multi_get_count [‘1234’, ‘5678’]

[Source]

# File lib/facebooker/models/user.rb, line 551
    def self.dashboard_multi_get_count(*uids)
     Facebooker::Session.create.post("facebook.dashboard.multiGetCount", :uids => uids.flatten)
    end

Facebooker::User.dashboard_multi_increment_count [‘1234’, ‘5678’]

[Source]

# File lib/facebooker/models/user.rb, line 561
    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_set_count({ ‘1234’ => ‘11’, ‘5678’ => ‘22’ })

[Source]

# File lib/facebooker/models/user.rb, line 556
    def self.dashboard_multi_set_count(ids)
      Facebooker::Session.create.post("facebook.dashboard.multiSetCount", :ids => ids.to_json)
    end

[Source]

# File lib/facebooker/models/user.rb, line 704
    def self.hash_email(email)
      email = email.downcase.strip
      crc=Zlib.crc32(email)
      md5=Digest::MD5.hexdigest(email)
      "#{crc}_#{md5}"
    end

Facebooker::User.multi_add_news([‘1234’, ‘4321’], [{ :message => ‘Hi users’, :action_link => { :text => "Uh hey there app", :href => ‘facebook.er/’ }}], ‘’)

[Source]

# File lib/facebooker/models/user.rb, line 598
    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"]})

[Source]

# File lib/facebooker/models/user.rb, line 606
    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"]})

[Source]

# File lib/facebooker/models/user.rb, line 611
    def self.multi_get_news(ids)
      Facebooker::Session.create.post('facebook.dashboard.multiGetNews', :ids => ids.to_json)
    end

Can pass in these two forms: id, session, (optional) attribute_hash attribute_hash

[Source]

# File lib/facebooker/models/user.rb, line 33
    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

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

[Source]

# File lib/facebooker/models/user.rb, line 645
    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

[Source]

# File lib/facebooker/models/user.rb, line 723
    def self.standard_fields(fields = [])
      valid_fields(fields,STANDARD_FIELDS)
    end

Unregister an array of email hashes

[Source]

# File lib/facebooker/models/user.rb, line 676
    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

[Source]

# File lib/facebooker/models/user.rb, line 691
    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

[Source]

# File lib/facebooker/models/user.rb, line 719
    def self.user_fields(fields = [])
      valid_fields(fields)
    end

Public Instance methods

Two Facebooker::User objects should be considered equal if their Facebook ids are equal

[Source]

# File lib/facebooker/models/user.rb, line 636
    def ==(other_user)
      other_user.is_a?(User) && id == other_user.id
    end

Publish a comment to a specific comment set by xid

See: wiki.developers.facebook.com/index.php/Comments.add

xid the xid for the set of comments text the text of the comment

[Source]

# File lib/facebooker/models/user.rb, line 196
    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: wiki.developers.facebook.com/index.php/Stream.addLike

post_id the post_id for the post that is being commented on

[Source]

# File lib/facebooker/models/user.rb, line 206
    def add_like_on(post_id)
      @session.post('facebook.stream.addLike', {:post_id=>post_id})
    end

facebook_session.user.add_news [{ :message => ‘Hey, who are you?’, :action_link => { :text => "I-I‘m a test user", :href => ‘facebook.er/’ }}], ‘

[Source]

# File lib/facebooker/models/user.rb, line 581
    def add_news(news, image=nil)
      params = { :uid => uid }
      params[:news] = news
      params[:image] = image if image
      
      session.post('facebook.dashboard.addNews', params)
    end

[Source]

# File lib/facebooker/models/user.rb, line 302
    def albums
      @albums ||= session.post('facebook.photos.getAlbums', :uid => self.id) do |response|
        response.map do |hash|
          Album.from_hash(hash)
        end
      end
    end

Returns whether the user (either the session user or user specified by uid) has authorized the calling application

[Source]

# File lib/facebooker/models/user.rb, line 480
    def app_user?
      session.post('facebook.users.isAppUser', {:uid => self.id}, use_session_key = true)
    end

[Source]

# File lib/facebooker/models/user.rb, line 93
    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

facebook_session.user.clear_news [‘111111’]

[Source]

# File lib/facebooker/models/user.rb, line 590
    def clear_news(*news_ids)
      params = { :uid => uid }
      params[:news_ids] = news_ids.flatten if news_ids
      
      session.post('facebook.dashboard.clearNews', params)
    end

Publish a comment on a post

See: 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

[Source]

# File lib/facebooker/models/user.rb, line 184
    def comment_on(post_id, comment)
      @session.post('facebook.stream.addComment', {:post_id=>post_id, :comment=>comment})
    end

[Source]

# File lib/facebooker/models/user.rb, line 172
    def convert_attachment_to_json(attachment)
      a = attachment.respond_to?(:to_hash) ? attachment.to_hash : attachment
      Facebooker.json_encode(a)
    end

[Source]

# File lib/facebooker/models/user.rb, line 321
    def create_album(params)
      @album = session.post('facebook.photos.createAlbum', params) {|response| Album.from_hash(response)}
    end

facebook_session.user.dashboard_count

[Source]

# File lib/facebooker/models/user.rb, line 528
    def dashboard_count
      session.post('facebook.dashboard.getCount', :uid => uid)
    end

facebook_session.user.dashboard_count = 5

[Source]

# File lib/facebooker/models/user.rb, line 533
    def dashboard_count=(new_count)
      session.post('facebook.dashboard.setCount', :uid => uid, :count => new_count)
    end

facebook_session.user.dashboard_decrement_count

[Source]

# File lib/facebooker/models/user.rb, line 543
    def dashboard_decrement_count
      session.post('facebook.dashboard.decrementCount', :uid => uid)
    end

facebook_session.user.dashboard_increment_count

[Source]

# File lib/facebooker/models/user.rb, line 538
    def dashboard_increment_count
      session.post('facebook.dashboard.incrementCount', :uid => uid)
    end

Returns a user‘s events, params correspond to API call parameters (except UID): 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

[Source]

# File lib/facebooker/models/user.rb, line 61
    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

[Source]

# File lib/facebooker/models/user.rb, line 121
    def friend_ids
      options = {:uid => self.id}
      @session.post('facebook.friends.get', options, false)
    end

[Source]

# File lib/facebooker/models/user.rb, line 258
    def friend_ids_with_this_app
      @friend_ids_with_this_app ||= session.post('facebook.friends.getAppUsers')
    end

[Source]

# File lib/facebooker/models/user.rb, line 220
     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

[Source]

# File lib/facebooker/models/user.rb, line 107
    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

Retrieve friends with user info populated Subsequent calls will be retrieved from memory. Optional: list of fields to retrieve as symbols

[Source]

# File lib/facebooker/models/user.rb, line 231
    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

Set the list of friends, given an array of User objects. If the list has been retrieved previously, will not set

[Source]

# File lib/facebooker/models/user.rb, line 84
    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

[Source]

# File lib/facebooker/models/user.rb, line 248
    def friends_with?(user_or_id)
      friends.map{|f| f.to_i}.include?(user_or_id.to_i)
    end

[Source]

# File lib/facebooker/models/user.rb, line 252
    def friends_with_this_app
      @friends_with_this_app ||= friend_ids_with_this_app.map do |uid|
        User.new(uid, session)
      end
    end

Get a count of unconnected friends

[Source]

# File lib/facebooker/models/user.rb, line 670
    def getUnconnectedFriendsCount
      session.post("facebook.connect.getUnconnectedFriendsCount")
    end

facebook_session.user.get_activity ‘123‘

[Source]

# File lib/facebooker/models/user.rb, line 616
    def get_activity(*activity_ids)
      params = {}
      params[:activity_ids] = activity_ids.flatten if activity_ids
      
      session.post('facebook.dashboard.getActivity', params)
    end

Convenience method to get cookies for the current user

[Source]

# File lib/facebooker/models/user.rb, line 510
    def get_cookies(name=nil)
      session.data.get_cookies(id, name)
    end

[Source]

# File lib/facebooker/models/user.rb, line 573
    def get_news(*news_ids)
      params = { :uid => uid }
      params[:news_ids] = news_ids.flatten if news_ids
      
      session.post('facebook.dashboard.getNews', params)
    end

[Source]

# File lib/facebooker/models/user.rb, line 437
    def get_profile_info
      session.post('facebook.profile.getInfo', :uid => id)
    end

[Source]

# File lib/facebooker/models/user.rb, line 262
    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

Checks to see if the user has enabled the given extended permission

[Source]

# File lib/facebooker/models/user.rb, line 474
    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

Convenience method to check multiple permissions at once

[Source]

# File lib/facebooker/models/user.rb, line 486
    def has_permissions?(ext_perms)
      ext_perms.all?{|p| has_permission?(p)}
    end

Set the mobile profile FBML

[Source]

# File lib/facebooker/models/user.rb, line 406
    def mobile_fbml=(markup)
      set_profile_fbml(nil, markup, nil,nil)
    end

[Source]

# File lib/facebooker/models/user.rb, line 286
    def notifications
      @notifications ||= Notifications.from_hash(session.post('facebook.notifications.get'))
    end

Retrieve profile data for logged in user Optional: list of fields to retrieve as symbols

[Source]

# File lib/facebooker/models/user.rb, line 240
    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

Prepares options for the stream.publish

[Source]

# File lib/facebooker/models/user.rb, line 152
    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

[Source]

# File lib/facebooker/models/user.rb, line 410
    def profile_action=(markup)
      set_profile_fbml(nil, nil, markup,nil)
    end

[Source]

# File lib/facebooker/models/user.rb, line 392
    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=

[Source]

# File lib/facebooker/models/user.rb, line 400
    def profile_fbml=(markup)
      set_profile_fbml(markup, nil, nil, nil)
    end

[Source]

# File lib/facebooker/models/user.rb, line 414
    def profile_main=(markup)
     set_profile_fbml(nil,nil,nil,markup)
    end

[Source]

# File lib/facebooker/models/user.rb, line 325
    def profile_photos
      session.get_photos(nil, nil, profile_pic_album_id)
    end

[Source]

# File lib/facebooker/models/user.rb, line 294
    def publish_action(action)
      publish(action)
    end

facebook_session.user.publish_activity({ :message => ’{actor} rolled around’, :action_link => { :text => ‘Roll around too’, :href => ‘facebook.er/’ }})

[Source]

# File lib/facebooker/models/user.rb, line 624
    def publish_activity(activity)
      session.post('facebook.dashboard.publishActivity', { :activity => activity.to_json })
    end

[Source]

# File lib/facebooker/models/user.rb, line 290
    def publish_story(story)
      publish(story)
    end

[Source]

# File lib/facebooker/models/user.rb, line 298
    def publish_templatized_action(action)
      publish(action)
    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: 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/'
  ])

[Source]

# File lib/facebooker/models/user.rb, line 147
    def publish_to(target, options = {})
      @session.post('facebook.stream.publish', prepare_publish_to_options(target, options), false)
    end

facebook_session.user.remove_activity [‘123’]

[Source]

# File lib/facebooker/models/user.rb, line 629
    def remove_activity(*activity_ids)
      session.post('facebook.dashboard.removeActivity', { :activity_ids => activity_ids.flatten })
    end

Remove a like on a post

See: wiki.developers.facebook.com/index.php/Stream.removeLike

post_id the post_id for the post that is being commented on

[Source]

# File lib/facebooker/models/user.rb, line 216
    def remove_like_on(post_id)
      @session.post('facebook.stream.removeLike', {:post_id=>post_id})
    end

Revoke any extended permission given by a user

[Source]

# File lib/facebooker/models/user.rb, line 492
    def revoke_permission(ext_perm)
      session.post('facebook.auth.revokeExtendedPermission', { :perm => ext_perm, :uid => uid }, false)
    end

Rsvp to an event with the eid and rsvp_status which can be ‘attending’, ‘unsure’, or ‘declined’. wiki.developers.facebook.com/index.php/Events.rsvp E.g:

 @user.rsvp_event('100321123', 'attending')
 # => Returns true if all went well

[Source]

# File lib/facebooker/models/user.rb, line 77
    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

Convenience method to send email to the current user

[Source]

# File lib/facebooker/models/user.rb, line 498
    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

[Source]

# File lib/facebooker/models/user.rb, line 504
    def set_cookie(name, value, expires=nil, path=nil)
      session.data.set_cookie(id, name, value, expires, path)
    end
set_profile_fbml(profile_fbml, mobile_fbml, profile_action_fbml, profile_main = nil)

[Source]

# File lib/facebooker/models/user.rb, line 418
    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

[Source]

# File lib/facebooker/adapters/bebo_adapter.rb, line 38
    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
 ** 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.

[Source]

# File lib/facebooker/models/user.rb, line 432
    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

Set the status for a user DOES NOT prepend "is" to the message

requires extended permission.

[Source]

# File lib/facebooker/models/user.rb, line 465
    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

This DOES NOT set the status of a user on Facebook Use the set_status method instead

[Source]

# File lib/facebooker/models/user.rb, line 444
    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

[Source]

# File lib/facebooker/models/user.rb, line 456
    def statuses( limit = 50 )
      session.post('facebook.status.get', {:uid => uid, :limit => limit}).collect { |ret| Status.from_hash(ret) }
    end

Retrieve user‘s facebook stream See wiki.developers.facebook.com/index.php/Stream.get for options

[Source]

# File lib/facebooker/models/user.rb, line 315
    def stream(options = {})
      @stream = session.post('facebook.stream.get', prepare_get_stream_options(options)) do |response|
        response
      end
    end

Get threads in a folder

See: wiki.developers.facebook.com/index.php/Message.getThreadsInFolder

options possible options are :folder_id, :limit and :offset

[Source]

# File lib/facebooker/models/user.rb, line 277
    def threads(options = {})
      options ||= {}
      @threads = session.post('facebook.message.getThreadsInFolder', options) do |response|
        response.map do |hash|
          MessageThread.from_hash(hash)
        end
      end
    end

Returns the user‘s id as an integer

[Source]

# File lib/facebooker/models/user.rb, line 516
    def to_i
      id
    end

[Source]

# File lib/facebooker/models/user.rb, line 520
    def to_s
      id.to_s
    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 wiki.developers.facebook.com/index.php/Photos.upload

[Source]

# File lib/facebooker/models/user.rb, line 355
    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 wiki.developers.facebook.com/index.php/Video.upload

[Source]

# File lib/facebooker/models/user.rb, line 387
    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

[Validate]