namespace WPForms\Integrations\SMTP;
use WPForms\Integrations\IntegrationInterface;
class Notifications implements IntegrationInterface {
* Determine if the class is allowed to load.
public function allow_load() {
return wpforms_is_admin_page( 'builder' ) || wpforms_is_admin_ajax();
private function hooks() {
add_filter( 'wpforms_builder_notifications_sender_address_settings', [ $this, 'change_from_email_settings' ], PHP_INT_MIN, 3 );
add_filter( 'wpforms_builder_notifications_sender_name_settings', [ $this, 'change_from_name_settings' ], PHP_INT_MIN, 3 );
add_action( 'wp_ajax_wpforms_builder_notification_from_email_validate', [ $this, 'notification_from_email_validate' ] );
add_filter( 'wpforms_builder_strings', [ $this, 'form_builder_strings' ], 10, 2 );
public function notification_from_email_validate() {
check_ajax_referer( 'wpforms-builder', 'nonce' );
// Before checking if $_POST['email'] is valid email, we need to check if smart tag is used and return its value.
$email = ! empty( $_POST['email'] ) ? sanitize_text_field( wp_unslash( $_POST['email'] ) ) : '';
$email = $email ? sanitize_email( wpforms_process_smart_tags( $email, [], [], '', 'smtp-notification-validation' ) ) : '';
if ( ! is_email( $email ) ) {
'<div class="wpforms-alert wpforms-alert-warning wpforms-alert-warning-wide">%s</div>',
__( 'Please enter a valid email address. Your notifications won\'t be sent if the field is not filled in correctly.', 'wpforms-lite' )
if ( ! $this->email_domain_matches_site_domain( $email ) ) {
wp_send_json_error( $this->get_warning_message() );
* Append additional strings for form builder.
* @param array $strings List of strings.
* @param object $form Current form object.
public function form_builder_strings( $strings, $form ) {
$strings['empty_email_address'] = esc_html__( 'Please enter a valid email address. Your notifications won\'t be sent if the field is not filled in correctly.', 'wpforms-lite' );
$strings['allow_only_one_email'] = esc_html__( 'Notifications can only use 1 From Email. Please do not enter multiple addresses.', 'wpforms-lite' );
$strings['allow_only_email_fields'] = esc_html__( 'This smart tag does not point to an Email field in your form.', 'wpforms-lite' );
* Add warning message when email doesn't match site domain.
* @param array $args Field settings.
* @param array $form_data Form data.
* @param int $id Notification ID.
public function change_from_email_settings( $args, $form_data, $id ) {
// phpcs:disable WPForms.PHP.ValidateHooks.InvalidHookName
/** This filter is documented in lite/wpforms-lite.php */
$from_email_after = apply_filters( 'wpforms_builder_notifications_from_email_after', '', $form_data, $id );
// phpcs:enable WPForms.PHP.ValidateHooks.InvalidHookName
if ( ! empty( $from_email_after ) ) {
'after' => '<div class="wpforms-alert wpforms-alert-warning">' . $from_email_after . '</div>',
'input_class' => 'wpforms-disabled',
'class' => 'from-email wpforms-panel-field-warning',
'class' => 'from-email js-wpforms-from-email-validation',
'tooltip' => esc_html__( 'Notifications can only use 1 From Email. Please do not enter multiple addresses.', 'wpforms-lite' ),
$args = wp_parse_args( $args, $default );
* Add warning message when name empty.
* @param array $args Field settings.
* @param array $form_data Form data.
* @param int $id Notification ID.
public function change_from_name_settings( $args, $form_data, $id ) {
// phpcs:disable WPForms.PHP.ValidateHooks.InvalidHookName
/** This filter is documented in lite/wpforms-lite.php */
$from_name_after = apply_filters( 'wpforms_builder_notifications_from_name_after', '', $form_data, $id );
// phpcs:enable WPForms.PHP.ValidateHooks.InvalidHookName
if ( ! empty( $from_name_after ) ) {
'after' => '<div class="wpforms-alert wpforms-alert-warning">' . $from_name_after . '</div>',
'input_class' => 'wpforms-disabled',
'class' => 'from-name wpforms-panel-field-warning',
return wp_parse_args( $args, $default );
private function get_warning_message() {
$site_domain = wp_parse_url( get_bloginfo( 'wpurl' ) )['host'];
$email_does_not_match_text = sprintf( /* translators: %1$s - WordPress site domain. */
__( 'The current \'From Email\' address does not match your website domain name (%1$s). This can cause your notification emails to be blocked or marked as spam.', 'wpforms-lite' ),
$install_wp_mail_smtp_text = '';
// If WP Mail SMTP is not active, show a message to install it.
! is_plugin_active( 'wp-mail-smtp-pro/wp_mail_smtp.php' ) &&
! is_plugin_active( 'wp-mail-smtp/wp_mail_smtp.php' )
$install_wp_mail_smtp_text .= sprintf(
wp_kses( /* translators: %1$s - WP Mail SMTP install page URL. */
'We strongly recommend that you install the free <a href="%1$s" target="_blank">WP Mail SMTP</a> plugin! The Setup Wizard makes it easy to fix your emails.',
esc_url( admin_url( 'admin.php?page=wpforms-smtp' ) )
$address_match_text = sprintf( /* translators: %1$s - WordPress site domain. */
__( 'Alternately, try using a From Address that matches your website domain (admin@%1$s).', 'wpforms-lite' ),
$fix_email_delivery_text = sprintf(
wp_kses( /* translators: %1$s - fixing email delivery issues doc URL. */
'Please check out our <a href="%1$s" target="_blank" rel="noopener noreferrer">doc on fixing email delivery issues</a> for more details.',
esc_url( wpforms_utm_link( 'https://wpforms.com/docs/how-to-fix-wordpress-contact-form-not-sending-email-with-smtp/', 'Builder Notifications', 'Delivery Issues Documentation' ) )
'<div class="wpforms-alert wpforms-alert-warning wpforms-alert-warning-wide"> <p>%1$s</p> <p>%2$s</p> <p>%3$s</p> <p>%4$s</p> </div>',
$email_does_not_match_text,
$install_wp_mail_smtp_text,
* Check if the domain name in an email address matches the WordPress site domain.
* @param string $email The email address to check against the WordPress site domain.
private function email_domain_matches_site_domain( $email ) {
// Process smart tags if they are used as a value.
$email = wpforms_process_smart_tags( $email, [], [], '', 'smtp-notification-validation' );
// Skip processing when email is empty or does not set.
// e.g. {field_id="3"} which we don't have at the moment.
$email_domain = substr( strrchr( $email, '@' ), 1 );
$site_domain = wp_parse_url( get_bloginfo( 'wpurl' ) )['host'];
// Check if From email domain ends with site domain.
return ! empty( $email_domain ) && preg_match( "/\b{$email_domain}$/", $site_domain ) === 1;
* Check if the site has any active SMTP plugins.
private function has_active_smtp_plugin() {
// List of plugins from \WPMailSMTP\Conflicts.
'branda-white-labeling/ultimate-branding.php',
'cimy-swift-smtp/cimy_swift_smtp.php',
'disable-emails/disable-emails.php',
'easy-wp-smtp/easy-wp-smtp.php',
'fluent-smtp/fluent-smtp.php',
'my-smtp-wp/my-smtp-wp.php',
'post-smtp/postman-smtp.php',
'postman-smtp/postman-smtp.php',
'postmark-approved-wordpress-plugin/postmark.php',
'sar-friendly-smtp/sar-friendly-smtp.php',
'sendgrid-email-delivery-simplified/wpsendgrid.php',
'sparkpost/wordpress-sparkpost.php',
'turbosmtp/turbo-smtp-plugin.php',
'woocommerce-sendinblue-newsletter-subscription/woocommerce-sendinblue.php',
'wp-amazon-ses-smtp/wp-amazon-ses.php',
'wp-easy-smtp/wp-easy-smtp.php',
'wp-gmail-smtp/wp-gmail-smtp.php',
'wp-html-mail/wp-html-mail.php',
'wp-mail-bank/wp-mail-bank.php',
'wp-mail-booster/wp-mail-booster.php',
'wp-mail-smtp-mailer/wp-mail-smtp-mailer.php',
'wp-mail-smtp-pro/wp_mail_smtp.php',
'wp-mail-smtp/wp_mail_smtp.php',
'wp-mailgun-smtp/wp-mailgun-smtp.php',
'wp-offload-ses/wp-offload-ses.php',
'wp-sendgrid-smtp/wp-sendgrid-smtp.php',
'wp-yahoo-smtp/wp-yahoo-smtp.php',
foreach ( $smtp_plugin_list as $smtp_plugin ) {
if ( is_plugin_active( $smtp_plugin ) ) {