Skip to content
This repository has been archived by the owner on Nov 29, 2019. It is now read-only.

AccountKit Plugin for Apache Cordova which allows you to add passwordless email and SMS authentication to your app

License

Notifications You must be signed in to change notification settings

gurisko/cordova-plugin-accountkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

npm version

Cordova AccountKit Plugin

The Apache Cordova wrapper around the Facebook AccountKit.

Installation

  1. Create Facebook Developer Account
  2. Get a Facebook App ID (APP_ID)
  3. Get an AccountKit client token (CLIENT_TOKEN)
  4. To install the plugin in your app, execute the following (replace variables where necessary):
cordova plugin add cordova-plugin-accountkit --save \
   --variable APP_ID="123456789" \
   --variable APP_NAME="myApplication" \
   --variable CLIENT_TOKEN="abcdefghijklmnopqrstuvwxyz" \
   --variable API_VERSION="v1.1"

If you need to change your APP_ID after installation, it's recommended that you remove and then re-add the plugin as above. Note that changes to the APP_ID value in your config.xml file will not be propagated to the individual platform builds.

Additional Steps

If you want to use Access Tokens flow with this plugin, you have to set Enable Client Access Token Flow in your app's dashboard to ON (for more information on Client Access Token Flow, see Access Tokens and Authorization Codes).

Android

It is recommended to add these permission to config.xml of your Cordova project to reduce the friction during the login process (more info):

<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

API

Login with an email address

AccountKitPlugin.loginWithEmail(Object options, Function success, Function failure)

Available options:

{
	useAccessToken: true,
	defaultCountryCode: "US",
	facebookNotificationsEnabled: true,
	initialEmail: "[email protected]"
}

Available country codes can be found here.

Success function returns an Object like:

{
	accountId: "<string>",
	applicationId: "<string>",
	token: "<long string>",
	lastRefresh: 1451606400,
	refreshInterval: 2592000
}

If you do not use access tokens an Object looks like:

{
	code: "<long string>",
	state: "<string>"
}

Failure function returns an error String.

Login with a phone number

AccountKitPlugin.loginWithPhoneNumber(Object options, Function success, Function failure)

Available options:

{
	useAccessToken: true,
	defaultCountryCode: "US",
	facebookNotificationsEnabled: true,
	initialPhoneNumber: ["420", "123456789"]
}

Available dialing codes and country codes can be found here.

Success function returns an Object like:

{
	accountId: "<string>",
	applicationId: "<string>",
	token: "<long string>",
	lastRefresh: 1451606400,
	refreshInterval: 2592000
}

If you do not use access tokens an Object looks like:

{
	code: "<long string>",
	state: "<string>"
}

Failure function returns an error String.

Logout

AccountKitPlugin.logout()

Get account

This method only works when login method was called with { useAccessToken: true }.

AccountKitPlugin.getAccount(Function success, Function failure)

Success function returns an Object like:

{
	accountId: "<string>",
	applicationId: "<string>",
	token: "<long string>",
	lastRefresh: 1451606400,
	refreshInterval: 2592000,
	email: "<string>",
	phoneNumber: "<string>"
}

About

AccountKit Plugin for Apache Cordova which allows you to add passwordless email and SMS authentication to your app

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •