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

Timestamp:

07/01/2017 01:29:09 PM (9 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;
         }