Ticket #41757: ms-functions.diff

wp-includes/ms-functions.php

@@ -2136 +2136 @@
  * @see add_user_to_blog()
  *
  * @param int   $user_id
- * @param mixed $password Ignored.
+ * @param mixed $password Accessible via 'added_new_user_to_blog' hook.
  * @param array $meta
  */
 function add_new_user_to_blog( $user_id, $password, $meta ) {
@@ -2149 +2149 @@
 
                 if ( ! is_wp_error( $result ) ) {
                         update_user_meta( $user_id, 'primary_blog', $blog_id );
+
+                        /**
+                         * Fires when a new user is added to a network site without an error from $result.
+                         * 
+                         * @since 4.9.0
+                         *
+                         * @param int    $user_id  New user's ID.
+                         * @param mixed  $password New user's password.
+                         * @param array  $meta     Array of meta data from the new registration.
+                         * @param int    $blog_id  Blog ID.
+                         */
+                        do_action( 'added_new_user_to_blog', $user_id, $password, $meta, $blog_id );
                 }
         }
 }