FaceGroups Gem

Gem Version Build Status

FaceGroups is a gem that specializes in getting data from public Facebook Groups.

Installation

If you are working on a project, add this to your Gemfile: gem 'facegroups'

For ad hoc installation from command line: $ gem install facegroups

Setup Facebook Credentials

Please setup your Facebook developer credentials by creating an app profile on Facebook Developer: https://developers.facebook.com - you should get a "client ID" and "client secret".

Usage

Require FaceGroups gem in your code: require 'facegroups'

Supply your Facebook credentials to our library in one of two ways:

  • Setup environment variables: ENV[FB_CLIENT_ID] and ENV[FB_CLIENT_SECRET]
  • or, provide them directly to FaceGroups:
FaceGroups::FbApi.config = {
  client_id: ENV[FB_CLIENT_ID],
  client_secret: ENV[FB_CLIENT_SECRET]
}

See the following example code for more usage details:

# Access the group
group = FaceGroups::Group.find(id: ENV['FB_GROUP_ID'])

puts group.name

feed = group.feed

puts feed.count

group.feed.postings.each do |posting|
  puts posting.id
  puts posting.created_time
  puts posting.message
  if posting.attachment
    puts posting.attachment.description
    puts posting.attachment.url
  end
end