mailgun/validator-demo

Mailgun email address jquery validation plugin http://mailgun.github.io/validator-demo/

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": "[email protected]",
         "domain": "example.com",
         "display_name": ""
     },
     "address": "[email protected]",
     "did_you_mean": null
 }

Demo

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

More information

• Validator API Docs
• Mailgun Blog Announcement

validator-demo's Issues

Selector

Can you add the original selector value? I want to do this:

$('input[type="email"]').mailgun_validator({
api_key: 'pubkey-XXXXXXXXXX',
in_progress: function(){
console.log('MG Validating');
},
success: function(data){
if (!data.is_valid) {
mailgunError($(this).selector, data);
} else {
mailgunSuccess($(this), data);
}
},
error: function(){
}
});

When upgrade to v3

I notes the latest mailgun API is v3, when to upgrade to v3 in your plan?

Thanks.

Exposing API Key to the Public

Am I correct in stating that by putting the API key in a jQuery plugin it'd allow for people to send emails on my behalf provided that they new the domain of the account?

It seems like all they'd have to figure out is the domain which would be in the header information for all the emails sent.

Am I overlooking something or should we really have a client validation API key in addition to a sending email api?

How to Integrate Mailgun with jQuery Validation

It would be helpful if an example of how to integrate Mailgun with jQuery Validation - http://jqueryvalidation.org/ was provided

change instead of focusout?

I know duplicates are caught, but wouldn't running on change instead of focusout be simpler and have a little better performance?

Hyphenated domains are marked invalid

Any domain with a hyphen is marked as invalid, for example: [email protected]

Submit form when email is valid

Hi, I'm using your validator for an email in a form. I can't figure out how to submit the form when the email is valid. I tried with $('#form').submit(); and many other ways but it works only when I click again and the validator doesn't validate because it is the same email.

JS error - success is not defined

A JS error is thrown when the timeout occurs because of an undefined variable here.
https://github.com/mailgun/validator-demo/blob/master/mailgun_validator.js#L100

This was introduced here d0012f4#diff-2058a81314d1963d903b2bfdf54a9773L75

Could the Mailgun API use CORS instead of JSONP?

Currently the server doesn't implement the OPTIONS preflight.

HTML5 constraint validation

It might make sense to use HTML5 constraint validation, in particular setCustomValidity().

See https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/HTML5/Constraint_validation#Constraint_API's_element.setCustomValidity()

Add package.json

I'd like to install with npm.

School Email Address Validation

I have some schools with this email format:

[email protected]
[email protected]
[email protected]

It says the emails are invalid..what is making it invalid, and how can I change it so that the school addresses become valid?

not working for #[email protected]

not working for "#[email protected]"

please check and correct it

validation_error bug in the demo example

It looks like there's a bug with how error validation_error function works.
https://github.com/mailgun/validator-demo/blob/master/index.html#L88

// if email is invalid
      function validation_error(error_message) {
        $('#status').html(error_message);
      }

$('#status').html(error_message); does not fire.

The "Address is invalid." check and error message does work properly, but it is fired inside validation_success function as the last remaining "else" condition.

You can easily test this by removing $('#status').html(error_message); and testing validator. You'll see it still works just fine. This is a problem because if we want to do something else when email is invalid, let's say addClass it does not work.

Provide a minified version and tag releases

We should provide a minified version of the validator script for use on live web sites:
http://www.closure-compiler.appspot.com/home

If we are doing minified scripts, we should also be tagging releases in git so it is easy to download the latest version.
https://help.github.com/articles/creating-releases/

No validation on first call

Hi,

The first call I make to mailgun_validator doesn't really happen. I've checked the network log and there is no validation requests. I then focus on the element that calls the validation, blur and the call is correctly made.

This is my code:

$("#email").blur(validateEmail);

var validateEmail = function() {
    var email = $("#email");
    if (email.val() !== "") {
        email.mailgun_validator({
               api_key: 'XXXXXXX',
               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
        });
};

I have logs in every method and I see that after the first call neither success_callback nor validation_error are called. Any ideas?

Security Issue

Is it really okay to expose our API Key?
e.g. api_key: 'api-key'

Thanks