WordPress/wp-includes
Adam Silverstein 9b0c0c7201 Users: Add a `users_pre_query` filter to short circuit WP_User_Query results.
Add a new filter `users_pre_query` - filters the users array before the query takes place. Return a non-null value to bypass WordPress's default user queries. Similar to the `posts_pre_query` filter for WP_Query added in #36687. This filter lets you short circuit the WP_User_Query MySQL query to return your own results.

Developers should note that filtering functions that require pagination information are encouraged to set the `total_users` property of the WP_User_Query object, passed to the filter by reference. If WP_User_Query does not perform a database query, it will not have enough information to generate these values itself.

Props tlovett1, birgire, boonebgorges, spacedmonkey.
Fixes #44169.

Built from https://develop.svn.wordpress.org/trunk@44373


git-svn-id: http://core.svn.wordpress.org/trunk@44203 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2018-12-29 16:06:50 +00:00
..
ID3 Media: update the `getID3` library to version `1.9.14` to avoid fatal errors in PHP7. 2017-07-31 19:50:45 +00:00
IXR XML-RPC: Add default values to IXR_Message for PHP 7.2 compatibility to avoid PHP Warnings. 2018-02-06 02:56:32 +00:00
Requests
SimplePie
Text External Libraries: Remove usage of `each()` from the `Text_Diff_Engine_native` class. 2017-10-26 12:52:53 +00:00
blocks Block Editor: Upgrade `@wordpress` packages to match version 4.7.1. 2018-12-19 03:16:48 +00:00
certificates
css Build tools: Allow building WordPress to `src`. 2018-12-24 13:29:50 +00:00
customize Docs: Future-proof comments referencing 5.0 TODOs. 2018-12-17 03:07:55 +00:00
fonts
images Build: Update images following [43684]. 2018-12-19 03:36:27 +00:00
js Build tools: Allow building WordPress to `src`. 2018-12-24 13:29:50 +00:00
pomo Docs: Add missing `@return` notations to three `MO` method DocBlocks. 2018-12-19 17:04:48 +00:00
random_compat External Libraries: Update Random_Compat from 1.2.1 to 2.0.11. 2017-11-08 11:48:49 +00:00
rest-api REST API: Remove a duplicate `require_once()`. 2018-12-19 03:27:26 +00:00
theme-compat Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
widgets Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
admin-bar.php Multisite: Display registered `new_item` text for `post` post type in My Sites menu. 2018-08-29 15:50:25 +00:00
atomlib.php General: Remove most uses of create_function() 2016-12-13 01:49:39 +00:00
author-template.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
blocks.php Block Editor: Fix PHP warning when loading editor styles while in RTL. 2018-12-17 18:07:51 +00:00
bookmark-template.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
bookmark.php Code is Poetry. 2017-11-30 23:11:00 +00:00
cache.php Code is Poetry. 2017-11-30 23:11:00 +00:00
canonical.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
capabilities.php Blocks: Add the reusable block post type, `wp_block`. 2018-12-14 02:15:37 +00:00
category-template.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
category.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-IXR.php
class-feed.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-http.php Docs: Update `@deprecated` tag for `WP_Http::_dispatch_request()`. See [42766]. 2018-12-20 01:59:48 +00:00
class-json.php Docs: Fix typo in `Services_JSON` DocBlocks. 2018-06-28 02:20:54 +00:00
class-oembed.php Docs: Remove erroneous pipe character usage in the `oembed_providers` filter DocBlock. 2018-12-19 16:36:48 +00:00
class-phpass.php
class-phpmailer.php Update PHPMailer to 5.2.22. 2017-01-11 01:23:41 +00:00
class-pop3.php
class-requests.php
class-simplepie.php
class-smtp.php Update PHPMailer to 5.2.22. 2017-01-11 01:23:41 +00:00
class-snoopy.php
class-walker-category-dropdown.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-walker-category.php Taxonomy: Make sure `wp_list_categories()` correctly outputs term name of `0`. 2018-09-02 22:09:24 +00:00
class-walker-comment.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-walker-nav-menu.php Docs: Correct and improve various inline documentation. 2018-03-25 19:35:29 +00:00
class-walker-page-dropdown.php Docs: Correctly specify the `$page` parameter of `list_pages` filter as a `WP_Post`. 2018-12-20 20:04:50 +00:00
class-walker-page.php Docs: Document more parameters and properties using typed array notation. 2018-03-25 18:10:32 +00:00
class-wp-admin-bar.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-ajax-response.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-block-parser.php Build tools: Fix the `travis:js` build. 2018-12-24 13:54:48 +00:00
class-wp-block-type-registry.php Blocks: Introduce `WP_Block_Type` and `WP_Block_Type_Registry` classes. 2018-12-13 09:44:23 +00:00
class-wp-block-type.php REST API: Preserve unknown, respect `null` in server-side block rendering. 2018-12-17 18:00:52 +00:00
class-wp-comment-query.php PHP7.3 compatibility: Fix compact throwing notices. 2018-12-14 05:13:52 +00:00
class-wp-comment.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-customize-control.php Docs: Remove `@static` notations from property DocBlocks in `wp-admin/*` and `wp-includes/*` classes. 2018-02-25 20:32:30 +00:00
class-wp-customize-manager.php Docs: Future-proof comments referencing 5.0 TODOs. 2018-12-17 03:07:55 +00:00
class-wp-customize-nav-menus.php Customizer: Remove a line of commented-out code in `WP_Customize_Nav_Menus::customize_register()`. 2018-12-19 07:23:47 +00:00
class-wp-customize-panel.php Docs: Remove `@static` notations from property DocBlocks in `wp-admin/*` and `wp-includes/*` classes. 2018-02-25 20:32:30 +00:00
class-wp-customize-section.php Docs: Remove `@static` notations from property DocBlocks in `wp-admin/*` and `wp-includes/*` classes. 2018-02-25 20:32:30 +00:00
class-wp-customize-setting.php General: Introduce `WP_Error::has_errors()` method and use it where appropriate. 2018-02-27 02:31:31 +00:00
class-wp-customize-widgets.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-dependency.php I18N: Add JavaScript translation support. 2018-12-14 05:52:52 +00:00
class-wp-editor.php TinyMCE: Fix the keyboard shortcut (Alt+Shift+H) to not open the default Block Editor help modal and change the title of the help modal to "Classic Block Keyboard Shortcuts" in the Classic BLock. Also remove Alt+Shift+Z in the Classic Block as it conflicts with the Block Editor. 2018-12-17 03:32:21 +00:00
class-wp-embed.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-error.php General: Introduce `WP_Error::has_errors()` method and use it where appropriate. 2018-02-27 02:31:31 +00:00
class-wp-feed-cache-transient.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-feed-cache.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-hook.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-http-cookie.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-http-curl.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-http-encoding.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-http-ixr-client.php Docs: Document more parameters and properties using typed array notation. 2018-03-25 19:33:31 +00:00
class-wp-http-proxy.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-http-requests-hooks.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-http-requests-response.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-http-response.php HTTP API: Use `WP_HTTP_Response::set_data()` in `::__construct()` instead of directly accessing the `$data` property. 2017-10-03 15:18:46 +00:00
class-wp-http-streams.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-image-editor-gd.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-image-editor-imagick.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-image-editor.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-list-util.php General: Allow `wp_list_pluck()` to operate on arrays of references without overwriting the referenced items. 2018-01-18 05:18:31 +00:00
class-wp-locale-switcher.php REST API: Render response in user locale with `?_locale=user`. 2018-12-14 01:32:39 +00:00
class-wp-locale.php I18N: Remove unused `$start_of_week` property from `WP_Locale`. 2018-02-18 16:32:34 +00:00
class-wp-matchesmapregex.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-meta-query.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-metadata-lazyloader.php Docs: Correct and improve various inline documentation. 2018-03-25 19:35:29 +00:00
class-wp-network-query.php PHP7.3 compatibility: Fix compact throwing notices. 2018-12-14 05:13:52 +00:00
class-wp-network.php Docs: Document more parameters and properties using typed array notation. 2018-03-25 19:33:31 +00:00
class-wp-oembed-controller.php Embeds: Filter HTML response in oEmbed proxy controller. 2018-12-14 03:20:37 +00:00
class-wp-post-type.php Docs: Remove `@access` notations from method DocBlocks in wp-includes/* classes. 2017-07-27 00:41:44 +00:00
class-wp-post.php Docs: Update and correct various inline documentation. 2018-05-07 17:20:22 +00:00
class-wp-query.php Query: Remove nextpage block delimiters when setting up global post data. 2018-12-17 19:29:51 +00:00
class-wp-rewrite.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-role.php Docs: Document more parameters and properties using typed array notation. 2018-03-25 19:33:31 +00:00
class-wp-roles.php Docs: Document `WP_Roles` properties with typed array notation. 2018-03-22 18:56:33 +00:00
class-wp-session-tokens.php Docs: Correct and improve docblocks for user session management functionality. 2018-09-14 13:45:26 +00:00
class-wp-simplepie-file.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-simplepie-sanitize-kses.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-site-query.php Networks and Sites: Fix incorrect variable location. 2018-12-15 11:02:18 +00:00
class-wp-site.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-tax-query.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-taxonomy.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-term-query.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-term.php Docs: Remove `@static` notations from method DocBlocks in `wp-includes/*` classes. 2018-02-25 20:22:30 +00:00
class-wp-text-diff-renderer-inline.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-text-diff-renderer-table.php Revisions: Improve performance of `WP_Text_Diff_Renderer_Table`. 2018-12-14 01:04:36 +00:00
class-wp-theme.php Bundled Themes: Make twentynineteen the default theme. 2018-12-14 02:49:38 +00:00
class-wp-user-meta-session-tokens.php Docs: Correct and improve docblocks for user session management functionality. 2018-09-14 13:45:26 +00:00
class-wp-user-query.php Users: Add a `users_pre_query` filter to short circuit WP_User_Query results. 2018-12-29 16:06:50 +00:00
class-wp-user.php Users: Add `LIMIT 1` to SQL query in `WP_User::get_data_by()`, as only one row is requested. 2018-09-23 15:33:24 +00:00
class-wp-walker.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-widget-factory.php Code is Poetry. 2017-11-30 23:11:00 +00:00
class-wp-widget.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
class-wp-xmlrpc-server.php PHP7.3 compatibility: Fix compact throwing notices. 2018-12-14 05:13:52 +00:00
class-wp.php Multisite: Validate activation links. 2018-12-13 01:26:24 +00:00
class.wp-dependencies.php Docs: Document that the `$src` parameter of `WP_Dependencies::add()` can be boolean. 2018-09-28 21:51:24 +00:00
class.wp-scripts.php I18N: Set translations for all WordPress packages scripts. 2018-12-17 03:17:04 +00:00
class.wp-styles.php Script/Style Dependencies: Simplify some logic in `WP_Styles::do_item()`. 2018-08-11 17:42:24 +00:00
comment-template.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
comment.php Update `since` annotation on `allow_empty_comment` hook. 2018-12-28 13:42:50 +00:00
compat.php General: In the `is_countable()` polyfill, if the provided object implements `SimpleXMLElement` or `ResourceBundle`, consider it countable. 2018-05-10 17:58:22 +00:00
cron.php Docs: Correct inline documentation versions. 2018-12-19 03:41:49 +00:00
date.php Docs: Correct and improve various inline documentation. 2018-03-25 19:35:29 +00:00
default-constants.php Bundled Themes: Make twentynineteen the default theme. 2018-12-14 02:49:38 +00:00
default-filters.php Styles: Add helper functions for loading block styles. 2018-12-14 03:36:38 +00:00
default-widgets.php Widgets: Introduce Gallery widget for displaying image galleries. 2017-09-25 06:28:45 +00:00
deprecated.php Administration: Change all the occurrences of "(opens in a new window)" to "(opens in a new tab)". 2018-05-05 09:45:22 +00:00
embed-template.php
embed.php Build tools: Allow building WordPress to `src`. 2018-12-24 13:29:50 +00:00
feed-atom-comments.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
feed-atom.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
feed-rdf.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
feed-rss.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
feed-rss2-comments.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
feed-rss2.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
feed.php Docs: Remove erroneous zero-width space before URL in `fetch_feed()` DocBlock. 2017-12-21 02:40:54 +00:00
formatting.php Block Editor: Update `@wordpress` dependencies. 2018-12-17 04:52:00 +00:00
functions.php Media: Improve verification of MIME file types. 2018-12-18 16:35:49 +00:00
functions.wp-scripts.php Docs: Fix typo in `wp_add_inline_script()` and `wp_add_inline_style()` description. 2018-12-20 02:42:48 +00:00
functions.wp-styles.php Docs: Fix typo in `wp_add_inline_script()` and `wp_add_inline_style()` description. 2018-12-20 02:42:48 +00:00
general-template.php Administration: Update default fallback color for SVG icons. 2018-12-20 19:01:48 +00:00
http.php HTTP: Don't treat `localhost` as same host by default. 2018-04-03 15:00:31 +00:00
kses.php PHPCS: Fix alignment issues. 2018-12-18 16:58:48 +00:00
l10n.php i18n: Remove the `script_loader_src` filter from `load_script_textdomain()`. 2018-12-19 03:34:44 +00:00
link-template.php Users: Remove unnecessary `is_null()` call in `get_avatar_data()`. 2018-12-20 02:49:48 +00:00
load.php Load: Disable PHP errors for JSON requests 2018-12-12 03:08:23 +00:00
locale.php Load: No-op `locale.php` 2016-12-03 04:16:38 +00:00
media-template.php PHPCS: Fix errors 2018-12-11 04:45:23 +00:00
media.php Docs: Ensure the optional `$width` and `$height` parameters are documented as such with defaults in the `add_image_size()` DocBlock. 2018-12-19 07:26:47 +00:00
meta.php REST API: Move object type-specific metadata integrations from the wrapper functions to the low-level Meta API functions. 2018-12-12 03:02:24 +00:00
ms-blogs.php Multisite: Fix coding standard errors after [43654]. 2018-09-24 15:22:24 +00:00
ms-default-constants.php Code is Poetry. 2017-11-30 23:11:00 +00:00
ms-default-filters.php Multisite: Introduce a site initialization and uninitialization API. 2018-09-24 15:09:26 +00:00
ms-deprecated.php Multisite: Validate activation links. 2018-12-13 01:26:24 +00:00
ms-files.php Code is Poetry. 2017-11-30 23:11:00 +00:00
ms-functions.php Multisite: Introduce a site initialization and uninitialization API. 2018-09-24 15:09:26 +00:00
ms-load.php Networks and Sites: In `get_site_by_path()`, use single `domain` and `path` parameters if there's only one item to look for. 2018-02-11 17:09:31 +00:00
ms-settings.php Code is Poetry. 2017-11-30 23:11:00 +00:00
nav-menu-template.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
nav-menu.php Nav Menus: Fix a PHP 7.3 error when switching themes. 2018-12-14 05:16:52 +00:00
option.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
pluggable-deprecated.php
pluggable.php i18n: Improve consistency of translator comments. 2018-10-02 19:51:24 +00:00
plugin.php Code is Poetry. 2017-11-30 23:11:00 +00:00
post-formats.php Post Formats: Don't assign a variable inside `if` statement in `get_post_format()`. 2018-08-30 09:01:25 +00:00
post-template.php Themes: Introduce responsive embeds support. 2018-12-14 01:50:37 +00:00
post-thumbnail-template.php Pinking shears. 2018-03-18 14:23:33 +00:00
post.php Docs: Update `@since` tag for `edit_post_{$post->post_type}` hook introduced in [43535]. 2018-12-20 02:19:48 +00:00
query.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
registration-functions.php Code is Poetry. 2017-11-30 23:11:00 +00:00
registration.php Code is Poetry. 2017-11-30 23:11:00 +00:00
rest-api.php REST API: Improve performance by avoiding `call_user_func()`. 2018-12-14 06:04:55 +00:00
revision.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
rewrite.php Code is Poetry. 2017-11-30 23:11:00 +00:00
rss-functions.php Code is Poetry. 2017-11-30 23:11:00 +00:00
rss.php
script-loader.php Block Editor: Upgrade @WordPress packages to the latest version (4.7.1) 2018-12-19 03:35:38 +00:00
session.php Code is Poetry. 2017-11-30 23:11:00 +00:00
shortcodes.php Docs: Correct parameter name in `strip_shortcodes_tagnames` filter DocBlock. 2018-08-02 15:13:27 +00:00
spl-autoload-compat.php General: Move the `__autoload()` compat function into its own file to prevent deprecated notices being thrown by the compiler in PHP 7.2. 2017-07-28 01:15:52 +00:00
taxonomy.php Update `since` annotation for `wp_insert_term_duplicate_check` filter. 2018-12-28 23:31:50 +00:00
template-loader.php Code is Poetry. 2017-11-30 23:11:00 +00:00
template.php Docs: Add missing code formatting to various `@since` entries. 2018-02-09 16:55:31 +00:00
theme.php Themes: Document the new theme features being added. 2018-12-14 03:41:37 +00:00
update.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
user.php Privacy: When clicking a confirmation link for a privacy request, return a `WP_Error` object if the link has expired. 2018-09-03 21:44:24 +00:00
vars.php Code is Poetry. 2017-11-30 23:11:00 +00:00
version.php Users: Add a `users_pre_query` filter to short circuit WP_User_Query results. 2018-12-29 16:06:50 +00:00
widgets.php Coding Standards: Upgrade WPCS to 1.0.0 2018-08-17 01:51:36 +00:00
wlwmanifest.xml
wp-db.php Docs: Update `@since` tag for the addition of query start time to logged query data. 2018-12-20 00:59:47 +00:00
wp-diff.php Code is Poetry. 2017-11-30 23:11:00 +00:00