Contents

# FaceGroups Gem

[![Gem Version](https://badge.fury.io/rb/facegroups.svg)](https://badge.fury.io/rb/facegroups)
[![Build Status](https://travis-ci.org/aditya-utama-wijaya/facegroups.svg?branch=master)](https://travis-ci.org/aditya-utama-wijaya/facegroups)

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

```ruby
# 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
```

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
facegroups-0.3.0	README.md
facegroups-0.2.2	README.md
facegroups-0.2.1	README.md
facegroups-0.2.0	README.md