wp_new_user_notification_email │ хук-фільтр │ WP 4.9.0

Дозволяє змінити вміст листа, який надсилається новому користувачеві під час реєстрації.

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

add_filter( 'wp_new_user_notification_email', 'wp_kama_new_user_notification_email_filter', 10, 3);

/**
 * Function for `wp_new_user_notification_email` filter-hook.
 *
 * @param array $wp_new_user_notification_email Used to build wp_mail().
 * @param WP_User $user User object for new user.
 * @param string $blogname The site title.
 *
 * @return array
 */
function wp_kama_new_user_notification_email_filter( $wp_new_user_notification_email, $user, $blogname ){

	// Filter...
	return $wp_new_user_notification_email;
}

$wp_new_user_notification_email (масив)

Масив з даними, що передаються функції wp_mail() крім вкладень. Ключі масиву:

to
Email щойно зареєстрованого користувача.
subject
Тема листа (заголовок).
message
Тіло листа (зміст, контент).
headers
Заголовки листа, що вказують на його атрибути.

$user (WP_User)

WP_User
об’єкт нового користувача.

$blogname (рядок)

Назва сайту, що отримується через
get_option(‘blogname’) .

Приклади

#1 Змінимо вміст листа під час реєстрації користувача

Нехай ми маємо власну роль з іменем price_list__subscriber , для якої відкритий доступ до сторінки “Прайс-листів”. Тоді при реєстрації користувача з такою роллю дефолтний лист WordPress добре доповнити інформацією про це.

add_filter( 'wp_new_user_notification_email', 'hpl_user_notification_email', 10, 3);

/**
 * Змінює вміст листа, який надсилається при реєстрації нового користувача з певною роллю.
 *
 * @param array $email_data
 * @param WP_User $user
 * @param string $blogname
 *
 * @return array
 */
function hpl_user_notification_email( $email_data, $user, $blogname ) {
	if ( user_can( $user, 'price_list__subscriber' ) ) {
		$text = "Вам наданий доступ на сторінку прайс-листів. rnrn";
		$text .= "Сторінка знаходиться за адресою http://example.com/price-list/. rnrn";
		$text .= "Тимчасовий пароль для входу згенерований автоматично, встановіть свій власний пароль за посиланням нижче. rnrn";

		$email_data['subject'] = 'Доступ до прайс-листу відкритий -'. wp_specialchars_decode($blogname);
		$email_data['message'] = $text . $email_data['message'];
	}

	return $email_data;
}

список змін

З версії 4.9.0

Введено.

Де викликається хук

wp_new_user_notification()

wp_new_user_notification_email_admin

wp_new_user_notification_email

wp-includes/pluggable.php 2205

$wp_new_user_notification_email = apply_filters( 'wp_new_user_notification_email', $wp_new_user_notification_email, $user, $blogname );

Де використовується хук у WordPress

Використання не знайдено.