Mogli Ruby Open Graph 库技术文档

1. 安装指南

首先，确保您的环境中已经安装了Ruby。然后，使用以下命令安装Mogli库：

gem install mogli

Mogli库依赖于HTTParty库，如果您尚未安装，请使用以下命令安装：

gem install httparty

2. 项目使用说明

Mogli是一个Ruby的Facebook Open Graph库，通过简单的API调用，可以方便地访问和操作Facebook的数据。

以下是一个基本的Rails项目使用Mogli的例子：

在environment.rb文件中添加以下代码来配置Mogli：

config.gem "mogli"

创建一个名为OauthController的控制器，如下所示：

class OauthController < ApplicationController

  def new
    session[:at] = nil
    redirect_to authenticator.authorize_url(:scope => 'publish_stream', :display => 'page')
  end

  def create
    mogli_client = Mogli::Client.create_from_code_and_authenticator(params[:code], authenticator)
    session[:at] = mogli_client.access_token
    redirect_to "/"
  end

  def index
    redirect_to new_oauth_path and return unless session[:at]
    user = Mogli::User.find("me", Mogli::Client.new(session[:at]))
    @user = user
    @posts = user.posts
  end

  def authenticator
    @authenticator ||= Mogli::Authenticator.new('client_id', 'secret', oauth_callback_url)
  end
end

添加相应的路由：

map.resource :oauth, :controller => "oauth"
map.root :controller => "oauth"
map.oauth_callback "/oauth/create", :controller => "oauth", :action => "create"

访问根路径/将重定向到登录页面，然后重定向回您的应用程序以显示最近的帖子。

3. 项目API使用文档

以下是一些Mogli API的基本用法：

从控制台创建一个客户端：

require "rubygems"
require "mogli"
client = Mogli::Client.new("your_access_token")

获取用户信息：

myself = Mogli::User.find("me", client)

或者通过用户ID获取：

mikemangino = Mogli::User.find(12451752, client)

查看帖子：

myself.posts

获取其他对象，例如相册：

album = Mogli::Album.find(99394368305, client)
album.photos

上传照片：

facebook_access_token = "..."
client = Mogli::Client.new(facebook_access_token)
client.post("me/photos", nil, {:source => File.open("myphoto.jpg")})

4. 项目安装方式

Mogli库可以通过Ruby的包管理工具gem进行安装。确保你的系统中已经安装了Ruby和gem工具，然后运行以下命令：

gem install mogli

此命令将自动下载并安装Mogli库以及其依赖项。

请注意，如果你的项目是基于Rails的，你可能还需要在Gemfile文件中添加gem "mogli"，然后执行bundle install命令来安装依赖项。