хук-действие since 4.4.0

wp_mail_failed

Проверено на WordPress 6.9, обновлено 06.08.2026 Источник: WordPress Developer Resources.

Сигнатура

do_action( 'wp_mail_failed', WP_Error $error )

Описание

Срабатывает после перехвата исключения PHPMailer.

Параметры

$error WP_Error обязательный

Объект WP_Error с сообщением PHPMailerPHPMailerException и массивом, содержащим получателя письма, тему, сообщение, заголовки, вложения и встроенные элементы.

Исходный код

wp-includes/pluggable.php:665

do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_data ) );

История изменений

Версия	Описание
4.4.0	Introduced.