Функция wp_send_new_user_notifications() отвечает за отправку уведомлений по электронной почте при создании нового пользователя в WordPress. Эти уведомления могут быть отправлены как администратору сайта, так и новому пользователю, информируя их о регистрации. Функция является обёрткой для более старой функции wp_new_user_notification(), но с предустановленным значением параметра уведомления по умолчанию — 'both', что означает отправку уведомлений и администратору, и новому пользователю.
wp_send_new_user_notifications( int $user_id, string $notify = 'both' ): void
Параметры
- $user_id (int) (обязательный): ID вновь созданного пользователя.
- $notify (string) (необязательный): Определяет, кому будет отправлено уведомление. Допустимые значения:
'admin'или пустая строка (''): уведомление получит только администратор.'user': уведомление получит только созданный пользователь.'both': уведомление будет отправлено как администратору, так и новому пользователю (по умолчанию).
Возвращаемое значение
- void: Функция не возвращает значений, она лишь инициирует отправку электронных писем.
Пример 1: Уведомление как админа, так и нового пользователя
$new_user_id = 10;
wp_send_new_user_notifications( $new_user_id, 'both' );
В этом примере после создания нового пользователя с ID 10, администратор сайта получит уведомление о том, что был зарегистрирован новый пользователь, а новому пользователю будет отправлено письмо с данными для авторизации на сайте.
Администратор получит:
На вашем сайте "Example Site" зарегистрирован новый пользователь:
Имя пользователя: new_user
Email: [email protected]
Пользователь получит:
Имя пользователя: new_user
Чтобы задать пароль, перейдите по следующей ссылке:
<https://example.com/wp-login.php?action=rp&key=some_key&login=new_user>
Пример 2: Уведомление только администратору
Если необходимо отправить уведомление только администратору о регистрации нового пользователя, используйте следующий код:
$new_user_id = 11;
wp_send_new_user_notifications( $new_user_id, 'admin' );
В этом случае письмо будет отправлено только администратору, а новый пользователь не получит уведомления.
Пример 3: Уведомление только новому пользователю
Если нужно уведомить только нового пользователя, а администратору не отправлять сообщение, можно использовать параметр 'user':
$new_user_id = 12;
wp_send_new_user_notifications( $new_user_id, 'user' );
В результате только новый пользователь получит письмо с данными для входа и ссылкой на установку пароля.
Когда использовать
Функция wp_send_new_user_notifications() обычно используется в следующих случаях:
- Когда нужно уведомить администратора и пользователя о создании нового аккаунта.
- Когда на сайте требуется регистрация пользователей, и нужно автоматизировать процесс уведомлений.
- Для кастомных сценариев при регистрации, например, при интеграции с внешними системами или плагинами.
Вызовы функции в WordPress
В WordPress эта функция вызывается автоматически при регистрации пользователя на следующих событиях:
register_new_useredit_user_created_usernetwork_site_new_created_usernetwork_site_users_created_usernetwork_user_new_created_user
Заключение
Функция wp_send_new_user_notifications() упрощает процесс отправки уведомлений о регистрации нового пользователя как администратору, так и самому пользователю. Используя различные параметры, можно гибко настраивать, кому отправлять уведомления, что делает функцию полезной при работе с регистрацией пользователей на сайте.