wp_new_user_notification() – Emails login credentials to a newly-registered user.

You appear to be a bot. Output may be restricted

Description

Emails login credentials to a newly-registered user.

A new user registration notification is also sent to admin email.

Usage

wp_new_user_notification( $user_id, $deprecated, $notify );

Parameters

$user_id
( int ) required – User ID.
$deprecated
( null ) optional – Not used (argument deprecated).
$notify
( string ) optional – Optional. Type of notification that should happen. Accepts 'admin' or an empty string (admin only), 'user', or 'both' (admin and user). Default empty.

Returns

void

Source

File name: wordpress/wp-includes/pluggable.php
Lines:

1 to 100 of 142
  function wp_new_user_notification( $user_id, $deprecated = null, $notify = '' ) {
    if ( null !== $deprecated ) {
      _deprecated_argument( wp_new_user_notification, '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";
 

 View on GitHub View on Trac