1.0.6 • Published 2 years ago

react-facebook-connect v1.0.6

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

React Facebook Connect

A React Component for Facebook Connect. This project was inspired by https://github.com/keppelen/react-facebook-login. Using more up to date react with functional components, hooks and typescript. Support both commonJS and EcmaScript modules.

Getting Started

  • yarn add react-facebook-connect or npm install react-facebook-connect
  • Your application will also need react-dom and react installed.

Development

git clone https://github.com/aviranbergic/react-facebook-connect.git && cd react-facebook-connect
npm install react react-dom react-facebook-connect --save --force
npm start

How to use

Basic Button

import FacebookConnect, { FacebokLoginResult } from 'react-facebook-connect';

const callbackHandler = (result: FacebokLoginResult | string) => {
  console.log(result);
}

<FacebookConnect appId='1138330606726062'
                 fields='name,email,picture' 
                 callback={callbackHandler} 
                 xfbml buttonSize='medium'
                 vairant='primary'
                 buttonText='Continue With Facebook'
                 ariaLabel='Continue With Facebook'
                 /> 

Override button with costum styling

You can provide your own custom styling + Icon (non mandatory).

import FacebookConnect, { FacebokLoginResult } from 'react-facebook-connect';
import { SomeIcon } from './SomeIcon'

const callbackHandler = (result: FacebokLoginResult | string) => {
  console.log(result);
}

const style = {
    width: '500px',
    color: 'white',
    backgroundColor: 'blue'
}

<FacebookConnect appId='1138330606726062'
                 fields='name,email,picture' 
                 callback={callbackHandler} 
                 customStyle={style} 
                 Icon={<SomeIcon/>} 
                 buttonText='Continue With Facebook' /> 

Passing Children

If You need to add more layers to the button.

buttonText and children cannot be used at the same time

import FacebookConnect, { FacebokLoginResult } from 'react-facebook-connect';

const callbackHandler = (result: FacebokLoginResult | string) => {
  console.log(result);
}

<FacebookConnect appId='1138330606726062' 
                 fields='name,email,picture' 
                 callback={callbackHandler}> 
<div> Connect With Facebook </div>
</ FacebookConnect>

Custom permission

By default the component, request only 'public_profile' permission, you can change if you send 'scope', that is a string comma separated attribute.

see https://developers.facebook.com/docs/facebook-login/permissions for permissions list

import FacebookConnect, { FacebokLoginResult } from 'react-facebook-connect';

const callbackHandler = (result: FacebokLoginResult | string) => {
  console.log(result);
}

<FacebookConnect appId='1138330606726062'
                 fields='name,email,picture' 
                 callback={callbackHandler} 
                 xfbml 
                 buttonSize='medium' 
                 vairant='primary'
                 scope='public_profile,user_friends,user_actions.books'> 
                 Connect With Facebook 
</ FacebookConnect>