react-facebook-auth
Version:
A Component React for Facebook authentication
77 lines (66 loc) • 4.38 kB
Markdown
[](https://travis-ci.org/ionutmilica/react-facebook-auth)
[](https://www.npmjs.com/package/react-facebook-auth)
[](https://codecov.io/gh/ionutmilica/react-facebook-auth)
Allows developers to receive a facebook authentication token that can be used by a backend service.
To install the latest version:
```
npm install --save react-facebook-auth
```
or
```
yarn add react-facebook-auth
```
```js
import React from 'react';
import ReactDOM from 'react-dom';
import FacebookAuth from 'react-facebook-auth';
const MyFacebookButton = ({ onClick }) => (
<button onClick={onClick}>
Login with facebook
</button>
);
const authenticate = (response) => {
console.log(response);
// Api call to server so we can validate the token
};
const App = () => (
<div>
<h1>Facebook Auth</h1>
<FacebookAuth
appId="<app-id>"
callback={authenticate}
component={MyFacebookButton}
/>
</div>
);
ReactDOM.render(
<App />,
document.getElementById('root'),
);
```
A full example can be found in [examples](https://github.com/ionutmilica/react-facebook-auth/tree/master/example) directory.
| Params | Type | Info |
|-----------------|----------|-------------------------------------------------------------------------------------------------------------------------|
| appId | string | Facebook application id. Check https://developers.facebook.com |
| scope | string | Comma separated list of extended permissions |
| fields | string | name,email,picture |
| callback | function | Callback triggered when we receive a response from facebook. |
| onFailure | function | If provided, will be triggered on failed requests. |
| returnScopes | boolean | When true, the granted scopes will be returned in a comma-separated list in the grantedScopes field of the authResponse |
| autoLoad | boolean | Defaults to: false |
| xfbml | boolean | Defaults to: false |
| cookie | boolean | Defaults to: false |
| reAuthenticate | boolean | Asks the person to re-authenticate unconditionally. Defaults to: false |
| reRequest | boolean | Asks the person again for revoked permissions. Defaults to: false |
| redirectUri | string | Defaults to: '/' |
| version | string | Facebook SDK version. Defaults to: 2.8 |
| language | string | Defaults to: en_US |
| disableRedirect | boolean | Defaults to: false |
| customProps | object | Allows custom props passing to the custom element. |
| component | node | Custom react element that returns a button element. |
MIT