Skip to content

mailgun/validator-demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Advanced jQuery Email Address Validator by Mailgun

Given an arbitrary address, Mailgun will validate the address based on:

  • Syntax checks (RFC defined grammar)
  • DNS validation
  • Spell checks
  • Email Service Provider (ESP) specific local-part grammar (if available)

How to use the email validator on your form

  1. Include jQuery
  2. Include mailgun_validator.js
  3. Sign up for a Mailgun account and insert your public API key
  4. Attach mailgun_validator() function to the email field you want validated
  5. Decide what should happen for valid emails, invalid emails and suggestions

Attaching to a form field:

   $('jquery_selector').mailgun_validator({
       api_key: 'api-key',
       in_progress: in_progress_callback, // called when request is made to validator
       success: success_callback,         // called when validator has returned
       error: validation_error,           // called when an error reaching the validator has occured
   });

Sample JSON in success callback:

 {
     "is_valid": true,
     "parts": {
         "local_part": "john.smith@example.com",
         "domain": "example.com",
         "display_name": ""
     },
     "address": "john.smith@example.com",
     "did_you_mean": null
 }

Demo

http://mailgun.github.io/validator-demo/

More information