Add new filter to WP_User_Query

[spacedmonkey]

Add a new filter to filter the value of results returned from the WP_User_Query. This brings the WP_User_Query class inline with other query classes, like WP_Query, which already has posts_results filter. This filter is a powerful one, that will allow for third party code, to hook in and change the results of the query.

[spacedmonkey]

Related: #43679

[danieltj]

Removing the performance focus and converting from bug to enhancement as nothing is technically broken here.

[spacedmonkey]

Updated the patch with coding standard fixes. cc @SergeyBiryukov

[SergeyBiryukov]

Replying to spacedmonkey:

Add a new filter to filter the value of results returned from the WP_User_Query. This brings the WP_User_Query class inline with other query classes, like WP_Query, which already has posts_results filter.

For consistency with the posts_results filter, which accepts an array of WP_Post objects rather than stdClass objects, I guess I would expect users_results to accept an array of WP_User objects.

What do you think of 43680.3.diff​? It runs the filter a bit later, after converting the results to WP_User objects when fields is all or all_with_meta, but before retrieving metadata via cache_users().

[SergeyBiryukov]

Related: #45153

[SirLouen]

Replying to spacedmonkey:

This filter is a powerful one, that will allow for third party code, to hook in and change the results of the query.

@spacedmonkey can an example, ​Testing Use Case, be provided?