0.1.5 • Published 4 years ago

@sendyit/auth v0.1.5

Weekly downloads
77
License
ISC
Repository
gitlab
Last release
4 years ago

Sendy Authentication Plugin

Basic and social authentication components for your frontend applications

Dependencies

  • Vuejs - javascript framework that supports the plugin
  • Axios - used to send http requests to external APIs
  • js-sha1 - used to encrypt passwords before sendng auth request

Please note that all dependencies need to be installed for sendy auth to work properly

Getting Started

To pull sendy authentication plugin into your vue project, use the command

npm i @sendyit/auth

Initializing & Configuring

Initialize the authentication plugin by passing it into the Vue.use() function

import SendyAuth from '@sendyit/auth'

Vue.use(SendyAuth)

The plugin can be configured by passing an options object as a second argument

import SendyAuth from '@sendyit/auth'

Vue.use(SendyAuth, {
    // social authentication driver: 'google'
    // default: google
    driver: 'google',

    // internal authentication url
    authUrl: null,

    // custom configurations for social drivers
    configs: {
        google: {
            // google's client key & identification for gapi
            clientId: ''
        }
    }
})

Usage

The sendy authentication plugin exposes two main components that are automatically injected into the main Vue instance upon initialization

  1. Social Authentication Component sendy-auth-social
  2. Basic Authentication Component sendy-auth-basic

Sendy Authentication Components

Include any of the two components in your .vue files as follows

// social authentication component
<sendy-auth-social><sendy-auth-social>

// basic authentication component
<sendy-auth-basic><sendy-auth-basic>

NOTE: @sendyit/auth does not have support for running both basic and social authentication (yet) so only include one component at a time

CONGRATULATIONS! You have implemented authentication using sendy auth. :)

Sendy Auth API

Sendy auth components can be customised to suite your needs by passing props and listening to events

Props

Social Component API

prop namedefault valuetypeprop description
app-nameSendy Authentication PluginstringSets the application name
button-textLoginstringSets submit button text
loading-textLogging in ...stringSets text shown while processing

Basic Component API

prop namedefault valuetypeprop description
form-headerLog in to SendystringSets the heading on the form
username-placeholderEnter EmailstringSets the placeholder text on the username field
password-placeholderPasswordstringSets the placeholder text on the password field
button-textLoginstringSets submit button text
loading-textLogging in ...stringSets text shown while processing
reset-link#stringSets link to trigger password resets
reset-link-textForgot password?stringSets text shown on the reset link
register-link#stringSets link to trigger registration
register-link-textSign UpstringSets text shown on the registration link
usernameemailstringDetermines the property that will be used as the username
passwordpasswordstringDetermines the property that will be used as the password
themebluestringSets the theme color. Allowed values: 'blue' & 'orange'
encryptfalsebooleanEncrypt the password before sending the payload

Events

The following events are triggered upon execution for both components

event nametypeevent description
authenticatedobjectReturns an object with the token on successful authentication
errorobjectReturns an error object in case authentication failed
0.1.4

4 years ago

0.1.3

4 years ago

0.1.5

4 years ago

0.1.2-beta.3

4 years ago

0.1.2-beta.2

4 years ago

0.1.2-beta.1

4 years ago

0.1.2-beta.0

4 years ago

0.1.1

5 years ago

0.1.0

5 years ago

0.1.0-alpha.3

5 years ago

0.1.0-alpha.2

5 years ago

0.1.0-alpha.1

5 years ago

0.1.0-alpha.0

5 years ago

1.0.0-beta.2

5 years ago

1.0.0-beta.1

5 years ago

1.0.0-beta.0

5 years ago

0.0.2-beta.2

5 years ago

0.0.2-beta.1

5 years ago

0.0.2-beta.0

5 years ago

0.0.1-beta.2

5 years ago

0.0.1-beta.1

5 years ago