October 6, 2016: Fixed issue where top-level domains were not correctly validated. Props Robert!
May 24, 2016: Fixed issue where configured fields were validated on every page submission rather than only when the page that contains them was submitted.
September 30, 2015: Fixed issue where spaces after the email would cause validation to fail.
April 2, 2015: Fixed issue where if domain check was case-sensitive.
October 1, 2014: Added support for limiting by top-level domain (i.e. ".co.uk", ".edu", etc)
Want to ban users from entering test@test.com and spamming your registration form? Want to only allow users with your companies email address to signup (i.e. jane@yourcompany.com). This snippet will let you do both!
| <?php | |
| /** | |
| * Gravity Wiz // Gravity Forms // Email Domain Validator | |
| * | |
| * This snippets allows you to exclude a list of invalid domains or include a list of valid domains for your Gravity Form Email fields. | |
| * | |
| * @version 1.4 | |
| * @author David Smith <david@gravitywiz.com> | |
| * @license GPL-2.0+ | |
| * @link http://gravitywiz.com/banlimit-email-domains-for-gravity-form-email-fields/ | |
| */ | |
| class GW_Email_Domain_Validator { | |
| private $_args; | |
| function __construct($args) { | |
| $this->_args = wp_parse_args( $args, array( | |
| 'form_id' => false, | |
| 'field_id' => false, | |
| 'domains' => false, | |
| 'validation_message' => __( 'Sorry, <strong>%s</strong> email accounts are not eligible for this form.' ), | |
| 'mode' => 'ban' // also accepts "limit" | |
| ) ); | |
| // convert field ID to an array for consistency, it can be passed as an array or a single ID | |
| if($this->_args['field_id'] && !is_array($this->_args['field_id'])) | |
| $this->_args['field_id'] = array($this->_args['field_id']); | |
| $form_filter = $this->_args['form_id'] ? "_{$this->_args['form_id']}" : ''; | |
| add_filter("gform_validation{$form_filter}", array($this, 'validate')); | |
| } | |
| function validate($validation_result) { | |
| $form = $validation_result['form']; | |
| foreach($form['fields'] as &$field) { | |
| // if this is not an email field, skip | |
| if(RGFormsModel::get_input_type($field) != 'email') | |
| continue; | |
| // if field ID was passed and current field is not in that array, skip | |
| if($this->_args['field_id'] && !in_array($field['id'], $this->_args['field_id'])) | |
| continue; | |
| $page_number = GFFormDisplay::get_source_page( $form['id'] ); | |
| if( $page_number > 0 && $field->pageNumber != $page_number ) { | |
| continue; | |
| } | |
| if( GFFormsModel::is_field_hidden( $form, $field, array() ) ) { | |
| continue; | |
| } | |
| $domain = $this->get_email_domain($field); | |
| // if domain is valid OR if the email field is empty, skip | |
| if($this->is_domain_valid($domain) || empty($domain)) | |
| continue; | |
| $validation_result['is_valid'] = false; | |
| $field['failed_validation'] = true; | |
| $field['validation_message'] = sprintf($this->_args['validation_message'], $domain); | |
| } | |
| $validation_result['form'] = $form; | |
| return $validation_result; | |
| } | |
| function get_email_domain( $field ) { | |
| $email = explode( '@', rgpost( "input_{$field['id']}" ) ); | |
| return trim( rgar( $email, 1 ) ); | |
| } | |
| function is_domain_valid( $domain ) { | |
| $mode = $this->_args['mode']; | |
| $domain = strtolower( $domain ); | |
| foreach( $this->_args['domains'] as $_domain ) { | |
| $_domain = strtolower( $_domain ); | |
| $full_match = $domain == $_domain; | |
| $suffix_match = strpos( $_domain, '.' ) === 0 && $this->str_ends_with( $domain, $_domain ); | |
| $has_match = $full_match || $suffix_match; | |
| if( $mode == 'ban' && $has_match ) { | |
| return false; | |
| } else if( $mode == 'limit' && $has_match ) { | |
| return true; | |
| } | |
| } | |
| return $mode == 'limit' ? false : true; | |
| } | |
| function str_ends_with( $string, $text ) { | |
| $length = strlen( $string ); | |
| $text_length = strlen( $text ); | |
| if( $text_length > $length ) { | |
| return false; | |
| } | |
| return substr_compare( $string, $text, $length - $text_length, $text_length ) === 0; | |
| } | |
| } | |
| class GWEmailDomainControl extends GW_Email_Domain_Validator { } | |
| # Configuration | |
| new GW_Email_Domain_Validator( array( | |
| 'form_id' => 326, | |
| 'field_id' => 1, | |
| 'domains' => array( 'gmail.com', 'hotmail.com', '.co.uk' ), | |
| 'validation_message' => __( 'Oh no! <strong>%s</strong> email accounts are not eligible for this form.' ), | |
| 'mode' => 'limit' | |
| ) ); |
How do I install this snippet?
Easy peasy. Just copy and paste the code above into your theme's functions.php file.
How do I use this functionality?
All you need to do is create a new instance of the GWEmailDomainControl() class, populated with your specific details, like so:
| new GWEmailDomainControl(array( | |
| 'form_id' => 152, | |
| 'field_id' => 9, | |
| 'domains' => array('gmail.com', 'hotmail.com', 'test.com') | |
| )); |
By default, the form will “ban” the specified email domains; however, you can also limit by the specified domains by passing limit for the mode argument. The example below demonstrates this as well as how to apply the email domain control to two specific fields by passing an array of field IDs for the field_id argument:
| new GWEmailDomainControl(array( | |
| 'form_id' => 152, | |
| 'field_id' => 9, | |
| 'domains' => array('gmail.com', 'hotmail.com', 'test.com'), | |
| 'mode' => 'limit' | |
| )); |
To apply this functionality to ALL fields on a form, do not pass the field_id argument at all.
| new GWEmailDomainControl(array( | |
| 'form_id' => 152, | |
| 'domains' => array('gmail.com', 'hotmail.com', 'test.com') | |
| )); |
Here is a full list of available options:
| new GWEmailDomainControl(array( | |
| 'form_id' => 152, | |
| 'field_id' => 9, // multiple field IDs can be passed as an array: array(8,9) | |
| 'domains' => array('gmail.com', 'hotmail.com', 'test.com'), | |
| 'validation_message' => __('Oh no! <strong>%s</strong> email accounts are not eligible for this form.'), | |
| 'mode' => 'ban' // also accepts "limit" | |
| )); |
form_idThe form ID of the form you would like to apply this functionality to. If you want to apply the the same email domain control to all forms, simply do not pass theform_idargument at all.field_idThe field ID for which this email domain control should be applied. If you would like to apply the same control to multiple fields you can pass an array of field IDs:'field_id' => array(8,12,15). If you want this to apply to all fields on a form, simply do not pass thefield_idargument at all.domainsAn array of email domains that should be banned or limited to depending on whatmodeyou have set.validation_messageThe message which will be displayed below the email field if the submitted email contains an invalid domain. You can use%sanywhere in the message to output the invalid domain.modeBy default, this is set tobanwhich will mark any of the specified domains as invalid if they are submitted in the email field. You can also pass alimitmode. In this mode, the specified domains are the only valid domains. All other domains will be marked as invalid.
Did this resource help you do something awesome with Gravity Forms? Then you'll absolutely love Gravity Perks; a suite of 33+ essential add-ons for Gravity Forms with support you can count on.
Hello! How I can multiple forms to form_id param?
Hey West, we have a handy tutorial written for this: https://gravitywiz.com/documentation/apply-class-based-snippet-different-forms/
TLDR; just create a new instance for each form. 🙂
Oh … finally figured out why I was getting a PHP fatal error every time I pasted the code into my functions.php file … I was copying and pasting the short snippet of code from where it says
“All you need to do is create a new instance of the GWEmailDomainControl() class, populated with your specific details, like so:”
But what I didn’t realise is that I had missed all the code hidden in the “Show Code” section!
Suggestion – could you make it clearer that there is a lot more code than what is shown in the post?
e.g. change this: How do I install this snippet? Easy peasy. Just copy and paste the code above into your theme’s functions.php file.
to this: How do I install this snippet? Easy peasy. Just click “show code” above, then copy and paste that code above into your theme’s functions.php file.
And change this: How do I use this functionality? All you need to do is create a new instance of the GWEmailDomainControl() class, populated with your specific details, like so:
To this:
How do I use this functionality? After you have inserted the code above into your functions.php file, all you need to do is create a new instance of the GWEmailDomainControl() class, populated with your specific details, like so:
Hi Josh,
Thanks for the feedback. I’ll forward your suggestion for a proposal to review and update the document.
Best
Is this possible to have a wildcard of subdomain?
new GW_Email_Domain_Validator( array( ‘form_id’ => 2, ‘field_id’ => 4, ‘domains’ => array( ‘*.domain.com.au’ ), ‘mode’ => ‘limit’ ) );
Hi Steve,
Subdomains like this “domain.com.au” are actually supported. If the mode is set to limit, the snippet will only allow email addresses within the subdomain specified in the domain array parameter but you will exclude the wildcard and dot. Something like this should work
new GW_Email_Domain_Validator( array( 'form_id' => 2, 'field_id' => 4, 'domains' => array( 'domain.com.au' ), 'mode' => 'limit' ) );Best,
Does this work on domains containing two dots? We have students who are on ‘student.organisation.tld’.
Hi Filip,
It should work with domains containing two dots.
Best,
Hello. I’ve used the code successfully for a single form. I wanted to use the same functionality for 3 similar forms with 3 different IDs. I tried using an array for the declaration and if statements that required the form id, but the “banned emails” did not filter. What should i do instead? Thank you so much!
I was thinking on copying all the codes 3 times for each form ID but that sounds like a bit of a hassle.
Hi Ana,
You can create multiple instances of the snippet configuration to target 3 different forms. Here is an article on how to do that: https://gravitywiz.com/documentation/apply-class-based-snippet-different-forms/
Best,
Hi Ana,
Did you find a solution? I have tried multiple variations on this and it seems to read/verify the last form entry.
Hi Carlos,
If you’re a Gravity Perks Subscriber, you can get in touch with us via our Support Form, with form exports and additional information on what you’re trying to achieve so we can assist you.
Best,
Is there a way to form this same function but instead for a single line text field?
Hi Mark,
That’s a great fit for GF Blacklist. You can use it to reject submissions for any field that matches a list of blocked words, phrases, or IPs.
So by just changing the field ID this function code will work with single text field inputs?
Hello Mark, You would need to change the form ID, Field ID and specify what domain you are looking to ban, then the functionality should work correctly for your use case.
this is brilliant, and thank you sincerely for it. I’ve created an admin form with a field in options table for a comma delimited list (e.g. domain.one, domain.two) – I want to use that list as my domains list. I have (via get_option) a string (domain.one, domain.two)… and in GWE array set ‘domains’ => $mystring. But it doesn’t work – ignore the domains entirely. I tried exploding the string to an arrray, still nothing. Any advice on how to get a string from WP_OPTIONS table to be the domains list? Even if not, thank you deeply for such a useful bit of code :)
Ok… I got it sorted… code in case it helps anyone.
https://snippi.com/s/yg7r42h
Cheers.