Описание pre_wp_mail
— Filter
Хук pre_wp_mail позволяет изменять параметры перед отправкой электронной почты через функцию wp_mail. Он срабатывает перед отправкой письма, что позволяет модифицировать данные, такие как адреса получателей, заголовки и содержание письма
Примеры использования
Пример изменения адреса получателя:
add_filter('pre_wp_mail', function($to, $subject, $message, $headers, $attachments) {
$to = 'new_email@example.com';
return $to;
}, 10, 5);
В этом примере мы изменяем адрес получателя на ‘new_email@example.com’
Пример изменения темы письма:
add_filter('pre_wp_mail', function($to, $subject, $message, $headers, $attachments) {
$subject = 'Новая тема письма';
return $subject;
}, 10, 5);
Здесь мы изменяем тему письма на ‘Новая тема письма’
Пример добавления заголовков к письму:
add_filter('pre_wp_mail', function($to, $subject, $message, $headers, $attachments) {
$headers[] = 'Cc: cc_email@example.com';
return $headers;
}, 10, 5);
Мы добавляем Cc заголовок для отправки копии письма
Пример изменения содержимого письма:
add_filter('pre_wp_mail', function($to, $subject, $message, $headers, $attachments) {
$message .= '
С уважением,
Ваша команда';
return $message;
}, 10, 5);
Мы добавляем подпись к содержимому письма
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить данные перед отправкой электронного письма, например, для изменения темы или адреса получателя
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только данных, передаваемых в wp_mail
– Предупреждения
Будьте осторожны с изменениями, которые могут повлиять на доставляемость писем, например, неправильные адреса получателей
Альтернативы
Тип: action
Этот хук позволяет выполнять действия после отправки письма, например, логирование
Используйте его, если нужно выполнить дополнительные действия после отправки письма
