1.0.8 • Published 2 years ago

@berlinsms/phonenumber-validator v1.0.8

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

jQuery PhonenumberValidator

Homepage

Description

A jquery-plugin to verify a phonenumber direct in the formular.

The user can enter his phone number in the form.

BerlinSMS will send a code to this number.

The user receives this code via SMS and has to enter it again on the website.

If the code is correct, the frontend receives a callback and a token.

The token can be used to check the validity in the backend.

Usage

Download bsms-phonenumber-validator.js

https://static.berlinsms.de/toolsforcoder/phonenumber-validator/dist/bsms-phonenumber-validator.min.js

Include jquery and bsms-phonenumber-validator.js

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script src="bsms-phonenumber-validator.min.js"></script>

Find your jquery-container and assign phonenumber-validator

$('.plugin-container').bsmsPhonenumberValidator();    

Make sure, the script is fully loaded, before you assign phonenumber-validator, e.g. use jquerys 'ready'

$(document).ready(function () {
    $('.plugin-container').bsmsPhonenumberValidator();
});    

Add options, if needed:

$(document).ready(()=>{
	$('.phonenumber-validator-container').bsmsPhonenumberValidator({
		countries: { 
			"AT": { name:"�sterreich",  code:"+43"} ,
			"DE": { name:"Deutschland", code:"+49"}, 
			"CH": { name:"Schweiz",     code:"+41"}, 
		}, 
		defaultCountry: "DE"
	});
});   

Add callbacks, if needed:

$(document).ready(function() {
	$('.phonenumber-validator-container').bsmsPhonenumberValidator({
		onSolved:onSolvedCallback
	});
});   
function onSolvedCallback() {
	alert('Phonenumber validated');
}

Options

OptionDESCRIPTIONDEFAULT
inputNamePhonenumberName attribute of a hidden input tag. The plugin adds it to the form and writes the phonenumber into the valuebsms-phonenumber
inputNameTokenName attribute of a hidden input tag. The plugin adds it to the form and writes the challenge token into the valuebsms-challenge-token
countriesDictionary of available countries, each key must be an uniqued identifier of a country, values are dictionaries with name and code of the country{"DE": { name:"Germany", code:"+49"}}
defaultCountryIdentifier of a country that ist initially selected must be a key in the country dictionaryDE
defaultLocalnumberLocalpart of a phonenumber that is initially displayed
twofaSitekeytwofaSitekey given by berlinsms (https://www.berlinsms.de/dokumentation/sitekey-secretkey-generieren/)
onLoadCallback that fires when the validator has loadednull
onSolvedCallback that is triggered when the phonenumber is validatednull
onExpiredCallback triggered when the validation-time expiresnull
onErrorCallback, will be triggered, if something is wrongnull
showCreditsshows creditstrue