A simple Angular module to abstract Social Login (Facebook, Twitter, Google, ...)
To see the library in action use this JSFiddle Demo (but attention, facebook login inside jsfiddle environment doesn't work properly if you use chrome).
- Twitter (..future)
You can install this package locally either with npm or bower
$ bower install htauth --save
$ npm instal htauth --save
You can also download and include the library file (full or minified) available in the /dist directory.
angular
.module('testapp', ['htauth'])
.config(['htauth.facebookProvider', function(facebookProvider) {
facebookProvider.init({
appId: '174327009577654', //my app id
locale: 'it_IT' // I'm a proud italian.
})
}])
.controller('testFacebook', [
'htauth.facebook',
function(facebook) {
// you can use:
// facebook.login()
// facebook.isLogged()
// facebook.getAuthResponse()
// facebook.getAccessToken()
//NB: the provider automatically check if the user is already logged in your app
// therefore a common flow may be
//.. your code
if(!facebook.isLogged())
facebook.login().then(function(authResponse){
// use authResponse.accessToken
});
else {
// use facebook.getAuthResponse()
// or simply facebook.getAccessToken()
}
//.. your code
}
]);Settings for provider configuration are described in Facebook Official Documentation (here and here).
// Default settings are
{
appId: false, // specify your APP ID
cookie: true,
locale: "en_US",
status: true,
version: "v2.5",
xfbml: false,
scope: "public_profile,email"
}angular // include htauth as dependecy
.module('YourAPP', ['htauth'])
.config(['htauth.facebookProvider', function(facebookProvider){
// configure the facebookProvider with init settings
// init settings are the same as Facebook Documentation
// more info here: https://developers.facebook.com/docs/javascript/reference/FB.init/v2.5
facebookProvider.init({
appId : '174327009577654', // your app id
locale: 'it_IT' // default locale is en_us
})
}])A Promise function that resolves when user correctly login to the App and reject if the user does not authorize your app or is not logged to facebbok.
angular
// ...something
.controller('yourController', [
'htauth.facebook',
function(facebook) {
//... code
// open the facebook login modal
// and get auth response as a promise
facebook.login()
.then(function(authResponse) {
// user logged in, authResponse is
// the object coming from Facebook
// authResponse.accessToken may be useful
})
.catch(function(error) {
// handle error;
});
//... code
}
}
]);true if the user is logged in false otherwise
get the AuthResponse Object coming from Facebook sdk (if the user is logged in)
get the accessToken (same as getAuthResponse().accessToken) if the user is logged in
angular
.module('testapp', ['htauth'])
.config(['htauth.googleProvider', function(googleProvider) {
googleProvider.init({
client_id: '725412889739-g3iihggrd9ut7m9d8qhs65lal6k8v9q7.apps.googleusercontent.com' // my app id
})
}])
.controller('testGoogle', [
'htauth.google',
function(google) {
// you can use:
// google.login()
// google.isLogged()
// google.getAuthResponse()
// google.getIdToken()
//NB: the provider automatically check if the user is already logged in your app
// therefore a common flow may be
//.. your code
if(!google.isLogged())
google.login().then(function(authResponse){
// use authResponse (the same object coming from google APIS)
});
else {
// use google.getAuthResponse()
// or simply google.getIdToken()
}
//.. your code
}
]);Settings for provider configuration are described in Google Official Documentation (here).
// Default settings are the same as Google init
{
client_id: false, // specify your APP ID
cookie_policy: 'single_host_origin',
fetch_basic_profile: true, // scope is profile, email
scope: // optional if fetch_basic_profile is true
}angular // include htauth as dependecy
.module('YourAPP', ['htauth'])
.config(['htauth.googleProvider', function(googleProvider){
// configure the googleProvider with init settings
// init settings are the same as Google Documentation
// more info here: https://developers.google.com/identity/sign-in/web/reference?hl=it#gapiauth2initwzxhzdk19paramswzxhzdk20)
googleProvider.init({
client_id: '725412889739-g3iihggrd9ut7m9d8qhs65lal6k8v9q7.apps.googleusercontent.com' // your app id here
})
}])A Promise function that resolves when user correctly login to the App and reject if the user does not authorize your app or is not logged to google.
angular
// ...something
.controller('yourController', [
'htauth.google',
function(google) {
//... code
// open the facebook login modal
// and get auth response as a promise
google.login()
.then(function(authResponse) {
// user logged in, authResponse is
// the object coming from Google
// authResponse.id_token may be useful
})
.catch(function(error) {
// handle error;
});
//... code
}
}
]);true if the user is logged in false otherwise
get the AuthResponse Object coming from Google sdk (if the user is logged in)
get the id_token (same as getAuthResponse().id_token) if the user is logged in
TODO
TODO
MIT © Andrea Tarquini aka @h4t0n