mosaic-facebook 1.3.0 → 1.3.1

data/README.md

@@ -0,0 +1,93 @@
+#Mosaic Facebook API gem
+
+This gem is designed to make integrating a Facebook application easy into your ruby program.
+
+
+## Installation
+
+If using Bundler, just add it to your Gemfile
+
+    gem 'mosaic-facebook'
+
+If you want to use it from other applications, just install it as a gem, then require it like normal.
+
+## Usage
+
+For almost any use case of the application, you will want to instantiate a new Facebook Application object.
+
+    app = Mosaic::Facebook::Graph::Application.new(:id => FB_CONFIG["client_id"], :secret => FB_CONFIG["client_secret"])
+
+You will then want to retrieve the oauth access token to allow you to make authenticated calls to the API.
+
+   @access_token = app.access_token
+
+### Logging a user in with Facebook
+
+To start with, you will want to redirect the user to the Facebook authentication page in your controller.
+
+    facebook_client_id = ** your facebook client id **
+    redirect_uri = ** the place where Facebook will redirect them back **
+    scope = ** the permissions you are asking for, comma separated string ***
+    redirect_to "http://www.facebook.com/dialog/oauth?client_id=#{facebook_client_id}&redirect_uri=#{CGI::escape(redirect_uri)}&scope=#{scope}"
+
+They will then be prompted to authorize your application with your permissions, and be redirected back to your redirect URI. You want to then verify that this was a
+valid callback, by using the authorize method on the application
+
+    user = app.authorize(params[:code], redirect_uri)
+
+This call will return a Mosaic::Facebook::Graph::User object, containing the details of the user. For an example call:
+
+    user.name # returns the name of the user
+    user.birthday # returns the user's birthday.
+
+You can also examine meta-data about a user:
+
+    user.likes # returns all the information about the likes of a user.
+
+### Checking that a user has liked your facebook page
+
+Alternately, you can query the like model directly, if you want to find out if a user liked a page
+
+    page_id = ** your facebook page id **
+    Mosaic::Facebook::Graph::Like.find_by_id(user.facebook_id, page_id, :access_token => user.oauth_token).any?
+
+### Grabbing a list of all the posts for a page
+
+First, you'll need to record the page
+
+    since_time = Time.now.to_i # If you don't pass a since time, you'll get all posts in the history of the page
+    page_id = ** your page id **
+    page = Mosaic::Facebook::Graph::Page.new(:id => page_id).feed.all(:access_token => app.access_token, :since => since_time)
+
+You can then iterate through the posts , grabbing all the fields of each post
+
+    page.feed.all each do |post|
+      from = post.from.all(:fields => 'name,username,picture')
+      puts post.id.to_s
+      puts post.message
+      puts post.created_time
+      puts from.username.blank? ? from.name : from.username
+      puts from.picture # profile photo
+      case post.type
+      when 'link'
+        puts post.link
+      when 'photo'
+        puts post.picture
+      when 'video'
+        puts post.source
+      end
+    end
+
+### Grabbing a list of events from a page
+
+Take the page we recorded earlier, and much like the post feed, we can now grab the event feed
+
+    events = page.events.all({:access_token => app.access_token})
+    events.each do |event|
+      puts event.name
+      puts event.description
+      puts event.start_time
+      puts event.end_time
+      puts event.location
+      puts event.venue
+    end

data/lib/mosaic/facebook/graph/event.rb

@@ -2,8 +2,7 @@ module Mosaic
   module Facebook
     module Graph
       class Event < Mosaic::Facebook::Graph::GraphObject
-        attr_accessor :id, :name, :description, :start_time, :end_time, :location, :venue, :updated_time, :picture, :ticket_uri
-
+        attr_accessor :id, :name, :description, :start_time, :end_time, :location, :venue, :updated_time, :picture, :ticket_uri, :privacy, :owner, :cover
       end
     end
   end

data/lib/mosaic/facebook/graph/post.rb

