Filter hook 'rest_user_collection_params'

in WP Core File wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php at line 1673

View Source

rest_user_collection_params

Filter Hook
Description
Filters REST API collection parameters for the users controller. This filter registers the collection parameter, but does not map the collection parameter to an internal WP_User_Query parameter. Use the `rest_user_query` filter to set WP_User_Query arguments.

Hook Information

File Location wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php View on GitHub
Hook Type Filter
Line Number 1673

Hook Parameters

Type Name Description
array $query_params JSON Schema-formatted collection parameters.

Usage Examples

Basic Usage
<?php
// Hook into rest_user_collection_params
add_filter('rest_user_collection_params', 'my_custom_filter', 10, 1);

function my_custom_filter($query_params) {
    // Your custom filtering logic here
    return $query_params;
}

Source Code Context

wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php:1673 - How this hook is used in WordPress core
<?php
1668  		 *
1669  		 * @since 4.7.0
1670  		 *
1671  		 * @param array $query_params JSON Schema-formatted collection parameters.
1672  		 */
1673  		return apply_filters( 'rest_user_collection_params', $query_params );
1674  	}
1675  }

PHP Documentation

<?php
/**
		 * Filters REST API collection parameters for the users controller.
		 *
		 * This filter registers the collection parameter, but does not map the
		 * collection parameter to an internal WP_User_Query parameter.  Use the
		 * `rest_user_query` filter to set WP_User_Query arguments.
		 *
		 * @since 4.7.0
		 *
		 * @param array $query_params JSON Schema-formatted collection parameters.
		 */
Quick Info
  • Hook Type: Filter
  • Parameters: 1
  • File: wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php
Related Hooks

Related hooks will be displayed here in future updates.