wp_mail() — функция отправки email

  1.2.1     wp-includes / pluggable.php  /  Кодекс WordPress

Практическое использование этой функции вы можете найти в моём видеоуроке.

Функция возвращает true в случае успешной отправки email, однако это не означает, что письмо будет получено и прочтено.

wp_mail( $to, $subject, $message, $headers = '', $attachments = array() )
$to
(строка|массив) получатель или получатели письма (в виде массива или через запятую). Обратите внимание, если вы укажете их через запятую, то каждый получатель письма увидит все email-адреса, на которые было выслано это письмо
$subject
(строка) тема сообщения
$message
(строка) текст сообщения, по умолчанию text/plain, это значит, что HTML-теги не поддерживаются, о том, как включить их поддержку, смотрите в примерах
$headers
(строка|массив) заголовки сообщения
$attachments
(строка|массив) вложения к письму, нужно указывать полный путь к файлам на сервере. Для того, чтобы вложить несколько файлов, используйте массив, либо строку, где путь к каждому файлу начинается с новой строки

Пример. Обычная отправка письма

Самый просто пример:

wp_mail('true@truemisha.ru', 'Какая-то тема', 'Какое-то сообщение');

Изменение имени и email отправителя

В WordPress по умолчанию в качестве отправителя письма выставляется «WordPress»,а в качестве его email «wordpress@truemisha.ru».

Я уже писал пост о том, как изменить стандартное имя и email отправителя для всех писем, отправляемых с блога на WordPress, а сейчас рассмотрим пример только для конкретного письма:

$headers = 'From: Миша <misha@truemisha.ru>' . "\r\n"; // в виде строки
wp_mail('true@truemisha.ru', 'Какая-то тема', 'Какое-то сообщение', $headers);

Использование HTML-тегов в письме

Для того, чтобы использовать HTML-теги в тексте сообщения, нужно изменить content-type письма на text/html, а это можно сделать двумя способами.

Через фильтр. В таком случае HTML-теги станет возможно использовать в любых письмах, отправляемых с блога, для этого нужно вставить в functions.php следующий код:

add_filter('wp_mail_content_type', create_function('', 'return "text/html";'));

Через заголовки. HTML-теги будут разрешены только для конкретного письма.

$headers[] = 'Content-type: text/html; charset=utf-8'; // в виде массива
wp_mail('true@truemisha.ru', 'Какая-то тема', 'Какое-то сообщение', $headers);

Изменение кодировки письма

Кодировка письма по умолчанию соответствует кодировке блога, но ее тоже можно изменить через заголовки (предыдущий пример) или через фильтр:

add_filter('wp_mail_charset', create_function('', 'return "utf-8";'));

В предыдущем примере (и по умолчанию тоже) WordPress отправляет письма юникодом, но таким способом вы спокойно можете изменить кодировку например на Windows-1251.

Отправка письма с измененными заголовками и вложениями

В данном случае обе переменные: $attachments и $headers — заданы в виде массива.

$attachments[] = WP_CONTENT_DIR . '/uploads/file_1.zip';
$attachments[] = WP_CONTENT_DIR . '/uploads/file_2.zip';
 
$headers[] = 'From: Миша <misha@truemisha.ru>';
$headers[] = 'Content-type: text/html; charset=utf-8';
 
wp_mail('true@truemisha.ru', 'Какая-то тема', 'Какое-то сообщение', $headers, $attachments);
Кодекс WordPress: Другое: add_theme_support(), bloginfo(), body_class(), bool_from_yn(), cache_javascript_headers(), do_robots(), get_bloginfo(), get_body_class(), get_num_queries(), get_option(), get_privacy_policy_url(), get_the_privacy_policy_link(), nocache_headers(), remove_query_arg(), status_header(), the_privacy_policy_link(), update_option(), wp_cache_get(), wp_cache_set(), wp_die(), wp_editor(), wp_get_archives(), wp_get_document_title(), wp_hash(), wp_list_pluck(), wp_mail(), wp_mkdir_p(), wp_notify_moderator(), wp_notify_postauthor(), wp_parse_args(), wp_redirect(), wp_robots(), wp_salt(), wp_text_diff(), wp_upload_bits()

Миша

Недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.

Комментарии — 14

Оставить комментарий

× Отменить ответ

Если вы хотите добавить код, не забудьте обернуть его в <pre lang="php"></pre>, если же код – меньше одной строчки, то можно и в <code></code>.