LOGIN – FACEBOOK SDK PHP #2

Continuando com nossa série de postagens sobre a API SDK em PHP do Facebook, hoje mostrei como implementar um sistema de login com o Facebook com permissões.

Se você não viu o post anterior, do qual há uma introdução, clique aqui.

Permissões:

Bom, para o login de usuários em seu site, são necessários permissões concebidas por esse usuário à sua aplicação. Essas permissões servem para usar diferentes recursos, como postagens no mural, informações do usuário, informações dos amigos dos usuários etc.
Por exemplo: sua aplicação vai, ao se cadastrar, usar o e-mail do usuário, ao realizar determinada ação em seu site, uma postagem no mural do usuário etc.

A lista com todas as permissões se encontra aqui: https://developers.facebook.com/docs/reference/login/

Login:

O login depende de uma URL gerada pelo Facebook de acordo com as permissões requisitadas pela aplicação:

$permissions = 'email, publish_stream';
$redirect_uri = 'http://meusite.com/singup';//Página de retorno após o login

$parameters = [
    'scope' => $permissions,
    'redirect_uri' => $redirect_uri,
    'display' => 'popup'
];

$loginUrl = $fb->getLoginUrl( $parameters );

Logout:

O Facebook também fornece a opção de logout no próprio Facebook:

$next = 'http://meusite.com';

$parameters = [ 'next' => $next ];

$logoutUrl = $fb->getLogoutUrl( $parameters );

mas se o logout for somente acontecer na sua aplicação, a função BaseFacebook::destroySession() destrói todas as sessions usadas pelo Facebook:

$fb->destroySession();
header( 'Location: http://meusite.com' );

Implementando:

Com esses recursos, o código ficaria mais ou menos assim:

$appConfig = [
    'appId' => 'APP_ID',
    'secret' => 'APP_SECRET'
];

$fb = new Facebook( $appConfig );

/**
 * @return ID do usuário logado ou verifica se está logado
*/
$user = $fb->getUser();

if( $user ){
    try{
        //Operações com usuário logado
        echo '<a href="' . $logoutUrl . '">Logout</a>';
    }catch( FacebookApiException $e ){
        $logoutUrl = '/logout.php';
        header( 'Location: ' . $logoutUrl );
    }
}else{
    $permissions = 'email, publish_stream';
    $redirect_uri = 'http://meusite.com/singup';//Página de retorno após o login

    $parameters = [
        'scope' => $permissions,
        'redirect_uri' => $redirect_uri,
        'display' => 'popup'
    ];

    $loginUrl = $fb->getLoginUrl( $parameters );

    echo '<a href="' . $loginUrl . '">Login</a>';
}

Ao clicar em login, algo do tipo irá aparecer para o usuário:

Bem, no post de hoje é isso. No próximo mostrarei como fazer postagens na timeline do usuário logado. 😀

INTRODUÇÃO – FACEBOOK SDK PHP #1

Nesse post vou falar sobre a Facebook SDK PHP, a API em PHP do Facebook.

Uma breve explicação do próprio Facebook sobre do que se trata essa SDK:

O SDK do Facebook para PHP permite aos desenvolvedores implementar um rico conjunto de funcionalidades do lado do servidor para acessar a API do Facebook. Isso inclui acesso a todos os recursos da API Graph e FQL. Ele também trabalha em conjunto com o JavaScript SDK para ajudar a implementar o login com o Facebook.

O SDK é tipicamente utilizado para realizar operações como um administrador aplicação, mas também pode ser utilizado para realizar operações em nome do utilizador actual sessão. Ao eliminar a necessidade de gerenciar tokens de acesso manualmente, o SDK simplifica muito o processo de autenticação e autorização de usuários para seu aplicativo.

Para a utilização dessa API é necessário ter um aplicativo cadastrado na sessão de desenvolvedores do Facebook, mas especificamente aqui: http://developers.facebook.com

Instalando:

A instalação pode ser feita por Composer:

{
    "require": {
        "facebook/php-sdk":"*"
    }
}

ou pelo repositório no GitHub do Facebook.

Utilizando:

Para utilizar é necessário duas chaves de acesso que estão no painel do App:

Depois disso, a instancia da API ocorre da seguinte maneira:

use Libs\FacebookSDK\Facebook;

$appConfig = [
    'appId' => 'APP_ID',
    'secret' => 'APP_SECRET'
];

$fb = new Facebook( $appConfig );

No próximo post sobre essa API, irei mostrar como fazer o login de usuários.