Changeset 59892 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php

Timestamp:

02/28/2025 06:19:21 PM (18 months ago)

Author:

joemcgill

Message:

REST API: Add support for search_columns to the user endpoint.

This adds support for passing a search_columns argument to the user controller so that users with list_users caps can specify which field is being searched.

Props youknowriad, joemcgill, ntsekouras, mreishus, mamaduka.
Fixes 62596.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php (modified) (3 diffs)

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php

@@ -258 +258 @@
          *
          * @since 4.7.0
+         * @since 6.8.0 Added support for the search_columns query param.
          *
          * @param WP_REST_Request $request Full details about the request.
@@ -332 +333 @@
                                 $prepared_args['search_columns'] = array( 'ID', 'user_login', 'user_nicename', 'display_name' );
                         }
+                        $search_columns         = $request->get_param( 'search_columns' );
+                        $valid_columns          = isset( $prepared_args['search_columns'] )
+                                ? $prepared_args['search_columns']
+                                : array( 'ID', 'user_login', 'user_nicename', 'user_email', 'display_name' );
+                        $search_columns_mapping = array(
+                                'id'       => 'ID',
+                                'username' => 'user_login',
+                                'slug'     => 'user_nicename',
+                                'email'    => 'user_email',
+                                'name'     => 'display_name',
+                        );
+                        $search_columns         = array_map(
+                                static function ( $column ) use ( $search_columns_mapping ) {
+                                        return $search_columns_mapping[ $column ];
+                                },
+                                $search_columns
+                        );
+                        $search_columns         = array_intersect( $search_columns, $valid_columns );
+                        if ( ! empty( $search_columns ) ) {
+                                $prepared_args['search_columns'] = $search_columns;
+                        }
                         $prepared_args['search'] = '*' . $prepared_args['search'] . '*';
                 }
@@ -1614 +1636 @@
                 );
 
+                $query_params['search_columns'] = array(
+                        'default'     => array(),
+                        'description' => __( 'Array of column names to be searched.' ),
+                        'type'        => 'array',
+                        'items'       => array(
+                                'enum' => array( 'email', 'name', 'id', 'username', 'slug' ),
+                                'type' => 'string',
+                        ),
+                );
+
                 /**
                  * Filters REST API collection parameters for the users controller.