al-facebooker 1.0.9
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG.txt +0 -0
- data/COPYING +19 -0
- data/History.txt +17 -0
- data/Manifest.txt +114 -0
- data/README +46 -0
- data/README.txt +97 -0
- data/Rakefile +76 -0
- data/TODO.txt +10 -0
- data/generators/facebook/facebook_generator.rb +14 -0
- data/generators/facebook/templates/config/facebooker.yml +46 -0
- data/generators/facebook/templates/public/javascripts/facebooker.js +106 -0
- data/generators/facebook_controller/USAGE +33 -0
- data/generators/facebook_controller/facebook_controller_generator.rb +40 -0
- data/generators/facebook_controller/templates/controller.rb +7 -0
- data/generators/facebook_controller/templates/functional_test.rb +11 -0
- data/generators/facebook_controller/templates/helper.rb +2 -0
- data/generators/facebook_controller/templates/view.fbml.erb +2 -0
- data/generators/facebook_controller/templates/view.html.erb +2 -0
- data/generators/facebook_publisher/facebook_publisher_generator.rb +14 -0
- data/generators/facebook_publisher/templates/create_facebook_templates.rb +15 -0
- data/generators/facebook_publisher/templates/publisher.rb +3 -0
- data/generators/facebook_scaffold/USAGE +27 -0
- data/generators/facebook_scaffold/facebook_scaffold_generator.rb +118 -0
- data/generators/facebook_scaffold/templates/controller.rb +93 -0
- data/generators/facebook_scaffold/templates/facebook_style.css +2579 -0
- data/generators/facebook_scaffold/templates/functional_test.rb +89 -0
- data/generators/facebook_scaffold/templates/helper.rb +2 -0
- data/generators/facebook_scaffold/templates/layout.fbml.erb +6 -0
- data/generators/facebook_scaffold/templates/layout.html.erb +17 -0
- data/generators/facebook_scaffold/templates/style.css +74 -0
- data/generators/facebook_scaffold/templates/view_edit.fbml.erb +13 -0
- data/generators/facebook_scaffold/templates/view_edit.html.erb +18 -0
- data/generators/facebook_scaffold/templates/view_index.fbml.erb +24 -0
- data/generators/facebook_scaffold/templates/view_index.html.erb +24 -0
- data/generators/facebook_scaffold/templates/view_new.fbml.erb +12 -0
- data/generators/facebook_scaffold/templates/view_new.html.erb +17 -0
- data/generators/facebook_scaffold/templates/view_show.fbml.erb +10 -0
- data/generators/facebook_scaffold/templates/view_show.html.erb +10 -0
- data/generators/publisher/publisher_generator.rb +14 -0
- data/generators/xd_receiver/templates/xd_receiver.html +10 -0
- data/generators/xd_receiver/xd_receiver_generator.rb +9 -0
- data/init.rb +70 -0
- data/install.rb +12 -0
- data/lib/facebooker.rb +171 -0
- data/lib/facebooker/adapters/adapter_base.rb +87 -0
- data/lib/facebooker/adapters/bebo_adapter.rb +75 -0
- data/lib/facebooker/adapters/facebook_adapter.rb +48 -0
- data/lib/facebooker/admin.rb +28 -0
- data/lib/facebooker/batch_request.rb +44 -0
- data/lib/facebooker/data.rb +57 -0
- data/lib/facebooker/feed.rb +78 -0
- data/lib/facebooker/logging.rb +51 -0
- data/lib/facebooker/model.rb +123 -0
- data/lib/facebooker/models/affiliation.rb +10 -0
- data/lib/facebooker/models/album.rb +11 -0
- data/lib/facebooker/models/applicationproperties.rb +39 -0
- data/lib/facebooker/models/cookie.rb +10 -0
- data/lib/facebooker/models/education_info.rb +11 -0
- data/lib/facebooker/models/event.rb +26 -0
- data/lib/facebooker/models/friend_list.rb +14 -0
- data/lib/facebooker/models/group.rb +35 -0
- data/lib/facebooker/models/info_item.rb +10 -0
- data/lib/facebooker/models/info_section.rb +10 -0
- data/lib/facebooker/models/location.rb +8 -0
- data/lib/facebooker/models/notifications.rb +17 -0
- data/lib/facebooker/models/page.rb +27 -0
- data/lib/facebooker/models/photo.rb +10 -0
- data/lib/facebooker/models/tag.rb +12 -0
- data/lib/facebooker/models/user.rb +396 -0
- data/lib/facebooker/models/work_info.rb +9 -0
- data/lib/facebooker/parser.rb +547 -0
- data/lib/facebooker/rails/controller.rb +280 -0
- data/lib/facebooker/rails/facebook_asset_path.rb +18 -0
- data/lib/facebooker/rails/facebook_form_builder.rb +112 -0
- data/lib/facebooker/rails/facebook_pretty_errors.rb +14 -0
- data/lib/facebooker/rails/facebook_request_fix.rb +24 -0
- data/lib/facebooker/rails/facebook_session_handling.rb +69 -0
- data/lib/facebooker/rails/facebook_url_helper.rb +191 -0
- data/lib/facebooker/rails/facebook_url_rewriting.rb +39 -0
- data/lib/facebooker/rails/helpers.rb +681 -0
- data/lib/facebooker/rails/helpers/fb_connect.rb +34 -0
- data/lib/facebooker/rails/profile_publisher_extensions.rb +42 -0
- data/lib/facebooker/rails/publisher.rb +510 -0
- data/lib/facebooker/rails/routing.rb +49 -0
- data/lib/facebooker/rails/test_helpers.rb +88 -0
- data/lib/facebooker/rails/utilities.rb +22 -0
- data/lib/facebooker/server_cache.rb +24 -0
- data/lib/facebooker/service.rb +92 -0
- data/lib/facebooker/session.rb +566 -0
- data/lib/facebooker/version.rb +9 -0
- data/lib/net/http_multipart_post.rb +123 -0
- data/lib/tasks/facebooker.rake +18 -0
- data/lib/tasks/tunnel.rake +46 -0
- data/rails/init.rb +1 -0
- data/setup.rb +1585 -0
- data/templates/layout.erb +24 -0
- data/test/adapters_test.rb +98 -0
- data/test/batch_request_test.rb +82 -0
- data/test/event_test.rb +15 -0
- data/test/facebook_admin_test.rb +76 -0
- data/test/facebook_cache_test.rb +44 -0
- data/test/facebook_data_test.rb +86 -0
- data/test/facebooker_test.rb +855 -0
- data/test/fixtures/multipart_post_body_with_only_parameters.txt +33 -0
- data/test/fixtures/multipart_post_body_with_single_file.txt +38 -0
- data/test/fixtures/multipart_post_body_with_single_file_that_has_nil_key.txt +38 -0
- data/test/http_multipart_post_test.rb +54 -0
- data/test/logging_test.rb +43 -0
- data/test/model_test.rb +91 -0
- data/test/publisher_test.rb +458 -0
- data/test/rails_integration_test.rb +1224 -0
- data/test/session_test.rb +613 -0
- data/test/test_helper.rb +60 -0
- data/test/user_test.rb +270 -0
- metadata +185 -0
@@ -0,0 +1,57 @@
|
|
1
|
+
module Facebooker
|
2
|
+
class Data
|
3
|
+
def initialize(session)
|
4
|
+
@session = session
|
5
|
+
end
|
6
|
+
|
7
|
+
##
|
8
|
+
# ** BETA ***
|
9
|
+
# Sets a cookie on Facebook
|
10
|
+
# +user+ The user for whom this cookie needs to be set.
|
11
|
+
# +name+ Name of the cookie
|
12
|
+
# +value+ Value of the cookie
|
13
|
+
# Optional:
|
14
|
+
# +expires+ Time when the cookie should expire. If not specified, the cookie never expires.
|
15
|
+
# +path+ Path relative to the application's callback URL, with which the cookie should be associated. (default value is /?
|
16
|
+
def set_cookie(user, name, value, expires=nil, path=nil)
|
17
|
+
@session.post('facebook.data.setCookie',
|
18
|
+
:uid => User.cast_to_facebook_id(user),
|
19
|
+
:name => name,
|
20
|
+
:value => value,
|
21
|
+
:expires => expires,
|
22
|
+
:path => path) {|response| response == '1'}
|
23
|
+
end
|
24
|
+
|
25
|
+
##
|
26
|
+
# ** BETA ***
|
27
|
+
# Gets a cookie stored on Facebook
|
28
|
+
# +user+ The user from whom to get the cookies.
|
29
|
+
# Optional:
|
30
|
+
# +name+ The name of the cookie. If not specified, all the cookies for the given user get returned.
|
31
|
+
def get_cookies(user, name=nil)
|
32
|
+
@cookies = @session.post(
|
33
|
+
'facebook.data.getCookies', :uid => User.cast_to_facebook_id(user), :name => name) do |response|
|
34
|
+
response.map do |hash|
|
35
|
+
Cookie.from_hash(hash)
|
36
|
+
end
|
37
|
+
end
|
38
|
+
end
|
39
|
+
|
40
|
+
##
|
41
|
+
# ** BETA ***
|
42
|
+
# Gets a preference stored on Facebook
|
43
|
+
# +pref_id+ The id of the preference to get
|
44
|
+
def get_preference(pref_id)
|
45
|
+
@session.post('facebook.data.getUserPreference', :pref_id=>pref_id)
|
46
|
+
end
|
47
|
+
|
48
|
+
##
|
49
|
+
# ** BETA ***
|
50
|
+
# Sets a preference on Facebook
|
51
|
+
# +pref_id+ The id of the preference to set
|
52
|
+
# +value+ The value to set for this preference
|
53
|
+
def set_preference(pref_id, value)
|
54
|
+
@session.post('facebook.data.setUserPreference', :pref_id=>pref_id, :value=>value)
|
55
|
+
end
|
56
|
+
end
|
57
|
+
end
|
@@ -0,0 +1,78 @@
|
|
1
|
+
module Facebooker
|
2
|
+
module Feed
|
3
|
+
METHODS = {'Action' => 'facebook.feed.publishActionOfUser', 'Story' => 'facebook.feed.publishStoryToUser',
|
4
|
+
'TemplatizedAction' => 'facebook.feed.publishTemplatizedAction' }
|
5
|
+
|
6
|
+
class ActionBase
|
7
|
+
1.upto(4) do |num|
|
8
|
+
attr_accessor "image_#{num}"
|
9
|
+
attr_accessor "image_#{num}_link"
|
10
|
+
end
|
11
|
+
|
12
|
+
def add_image(image,link=nil)
|
13
|
+
1.upto(4) do |num|
|
14
|
+
if send("image_#{num}").blank?
|
15
|
+
send("image_#{num}=",image)
|
16
|
+
send("image_#{num}_link=",link) unless link.nil?
|
17
|
+
return num
|
18
|
+
end
|
19
|
+
end
|
20
|
+
end
|
21
|
+
|
22
|
+
|
23
|
+
protected
|
24
|
+
def image_params
|
25
|
+
image_hash = {}
|
26
|
+
1.upto(4) do |num|
|
27
|
+
image_attribute = "image_#{num}"
|
28
|
+
image_link_attribute = image_attribute + "_link"
|
29
|
+
self.__send__(image_attribute) ? image_hash[image_attribute] = self.__send__(image_attribute) : nil
|
30
|
+
self.__send__(image_link_attribute) ? image_hash[image_link_attribute] = self.__send__(image_link_attribute) : nil
|
31
|
+
end
|
32
|
+
image_hash
|
33
|
+
end
|
34
|
+
end
|
35
|
+
|
36
|
+
##
|
37
|
+
# Representation of a templatized action to be published into a user's news feed
|
38
|
+
class TemplatizedAction < ActionBase
|
39
|
+
attr_accessor :page_actor_id, :title_template, :title_data, :body_template, :body_data, :body_general, :target_ids
|
40
|
+
|
41
|
+
def to_params
|
42
|
+
raise "Must set title_template" if self.title_template.nil?
|
43
|
+
{ :page_actor_id => page_actor_id,
|
44
|
+
:title_template => title_template,
|
45
|
+
:title_data => convert_json(title_data),
|
46
|
+
:body_template => body_template,
|
47
|
+
:body_data => convert_json(body_data),
|
48
|
+
:body_general => body_general,
|
49
|
+
:target_ids => target_ids }.merge image_params
|
50
|
+
end
|
51
|
+
|
52
|
+
def convert_json(hash_or_string)
|
53
|
+
(hash_or_string.is_a?(Hash) and hash_or_string.respond_to?(:to_json)) ? hash_or_string.to_json : hash_or_string
|
54
|
+
end
|
55
|
+
end
|
56
|
+
|
57
|
+
##
|
58
|
+
# Representation of a story to be published into a user's news feed.
|
59
|
+
class Story < ActionBase
|
60
|
+
attr_accessor :title, :body
|
61
|
+
|
62
|
+
##
|
63
|
+
# Converts Story to a Hash of its attributes for use as parameters to Facebook REST API calls
|
64
|
+
def to_params
|
65
|
+
raise "Must set title before converting" if self.title.nil?
|
66
|
+
{ :title => title, :body => body }.merge image_params
|
67
|
+
end
|
68
|
+
|
69
|
+
end
|
70
|
+
Action = Story.dup
|
71
|
+
def Action.name
|
72
|
+
"Action"
|
73
|
+
end
|
74
|
+
##
|
75
|
+
# Representation of an action to be published into a user's news feed. Alias for Story.
|
76
|
+
class Action; end
|
77
|
+
end
|
78
|
+
end
|
@@ -0,0 +1,51 @@
|
|
1
|
+
require 'benchmark'
|
2
|
+
module Facebooker
|
3
|
+
@@logger = nil
|
4
|
+
def self.logger=(logger)
|
5
|
+
@@logger = logger
|
6
|
+
end
|
7
|
+
def self.logger
|
8
|
+
@@logger
|
9
|
+
end
|
10
|
+
|
11
|
+
module Logging
|
12
|
+
|
13
|
+
def self.skip_api_logging=(val)
|
14
|
+
@skip_api_logging=val
|
15
|
+
end
|
16
|
+
|
17
|
+
def self.skip_api_logging
|
18
|
+
@skip_api_logging
|
19
|
+
end
|
20
|
+
|
21
|
+
|
22
|
+
def self.log_fb_api(method, params)
|
23
|
+
message = method # might customize later
|
24
|
+
dump = format_fb_params(params)
|
25
|
+
if block_given?
|
26
|
+
result = nil
|
27
|
+
seconds = Benchmark.realtime { result = yield }
|
28
|
+
log_info(message, dump, seconds) unless skip_api_logging
|
29
|
+
result
|
30
|
+
else
|
31
|
+
log_info(message, dump) unless skip_api_logging
|
32
|
+
nil
|
33
|
+
end
|
34
|
+
rescue Exception => e
|
35
|
+
exception = "#{e.class.name}: #{e.message}: #{dump}"
|
36
|
+
log_info(message, exception)
|
37
|
+
raise
|
38
|
+
end
|
39
|
+
|
40
|
+
def self.format_fb_params(params)
|
41
|
+
params.map { |key,value| "#{key} = #{value}" }.join(', ')
|
42
|
+
end
|
43
|
+
|
44
|
+
def self.log_info(message, dump, seconds = 0)
|
45
|
+
return unless Facebooker.logger
|
46
|
+
log_message = "#{message} (#{seconds}) #{dump}"
|
47
|
+
Facebooker.logger.debug(log_message)
|
48
|
+
end
|
49
|
+
|
50
|
+
end
|
51
|
+
end
|
@@ -0,0 +1,123 @@
|
|
1
|
+
module Facebooker
|
2
|
+
##
|
3
|
+
# helper methods primarily supporting the management of Ruby objects which are populatable via Hashes.
|
4
|
+
# Since most Facebook API calls accept and return hashes of data (as XML), the Model module allows us to
|
5
|
+
# directly populate a model's attributes given a Hash with matching key names.
|
6
|
+
module Model
|
7
|
+
class UnboundSessionException < Exception; end
|
8
|
+
def self.included(includer)
|
9
|
+
includer.extend ClassMethods
|
10
|
+
includer.__send__(:attr_writer, :session)
|
11
|
+
includer.__send__(:attr_reader, :anonymous_fields)
|
12
|
+
end
|
13
|
+
module ClassMethods
|
14
|
+
##
|
15
|
+
# Instantiate a new instance of the class into which we are included and populate that instance's
|
16
|
+
# attributes given the provided Hash. Key names in the Hash should map to attribute names on the model.
|
17
|
+
def from_hash(hash)
|
18
|
+
instance = new(hash)
|
19
|
+
yield instance if block_given?
|
20
|
+
instance
|
21
|
+
end
|
22
|
+
|
23
|
+
##
|
24
|
+
# Create a standard attr_writer and a populating_attr_reader
|
25
|
+
def populating_attr_accessor(*symbols)
|
26
|
+
attr_writer *symbols
|
27
|
+
populating_attr_reader *symbols
|
28
|
+
end
|
29
|
+
|
30
|
+
##
|
31
|
+
# Create a reader that will attempt to populate the model if it has not already been populated
|
32
|
+
def populating_attr_reader(*symbols)
|
33
|
+
symbols.each do |symbol|
|
34
|
+
define_method(symbol) do
|
35
|
+
populate unless populated?
|
36
|
+
instance_variable_get("@#{symbol}")
|
37
|
+
end
|
38
|
+
end
|
39
|
+
end
|
40
|
+
|
41
|
+
def populating_hash_settable_accessor(symbol, klass)
|
42
|
+
populating_attr_reader symbol
|
43
|
+
hash_settable_writer(symbol, klass)
|
44
|
+
end
|
45
|
+
|
46
|
+
def populating_hash_settable_list_accessor(symbol, klass)
|
47
|
+
populating_attr_reader symbol
|
48
|
+
hash_settable_list_writer(symbol, klass)
|
49
|
+
end
|
50
|
+
|
51
|
+
#
|
52
|
+
# Declares an attribute named ::symbol:: which can be set with either an instance of ::klass::
|
53
|
+
# or a Hash which will be used to populate a new instance of ::klass::.
|
54
|
+
def hash_settable_accessor(symbol, klass)
|
55
|
+
attr_reader symbol
|
56
|
+
hash_settable_writer(symbol, klass)
|
57
|
+
end
|
58
|
+
|
59
|
+
def hash_settable_writer(symbol, klass)
|
60
|
+
define_method("#{symbol}=") do |value|
|
61
|
+
instance_variable_set("@#{symbol}", value.kind_of?(Hash) ? klass.from_hash(value) : value)
|
62
|
+
end
|
63
|
+
end
|
64
|
+
|
65
|
+
#
|
66
|
+
# Declares an attribute named ::symbol:: which can be set with either a list of instances of ::klass::
|
67
|
+
# or a list of Hashes which will be used to populate a new instance of ::klass::.
|
68
|
+
def hash_settable_list_accessor(symbol, klass)
|
69
|
+
attr_reader symbol
|
70
|
+
hash_settable_list_writer(symbol, klass)
|
71
|
+
end
|
72
|
+
|
73
|
+
def hash_settable_list_writer(symbol, klass)
|
74
|
+
define_method("#{symbol}=") do |list|
|
75
|
+
instance_variable_set("@#{symbol}", list.map do |item|
|
76
|
+
item.kind_of?(Hash) ? klass.from_hash(item) : item
|
77
|
+
end)
|
78
|
+
end
|
79
|
+
end
|
80
|
+
end
|
81
|
+
|
82
|
+
##
|
83
|
+
# Centralized, error-checked place for a model to get the session to which it is bound.
|
84
|
+
# Any Facebook API queries require a Session instance.
|
85
|
+
def session
|
86
|
+
@session || (raise UnboundSessionException, "Must bind this object to a Facebook session before querying")
|
87
|
+
end
|
88
|
+
|
89
|
+
#
|
90
|
+
# This gets populated from FQL queries.
|
91
|
+
def anon=(value)
|
92
|
+
@anonymous_fields = value
|
93
|
+
end
|
94
|
+
|
95
|
+
def initialize(hash = {})
|
96
|
+
populate_from_hash!(hash)
|
97
|
+
end
|
98
|
+
|
99
|
+
def populate
|
100
|
+
raise NotImplementedError, "#{self.class} included me and should have overriden me"
|
101
|
+
end
|
102
|
+
|
103
|
+
def populated?
|
104
|
+
!@populated.nil?
|
105
|
+
end
|
106
|
+
|
107
|
+
##
|
108
|
+
# Set model's attributes via Hash. Keys should map directly to the model's attribute names.
|
109
|
+
def populate_from_hash!(hash)
|
110
|
+
unless hash.empty?
|
111
|
+
hash.each do |key, value|
|
112
|
+
set_attr_method = "#{key}="
|
113
|
+
if respond_to?(set_attr_method)
|
114
|
+
self.__send__(set_attr_method, value)
|
115
|
+
else
|
116
|
+
Facebooker::Logging.log_info("**Warning**, Attempt to set non-attribute: #{key}",hash)
|
117
|
+
end
|
118
|
+
end
|
119
|
+
@populated = true
|
120
|
+
end
|
121
|
+
end
|
122
|
+
end
|
123
|
+
end
|
@@ -0,0 +1,10 @@
|
|
1
|
+
require 'facebooker/model'
|
2
|
+
module Facebooker
|
3
|
+
##
|
4
|
+
# Represents a user's affiliation, for example, which educational institutions
|
5
|
+
# the user is associated with.
|
6
|
+
class Affiliation
|
7
|
+
include Model
|
8
|
+
attr_accessor :name, :status, :type, :year, :nid
|
9
|
+
end
|
10
|
+
end
|
@@ -0,0 +1,39 @@
|
|
1
|
+
module Facebooker
|
2
|
+
|
3
|
+
# application_name string The name of your application.
|
4
|
+
# callback_url string Your application's callback URL. The callback URL cannot be longer than 100 characters.
|
5
|
+
# post_install_url string The URL where a user gets redirected after installing your application. The post-install URL cannot be longer than 100 characters.
|
6
|
+
# edit_url string
|
7
|
+
# dashboard_url string
|
8
|
+
# uninstall_url string The URL where a user gets redirected after removing your application.
|
9
|
+
# ip_list string For Web-based applications, these are the IP addresses of your servers that can access Facebook's servers and serve information to your application.
|
10
|
+
# email string The email address associated with the application; the email address Facebook uses to contact you about your application. (default value is your Facebook email address.)
|
11
|
+
# description string The description of your application.
|
12
|
+
# use_iframe bool Indicates whether you render your application with FBML (0) or in an iframe (1). (default value is 1)
|
13
|
+
# desktop bool Indicates whether your application is Web-based (0) or gets installed on a user's desktop (1). (default value is 1)
|
14
|
+
# is_mobile bool Indicates whether your application can run on a mobile device (1) or not (0). (default value is 1)
|
15
|
+
# default_fbml string The default FBML code that appears in the user's profile box when he or she adds your application.
|
16
|
+
# default_column bool Indicates whether your application appears in the wide (1) or narrow (0) column of a user's Facebook profile. (default value is 1)
|
17
|
+
# message_url string For applications that can create attachments, this is the URL where you store the attachment's content.
|
18
|
+
# message_action string For applications that can create attachments, this is the label for the action that creates the attachment. It cannot be more than 20 characters.
|
19
|
+
# about_url string This is the URL to your application's About page. About pages are now Facebook Pages.
|
20
|
+
# private_install bool Indicates whether you want to disable (1) or enable (0) News Feed and Mini-Feed stories when a user installs your application. (default value is 1)
|
21
|
+
# installable bool Indicates whether a user can (1) or cannot (0) install your application. (default value is 1)
|
22
|
+
# privacy_url string The URL to your application's privacy terms.
|
23
|
+
# help_url string The URL to your application's help page.
|
24
|
+
# see_all_url string
|
25
|
+
# tos_url string The URL to your application's Terms of Service.
|
26
|
+
# dev_mode bool Indicates whether developer mode is enabled (1) or disabled (0). Only developers can install applications in developer mode. (default value is 1)
|
27
|
+
# preload_fql string A preloaded FQL query.
|
28
|
+
class ApplicationProperties
|
29
|
+
include Model
|
30
|
+
FIELDS = [ :application_name, :callback_url, :post_install_url, :edit_url, :dashboard_url,
|
31
|
+
:uninstall_url, :ip_list, :email, :description, :use_iframe, :desktop, :is_mobile,
|
32
|
+
:default_fbml, :default_column, :message_url, :message_action, :about_url,
|
33
|
+
:private_install, :installable, :privacy_url, :help_url, :see_all_url, :tos_url,
|
34
|
+
:dev_mode, :preload_fql, :icon_url, :canvas_name, :logo_url, :connect_logo_url ]
|
35
|
+
|
36
|
+
attr_accessor *FIELDS
|
37
|
+
|
38
|
+
end
|
39
|
+
end
|
@@ -0,0 +1,26 @@
|
|
1
|
+
require 'facebooker/model'
|
2
|
+
module Facebooker
|
3
|
+
class Event
|
4
|
+
|
5
|
+
##
|
6
|
+
# The relationship between a Facebook user and an Event to which he or she has been
|
7
|
+
# invited and may or may not be attending (based on #rsvp_status)
|
8
|
+
class Attendance
|
9
|
+
include Model
|
10
|
+
attr_accessor :eid, :uid, :rsvp_status
|
11
|
+
|
12
|
+
##
|
13
|
+
# Get the full, populated Event object which this Attendance is associated with.
|
14
|
+
# First access will query the Facebook API (facebook.events.get). Subsequent
|
15
|
+
# calls are retrieved from in-memory cache.
|
16
|
+
def event
|
17
|
+
@event ||= Event.from_hash(session.post('facebook.events.get', :eids => [eid]).first)
|
18
|
+
end
|
19
|
+
|
20
|
+
#TODO: implement user() method
|
21
|
+
end
|
22
|
+
|
23
|
+
include Model
|
24
|
+
attr_accessor :eid, :pic, :pic_small, :pic_big, :name, :creator, :update_time, :description, :tagline, :venue, :host, :event_type, :nid, :location, :end_time, :start_time, :event_subtype
|
25
|
+
end
|
26
|
+
end
|
@@ -0,0 +1,14 @@
|
|
1
|
+
require 'facebooker/model'
|
2
|
+
module Facebooker
|
3
|
+
##
|
4
|
+
# A simple representation of a friend list.
|
5
|
+
class FriendList
|
6
|
+
include Model
|
7
|
+
attr_accessor :flid, :name
|
8
|
+
|
9
|
+
# We need this to be an integer, so do the conversion
|
10
|
+
def flid=(f)
|
11
|
+
@flid= ( f.nil? ? nil : f.to_i)
|
12
|
+
end
|
13
|
+
end
|
14
|
+
end
|
@@ -0,0 +1,35 @@
|
|
1
|
+
require 'facebooker/model'
|
2
|
+
module Facebooker
|
3
|
+
class Group
|
4
|
+
##
|
5
|
+
# The model of a user's relationship to a group. Users can occupy different positions within a group (e.g. 'owner')
|
6
|
+
class Membership
|
7
|
+
include Model
|
8
|
+
attr_accessor :position, :gid, :uid
|
9
|
+
end
|
10
|
+
include Model
|
11
|
+
attr_accessor :pic, :pic_small, :pic_big, :name, :creator, :recent_news, :gid, :update_time, :group_subtype, :group_type, :website, :office, :description, :venue, :nid
|
12
|
+
|
13
|
+
|
14
|
+
##
|
15
|
+
# Get the full list of members as populated User objects. First time fetches group members via Facebook API call.
|
16
|
+
# Subsequent calls return cached values.
|
17
|
+
# This is a convenience method for getting all of the Membership instances and instantiating User instances for each Membership.
|
18
|
+
def members
|
19
|
+
@members ||= memberships.map do |membership|
|
20
|
+
User.new(membership.uid, session)
|
21
|
+
end
|
22
|
+
end
|
23
|
+
|
24
|
+
##
|
25
|
+
# Get a list of Membership instances associated with this Group. First call retrieves the Membership instances via a Facebook
|
26
|
+
# API call. Subsequent calls are retrieved from in-memory cache.
|
27
|
+
def memberships
|
28
|
+
@memberships ||= session.post('facebook.groups.getMembers', :gid => gid).map do |hash|
|
29
|
+
Membership.from_hash(hash) do |membership|
|
30
|
+
membership.gid = gid
|
31
|
+
end
|
32
|
+
end
|
33
|
+
end
|
34
|
+
end
|
35
|
+
end
|