Skip to content

mikkelsjolin/cordova-digits

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cordova-digits

Cordova plugin for Digits native mobile SDK (https://get.digits.com)

Letting Cordova chat with Digits

Characteristics

Support login and logout for native Digits SDK, with options for customization:

  • accentColor (only for iOs, in android you need to update manually a theme file)
  • backgroundColor (only for iOs, in android you need to update manually a theme file)
  • phoneNumer (pre-populate)
  • title: Custom title in the top navbar (only for iOs)
  • accountFields: used if you want to get only the phone number or also email for example

Installation

cordova plugin add cordova-digits --save --variable FABRIC_API_KEY=your_api_key --variable FABRIC_API_SECRET=your_api_secret

Suported Plaforms

  • iOS
  • Android

Usage

Authenticate

CordovaDigits.authenticate(options, successCallback(result), errorCallback(error))

Example:

var options = {
    accentColor: '#0389D1', //only for iOs
    backgroundColor: '#FFFFFF', //only for iOs
    phoneNumber: '+507', //pre populate with country prefix or phone number
    title: 'YOUR TITLE', //only for iOs
    accountFields: 'defaultOptionMask' //can be email, defaultOptionMask, none
};

CordovaDigits.authenticate(
    options,
    function (result) {

        console.log('[Digits]', 'login result', result);
        //your code

    },
    function (error) {
        console.warn('[Digits]', 'login error', err);
        //your code
    }
);

The result in success callback has the two headers for user verification:

{
  "X-Verify-Credentials-Authorization" : "OAuth oauth_signature="OAUTH_SIGNATURE\",oauth_nonce=\"OAUTH_NONCE\",oauth_timestamp=\"1487784750\",oauth_consumer_key=\"CONSUMER_KEY\",oauth_token=\"OAUTH_TOKEN\",oauth_version=\"1.0\",oauth_signature_method=\"HMAC-SHA1\"",
  "X-Auth-Service-Provider" : "https:\/\/api.digits.com\/1.1\/sdk\/account.json"
}

LogOut

CordovaDigits.logOut();

IsAuthenticated

Get the current digits session if it exists

CordovaDigits.isAuthenticated(successCallback(result), errorCallback(error))

Example:


CordovaDigits.isAuthenticated(
    function (result) {

        console.log('[Digits]', 'user is authenticated', result);
        //your code

    },
    function (error) {
        console.warn('[Digits]', 'user not authenticated', err);
        //your code
    }
);

The result in success callback is similar to the authenticate() method:

onSessionHasChanged

Listener for session updated event, for example when the phone number has changed, more info...

Not tested yet

onSessionExpired

Listener for session expired event, more info...

Not tested yet

Contributors

This plugin is based on ideas and code from other repos:

About

Letting Cordova chat with Digits

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Objective-C 84.7%
  • Swift 8.4%
  • Java 6.0%
  • Other 0.9%