Описание
Отправляет письмо на почту. Похожа на mail() в PHP. Имя отправителя по умолчанию: WordPress, а email по умолчанию: [email protected]. Их можно переписать изменив заголовок письма на:
From: Example User
Функция использует фильтры wp_mail_from и wp_mail_from_name, которые влияют на адрес email’a и имя отправителя, соответственно. Поле «от кого» собирается заново. Если указан только параметр wp_mail_from (email), то имя указываться не будет вообще: (From: [email protected]) Тип письма по умолчанию text/plain, а значит в теле письма нельзя использовать html теги. Изменить тип письма можно через фильтр wp_mail_content_type или указав заголовок: content-type: text/html. Кодировка по умолчанию соответствует кодировке блога (обычно utf-8). Кодировка устанавливается через фильтр wp_mail_charset’ filter.
wp_mail() используется в wp_new_user_notification().
Функция возвращает true, если удалось отправить письмо и false, если нет.
true не означает, что письмо дошло до адресата, а означет только то, что функция проделала всю процедуру отправки письма успешно — без ошибок.
Использование
- wp_mail( $to, $subject, $message, $headers, $attachments ); ?>
Параметры
- $to (строка/массив) (обязательный)
- Мылы получателей письма. Несколько получателей указываются в массиве или через запятую в строке. По умолчанию: нет
- $subject (строка) (обязательный)
- Тема письма (заголовок). По умолчанию: нет
- $message (строка) (обязательный)
- Тело письма (содержание, контент). По умолчанию: нет
- $headers (строка)
- Заголовки письма, указывающие на его атрибуты. Для продвинутого использования. По умолчанию: ''
- $attachments (строка/массив)
- Файлы, которые следует прикрепить к письму. Указываем полный путь до файла (название файла включительно). Если нужно прикрепить несколько файлов указываем их названия в массиве или в строке через перенос строки. По умолчанию: ''
Примеры
1. Пример отправки письма
Отправим письмо от My Name
- $attachments = array(WP_CONTENT_DIR . ‘/uploads/attach.zip’);
- $headers = ‘From: My Name
‘ . «\r\n»; - wp_mail(‘[email protected]’, ‘Тема’, ‘Содержание’, $headers, $attachments);
- ?>
[email protected] — кому отправляем.
2. Настройка через фильтр
Заголовки можно настроить через фильтр. Этот пример показывает как изменить тип письма на html? используя фильтр wp_mail_content_type:
- add_filter(‘wp_mail_content_type’,create_function(», ‘return «text/html»;’));
- wp_mail(‘[email protected]’, ‘The subject’, ‘
The HTML message
‘
); - ?>
На заметку
Для работы этой функции сервер должен работать с SMTP и должен быть установлен smtp_port в php.ini. Источник : http://wp-kama.ru/function/wp_mail