WordPress как на ладони

wp_new_user_notification()WP 2.0.0

Уведомляет по почте администратора сайта о регистрации нового пользователя и отправляет пользователю письмо с логином и паролем для авторизации.

Эта функция автоматически срабатывает на хуке register_new_user, на который зацеплена другая функция wp_send_new_user_notifications() - обертка для этой функции.

add_action( 'register_new_user', 'wp_send_new_user_notifications' );

Pluggable функция — эту функцию можно заменить из плагина. Это значит, что она будет работать (подключается) только после подключения всех плагинов, а до этого момента функция еще не определена... Поэтому нельзя вызывать эту и зависящие от неё функции прямо из кода плагина. Их нужно вызывать через хук plugins_loaded или позднее, например хук init.

Замена функции (переопределение) — в must-use или обычном плагине можно создать функцию с таким же названием, тогда она заменит текущую функцию.

Работает на основе: wp_mail()
Основа для: wp_send_new_user_notifications()

Возвращает

null. Ничего.

Использование

wp_new_user_notification( $user_id, $deprecated, $notify );
$user_id(число) (обязательный)
ID пользователя.
$deprecated(устарел)
Устарел с версии 4.3.1. Нужно указывать null.
По умолчанию: null
$notify(строка)

Определяет тип уведомления.

  • admin или пустая строка ('') - уведомление получит только админ.
  • user - уведомление получит только созданный пользователь.
  • both - уведомления получат админ и созданный пользователь.

По умолчанию: ''

Примеры

0

#1 Уведомление админа и нового пользователя о регистрации и отправка обоим письма

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

$new_user_id = 8;

wp_new_user_notification( $new_user_id, 'both' );

В результате:

Админ получит:

На вашем сайте «SYSTEMa» зарегистрирован новый пользователь:

Имя пользователя: user

E-mail: user@user.user

Юзер получит:

Имя пользователя: user

Чтобы задать пароль, перейдите по следующей ссылке:

<http://example.com/wp-login.php?action=rp&key=1ORsgCiUtZdwDw3tss4U&login=user>

http://example.com/wp-login.php

Список изменений

С версии 2.0.0 Введена.
С версии 4.3.0 The $plaintext_pass parameter was changed to $notify.
С версии 4.3.1 The $plaintext_pass parameter was deprecated. $notify added as a third parameter.
С версии 4.6.0 The $notify parameter accepts 'user' for sending notification only to the user created.

Код wp_new_user_notification() WP 6.4.3

