https://github.com/cjpatoilo/openfb

Facebook integration in JavaScript apps running in the browser and in Cordova.
https://github.com/cjpatoilo/openfb

auth authenticate authentication cordova facebook fb login oauth openfb webview

Last synced: 3 months ago
JSON representation

Facebook integration in JavaScript apps running in the browser and in Cordova.

• Host: GitHub
• URL: https://github.com/cjpatoilo/openfb
• Owner: cjpatoilo
• License: mit
• Created: 2017-06-22T05:47:44.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2023-02-27T01:24:01.000Z (almost 2 years ago)
• Last Synced: 2024-10-16T07:23:33.297Z (3 months ago)
• Topics: auth, authenticate, authentication, cordova, facebook, fb, login, oauth, openfb, webview
• Language: JavaScript
• Homepage: https://cjpatoilo.com/openfb
• Size: 2.76 MB
• Stars: 4
• Watchers: 2
• Forks: 1
• Open Issues: 33
• Metadata Files:
  • Readme: readme.md
  • Contributing: .github/contributing.md
  • Funding: .github/funding.yml
  • License: license

Awesome Lists containing this project

README

        
[![Facebook integration in JavaScript apps running in the browser and in Cordova.](https://repository-images.githubusercontent.com/95079283/9f5a5680-0331-11ea-8e74-3ad837a646a2)](https://github.com/cjpatoilo/openfb)

> Facebook integration in JavaScript apps running in the browser and in Cordova.

[![Travis Status](https://travis-ci.org/cjpatoilo/openfb.svg?branch=master)](https://travis-ci.org/cjpatoilo/openfb?branch=master)

[![AppVeyor Status](https://ci.appveyor.com/api/projects/status/12iw9j8dflj56h6n?svg=true)](https://ci.appveyor.com/project/cjpatoilo/openfb)

[![Codacy Status](https://img.shields.io/codacy/grade/37430abefbc14c488ae768cd4e8f55fe/master.svg)](https://www.codacy.com/app/cjpatoilo/openfb/dashboard)

[![Dependencies Status](https://david-dm.org/cjpatoilo/openfb.svg)](https://david-dm.org/cjpatoilo/openfb)

[![Version Status](https://badge.fury.io/js/openfb.svg)](https://www.npmjs.com/package/openfb)

[![Download Status](https://img.shields.io/npm/dt/openfb.svg)](https://www.npmjs.com/package/openfb)

[![Gitter Chat](https://img.shields.io/badge/gitter-join_the_chat-4cc61e.svg)](https://gitter.im/cjpatoilo/openfb)

## Why it's awesome

OpenFB is an easy way for Facebook integration in JavaScript apps. No dependency. No Facebook plugin. No Facebook SDK. OpenFB allows you to login to Facebook and executes any Facebook Graph API request.

## Getting Started

**Install with npm**

```

$ npm install openfb

```

**Install with Yarn**

```

$ yarn add openfb

```

**Install with Bower**

```

$ bower install openfb

```

## Usage

First step, create a Facebook App:

1. Access https://developers.facebook.com/apps, and in "My Apps" Tab click `Create App`

1. Define a unique name for your app and click `Create App ID`

Second step, create Facebook Login:

1. Click `Set Up` of the "Facebook Login" section

1. Now click on the "Settings" of the "Facebook Login" tab in the sidebar navigation

1. On the "Client OAuth Settings", add the following URLs in the "Valid OAuth Redirect URIs" field:

 - http://localhost:8100/oauthcallback.html (for access using ionic serve)

 - https://www.facebook.com/connect/login_success.html (for access from Cordova)

1. Click Save Changes

1. Now, the `App ID` is available

## Features

- Integrate your JavaScript application with Facebook.

- Works for both BROWSER-BASED apps and CORDOVA apps.

- Login to Facebook.

- Run any Facebook Graph API request.

- No dependency.

- No Facebook SDK.

- No Facebook Cordova plugin.

- No jQuery.

## Extensions

- [Angular](https://github.com/cjpatoilo/openfb/tree/master/packages/angular-openfb)

- [Angular.js](https://github.com/cjpatoilo/openfb/tree/master/packages/ngopenfb)

- [Vanilla](https://github.com/cjpatoilo/openfb)

## Contributing

Want to contribute? Follow these [recommendations](https://github.com/cjpatoilo/openfb/contribute).

## License

Designed with ♥ by [CJ Patoilo](https://twitter.com/cjpatoilo). Licensed under the [MIT License](https://cjpatoilo.com/license).