Email address validation for user registrations, custom forms and more.

This plugin requires Craft CMS 3.0.0, or later.

Log into your control panel and click on 'Plugin Store'. Search for 'Email Validator'.

1. Open your terminal and go to your Craft project:

cd /path/to/project

2. Then tell Composer to load the plugin:

composer require lukeyouell/craft-emailvalidator

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Email Validator.

You can toggle which checks are enforced by updating the plugin settings.

The following options are available:

If you create a config file in your config folder called email-validator.php, you can override the plugin's settings in the Control Panel. Since that config file is fully multi-environment aware, this is a handy way to have different settings across multiple environments.

Here's what that config file might look like along with a list of all of the possible values you can override.

<?php

return [
    'typoCheck'          => true,
    'allowNoMX'          => false,
    'allowCatchAll'      => true,
    'allowRoles'         => true,
    'allowFree'          => true,
    'allowDisposable'    => false,
    // Contact Form plugin settings
    'cfValidation'       => true,
    'cf_allowNoMX'       => false,
    'cf_allowCatchAll'   => true,
    'cf_allowRoles'      => true,
    'cf_allowFree'       => true,
    'cf_allowDisposable' => false,
];

The plugin will automatically enforce it's validation checks if Verify email addresses? is checked in the user settings.

These settings can be found in Settings > Users > Settings

You can validate an email address from within your templates by using the following function:

{% set validation = validateEmail('joe.bloggs@email.co.uk') %}

<pre>{{ validation|json_encode(constant('JSON_PRETTY_PRINT')) }}</pre>

This response will be returned.

If you have the Contact Form plugin installed you can validate submissions using Email Validator.

Email Validator will automatically detect if this plugin is installed, all you need to do is head to:

Settings → Email Validator → Contact Form

You can also validate an email address from within your own plugins/modules:

use lukeyouell\emailvalidator\EmailValidator;

EmailValidator::getInstance()->validationService->validateEmail('joe.bloggs@email.co.uk');

This response will be returned.

The email address being validated.

The local part of the email address.

The domain of the email address.

Contains a 'did you mean' suggestion if a potential domain typo has been detected.

Returns true or false depending on whether or not the email address format is valid.

Returns true or false depending on whether or not MX Records could be found for the requested domain.

Returns true or false depending on whether or not the requested email address is found to be part of a catch-all mailbox.

Returns true or false depending on whether or not the requested email address is role-based. (e.g. 'admin@email.co.uk', 'support@email.co.uk')

Returns true or false depending on whether or not the requested email address is found to be using a free email provider. (e.g. Gmail, Yahoo!)

Returns true or false depending on whether or not the requested email address is found to be using a disposable email provider.

Some things to do, and ideas for potential features:

• Switch to using jobs to update list of providers
• Console commands
• Custom rules validator
• SMTP verification
• Commerce integration
• Validation score

Brought to you by Luke Youell