wp_mail_succeeded │ хук-подія │ WP 5.9.0

Дозволяє зробити щось після того, як лист відправлений (PHPMailer відправив email).

Виконання цієї події не означає, що одержувач успішно отримав листа. Воно означає лише те, що метод PHPMailer::send зміг обробити запит без помилок.

Використання

add_action( 'wp_mail_succeeded', 'wp_kama_mail_succeeded_action');

/**
 * Function for `wp_mail_succeeded` action-hook.
 *
 * @param array $mail_data На array розміщення email recipient(s), subject, message, headers, and attachments.
 *
 * @return void
 */
function wp_kama_mail_succeeded_action( $mail_data ){

	// action...
}

$mail_data (масив): Дані листи як масиву. Містить: тему, повідомлення, заголовки та вкладення.

Приклади

#1 Які дані отримує хук

// Відправимо лист
$to = '[email protected]';
$subject = 'Тема повідомлення';
$message = 'Контент листа';
$headers = [
	'From: Me Myself <[email protected]>',
	'content-type: text/html',
	'cc: John Q Codex <[email protected]>',
	'cc: John2 Codex <[email protected]>',
	'bcc: [email protected]',
];
$attachments = [];

wp_mail($to, $subject, $message, $headers, $attachments);

Подивимося, які дані отримає хук:

add_action( 'wp_mail_succeeded', function ( $mail_data ) {
	print_r ($ mail_data);
} );

/*
Array
(
	[to] => Array
		(
			[0] => [email protected]
		)

	[subject] => Тема повідомлення
	[message] => Контент листа
	[headers] => Array
		(
		)

	[attachments] => Array
		(
		)

)
*/

Як бачимо, headers порожні (обнуляються по “шляху”).