Socialid.login.automaticFacebookLogin
Renato.neves (Talk | contribs) (→Example) |
Renato.neves (Talk | contribs) (→Description) |
||
| Line 1: | Line 1: | ||
== Description == | == Description == | ||
| − | + | It uses the Facebook Javascript SDK to automatically logs an user if permission has already been given to the social application. | |
| − | + | It's necessary to inform your Facebook application id (check in https://developers.facebook.com/apps/) as a parameter in this API. This Facebook application id should be the same configured in the Facebook social app used in your Social Login application (check in https://app.socialidnow.com/marketing/social_apps). If you don't have your social app configured in the Social-ID platform, you should be using the default application, and the automatic Facebook login does not work in this case. It's recommended to you create an application on Facebook platform and configure it in the Social-ID platform (see [[Facebook Application Settings]]). | |
| − | + | This method can trigger the following events: | |
* [[socialid.events.onLoginSuccess]] | * [[socialid.events.onLoginSuccess]] | ||
* [[socialid.events.onLoginError]] | * [[socialid.events.onLoginError]] | ||
Revision as of 12:49, 4 November 2014
Contents |
Description
It uses the Facebook Javascript SDK to automatically logs an user if permission has already been given to the social application.
It's necessary to inform your Facebook application id (check in https://developers.facebook.com/apps/) as a parameter in this API. This Facebook application id should be the same configured in the Facebook social app used in your Social Login application (check in https://app.socialidnow.com/marketing/social_apps). If you don't have your social app configured in the Social-ID platform, you should be using the default application, and the automatic Facebook login does not work in this case. It's recommended to you create an application on Facebook platform and configure it in the Social-ID platform (see Facebook Application Settings).
This method can trigger the following events:
Usage
socialid.login.automaticFacebookLogin(facebookAppId, callbacks)
Parameters
| facebookAppId | obrigatório | App ID da aplicação do Facebook. Consule sua aplicação aqui: https://developers.facebook.com/apps/. Nota: use o mesmo ID da aplicação social cadastrada no Social Login. | callbacks | opcional | Um objeto contendo handlers para os seguintes tipos de eventos: onConnected, onUnauthorized e/ou onLoggedOut. |
|---|
API Response
Esta API executa diferentes callbacks ou dispara diferentes eventos.
Caso o usuário esteja logado no Facebook e já tenha autorizado sua aplicação social (status "connected" na API do Facebook), um destes dois eventos será disparado:
Além disso, serão executados os callbacks passados como parâmetro nesta API, de acordo com o status do login no Facebook:
- onConnected(accessToken, loginStatus): o usuário está logado no Facebook e autorizou a aplicação social. "accessToken" contém o token de acesso temporário fornecido pelo Facebook e loginStatus contém a resposta da API socialid.login.loginCredentials.
- onUnauthorized(): o usuário está logado no Facebook, mas não autorizou a aplicação social.
- onLoggedOut(): o usuário não está logado no Facebook.
Example
Loga um usuário na sessão atual dado seu access token do Facebook:
var appId = 1, fbAppId = '12345';
socialid.login.init(appId);
socialid.login.automaticFacebookLogin(fbAppId, {
onConnected: onConnected,
onUnauthorized: onUnauthorized,
onLoggedOut: onLoggedOut
});
/* Facebook Login Callbacks */
function onConnected(accessToken, loginStatus) {
alert("You are connected to Facebook with access token: " + accessToken);
if (loginStatus.status != "success") {
alert("There was an error logging you.");
}
}
function onUnauthorized() {
alert("You are logged in to Facebook but have not authorized the application.");
}
function onLoggedOut() {
alert("You are not logged in to Facebook.");
}
/* Login Events */
socialid.events.onLoginSuccess.addHandler(function(data) {
console.log("Website received onLoginSuccess: ", data);
});
socialid.events.onLoginError.addHandler(function(data) {
console.log("Website received onLoginError: ", data);
});
Teste o login automático em nossa aplicação de exemplo: https://sid-examples.herokuapp.com/social_logins/automatic_login
Teste as APIs em nosso playground: https://sid-examples.herokuapp.com/social_logins/playground
