Changeset 40980 for trunk/src/wp-includes/user.php

Timestamp:

07/01/2017 01:29:09 PM (7 years ago)

Author:

boonebgorges

Message:

Users: Allow data to be filtered before updating or creating a user.

Props DaveFX.
Fixes #40545.

File:

• trunk/src/wp-includes/user.php (modified) (2 diffs)

trunk/src/wp-includes/user.php

@@ -1643 +1643 @@
     $data = wp_unslash( $compacted );
 
+    if ( ! $update ) {
+        $data = $data + compact( 'user_login' );
+    }
+
+    /**
+     * Filters user data before the record is created or updated.
+     *
+     * It only includes data in the wp_users table wp_user, not any user metadata.
+     *
+     * @since 4.9.0
+     *
+     * @param array    $data {
+     *     Values and keys for the user.
+     *
+     *     @type string $user_login      The user's login. Only included if $update == false
+     *     @type string $user_pass       The user's password.
+     *     @type string $user_email      The user's email.
+     *     @type string $user_url        The user's url.
+     *     @type string $user_nicename   The user's nice name. Defaults to a URL-safe version of user's login
+     *     @type string $display_name    The user's display name.
+     *     @type string $user_registered MySQL timestamp describing the moment when the user registered. Defaults to
+     *                                   the current UTC timestamp.
+     * }
+     * @param bool     $update Whether the user is being updated rather than created.
+     * @param int|null $id     ID of the user to be updated, or NULL if the user is being created.
+     */
+    $data = apply_filters( 'wp_pre_insert_user_data', $data, $update, $update ? (int) $ID : null );
+
     if ( $update ) {
         if ( $user_email !== $old_user_data->user_email ) {
@@ -1650 +1678 @@
         $user_id = (int) $ID;
     } else {
-        $wpdb->insert( $wpdb->users, $data + compact( 'user_login' ) );
+        $wpdb->insert( $wpdb->users, $data );
         $user_id = (int) $wpdb->insert_id;
     }