@@ -2,7 +2,7 @@ module Mosaic
   module Facebook
     module Graph
       class Post < Mosaic::Facebook::Graph::GraphObject
-        attr_accessor :id, :created_time, :to, :message, :type, :link, :picture, :updated_time
+        attr_accessor :id, :created_time, :to, :message, :type, :link, :picture, :updated_time, :source
 
         def comments
           if @comments.is_a?(Hash)

data/lib/mosaic/facebook/version.rb

@@ -1,5 +1,5 @@
 module Mosaic
   module Facebook
-    VERSION = '1.3.0'
+    VERSION = '1.3.1'
   end
 end

metadata

@@ -1,45 +1,20 @@
 --- !ruby/object:Gem::Specification
 name: mosaic-facebook
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
+  prerelease: 
 platform: ruby
 authors:
 - Ajit Singh
 autorequire: 
 bindir: bin
-cert_chain:
-- !binary |-
-  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURNakNDQWhxZ0F3SUJB
-  Z0lCQURBTkJna3Foa2lHOXcwQkFRVUZBREEvTVJBd0RnWURWUVFEREFkcWIy
-  VXUKY0hsdE1SWXdGQVlLQ1pJbWlaUHlMR1FCR1JZR2JXOXpZV2xqTVJNd0VR
-  WUtDWkltaVpQeUxHUUJHUllEWTI5dApNQjRYRFRFek1ETXdOVEU0TVRrME5G
-  b1hEVEUwTURNd05URTRNVGswTkZvd1B6RVFNQTRHQTFVRUF3d0hhbTlsCkxu
-  QjViVEVXTUJRR0NnbVNKb21UOGl4a0FSa1dCbTF2YzJGcFl6RVRNQkVHQ2dt
-  U0pvbVQ4aXhrQVJrV0EyTnYKYlRDQ0FTSXdEUVlKS29aSWh2Y05BUUVCQlFB
-  RGdnRVBBRENDQVFvQ2dnRUJBUGFYbEVtd2JGY0czRnRLSGZOUApXdHpoZ2lJ
-  U0d0S1JnNkFubVdHNkFKcXNSZkNDaDBBUjhlUDRWMURBMFRWM29DRGJoamtp
-  Tjg0QXp0SUMzd1Q2ClpUMGdNWkwra2NwZUdVejFCT21rSmFjcC8zUE9jQUlr
-  VGp1dEFjTXg0N1B0WW5FSkpvd3FUYkJiYTZJYStLZEwKclVEZCtRQ2IzdS9i
-  MGZ4N3o5MmR2ZkZuRFdKY2lMdXlvY0dTT3pUMDBaNWRDSlV6WmNRZzA2eWFH
-  QlVCWlRlUAo4OTRoWXNTT2pwajJOdlpPNnBoVGlxaVZ0cm1hM0VPVVZuVDdL
-  cW5pZWt4QVV5Tk1BeUdhNzBRV243VURkRTNuCnpqb2xvV3NxTmI4bU85NTVj
-  cFdMbWFicTlEOS9XODhkYzNzUVZHK1FlcWNVTHpTTnNBSEt4MDhIZ1ZkdG03
-  a00KNkw4Q0F3RUFBYU01TURjd0NRWURWUjBUQkFJd0FEQWRCZ05WSFE0RUZn
-  UVVKbnZNNFdNcThPT3p5Q2hoSTYwTwpDdWtxQWtNd0N3WURWUjBQQkFRREFn
-  U3dNQTBHQ1NxR1NJYjNEUUVCQlFVQUE0SUJBUUFNalNNVk1uSVV2VVRFClJF
-  RFRYUjAyaGh3ancrb1Zzcks5Tk1YVkJZZDV5VzZ6d1RVa2l2KzI2aHllbk1S
-  dDdVQW85ZGF1WXlEQ2ZSVWcKTDkyK2J0NXZoYzkwRzVPeWREUUFPSCtFWnBH
-  Mkdlc1Fzcy9ya0ZvbTdlY3N6WWV3ZlZXSVhpeVRURWhTeXFyZQp3MGZBN1FZ
-  UmVVSHBlMEpiS1dmRW9CcG5QazRyL2tidHZobXZESklYdnM1TmZ6eVJyU25u
-  S29jRHI1T29RK2lPCldoa2ZabTFyOTgyWTRLWmg4eVI5aVp4QURQSjBVMDJn
-  cWkwT1ZqMjAvRCsvcjJxRkNqV2cwVjAzdTdGNDg2UkwKbkVBa3lXL3NaTjRX
-  Q29RbmpoeDF3MmYrd2FnVURBTzY4L0E1U0kxaUdyZVlRb3VvN1lRS0xNWC9p
-  WlFKYng2QwpzTERtRXdUcgotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg==
-date: 2013-06-07 00:00:00.000000000 Z
+cert_chain: []
+date: 2013-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -47,6 +22,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -54,6 +30,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday_middleware
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -61,6 +38,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -68,6 +46,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_xml
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -75,6 +54,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -82,6 +62,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -89,6 +70,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -96,6 +78,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: debugger
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -103,6 +86,7 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -110,6 +94,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -117,6 +102,7 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -124,6 +110,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -131,6 +118,7 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -138,6 +126,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -145,6 +134,7 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -152,6 +142,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -159,6 +150,7 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -173,11 +165,10 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - Gemfile
+- README.md
 - Rakefile
 - lib/mosaic-facebook.rb
