' . $smtp_debug . ''; } else { $smtp_text .= '[empty]'; } } $errors = apply_filters( 'wp_mail_smtp_admin_test_get_debug_messages', array( $versions_text, $mailer_text, $debug_text, $smtp_text, ) ); return '
' . implode( ''; } /** * Returns debug information for detection, processing, and display. * * @since 1.3.0 * * @return array */ protected function get_debug_details() { $options = new Options(); $smtp_host = $options->get( 'smtp', 'host' ); $smtp_port = $options->get( 'smtp', 'port' ); $smtp_encryption = $options->get( 'smtp', 'encryption' ); $details = array( // [any] - cURL error 60/77. array( 'mailer' => 'any', 'errors' => array( array( 'cURL error 60' ), array( 'cURL error 77' ), ), 'description' => array( '' . esc_html__( 'SSL certificate issue.', 'wp-mail-smtp' ) . '', esc_html__( 'This means your web server cannot reliably make secure connections (make requests to HTTPS sites).', 'wp-mail-smtp' ), esc_html__( 'Typically this error is returned when web server is not configured properly.', 'wp-mail-smtp' ), ), 'steps' => array( esc_html__( 'Contact your web hosting provider and inform them your site has an issue with SSL certificates.', 'wp-mail-smtp' ), esc_html__( 'The exact error you can provide them is in the Error log, available at the bottom of this page.', 'wp-mail-smtp' ), esc_html__( 'Ask them to resolve the issue then try again.', 'wp-mail-smtp' ), ), ), // [any] - cURL error 6/7. array( 'mailer' => 'any', 'errors' => array( array( 'cURL error 6' ), array( 'cURL error 7' ), ), 'description' => array( '' . esc_html__( 'Could not connect to host.', 'wp-mail-smtp' ) . '', ! empty( $smtp_host ) ? sprintf( /* translators: %s - SMTP host address. */ esc_html__( 'This means your web server was unable to connect to %s.', 'wp-mail-smtp' ), $smtp_host ) : esc_html__( 'This means your web server was unable to connect to the host server.', 'wp-mail-smtp' ), esc_html__( 'Typically this error is returned your web server is blocking the connections or the SMTP host denying the request.', 'wp-mail-smtp' ), ), 'steps' => array( sprintf( /* translators: %s - SMTP host address. */ esc_html__( 'Contact your web hosting provider and ask them to verify your server can connect to %s. Additionally, ask them if a firewall or security policy may be preventing the connection.', 'wp-mail-smtp' ), $smtp_host ), esc_html__( 'If using "Other SMTP" Mailer, triple check your SMTP settings including host address, email, and password.', 'wp-mail-smtp' ), esc_html__( 'If using "Other SMTP" Mailer, contact your SMTP host to confirm they are accepting outside connections with the settings you have configured (address, username, port, security, etc).', 'wp-mail-smtp' ), ), ), // [any] - cURL error XX (other). array( 'mailer' => 'any', 'errors' => array( array( 'cURL error' ), ), 'description' => array( '' . esc_html__( 'Could not connect to your host.', 'wp-mail-smtp' ) . '', ! empty( $smtp_host ) ? sprintf( /* translators: %s - SMTP host address. */ esc_html__( 'This means your web server was unable to connect to %s.', 'wp-mail-smtp' ), $smtp_host ) : esc_html__( 'This means your web server was unable to connect to the host server.', 'wp-mail-smtp' ), esc_html__( 'Typically this error is returned when web server is not configured properly.', 'wp-mail-smtp' ), ), 'steps' => array( esc_html__( 'Contact your web hosting provider and inform them you are having issues making outbound connections.', 'wp-mail-smtp' ), esc_html__( 'The exact error you can provide them is in the Error log, available at the bottom of this page.', 'wp-mail-smtp' ), esc_html__( 'Ask them to resolve the issue then try again.', 'wp-mail-smtp' ), ), ), // [smtp] - SMTP Error: Count not authenticate. array( 'mailer' => 'smtp', 'errors' => array( array( 'SMTP Error: Could not authenticate.' ), ), 'description' => array( '' . esc_html__( 'Could not authenticate your SMTP account.', 'wp-mail-smtp' ) . '', esc_html__( 'This means we were able to connect to your SMTP host, but were not able to proceed using the email/password in the settings.', 'wp-mail-smtp' ), esc_html__( 'Typically this error is returned when the email or password is not correct or is not what the SMTP host is expecting.', 'wp-mail-smtp' ), ), 'steps' => array( esc_html__( 'Triple check your SMTP settings including host address, email, and password. If you have recently reset your password you will need to update the settings.', 'wp-mail-smtp' ), esc_html__( 'Contact your SMTP host to confirm you are using the correct username and password.', 'wp-mail-smtp' ), esc_html__( 'Verify with your SMTP host that your account has permissions to send emails using outside connections.', 'wp-mail-smtp' ), ), ), // [smtp] - Sending bulk email, hitting rate limit. array( 'mailer' => 'smtp', 'errors' => array( array( 'We do not authorize the use of this system to transport unsolicited' ), ), 'description' => array( '' . esc_html__( 'Error due to unsolicited and/or bulk e-mail.', 'wp-mail-smtp' ) . '', esc_html__( 'This means the connection to your SMTP host was made successfully, but the host rejected the email.', 'wp-mail-smtp' ), esc_html__( 'Typically this error is returned when your are sending too many e-mails or e-mails that have been identified as spam.', 'wp-mail-smtp' ), ), 'steps' => array( esc_html__( 'Check the emails that are sending are sending individually. Example: email is not sending to 30 recipients. You can install any WordPress e-mail logging plugin to do that.', 'wp-mail-smtp' ), esc_html__( 'Contact your SMTP host to ask about sending/rate limits.', 'wp-mail-smtp' ), esc_html__( 'Verify with them your SMTP account is in good standing and your account has not been flagged.', 'wp-mail-smtp' ), ), ), // [smtp] - Unauthenticated senders not allowed. array( 'mailer' => 'smtp', 'errors' => array( array( 'Unauthenticated senders not allowed' ), ), 'description' => array( '' . esc_html__( 'Unauthenticated senders are not allowed.', 'wp-mail-smtp' ) . '', esc_html__( 'This means the connection to your SMTP host was made successfully, but you should enable Authentication and provide correct Username and Password.', 'wp-mail-smtp' ), ), 'steps' => array( esc_html__( 'Go to WP Mail SMTP plugin Settings page.', 'wp-mail-smtp' ), esc_html__( 'Enable Authentication', 'wp-mail-smtp' ), esc_html__( 'Enter correct SMTP Username (usually this is an email address) and Password in the appropriate fields.', 'wp-mail-smtp' ), ), ), // [smtp] - SMTP connect() failed. array( 'mailer' => 'smtp', 'errors' => array( array( 'SMTP connect() failed' ), ), 'description' => array( '' . esc_html__( 'Could not connect to the SMTP host.', 'wp-mail-smtp' ) . '', ! empty( $smtp_host ) ? sprintf( /* translators: %s - SMTP host address. */ esc_html__( 'This means your web server was unable to connect to %s.', 'wp-mail-smtp' ), $smtp_host ) : esc_html__( 'This means your web server was unable to connect to the host server.', 'wp-mail-smtp' ), esc_html__( 'Typically this error is returned for one of the following reasons:', 'wp-mail-smtp' ), '-' . esc_html__( 'SMTP settings are incorrect (wrong port, security setting, incorrect host).', 'wp-mail-smtp' ) . '
', array_filter( $errors ) ) . '
info@example.com',
'info@localhost, info@192.168.1.1'
),
esc_html__( 'Make sure that the generated email has a TO header, useful when you are responsible for email creation.', 'wp-mail-smtp' ),
),
),
// [gmail] - Token has been expired or revoked.
array(
'mailer' => 'gmail',
'errors' => array(
array( 'invalid_grant', 'Token has been expired or revoked' ),
),
'description' => array(
'' . esc_html__( 'Google API Error.', 'wp-mail-smtp' ) . '',
esc_html__( 'Unfortunately, this error can be due to many different reasons.', 'wp-mail-smtp' ),
),
'steps' => array(
sprintf(
wp_kses(
/* translators: %s - Blog article URL. */
__( 'Please read this article to learn more about what can cause this error and how it can be resolved.', 'wp-mail-smtp' ),
array(
'a' => array(
'href' => array(),
'target' => array(),
'rel' => array(),
),
)
),
'https://blog.timekit.io/google-oauth-invalid-grant-nightmare-and-how-to-fix-it-9f4efaf1da35'
),
),
),
// [gmail] - Code was already redeemed.
array(
'mailer' => 'gmail',
'errors' => array(
array( 'invalid_grant', 'Code was already redeemed' ),
),
'description' => array(
'' . esc_html__( 'Google API Error.', 'wp-mail-smtp' ) . '',
esc_html__( 'Authentication code that Google returned to you has already been used on your previous auth attempt.', 'wp-mail-smtp' ),
),
'steps' => array(
esc_html__( 'Make sure that you are not trying to manually clean up the plugin options to retry the "Allow..." step.', 'wp-mail-smtp' ),
esc_html__( 'Reinstall the plugin with clean plugin data turned on on Misc page. This will remove all the plugin options and you will be safe to retry.', 'wp-mail-smtp' ),
esc_html__( 'Make sure there is no aggressive caching on site admin area pages or try to clean cache between attempts.', 'wp-mail-smtp' ),
),
),
// [gmail] - 400: Mail service not enabled.
array(
'mailer' => 'gmail',
'errors' => array(
array( '400', 'Mail service not enabled' ),
),
'description' => array(
'' . esc_html__( 'Google API Error.', 'wp-mail-smtp' ) . '',
esc_html__( 'There are various reasons for that, please review the steps below.', 'wp-mail-smtp' ),
),
'steps' => array(
sprintf(
wp_kses(
/* translators: %s - Google G Suite Admin area URL. */
__( 'Make sure that your G Suite trial period has not expired. You can check the status here.', 'wp-mail-smtp' ),
array(
'a' => array(
'href' => array(),
'rel' => array(),
'target' => array(),
),
)
),
'https://admin.google.com'
),
sprintf(
wp_kses(
/* translators: %s - Google G Suite Admin area URL. */
__( 'Make sure that Gmail app in your G Suite is actually enabled. You can check that in Apps list in G Suite Admin area.', 'wp-mail-smtp' ),
array(
'a' => array(
'href' => array(),
'rel' => array(),
'target' => array(),
),
)
),
'https://admin.google.com'
),
sprintf(
wp_kses(
/* translators: %s - Google Developers Console URL. */
__( 'Make sure that you have Gmail API enabled, and you can do that here.', 'wp-mail-smtp' ),
array(
'a' => array(
'href' => array(),
'rel' => array(),
'target' => array(),
),
)
),
'https://console.developers.google.com/'
),
),
),
// [gmail] - 403: Project X is not found and cannot be used for API calls.
array(
'mailer' => 'gmail',
'errors' => array(
array( '403', 'is not found and cannot be used for API calls' ),
),
'description' => array(
'' . esc_html__( 'Google API Error.', 'wp-mail-smtp' ) . '',
),
'steps' => array(
esc_html__( 'Make sure that the used Client ID/Secret correspond to a proper project that has Gmail API enabled.', 'wp-mail-smtp' ),
sprintf(
wp_kses(
/* translators: %s - WPForms.com tutorial URL. */
esc_html__( 'Please follow our Gmail tutorial to be sure that all the correct project and data is applied.', 'wp-mail-smtp' ),
array(
'a' => array(
'href' => array(),
'rel' => array(),
'target' => array(),
),
)
),
'https://wpforms.com/how-to-securely-send-wordpress-emails-using-gmail-smtp/'
),
),
),
// [gmail] - The OAuth client was disabled.
array(
'mailer' => 'gmail',
'errors' => array(
array( 'disabled_client', 'The OAuth client was disabled' ),
),
'description' => array(
'' . esc_html__( 'Google API Error.', 'wp-mail-smtp' ) . '',
esc_html__( 'You may have added a new API to a project', 'wp-mail-smtp' ),
),
'steps' => array(
esc_html__( 'Make sure that the used Client ID/Secret correspond to a proper project that has Gmail API enabled.', 'wp-mail-smtp' ),
esc_html__( 'Try to use a separate project for your emails, so the project has only 1 Gmail API in it enabled. You will need to remove the old project and create a new one from scratch.', 'wp-mail-smtp' ),
),
),
);
// Error detection logic.
foreach ( $details as $data ) {
// Check for appropriate mailer.
if ( 'any' !== $data['mailer'] && $this->debug['mailer'] !== $data['mailer'] ) {
continue;
}
$match = false;
// Attempt to detect errors.
foreach ( $data['errors'] as $error_group ) {
foreach ( $error_group as $error_code => $error_message ) {
$match = ( false !== strpos( $this->debug['error_log'], $error_message ) || false !== strpos( $this->debug['error_log'], $error_message ) );
if ( ! $match ) {
break;
}
}
if ( $match ) {
break;
}
}
if ( $match ) {
return $data;
}
}
// Return defaults.
return array(
'description' => array(
'' . esc_html__( 'An issue was detected.', 'wp-mail-smtp' ) . '',
esc_html__( 'This means your test email was unable to be sent.', 'wp-mail-smtp' ),
esc_html__( 'Typically this error is returned for one of the following reasons:', 'wp-mail-smtp' ),
'- ' . esc_html__( 'Plugin settings are incorrect (wrong SMTP settings, invalid Mailer configuration, etc).', 'wp-mail-smtp' ) . '
submit a support ticket.', 'wp-mail-smtp' ), array( 'a' => array( 'href' => array(), 'rel' => array(), 'target' => array(), ), ) ), 'https://wpforms.com/account/support/' ); ?>
purchase a WPForms license. Along with getting priority support for WP Mail SMTP, you will also get access to the best drag & drop WordPress form builder plugin.', 'wp-mail-smtp' ), array( 'a' => array( 'href' => array(), 'rel' => array(), 'target' => array(), ), ) ), 'https://wpforms.com/?discount=THANKYOU&utm_source=WordPress&utm_medium=debug-cta&utm_campaign=smtpplugin' ); ?>
array( 'class' => array(), ), ) ), str_repeat( '', 5 ) ); ?>
limited support on the WordPress.org support forums. You can create a support thread there, but please understand that free support is not guaranteed and is limited to simple issues. If you have an urgent or complex issue, then please consider purchasing a WPForms license to access our priority support ticket system.', 'wp-mail-smtp' ), array( 'a' => array( 'href' => array(), 'rel' => array(), 'target' => array(), ), ) ), 'https://wordpress.org/support/topic/wp-mail-smtp-support-policy/', 'https://wordpress.org/support/plugin/wp-mail-smtp/', 'https://wpforms.com/?discount=THANKYOU&utm_source=WordPress&utm_medium=debug-cta&utm_campaign=smtpplugin' ); ?>