通知用户他们的帐户激活已成功。

原型

wpmu_welcome_user_notification( int $user_id, string $password, array $meta = array() )

描述

过滤’wpmu_welcome_user_notification’以禁用或绕过。

参数

$user_id (int) (Required) 用户身份。

$password (string) (Required) 用户密码。

$meta (array) (Optional)  注册元数据。

返回值

(bool)  

源文件

路径:wp-includes/ms-functions.php

<?php
...
function wpmu_welcome_user_notification( $user_id, $password, $meta = array() ) {
	$current_network = get_network();
	/**
 	 * Filters whether to bypass the welcome email after user activation.
	 *
	 * Returning false disables the welcome email.
	 *
	 * @since MU (3.0.0)
	 *
	 * @param int    $user_id  User ID.
	 * @param string $password User password.
	 * @param array  $meta     Signup meta data. Default empty array.
	 */
	if ( ! apply_filters( 'wpmu_welcome_user_notification', $user_id, $password, $meta ) )
		return false;
	$welcome_email = get_site_option( 'welcome_user_email' );
	$user = get_userdata( $user_id );
	$switched_locale = switch_to_locale( get_user_locale( $user ) );
	/**
	 * Filters the content of the welcome email after user activation.
	 *
	 * Content should be formatted for transmission via wp_mail().
	 *
	 * @since MU (3.0.0)
	 *
	 * @param string $welcome_email The message body of the account activation success email.
	 * @param int    $user_id       User ID.
	 * @param string $password      User password.
	 * @param array  $meta          Signup meta data. Default empty array.
	 */
	$welcome_email = apply_filters( 'update_welcome_user_email', $welcome_email, $user_id, $password, $meta );
	$welcome_email = str_replace( 'SITE_NAME', $current_network->site_name, $welcome_email );
	$welcome_email = str_replace( 'USERNAME', $user->user_login, $welcome_email );
	$welcome_email = str_replace( 'PASSWORD', $password, $welcome_email );
	$welcome_email = str_replace( 'LOGINLINK', wp_login_url(), $welcome_email );
	$admin_email = get_site_option( 'admin_email' );
	if ( $admin_email == '' )
		$admin_email = '[email protected]' . $_SERVER['SERVER_NAME'];
	$from_name = get_site_option( 'site_name' ) == '' ? 'WordPress' : esc_html( get_site_option( 'site_name' ) );
	$message_headers = "From: "{$from_name}" <{$admin_email}>n" . "Content-Type: text/plain; charset="" . get_option('blog_charset') . ""n";
	$message = $welcome_email;
	if ( empty( $current_network->site_name ) )
		$current_network->site_name = 'WordPress';
	/* translators: New user notification email subject. 1: Network name, 2: New user login */
	$subject = __( 'New %1$s User: %2$s' );
	/**
	 * Filters the subject of the welcome email after user activation.
	 *
	 * @since MU (3.0.0)
	 *
	 * @param string $subject Subject of the email.
	 */
	$subject = apply_filters( 'update_welcome_user_subject', sprintf( $subject, $current_network->site_name, $user->user_login) );
	wp_mail( $user->user_email, wp_specialchars_decode( $subject ), $message, $message_headers );
	if ( $switched_locale ) {
		restore_previous_locale();
	}
	return true;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wpmu_welcome_user_notification/