-- lib/mosaic/.DS_Store
 - lib/mosaic/facebook.rb
-- lib/mosaic/facebook/.DS_Store
 - lib/mosaic/facebook/api.rb
 - lib/mosaic/facebook/api/api_object.rb
 - lib/mosaic/facebook/api/notification.rb
@@ -249,26 +240,30 @@ files:
 - spec/vcr/vcr.rb
 homepage: ''
 licenses: []
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -1236313844666775469
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.3.4
 requirements: []
 rubyforge_project: mosaic_facebook
-rubygems_version: 2.0.3
+rubygems_version: 1.8.23
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: gem/plugin to connect to facebook graph api
 test_files:
 - spec/api/notification_spec.rb
@@ -314,4 +309,3 @@ test_files:
 - spec/vcr/fixtures/cassettes/Mosaic_Facebook_Notification/when_no_or_invalid_token_is_passed/should_require_a_valid_access_token.yml
 - spec/vcr/fixtures/cassettes/Mosaic_Facebook_Notification/when_no_or_invalid_token_is_passed/should_require_an_access_token.yml
 - spec/vcr/vcr.rb
-has_rdoc: 

checksums.yaml

@@ -1,15 +0,0 @@
----
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    NjUxMjE5MzBiMzJjODMwN2ZhNGVhYzYzNmRiOTkzNjhiNDg0ZDgwNg==
-  data.tar.gz: !binary |-
-    ZTE1MjZhZjkwYzE3OGMzYTk1ZTc0ODE0MWJjNGZlYWU1NTFkN2VkMA==
-!binary "U0hBNTEy":
-  metadata.gz: !binary |-
-    MDNmNjMxMTRkMmU4YjAwZDZmZjM4NTNjZWZlYzhjOGZhMDEwN2YyNzM1NzA0
-    MzQ4NDNkODJiNjcyNTJhMmRlNzMyMDNjNDZiYjAwNTc2MjlkNmZiZGY0NWVk
-    NWIzNDQyZWJhYzAzZjU4MzU4ZGUwOTQ2YTA1MTBlNzA4MjU0ZmE=
-  data.tar.gz: !binary |-
-    Y2E3MWIzNTQ2MGI0OWIwMmU3Njc2MjQyZWRmZGZjZmNkMDU1NzRiM2ZhNjVi
-    MDZhMzViYWMzZDE0ODBkNzFhZDU3MjhlNmM2ODlhMjU1ZmMyMDNjZmM1NTRi
-    YmM4MGIxMTcwYTU1ZWYzYTUyYjZhZDk4M2EwYjQzYWQ3ODcyZDQ=