function wp_new_user_notification( $user_id, $deprecated = null, $notify = '' ) {
	if ( null !== $deprecated ) {
		_deprecated_argument( __FUNCTION__, '4.3.1' );
	}

	// Accepts only 'user', 'admin' , 'both' or default '' as $notify.
	if ( ! in_array( $notify, array( 'user', 'admin', 'both', '' ), true ) ) {
		return;
	}

	$user = get_userdata( $user_id );

	/*
	 * The blogname option is escaped with esc_html() on the way into the database in sanitize_option().
	 * We want to reverse this for the plain text arena of emails.
	 */
	$blogname = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );

	/**
	 * Filters whether the admin is notified of a new user registration.
	 *
	 * @since 6.1.0
	 *
	 * @param bool    $send Whether to send the email. Default true.
	 * @param WP_User $user User object for new user.
	 */
	$send_notification_to_admin = apply_filters( 'wp_send_new_user_notification_to_admin', true, $user );

	if ( 'user' !== $notify && true === $send_notification_to_admin ) {
		$switched_locale = switch_to_locale( get_locale() );

		/* translators: %s: Site title. */
		$message = sprintf( __( 'New user registration on your site %s:' ), $blogname ) . "\r\n\r\n";
		/* translators: %s: User login. */
		$message .= sprintf( __( 'Username: %s' ), $user->user_login ) . "\r\n\r\n";
		/* translators: %s: User email address. */
		$message .= sprintf( __( 'Email: %s' ), $user->user_email ) . "\r\n";

		$wp_new_user_notification_email_admin = array(
			'to'      => get_option( 'admin_email' ),
			/* translators: New user registration notification email subject. %s: Site title. */
			'subject' => __( '[%s] New User Registration' ),
			'message' => $message,
			'headers' => '',
		);

		/**
		 * Filters the contents of the new user notification email sent to the site admin.
		 *
		 * @since 4.9.0
		 *
		 * @param array   $wp_new_user_notification_email_admin {
		 *     Used to build wp_mail().
		 *
		 *     @type string $to      The intended recipient - site admin email address.
		 *     @type string $subject The subject of the email.
		 *     @type string $message The body of the email.
		 *     @type string $headers The headers of the email.
		 * }
		 * @param WP_User $user     User object for new user.
		 * @param string  $blogname The site title.
		 */
		$wp_new_user_notification_email_admin = apply_filters( 'wp_new_user_notification_email_admin', $wp_new_user_notification_email_admin, $user, $blogname );

		wp_mail(
			$wp_new_user_notification_email_admin['to'],
			wp_specialchars_decode( sprintf( $wp_new_user_notification_email_admin['subject'], $blogname ) ),
			$wp_new_user_notification_email_admin['message'],
			$wp_new_user_notification_email_admin['headers']
		);

		if ( $switched_locale ) {
			restore_previous_locale();
		}
	}

	/**
	 * Filters whether the user is notified of their new user registration.
	 *
	 * @since 6.1.0
	 *
	 * @param bool    $send Whether to send the email. Default true.
	 * @param WP_User $user User object for new user.
	 */
	$send_notification_to_user = apply_filters( 'wp_send_new_user_notification_to_user', true, $user );

	// `$deprecated` was pre-4.3 `$plaintext_pass`. An empty `$plaintext_pass` didn't sent a user notification.
	if ( 'admin' === $notify || true !== $send_notification_to_user || ( empty( $deprecated ) && empty( $notify ) ) ) {
		return;
	}

	$key = get_password_reset_key( $user );
	if ( is_wp_error( $key ) ) {
		return;
	}

	$switched_locale = switch_to_user_locale( $user_id );

	/* translators: %s: User login. */
	$message  = sprintf( __( 'Username: %s' ), $user->user_login ) . "\r\n\r\n";
	$message .= __( 'To set your password, visit the following address:' ) . "\r\n\r\n";
	$message .= network_site_url( "wp-login.php?action=rp&key=$key&login=" . rawurlencode( $user->user_login ), 'login' ) . "\r\n\r\n";

	$message .= wp_login_url() . "\r\n";

	$wp_new_user_notification_email = array(
		'to'      => $user->user_email,
		/* translators: Login details notification email subject. %s: Site title. */
		'subject' => __( '[%s] Login Details' ),
		'message' => $message,
		'headers' => '',
	);

	/**
	 * Filters the contents of the new user notification email sent to the new user.
	 *
	 * @since 4.9.0
	 *
	 * @param array   $wp_new_user_notification_email {
	 *     Used to build wp_mail().
	 *
	 *     @type string $to      The intended recipient - New user email address.
	 *     @type string $subject The subject of the email.
	 *     @type string $message The body of the email.
	 *     @type string $headers The headers of the email.
	 * }
	 * @param WP_User $user     User object for new user.
	 * @param string  $blogname The site title.
	 */
	$wp_new_user_notification_email = apply_filters( 'wp_new_user_notification_email', $wp_new_user_notification_email, $user, $blogname );

	wp_mail(
		$wp_new_user_notification_email['to'],
		wp_specialchars_decode( sprintf( $wp_new_user_notification_email['subject'], $blogname ) ),
		$wp_new_user_notification_email['message'],
		$wp_new_user_notification_email['headers']
	);

	if ( $switched_locale ) {
		restore_previous_locale();
	}
}
2 комментария
    Войти