Faceboo

Integrate Facebook SDK into Silex micro-framework (FacebookServiceProvider) or Symfony2 (FacebooBundle)., _(*1)

Provide several methods to do common tasks with Facebook. * authentification * permissions management * fan-gate management, _(*2)

Installation

Add faceboo to your dependencies using composer:, _(*3)

php composer.phar require "pitpit/faceboo":"2.0.*@dev"

To use Faceboo with Silex <= 1.0, please use:, _(*4)

php composer.phar require "pitpit/faceboo":"1.0.*@dev"

Parameters

app_id: App ID
secret: App Secret
permissions: array of facebook oAuth permissions needed for the app
namespace: App namespace
canvas: true if the app is called through facebook iframe
proxy: to make facebook requests work behind non-transparent proxy
timeout: ...
connect_timeout: ...
protect: true|false, disable the redirection when accessing the server, in canvas mode

Usage

Silex

Register the namespace and the extension, in top of index.php:, _(*5)

$app->register(new Faceboo\Provider\FacebooServiceProvider(), array(
    'faceboo.app_id' => 'xxx',
    'faceboo.secret' => 'xxx'
));

See above for a complete list of avalaible parameters., _(*6)

Login and ask user for Facebook oAuth permissions:, _(*7)

$app['faceboo.permissions'] = array();

$app->match('/', function () use ($app) {

    if ($response = $app['faceboo']->auth()) return $response;

    //...
});

In canvas mode, protect your canvas app from direct access to the source server:, _(*8)

$app->before(function(Request $request) use ($app) {
    if ($response = $app['faceboo']->protect()) return $response;
});

* do not rely on it, it's based on HTTP_REFERER so it's not really secured

In a fan page tab, is the current user admin of the fan page :, _(*9)

$app->match('/', function () use ($app) {

    $isAdmin = $app['faceboo']->isFanPageAdmin();

    //...
}

* you need to define "secret" parameter

In a fan page tab, what is the fan page id :, _(*10)

$app->match('/', function () use ($app) {

    $pageId = $app['faceboo']->getFanPageId();

    //...
}

* you need to define "secret" parameter

In a fan page tab, does the current user like the fan page :, _(*11)

$app->match('/', function () use ($app) {

    $isFan = $app['faceboo']->isFan();

    //...
}

* you need to define "secret" parameter

Get the current facebook user id:, _(*12)

$app['faceboo']->getUser();

Call the Facebook api:, _(*13)

$data =  $app['faceboo']->api('/me);

Symfony2

Register the bundle in app/AppKernel.php:, _(*14)

    $bundles = array(
        //...
        new Faceboo\FacebooBundle\FacebooFacebooBundle(),
    );

Add the following in app/config/config.yml:, _(*15)

faceboo:
    app_id: 297720976910223
    secret: b151a27351e91dab2ee18986d8c47052

See above for a complete list of avalaible parameters., _(*16)

Login and ask user for permissions if needed:, _(*17)

public function indexAction()
{
    if ($response = $this->get('faceboo')->auth()) return $response;

    //...
}

TODO

developp permissions authorization on website mode
get rid of SilexEvent dependency to make it work with Symfony
In canvas mode, override UrlGenerator to have the canvas URL when generate() is called with $absolute = true
fan page
- does the user like the fan page ?
- route according to local

, _(*18)