From 1f85e7484f154912d8869886ee3e5b68b06c0bc4 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Tue, 11 Aug 2020 00:34:08 +0000 Subject: [PATCH] Docs: Consistently use third-person singular verbs for various filter descriptions, per the documentation standards. See #50768. Built from https://develop.svn.wordpress.org/trunk@48782 git-svn-id: http://core.svn.wordpress.org/trunk@48544 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-admin/includes/class-wp-ms-sites-list-table.php | 2 +- wp-admin/includes/class-wp-site-health.php | 2 +- wp-admin/includes/file.php | 4 ++-- wp-admin/includes/post.php | 6 +++--- wp-content/themes/twentyeleven/author.php | 2 +- wp-content/themes/twentyeleven/category.php | 2 +- wp-content/themes/twentyeleven/content-status.php | 2 +- wp-content/themes/twentyeleven/functions.php | 4 ++-- wp-content/themes/twentyeleven/image.php | 2 +- wp-content/themes/twentyeleven/inc/theme-options.php | 10 +++++----- wp-content/themes/twentyeleven/tag.php | 2 +- wp-content/themes/twentyfifteen/author-bio.php | 2 +- wp-content/themes/twentyfifteen/functions.php | 2 +- wp-content/themes/twentyfifteen/image.php | 2 +- wp-content/themes/twentyfifteen/inc/custom-header.php | 2 +- wp-content/themes/twentyfifteen/inc/customizer.php | 2 +- wp-content/themes/twentyfourteen/functions.php | 6 +++--- wp-content/themes/twentyfourteen/inc/custom-header.php | 2 +- wp-content/themes/twentynineteen/image.php | 2 +- .../themes/twentynineteen/inc/color-patterns.php | 10 +++++----- wp-content/themes/twentyseventeen/front-page.php | 2 +- wp-content/themes/twentyseventeen/functions.php | 4 ++-- .../themes/twentyseventeen/inc/color-patterns.php | 2 +- .../themes/twentyseventeen/inc/custom-header.php | 2 +- wp-content/themes/twentyseventeen/inc/customizer.php | 2 +- .../themes/twentyseventeen/inc/icon-functions.php | 2 +- .../themes/twentyseventeen/inc/template-functions.php | 2 +- wp-content/themes/twentysixteen/header.php | 2 +- wp-content/themes/twentysixteen/image.php | 2 +- wp-content/themes/twentysixteen/inc/customizer.php | 6 +++--- .../themes/twentysixteen/template-parts/biography.php | 2 +- wp-content/themes/twentyten/author.php | 2 +- wp-content/themes/twentyten/functions.php | 4 ++-- wp-content/themes/twentyten/loop-attachment.php | 4 ++-- wp-content/themes/twentythirteen/author-bio.php | 2 +- wp-content/themes/twentythirteen/functions.php | 2 +- wp-content/themes/twentytwelve/author.php | 2 +- wp-content/themes/twentytwelve/content-status.php | 2 +- wp-content/themes/twentytwelve/image.php | 2 +- .../classes/class-twentytwenty-customize.php | 2 +- wp-includes/class-wp-comment-query.php | 2 +- wp-includes/class-wp-customize-manager.php | 4 ++-- wp-includes/class-wp-network-query.php | 2 +- wp-includes/class-wp-recovery-mode-cookie-service.php | 3 ++- wp-includes/class-wp-recovery-mode-email-service.php | 2 +- wp-includes/class-wp-recovery-mode-link-service.php | 2 +- wp-includes/class-wp-recovery-mode.php | 4 ++-- wp-includes/class-wp-site-query.php | 2 +- wp-includes/class-wp-term-query.php | 2 +- wp-includes/cron.php | 2 +- .../class-wp-customize-custom-css-setting.php | 2 +- wp-includes/media.php | 2 +- wp-includes/post.php | 2 +- wp-includes/rest-api.php | 2 +- .../class-wp-rest-block-directory-controller.php | 2 +- .../endpoints/class-wp-rest-comments-controller.php | 4 ++-- .../endpoints/class-wp-rest-posts-controller.php | 4 ++-- .../endpoints/class-wp-rest-terms-controller.php | 2 +- .../endpoints/class-wp-rest-themes-controller.php | 2 +- .../endpoints/class-wp-rest-users-controller.php | 2 +- .../providers/class-wp-sitemaps-taxonomies.php | 2 +- wp-includes/taxonomy.php | 2 +- wp-includes/update.php | 2 +- wp-includes/user.php | 5 +++-- wp-includes/version.php | 2 +- wp-includes/widgets/class-wp-widget-custom-html.php | 2 +- wp-includes/widgets/class-wp-widget-text.php | 2 +- 67 files changed, 93 insertions(+), 91 deletions(-) diff --git a/wp-admin/includes/class-wp-ms-sites-list-table.php b/wp-admin/includes/class-wp-ms-sites-list-table.php index 50ba8f32ef..e1d15d6337 100644 --- a/wp-admin/includes/class-wp-ms-sites-list-table.php +++ b/wp-admin/includes/class-wp-ms-sites-list-table.php @@ -626,7 +626,7 @@ class WP_MS_Sites_List_Table extends WP_List_Table { } /** - * Filter the default site display states for items in the Sites list table. + * Filters the default site display states for items in the Sites list table. * * @since 5.3.0 * diff --git a/wp-admin/includes/class-wp-site-health.php b/wp-admin/includes/class-wp-site-health.php index c27a50a2ef..2fd570318d 100644 --- a/wp-admin/includes/class-wp-site-health.php +++ b/wp-admin/includes/class-wp-site-health.php @@ -152,7 +152,7 @@ class WP_Site_Health { */ private function perform_test( $callback ) { /** - * Filter the output of a finished Site Health test. + * Filters the output of a finished Site Health test. * * @since 5.3.0 * diff --git a/wp-admin/includes/file.php b/wp-admin/includes/file.php index e22292c4f8..0625bec9e2 100644 --- a/wp-admin/includes/file.php +++ b/wp-admin/includes/file.php @@ -1125,7 +1125,7 @@ function download_url( $url, $timeout = 300, $signature_verification = false ) { } /** - * Filter the URL where the signature for a file is located. + * Filters the URL where the signature for a file is located. * * @since 5.2.0 * @@ -1394,7 +1394,7 @@ function wp_trusted_keys() { // TODO: Add key #2 with longer expiration. /** - * Filter the valid signing keys used to verify the contents of files. + * Filters the valid signing keys used to verify the contents of files. * * @since 5.2.0 * diff --git a/wp-admin/includes/post.php b/wp-admin/includes/post.php index 7ad1ed361d..398add09ea 100644 --- a/wp-admin/includes/post.php +++ b/wp-admin/includes/post.php @@ -2127,7 +2127,7 @@ function use_block_editor_for_post( $post ) { $use_block_editor = use_block_editor_for_post_type( $post->post_type ); /** - * Filter whether a post is able to be edited in the block editor. + * Filters whether a post is able to be edited in the block editor. * * @since 5.0.0 * @@ -2163,7 +2163,7 @@ function use_block_editor_for_post_type( $post_type ) { } /** - * Filter whether a post is able to be edited in the block editor. + * Filters whether a post is able to be edited in the block editor. * * @since 5.0.0 * @@ -2216,7 +2216,7 @@ function get_block_categories( $post ) { ); /** - * Filter the default array of block categories. + * Filters the default array of block categories. * * @since 5.0.0 * diff --git a/wp-content/themes/twentyeleven/author.php b/wp-content/themes/twentyeleven/author.php index 5751e33410..2a53f6c14f 100644 --- a/wp-content/themes/twentyeleven/author.php +++ b/wp-content/themes/twentyeleven/author.php @@ -53,7 +53,7 @@ get_header(); ?>
$category_description = category_description(); if ( ! empty( $category_description ) ) { /** - * Filter the default Twenty Eleven category description. + * Filters the default Twenty Eleven category description. * * @since Twenty Eleven 1.0 * diff --git a/wp-content/themes/twentyeleven/content-status.php b/wp-content/themes/twentyeleven/content-status.php index 9372596490..587f10c854 100644 --- a/wp-content/themes/twentyeleven/content-status.php +++ b/wp-content/themes/twentyeleven/content-status.php @@ -35,7 +35,7 @@
'000', // The height and width of our custom header. /** - * Filter the Twenty Eleven default header image width. + * Filters the Twenty Eleven default header image width. * * @since Twenty Eleven 1.0 * @@ -182,7 +182,7 @@ if ( ! function_exists( 'twentyeleven_setup' ) ) : */ 'width' => apply_filters( 'twentyeleven_header_image_width', 1000 ), /** - * Filter the Twenty Eleven default header image height. + * Filters the Twenty Eleven default header image height. * * @since Twenty Eleven 1.0 * diff --git a/wp-content/themes/twentyeleven/image.php b/wp-content/themes/twentyeleven/image.php index 8625991dda..2476da44a3 100644 --- a/wp-content/themes/twentyeleven/image.php +++ b/wp-content/themes/twentyeleven/image.php @@ -93,7 +93,7 @@ get_header(); ?> $tag_description = tag_description(); if ( ! empty( $tag_description ) ) { /** - * Filter the default Twenty Eleven tag description. + * Filters the default Twenty Eleven tag description. * * @since Twenty Eleven 1.0 * diff --git a/wp-content/themes/twentyfifteen/author-bio.php b/wp-content/themes/twentyfifteen/author-bio.php index 6457b13c87..995ad1a4c7 100644 --- a/wp-content/themes/twentyfifteen/author-bio.php +++ b/wp-content/themes/twentyfifteen/author-bio.php @@ -13,7 +13,7 @@
if ( 0 !== twentyseventeen_panel_count() || is_customize_preview() ) : // If we have pages to show. /** - * Filter number of front page sections in Twenty Seventeen. + * Filters the number of front page sections in Twenty Seventeen. * * @since Twenty Seventeen 1.0 * diff --git a/wp-content/themes/twentyseventeen/functions.php b/wp-content/themes/twentyseventeen/functions.php index e3c6ef91c2..180b3fc328 100644 --- a/wp-content/themes/twentyseventeen/functions.php +++ b/wp-content/themes/twentyseventeen/functions.php @@ -267,7 +267,7 @@ function twentyseventeen_content_width() { } /** - * Filter Twenty Seventeen content width of the theme. + * Filters Twenty Seventeen content width of the theme. * * @since Twenty Seventeen 1.0 * @@ -544,7 +544,7 @@ function twentyseventeen_content_image_sizes_attr( $sizes, $size ) { add_filter( 'wp_calculate_image_sizes', 'twentyseventeen_content_image_sizes_attr', 10, 2 ); /** - * Filter the `sizes` value in the header image markup. + * Filters the `sizes` value in the header image markup. * * @since Twenty Seventeen 1.0 * diff --git a/wp-content/themes/twentyseventeen/inc/color-patterns.php b/wp-content/themes/twentyseventeen/inc/color-patterns.php index 2e3422ffc2..5ef97829cb 100644 --- a/wp-content/themes/twentyseventeen/inc/color-patterns.php +++ b/wp-content/themes/twentyseventeen/inc/color-patterns.php @@ -14,7 +14,7 @@ function twentyseventeen_custom_colors_css() { $hue = absint( get_theme_mod( 'colorscheme_hue', 250 ) ); /** - * Filter Twenty Seventeen default saturation level. + * Filters Twenty Seventeen default saturation level. * * @since Twenty Seventeen 1.0 * diff --git a/wp-content/themes/twentyseventeen/inc/custom-header.php b/wp-content/themes/twentyseventeen/inc/custom-header.php index 2e25a98f65..24678dcd02 100644 --- a/wp-content/themes/twentyseventeen/inc/custom-header.php +++ b/wp-content/themes/twentyseventeen/inc/custom-header.php @@ -19,7 +19,7 @@ function twentyseventeen_custom_header_setup() { add_theme_support( 'custom-header', /** - * Filter Twenty Seventeen custom-header support arguments. + * Filters Twenty Seventeen custom-header support arguments. * * @since Twenty Seventeen 1.0 * diff --git a/wp-content/themes/twentyseventeen/inc/customizer.php b/wp-content/themes/twentyseventeen/inc/customizer.php index 1e9c60c9bf..635212cf27 100644 --- a/wp-content/themes/twentyseventeen/inc/customizer.php +++ b/wp-content/themes/twentyseventeen/inc/customizer.php @@ -116,7 +116,7 @@ function twentyseventeen_customize_register( $wp_customize ) { ); /** - * Filter number of front page sections in Twenty Seventeen. + * Filters the number of front page sections in Twenty Seventeen. * * @since Twenty Seventeen 1.0 * diff --git a/wp-content/themes/twentyseventeen/inc/icon-functions.php b/wp-content/themes/twentyseventeen/inc/icon-functions.php index 4a0964ca61..44bfe9ec53 100644 --- a/wp-content/themes/twentyseventeen/inc/icon-functions.php +++ b/wp-content/themes/twentyseventeen/inc/icon-functions.php @@ -213,7 +213,7 @@ function twentyseventeen_social_links_icons() { ); /** - * Filter Twenty Seventeen social links icons. + * Filters Twenty Seventeen social links icons. * * @since Twenty Seventeen 1.0 * diff --git a/wp-content/themes/twentyseventeen/inc/template-functions.php b/wp-content/themes/twentyseventeen/inc/template-functions.php index 55f4c9aa55..8ccc393b07 100644 --- a/wp-content/themes/twentyseventeen/inc/template-functions.php +++ b/wp-content/themes/twentyseventeen/inc/template-functions.php @@ -76,7 +76,7 @@ function twentyseventeen_panel_count() { $panel_count = 0; /** - * Filter number of front page sections in Twenty Seventeen. + * Filters the number of front page sections in Twenty Seventeen. * * @since Twenty Seventeen 1.0 * diff --git a/wp-content/themes/twentysixteen/header.php b/wp-content/themes/twentysixteen/header.php index 28c587857b..c6d3d8cc03 100644 --- a/wp-content/themes/twentysixteen/header.php +++ b/wp-content/themes/twentysixteen/header.php @@ -85,7 +85,7 @@
'%s/images/headers/path.jpg', // The height and width of our custom header. /** - * Filter the Twenty Ten default header image width. + * Filters the Twenty Ten default header image width. * * @since Twenty Ten 1.0 * @@ -165,7 +165,7 @@ if ( ! function_exists( 'twentyten_setup' ) ) : */ 'width' => apply_filters( 'twentyten_header_image_width', 940 ), /** - * Filter the Twenty Ten defaul header image height. + * Filters the Twenty Ten defaul header image height. * * @since Twenty Ten 1.0 * diff --git a/wp-content/themes/twentyten/loop-attachment.php b/wp-content/themes/twentyten/loop-attachment.php index bf1af53c54..8298c6dd7e 100644 --- a/wp-content/themes/twentyten/loop-attachment.php +++ b/wp-content/themes/twentyten/loop-attachment.php @@ -123,7 +123,7 @@ if ( have_posts() ) {

generate_cookie(); /** - * Filter the length of time a Recovery Mode cookie is valid for. + * Filters the length of time a Recovery Mode cookie is valid for. * * @since 5.2.0 * * @param int $length Length in seconds. */ $length = apply_filters( 'recovery_mode_cookie_length', WEEK_IN_SECONDS ); + $expire = time() + $length; setcookie( RECOVERY_MODE_COOKIE, $value, $expire, COOKIEPATH, COOKIE_DOMAIN, is_ssl(), true ); diff --git a/wp-includes/class-wp-recovery-mode-email-service.php b/wp-includes/class-wp-recovery-mode-email-service.php index 45ab25f88b..0f9d2f3195 100644 --- a/wp-includes/class-wp-recovery-mode-email-service.php +++ b/wp-includes/class-wp-recovery-mode-email-service.php @@ -202,7 +202,7 @@ When seeking help with this issue, you may be asked for some of the following in ); /** - * Filter the contents of the Recovery Mode email. + * Filters the contents of the Recovery Mode email. * * @since 5.2.0 * diff --git a/wp-includes/class-wp-recovery-mode-link-service.php b/wp-includes/class-wp-recovery-mode-link-service.php index 1344cb7cab..7e7db7a1e0 100644 --- a/wp-includes/class-wp-recovery-mode-link-service.php +++ b/wp-includes/class-wp-recovery-mode-link-service.php @@ -114,7 +114,7 @@ class WP_Recovery_Mode_Link_Service { ); /** - * Filter the URL to begin recovery mode. + * Filters the URL to begin recovery mode. * * @since 5.2.0 * diff --git a/wp-includes/class-wp-recovery-mode.php b/wp-includes/class-wp-recovery-mode.php index a9a2146ed1..1694e42e56 100644 --- a/wp-includes/class-wp-recovery-mode.php +++ b/wp-includes/class-wp-recovery-mode.php @@ -297,7 +297,7 @@ class WP_Recovery_Mode { */ protected function get_email_rate_limit() { /** - * Filter the rate limit between sending new recovery mode email links. + * Filters the rate limit between sending new recovery mode email links. * * @since 5.2.0 * @@ -319,7 +319,7 @@ class WP_Recovery_Mode { $valid_for = $rate_limit; /** - * Filter the amount of time the recovery mode email link is valid for. + * Filters the amount of time the recovery mode email link is valid for. * * The ttl must be at least as long as the email rate limit. * diff --git a/wp-includes/class-wp-site-query.php b/wp-includes/class-wp-site-query.php index c81e5279c7..702488fc06 100644 --- a/wp-includes/class-wp-site-query.php +++ b/wp-includes/class-wp-site-query.php @@ -291,7 +291,7 @@ class WP_Site_Query { $site_data = null; /** - * Filter the site data before the get_sites query takes place. + * Filters the site data before the get_sites query takes place. * * Return a non-null value to bypass WordPress's default site queries. * diff --git a/wp-includes/class-wp-term-query.php b/wp-includes/class-wp-term-query.php index 15198a3356..4009e100d3 100644 --- a/wp-includes/class-wp-term-query.php +++ b/wp-includes/class-wp-term-query.php @@ -688,7 +688,7 @@ class WP_Term_Query { $this->terms = null; /** - * Filter the terms array before the query takes place. + * Filters the terms array before the query takes place. * * Return a non-null value to bypass WordPress's default term queries. * diff --git a/wp-includes/cron.php b/wp-includes/cron.php index 5ce79deaf3..984e83a9f2 100644 --- a/wp-includes/cron.php +++ b/wp-includes/cron.php @@ -863,7 +863,7 @@ function wp_get_schedule( $hook, $args = array() ) { } /** - * Filter the schedule for a hook. + * Filters the schedule for a hook. * * @since 5.1.0 * diff --git a/wp-includes/customize/class-wp-customize-custom-css-setting.php b/wp-includes/customize/class-wp-customize-custom-css-setting.php index f1911c88ec..39750f864c 100644 --- a/wp-includes/customize/class-wp-customize-custom-css-setting.php +++ b/wp-includes/customize/class-wp-customize-custom-css-setting.php @@ -90,7 +90,7 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting { } /** - * Filter `wp_get_custom_css` for applying the customized value. + * Filters `wp_get_custom_css` for applying the customized value. * * This is used in the preview when `wp_get_custom_css()` is called for rendering the styles. * diff --git a/wp-includes/media.php b/wp-includes/media.php index b6b0800d67..3df41f58f7 100644 --- a/wp-includes/media.php +++ b/wp-includes/media.php @@ -1553,7 +1553,7 @@ function wp_image_file_matches_image_meta( $image_location, $image_meta, $attach } /** - * Filter whether an image path or URI matches image meta. + * Filters whether an image path or URI matches image meta. * * @since 5.5.0 * diff --git a/wp-includes/post.php b/wp-includes/post.php index 8702d3e796..f41a5e96c2 100644 --- a/wp-includes/post.php +++ b/wp-includes/post.php @@ -7330,7 +7330,7 @@ function wp_add_trashed_suffix_to_post_name_for_post( $post ) { } /** - * Filter the SQL clauses of an attachment query to include filenames. + * Filters the SQL clauses of an attachment query to include filenames. * * @since 4.7.0 * @access private diff --git a/wp-includes/rest-api.php b/wp-includes/rest-api.php index a43019150a..12e3df3247 100644 --- a/wp-includes/rest-api.php +++ b/wp-includes/rest-api.php @@ -786,7 +786,7 @@ function _rest_array_intersect_key_recursive( $array1, $array2 ) { } /** - * Filter the API response to include only a white-listed set of response object fields. + * Filters the API response to include only a white-listed set of response object fields. * * @since 4.8.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php index 4dc0f17fbe..c2069b21bc 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-block-directory-controller.php @@ -308,7 +308,7 @@ class WP_REST_Block_Directory_Controller extends WP_REST_Controller { unset( $query_params['search'] ); /** - * Filter collection parameters for the block directory controller. + * Filters collection parameters for the block directory controller. * * @since 5.5.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php index d72efedcbc..b921144684 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php @@ -449,7 +449,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { } /** - * Filter whether comments can be created without authentication. + * Filters whether comments can be created without authentication. * * Enables creating comments for anonymous users. * @@ -1676,7 +1676,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ); /** - * Filter collection parameters for the comments controller. + * Filters collection parameters for the comments controller. * * This filter registers the collection parameter, but does not map the * collection parameter to an internal WP_Comment_Query parameter. Use the diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php index 9f33459612..90de111538 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php @@ -2411,7 +2411,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { $schema_fields = array_keys( $schema['properties'] ); /** - * Filter the post's schema. + * Filters the post's schema. * * The dynamic portion of the filter, `$this->post_type`, refers to the * post type slug for the controller. @@ -2752,7 +2752,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { } /** - * Filter collection parameters for the posts controller. + * Filters collection parameters for the posts controller. * * The dynamic part of the filter `$this->post_type` refers to the post * type slug for the controller. diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php index e444d26839..7ee484e649 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php @@ -1081,7 +1081,7 @@ class WP_REST_Terms_Controller extends WP_REST_Controller { ); /** - * Filter collection parameters for the terms controller. + * Filters collection parameters for the terms controller. * * The dynamic part of the filter `$this->taxonomy` refers to the taxonomy * slug for the controller. diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php index 591e3b838b..f8737276e9 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php @@ -439,7 +439,7 @@ class WP_REST_Themes_Controller extends WP_REST_Controller { ); /** - * Filter collection parameters for the themes controller. + * Filters collection parameters for the themes controller. * * @since 5.0.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php index 21a4b829a7..d8a969705c 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php @@ -1559,7 +1559,7 @@ class WP_REST_Users_Controller extends WP_REST_Controller { ); /** - * Filter collection parameters for the users controller. + * Filters 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 diff --git a/wp-includes/sitemaps/providers/class-wp-sitemaps-taxonomies.php b/wp-includes/sitemaps/providers/class-wp-sitemaps-taxonomies.php index b8ea2e94d2..34ff5212e4 100644 --- a/wp-includes/sitemaps/providers/class-wp-sitemaps-taxonomies.php +++ b/wp-includes/sitemaps/providers/class-wp-sitemaps-taxonomies.php @@ -38,7 +38,7 @@ class WP_Sitemaps_Taxonomies extends WP_Sitemaps_Provider { $taxonomies = array_filter( $taxonomies, 'is_taxonomy_viewable' ); /** - * Filter the list of taxonomy object subtypes available within the sitemap. + * Filters the list of taxonomy object subtypes available within the sitemap. * * @since 5.5.0 * diff --git a/wp-includes/taxonomy.php b/wp-includes/taxonomy.php index dc4402d565..af5a20a443 100644 --- a/wp-includes/taxonomy.php +++ b/wp-includes/taxonomy.php @@ -2050,7 +2050,7 @@ function wp_get_object_terms( $object_ids, $taxonomies, $args = array() ) { $args = wp_parse_args( $args ); /** - * Filter arguments for retrieving object terms. + * Filters arguments for retrieving object terms. * * @since 4.9.0 * diff --git a/wp-includes/update.php b/wp-includes/update.php index 734afeb96e..a5df68a40f 100644 --- a/wp-includes/update.php +++ b/wp-includes/update.php @@ -105,7 +105,7 @@ function wp_version_check( $extra_stats = array(), $force_check = false ) { ); /** - * Filter the query arguments sent as part of the core version check. + * Filters the query arguments sent as part of the core version check. * * WARNING: Changing this data may result in your site not receiving security updates. * Please exercise extreme caution. diff --git a/wp-includes/user.php b/wp-includes/user.php index 4994563d08..22a9639033 100644 --- a/wp-includes/user.php +++ b/wp-includes/user.php @@ -896,8 +896,9 @@ function count_users( $strategy = 'time', $site_id = null ) { } /** - * Filter the user count before queries are run. Return a non-null value to cause count_users() - * to return early. + * Filters the user count before queries are run. + * + * Return a non-null value to cause count_users() to return early. * * @since 5.1.0 * diff --git a/wp-includes/version.php b/wp-includes/version.php index d86df04c03..893a9197ca 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.6-alpha-48778'; +$wp_version = '5.6-alpha-48782'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. diff --git a/wp-includes/widgets/class-wp-widget-custom-html.php b/wp-includes/widgets/class-wp-widget-custom-html.php index d947aeae8e..b9140e65e8 100644 --- a/wp-includes/widgets/class-wp-widget-custom-html.php +++ b/wp-includes/widgets/class-wp-widget-custom-html.php @@ -83,7 +83,7 @@ class WP_Widget_Custom_HTML extends WP_Widget { } /** - * Filter gallery shortcode attributes. + * Filters gallery shortcode attributes. * * Prevents all of a site's attachments from being shown in a gallery displayed on a * non-singular template where a $post context is not available. diff --git a/wp-includes/widgets/class-wp-widget-text.php b/wp-includes/widgets/class-wp-widget-text.php index bd9c1df230..8cac1b9185 100644 --- a/wp-includes/widgets/class-wp-widget-text.php +++ b/wp-includes/widgets/class-wp-widget-text.php @@ -193,7 +193,7 @@ class WP_Widget_Text extends WP_Widget { } /** - * Filter gallery shortcode attributes. + * Filters gallery shortcode attributes. * * Prevents all of a site's attachments from being shown in a gallery displayed on a * non-singular template where a $post context is not available.