From 602b51a209e39462e45003378df2bf89d008aa72 Mon Sep 17 00:00:00 2001 From: Drew Jaynes Date: Sun, 22 May 2016 18:15:28 +0000 Subject: [PATCH] Docs: Standardize filter docs in core classes in wp-includes/* to use third-person singular verbs per the inline documentation standards for PHP. See #36913. Built from https://develop.svn.wordpress.org/trunk@37492 git-svn-id: http://core.svn.wordpress.org/trunk@37460 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/class-wp-comment-query.php | 6 +-- wp-includes/class-wp-editor.php | 40 ++++++++-------- wp-includes/class-wp-embed.php | 12 ++--- wp-includes/class-wp-http-cookie.php | 2 +- wp-includes/class-wp-http-curl.php | 2 +- wp-includes/class-wp-http-encoding.php | 2 +- wp-includes/class-wp-http-ixr-client.php | 2 +- wp-includes/class-wp-http-proxy.php | 2 +- wp-includes/class-wp-http-streams.php | 6 +-- wp-includes/class-wp-image-editor-gd.php | 4 +- wp-includes/class-wp-image-editor-imagick.php | 2 +- wp-includes/class-wp-image-editor.php | 6 +-- wp-includes/class-wp-meta-query.php | 4 +- wp-includes/class-wp-network.php | 2 +- wp-includes/class-wp-oembed-controller.php | 4 +- wp-includes/class-wp-rewrite.php | 28 +++++------ wp-includes/class-wp-role.php | 2 +- wp-includes/class-wp-theme.php | 8 ++-- wp-includes/class-wp-user-query.php | 4 +- wp-includes/class-wp-widget.php | 6 +-- wp-includes/class-wp-xmlrpc-server.php | 48 +++++++++---------- wp-includes/version.php | 2 +- 22 files changed, 97 insertions(+), 97 deletions(-) diff --git a/wp-includes/class-wp-comment-query.php b/wp-includes/class-wp-comment-query.php index 39b538ce43..78763b74da 100644 --- a/wp-includes/class-wp-comment-query.php +++ b/wp-includes/class-wp-comment-query.php @@ -414,7 +414,7 @@ class WP_Comment_Query { if ( $comment_ids && $this->query_vars['number'] && ! $this->query_vars['no_found_rows'] ) { /** - * Filter the query used to retrieve found comment count. + * Filters the query used to retrieve found comment count. * * @since 4.4.0 * @@ -453,7 +453,7 @@ class WP_Comment_Query { } /** - * Filter the comment query results. + * Filters the comment query results. * * @since 3.1.0 * @@ -850,7 +850,7 @@ class WP_Comment_Query { $pieces = array( 'fields', 'join', 'where', 'orderby', 'limits', 'groupby' ); /** - * Filter the comment query clauses. + * Filters the comment query clauses. * * @since 3.1.0 * diff --git a/wp-includes/class-wp-editor.php b/wp-includes/class-wp-editor.php index 38c650c416..395705f26e 100644 --- a/wp-includes/class-wp-editor.php +++ b/wp-includes/class-wp-editor.php @@ -66,7 +66,7 @@ final class _WP_Editors { public static function parse_settings( $editor_id, $settings ) { /** - * Filter the wp_editor() settings. + * Filters the wp_editor() settings. * * @since 4.0.0 * @@ -241,7 +241,7 @@ final class _WP_Editors { } /** - * Filter the HTML markup output that displays the editor. + * Filters the HTML markup output that displays the editor. * * @since 2.1.0 * @@ -258,7 +258,7 @@ final class _WP_Editors { } /** - * Filter the default editor content. + * Filters the default editor content. * * @since 2.1.0 * @@ -333,7 +333,7 @@ final class _WP_Editors { } /** - * Filter the Quicktags settings. + * Filters the Quicktags settings. * * @since 3.3.0 * @@ -362,7 +362,7 @@ final class _WP_Editors { if ( $set['teeny'] ) { /** - * Filter the list of teenyMCE plugins. + * Filters the list of teenyMCE plugins. * * @since 2.7.0 * @@ -373,7 +373,7 @@ final class _WP_Editors { } else { /** - * Filter the list of TinyMCE external plugins. + * Filters the list of TinyMCE external plugins. * * The filter takes an associative array of external plugins for * TinyMCE in the form 'plugin_name' => 'url'. @@ -418,7 +418,7 @@ final class _WP_Editors { } /** - * Filter the list of default TinyMCE plugins. + * Filters the list of default TinyMCE plugins. * * The filter specifies which of the default plugins included * in WordPress should be added to the TinyMCE instance. @@ -438,7 +438,7 @@ final class _WP_Editors { if ( ! empty( $mce_external_plugins ) ) { /** - * Filter the translations loaded for external TinyMCE 3.x plugins. + * Filters the translations loaded for external TinyMCE 3.x plugins. * * The filter takes an associative array ('plugin_name' => 'path') * where 'path' is the include path to the file. @@ -576,7 +576,7 @@ final class _WP_Editors { } /** - * Filter the comma-delimited list of stylesheets to load in TinyMCE. + * Filters the comma-delimited list of stylesheets to load in TinyMCE. * * @since 2.1.0 * @@ -591,7 +591,7 @@ final class _WP_Editors { if ( $set['teeny'] ) { /** - * Filter the list of teenyMCE buttons (Text tab). + * Filters the list of teenyMCE buttons (Text tab). * * @since 2.7.0 * @@ -614,7 +614,7 @@ final class _WP_Editors { $mce_buttons[] = 'wp_adv'; /** - * Filter the first-row list of TinyMCE buttons (Visual tab). + * Filters the first-row list of TinyMCE buttons (Visual tab). * * @since 2.0.0 * @@ -630,7 +630,7 @@ final class _WP_Editors { } /** - * Filter the second-row list of TinyMCE buttons (Visual tab). + * Filters the second-row list of TinyMCE buttons (Visual tab). * * @since 2.0.0 * @@ -640,7 +640,7 @@ final class _WP_Editors { $mce_buttons_2 = apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id ); /** - * Filter the third-row list of TinyMCE buttons (Visual tab). + * Filters the third-row list of TinyMCE buttons (Visual tab). * * @since 2.0.0 * @@ -650,7 +650,7 @@ final class _WP_Editors { $mce_buttons_3 = apply_filters( 'mce_buttons_3', array(), $editor_id ); /** - * Filter the fourth-row list of TinyMCE buttons (Visual tab). + * Filters the fourth-row list of TinyMCE buttons (Visual tab). * * @since 2.5.0 * @@ -711,7 +711,7 @@ final class _WP_Editors { if ( $set['teeny'] ) { /** - * Filter the teenyMCE config before init. + * Filters the teenyMCE config before init. * * @since 2.7.0 * @@ -722,7 +722,7 @@ final class _WP_Editors { } else { /** - * Filter the TinyMCE config before init. + * Filters the TinyMCE config before init. * * @since 2.5.0 * @@ -1089,7 +1089,7 @@ final class _WP_Editors { } /** - * Filter translated strings prepared for TinyMCE. + * Filters translated strings prepared for TinyMCE. * * @since 3.9.0 * @@ -1137,7 +1137,7 @@ final class _WP_Editors { global $wp_version, $tinymce_version, $concatenate_scripts, $compress_scripts; /** - * Filter "tiny_mce_version" is deprecated + * Filters "tiny_mce_version" is deprecated * * The tiny_mce_version filter is not needed since external plugins are loaded directly by TinyMCE. * These plugins can be refreshed by appending query string to the URL passed to "mce_external_plugins" filter. @@ -1335,7 +1335,7 @@ final class _WP_Editors { $query['offset'] = $args['pagenum'] > 1 ? $query['posts_per_page'] * ( $args['pagenum'] - 1 ) : 0; /** - * Filter the link query arguments. + * Filters the link query arguments. * * Allows modification of the link query arguments before querying. * @@ -1371,7 +1371,7 @@ final class _WP_Editors { } /** - * Filter the link query results. + * Filters the link query results. * * Allows modification of the returned link query results. * diff --git a/wp-includes/class-wp-embed.php b/wp-includes/class-wp-embed.php index b53b5fed65..4cb475f5d4 100644 --- a/wp-includes/class-wp-embed.php +++ b/wp-includes/class-wp-embed.php @@ -165,7 +165,7 @@ class WP_Embed { if ( preg_match( $handler['regex'], $url, $matches ) && is_callable( $handler['callback'] ) ) { if ( false !== $return = call_user_func( $handler['callback'], $matches, $attr, $url, $rawattr ) ) /** - * Filter the returned embed handler. + * Filters the returned embed handler. * * @since 2.9.0 * @@ -193,7 +193,7 @@ class WP_Embed { $cachekey_time = '_oembed_time_' . $key_suffix; /** - * Filter the oEmbed TTL value (time to live). + * Filters the oEmbed TTL value (time to live). * * @since 4.0.0 * @@ -220,7 +220,7 @@ class WP_Embed { if ( ! empty( $cache ) ) { /** - * Filter the cached oEmbed HTML. + * Filters the cached oEmbed HTML. * * @since 2.9.0 * @@ -236,7 +236,7 @@ class WP_Embed { } /** - * Filter whether to inspect the given URL for discoverable link tags. + * Filters whether to inspect the given URL for discoverable link tags. * * @since 2.9.0 * @since 4.4.0 The default value changed to true. @@ -295,7 +295,7 @@ class WP_Embed { $post_types = get_post_types( array( 'show_ui' => true ) ); /** - * Filter the array of post types to cache oEmbed results for. + * Filters the array of post types to cache oEmbed results for. * * @since 2.9.0 * @@ -365,7 +365,7 @@ class WP_Embed { $output = ( $this->linkifunknown ) ? '' . esc_html($url) . '' : $url; /** - * Filter the returned, maybe-linked embed URL. + * Filters the returned, maybe-linked embed URL. * * @since 2.9.0 * diff --git a/wp-includes/class-wp-http-cookie.php b/wp-includes/class-wp-http-cookie.php index 95148efd53..8ae947be57 100644 --- a/wp-includes/class-wp-http-cookie.php +++ b/wp-includes/class-wp-http-cookie.php @@ -195,7 +195,7 @@ class WP_Http_Cookie { return ''; /** - * Filter the header-encoded cookie value. + * Filters the header-encoded cookie value. * * @since 3.4.0 * diff --git a/wp-includes/class-wp-http-curl.php b/wp-includes/class-wp-http-curl.php index a161677ccc..790e93cffb 100644 --- a/wp-includes/class-wp-http-curl.php +++ b/wp-includes/class-wp-http-curl.php @@ -373,7 +373,7 @@ class WP_Http_Curl { } /** - * Filter whether cURL can be used as a transport for retrieving a URL. + * Filters whether cURL can be used as a transport for retrieving a URL. * * @since 2.7.0 * diff --git a/wp-includes/class-wp-http-encoding.php b/wp-includes/class-wp-http-encoding.php index eee8469592..fd419524f0 100644 --- a/wp-includes/class-wp-http-encoding.php +++ b/wp-includes/class-wp-http-encoding.php @@ -161,7 +161,7 @@ class WP_Http_Encoding { } /** - * Filter the allowed encoding types. + * Filters the allowed encoding types. * * @since 3.6.0 * diff --git a/wp-includes/class-wp-http-ixr-client.php b/wp-includes/class-wp-http-ixr-client.php index 601ca14319..e4ed55020f 100644 --- a/wp-includes/class-wp-http-ixr-client.php +++ b/wp-includes/class-wp-http-ixr-client.php @@ -69,7 +69,7 @@ class WP_HTTP_IXR_Client extends IXR_Client { } /** - * Filter the headers collection to be sent to the XML-RPC server. + * Filters the headers collection to be sent to the XML-RPC server. * * @since 4.4.0 * diff --git a/wp-includes/class-wp-http-proxy.php b/wp-includes/class-wp-http-proxy.php index af9d338be5..7ae3d4e266 100644 --- a/wp-includes/class-wp-http-proxy.php +++ b/wp-includes/class-wp-http-proxy.php @@ -176,7 +176,7 @@ class WP_HTTP_Proxy { $home = parse_url( get_option('siteurl') ); /** - * Filter whether to preempt sending the request through the proxy server. + * Filters whether to preempt sending the request through the proxy server. * * Returning false will bypass the proxy; returning true will send * the request through the proxy. Returning null bypasses the filter. diff --git a/wp-includes/class-wp-http-streams.php b/wp-includes/class-wp-http-streams.php index 3620446a96..2f10c67598 100644 --- a/wp-includes/class-wp-http-streams.php +++ b/wp-includes/class-wp-http-streams.php @@ -89,7 +89,7 @@ class WP_Http_Streams { $ssl_verify = isset( $r['sslverify'] ) && $r['sslverify']; if ( $is_local ) { /** - * Filter whether SSL should be verified for local requests. + * Filters whether SSL should be verified for local requests. * * @since 2.8.0 * @@ -98,7 +98,7 @@ class WP_Http_Streams { $ssl_verify = apply_filters( 'https_local_ssl_verify', $ssl_verify ); } elseif ( ! $is_local ) { /** - * Filter whether SSL should be verified for non-local requests. + * Filters whether SSL should be verified for non-local requests. * * @since 2.8.0 * @@ -401,7 +401,7 @@ class WP_Http_Streams { } /** - * Filter whether streams can be used as a transport for retrieving a URL. + * Filters whether streams can be used as a transport for retrieving a URL. * * @since 2.7.0 * diff --git a/wp-includes/class-wp-image-editor-gd.php b/wp-includes/class-wp-image-editor-gd.php index 2093c6b462..f41a1ed432 100644 --- a/wp-includes/class-wp-image-editor-gd.php +++ b/wp-includes/class-wp-image-editor-gd.php @@ -97,7 +97,7 @@ class WP_Image_Editor_GD extends WP_Image_Editor { return new WP_Error( 'error_loading_image', __('File doesn’t exist?'), $this->file ); /** - * Filter the memory limit allocated for image manipulation. + * Filters the memory limit allocated for image manipulation. * * @since 3.5.0 * @@ -429,7 +429,7 @@ class WP_Image_Editor_GD extends WP_Image_Editor { @ chmod( $filename, $perms ); /** - * Filter the name of the saved image file. + * Filters the name of the saved image file. * * @since 2.6.0 * diff --git a/wp-includes/class-wp-image-editor-imagick.php b/wp-includes/class-wp-image-editor-imagick.php index bbc9fa85a1..ddfb06c139 100644 --- a/wp-includes/class-wp-image-editor-imagick.php +++ b/wp-includes/class-wp-image-editor-imagick.php @@ -311,7 +311,7 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor { } /** - * Filter whether to strip metadata from images when they're resized. + * Filters whether to strip metadata from images when they're resized. * * This filter only applies when resizing using the Imagick editor since GD * always strips profiles by default. diff --git a/wp-includes/class-wp-image-editor.php b/wp-includes/class-wp-image-editor.php index 44fd66f00c..c046823e9f 100644 --- a/wp-includes/class-wp-image-editor.php +++ b/wp-includes/class-wp-image-editor.php @@ -237,7 +237,7 @@ abstract class WP_Image_Editor { public function set_quality( $quality = null ) { if ( null === $quality ) { /** - * Filter the default image compression quality setting. + * Filters the default image compression quality setting. * * Applies only during initial editor instantiation, or when set_quality() is run * manually without the `$quality` argument. @@ -253,7 +253,7 @@ abstract class WP_Image_Editor { if ( 'image/jpeg' == $this->mime_type ) { /** - * Filter the JPEG compression quality for backward-compatibility. + * Filters the JPEG compression quality for backward-compatibility. * * Applies only during initial editor instantiation, or when set_quality() is run * manually without the `$quality` argument. @@ -333,7 +333,7 @@ abstract class WP_Image_Editor { // If not, choose a default instead. if ( ! $this->supports_mime_type( $mime_type ) ) { /** - * Filter default mime type prior to getting the file extension. + * Filters default mime type prior to getting the file extension. * * @see wp_get_mime_types() * diff --git a/wp-includes/class-wp-meta-query.php b/wp-includes/class-wp-meta-query.php index b544e4f4e6..b1369a067d 100644 --- a/wp-includes/class-wp-meta-query.php +++ b/wp-includes/class-wp-meta-query.php @@ -344,7 +344,7 @@ class WP_Meta_Query { } /** - * Filter the meta query's generated SQL. + * Filters the meta query's generated SQL. * * @since 3.1.0 * @@ -717,7 +717,7 @@ class WP_Meta_Query { } /** - * Filter the table alias identified as compatible with the current clause. + * Filters the table alias identified as compatible with the current clause. * * @since 4.1.0 * diff --git a/wp-includes/class-wp-network.php b/wp-includes/class-wp-network.php index 529c73f3b7..75eb647439 100644 --- a/wp-includes/class-wp-network.php +++ b/wp-includes/class-wp-network.php @@ -230,7 +230,7 @@ class WP_Network { $path_segments = array_filter( explode( '/', trim( $path, '/' ) ) ); /** - * Filter the number of path segments to consider when searching for a site. + * Filters the number of path segments to consider when searching for a site. * * @since 3.9.0 * diff --git a/wp-includes/class-wp-oembed-controller.php b/wp-includes/class-wp-oembed-controller.php index dbb4e3e91b..dd89e94d75 100644 --- a/wp-includes/class-wp-oembed-controller.php +++ b/wp-includes/class-wp-oembed-controller.php @@ -23,7 +23,7 @@ final class WP_oEmbed_Controller { */ public function register_routes() { /** - * Filter the maxwidth oEmbed parameter. + * Filters the maxwidth oEmbed parameter. * * @since 4.4.0 * @@ -67,7 +67,7 @@ final class WP_oEmbed_Controller { $post_id = url_to_postid( $request['url'] ); /** - * Filter the determined post ID. + * Filters the determined post ID. * * @since 4.4.0 * diff --git a/wp-includes/class-wp-rewrite.php b/wp-includes/class-wp-rewrite.php index 9c8b492c8f..adcbc0155a 100644 --- a/wp-includes/class-wp-rewrite.php +++ b/wp-includes/class-wp-rewrite.php @@ -1297,7 +1297,7 @@ class WP_Rewrite { $post_rewrite = $this->generate_rewrite_rules( $this->permalink_structure, EP_PERMALINK ); /** - * Filter rewrite rules used for "post" archives. + * Filters rewrite rules used for "post" archives. * * @since 1.5.0 * @@ -1309,7 +1309,7 @@ class WP_Rewrite { $date_rewrite = $this->generate_rewrite_rules($this->get_date_permastruct(), EP_DATE); /** - * Filter rewrite rules used for date archives. + * Filters rewrite rules used for date archives. * * Likely date archives would include /yyyy/, /yyyy/mm/, and /yyyy/mm/dd/. * @@ -1323,7 +1323,7 @@ class WP_Rewrite { $root_rewrite = $this->generate_rewrite_rules($this->root . '/', EP_ROOT); /** - * Filter rewrite rules used for root-level archives. + * Filters rewrite rules used for root-level archives. * * Likely root-level archives would include pagination rules for the homepage * as well as site-wide post feeds (e.g. /feed/, and /feed/atom/). @@ -1338,7 +1338,7 @@ class WP_Rewrite { $comments_rewrite = $this->generate_rewrite_rules($this->root . $this->comments_base, EP_COMMENTS, false, true, true, false); /** - * Filter rewrite rules used for comment feed archives. + * Filters rewrite rules used for comment feed archives. * * Likely comments feed archives include /comments/feed/, and /comments/feed/atom/. * @@ -1353,7 +1353,7 @@ class WP_Rewrite { $search_rewrite = $this->generate_rewrite_rules($search_structure, EP_SEARCH); /** - * Filter rewrite rules used for search archives. + * Filters rewrite rules used for search archives. * * Likely search-related archives include /search/search+query/ as well as * pagination and feed paths for a search. @@ -1368,7 +1368,7 @@ class WP_Rewrite { $author_rewrite = $this->generate_rewrite_rules($this->get_author_permastruct(), EP_AUTHORS); /** - * Filter rewrite rules used for author archives. + * Filters rewrite rules used for author archives. * * Likely author archives would include /author/author-name/, as well as * pagination and feed paths for author archives. @@ -1383,7 +1383,7 @@ class WP_Rewrite { $page_rewrite = $this->page_rewrite_rules(); /** - * Filter rewrite rules used for "page" post type archives. + * Filters rewrite rules used for "page" post type archives. * * @since 1.5.0 * @@ -1403,7 +1403,7 @@ class WP_Rewrite { } /** - * Filter rewrite rules used for individual permastructs. + * Filters rewrite rules used for individual permastructs. * * The dynamic portion of the hook name, `$permastructname`, refers * to the name of the registered permastruct, e.g. 'post_tag' (tags), @@ -1417,7 +1417,7 @@ class WP_Rewrite { if ( 'post_tag' == $permastructname ) { /** - * Filter rewrite rules used specifically for Tags. + * Filters rewrite rules used specifically for Tags. * * @since 2.3.0 * @deprecated 3.1.0 Use 'post_tag_rewrite_rules' instead @@ -1446,7 +1446,7 @@ class WP_Rewrite { do_action_ref_array( 'generate_rewrite_rules', array( &$this ) ); /** - * Filter the full set of generated rewrite rules. + * Filters the full set of generated rewrite rules. * * @since 1.5.0 * @@ -1550,7 +1550,7 @@ class WP_Rewrite { $rules .= "\n"; /** - * Filter the list of rewrite rules formatted for output to an .htaccess file. + * Filters the list of rewrite rules formatted for output to an .htaccess file. * * @since 1.5.0 * @@ -1559,7 +1559,7 @@ class WP_Rewrite { $rules = apply_filters( 'mod_rewrite_rules', $rules ); /** - * Filter the list of rewrite rules formatted for output to an .htaccess file. + * Filters the list of rewrite rules formatted for output to an .htaccess file. * * @since 1.5.0 * @deprecated 1.5.0 Use the mod_rewrite_rules filter instead. @@ -1612,7 +1612,7 @@ class WP_Rewrite { } /** - * Filter the list of rewrite rules formatted for output to a web.config. + * Filters the list of rewrite rules formatted for output to a web.config. * * @since 2.8.0 * @@ -1814,7 +1814,7 @@ class WP_Rewrite { $this->wp_rewrite_rules(); /** - * Filter whether a "hard" rewrite rule flush should be performed when requested. + * Filters whether a "hard" rewrite rule flush should be performed when requested. * * A "hard" flush updates .htaccess (Apache) or web.config (IIS). * diff --git a/wp-includes/class-wp-role.php b/wp-includes/class-wp-role.php index 8d03b65971..6c9702de04 100644 --- a/wp-includes/class-wp-role.php +++ b/wp-includes/class-wp-role.php @@ -96,7 +96,7 @@ class WP_Role { */ public function has_cap( $cap ) { /** - * Filter which capabilities a role has. + * Filters which capabilities a role has. * * @since 2.0.0 * diff --git a/wp-includes/class-wp-theme.php b/wp-includes/class-wp-theme.php index 8c1134fd18..489bd53712 100644 --- a/wp-includes/class-wp-theme.php +++ b/wp-includes/class-wp-theme.php @@ -1031,7 +1031,7 @@ final class WP_Theme implements ArrayAccess { $page_templates += $this->parent()->get_page_templates( $post ); /** - * Filter list of page templates for a theme. + * Filters list of page templates for a theme. * * @since 3.9.0 * @since 4.4.0 Converted to allow complete control over the `$page_templates` array. @@ -1192,7 +1192,7 @@ final class WP_Theme implements ArrayAccess { */ public static function get_allowed( $blog_id = null ) { /** - * Filter the array of themes allowed on the network. + * Filters the array of themes allowed on the network. * * Site is provided as context so that a list of network allowed themes can * be filtered further. @@ -1225,7 +1225,7 @@ final class WP_Theme implements ArrayAccess { } /** - * Filter the array of themes allowed on the network. + * Filters the array of themes allowed on the network. * * @since MU * @@ -1257,7 +1257,7 @@ final class WP_Theme implements ArrayAccess { if ( isset( $allowed_themes[ $blog_id ] ) ) { /** - * Filter the array of themes allowed on the site. + * Filters the array of themes allowed on the site. * * @since 4.5.0 * diff --git a/wp-includes/class-wp-user-query.php b/wp-includes/class-wp-user-query.php index a8dcd44ccd..84cdcf6b29 100644 --- a/wp-includes/class-wp-user-query.php +++ b/wp-includes/class-wp-user-query.php @@ -480,7 +480,7 @@ class WP_User_Query { } /** - * Filter the columns to search in a WP_User_Query search. + * Filters the columns to search in a WP_User_Query search. * * The default columns depend on the search term, and include 'user_email', * 'user_login', 'ID', 'user_url', 'display_name', and 'user_nicename'. @@ -547,7 +547,7 @@ class WP_User_Query { } /** - * Filter SELECT FOUND_ROWS() query for the current WP_User_Query instance. + * Filters SELECT FOUND_ROWS() query for the current WP_User_Query instance. * * @since 3.2.0 * diff --git a/wp-includes/class-wp-widget.php b/wp-includes/class-wp-widget.php index f22b5aa29d..f1a4f6bcfd 100644 --- a/wp-includes/class-wp-widget.php +++ b/wp-includes/class-wp-widget.php @@ -353,7 +353,7 @@ abstract class WP_Widget { $instance = $instances[ $this->number ]; /** - * Filter the settings for a particular widget instance. + * Filters the settings for a particular widget instance. * * Returning false will effectively short-circuit display of the widget. * @@ -442,7 +442,7 @@ abstract class WP_Widget { } /** - * Filter a widget's settings before saving. + * Filters a widget's settings before saving. * * Returning false will effectively short-circuit the widget's ability * to update settings. @@ -498,7 +498,7 @@ abstract class WP_Widget { } /** - * Filter the widget instance's settings before displaying the control form. + * Filters the widget instance's settings before displaying the control form. * * Returning false effectively short-circuits display of the control form. * diff --git a/wp-includes/class-wp-xmlrpc-server.php b/wp-includes/class-wp-xmlrpc-server.php index 106b8de72a..45b368620f 100644 --- a/wp-includes/class-wp-xmlrpc-server.php +++ b/wp-includes/class-wp-xmlrpc-server.php @@ -159,7 +159,7 @@ class wp_xmlrpc_server extends IXR_Server { $this->initialise_blog_option_info(); /** - * Filter the methods exposed by the XML-RPC server. + * Filters the methods exposed by the XML-RPC server. * * This filter can be used to add new methods, and remove built-in methods. * @@ -247,7 +247,7 @@ class wp_xmlrpc_server extends IXR_Server { } /** - * Filter whether XML-RPC methods requiring authentication are enabled. + * Filters whether XML-RPC methods requiring authentication are enabled. * * Contrary to the way it's named, this filter does not control whether XML-RPC is *fully* * enabled, rather, it only controls whether XML-RPC methods requiring authentication - such @@ -288,7 +288,7 @@ class wp_xmlrpc_server extends IXR_Server { $this->auth_failed = true; /** - * Filter the XML-RPC user login error message. + * Filters the XML-RPC user login error message. * * @since 3.5.0 * @@ -562,7 +562,7 @@ class wp_xmlrpc_server extends IXR_Server { ); /** - * Filter the XML-RPC blog options property. + * Filters the XML-RPC blog options property. * * @since 2.6.0 * @@ -704,7 +704,7 @@ class wp_xmlrpc_server extends IXR_Server { $_taxonomy['object_type'] = array_unique( (array) $taxonomy->object_type ); /** - * Filter XML-RPC-prepared data for the given taxonomy. + * Filters XML-RPC-prepared data for the given taxonomy. * * @since 3.4.0 * @@ -738,7 +738,7 @@ class wp_xmlrpc_server extends IXR_Server { $_term['count'] = intval( $_term['count'] ); /** - * Filter XML-RPC-prepared data for the given term. + * Filters XML-RPC-prepared data for the given term. * * @since 3.4.0 * @@ -867,7 +867,7 @@ class wp_xmlrpc_server extends IXR_Server { } /** - * Filter XML-RPC-prepared date for the given post. + * Filters XML-RPC-prepared date for the given post. * * @since 3.4.0 * @@ -918,7 +918,7 @@ class wp_xmlrpc_server extends IXR_Server { $_post_type['taxonomies'] = get_object_taxonomies( $post_type->name, 'names' ); /** - * Filter XML-RPC-prepared date for the given post type. + * Filters XML-RPC-prepared date for the given post type. * * @since 3.4.0 * @@ -957,7 +957,7 @@ class wp_xmlrpc_server extends IXR_Server { $_media_item['thumbnail'] = $_media_item['link']; /** - * Filter XML-RPC-prepared data for the given media item. + * Filters XML-RPC-prepared data for the given media item. * * @since 3.4.0 * @@ -1039,7 +1039,7 @@ class wp_xmlrpc_server extends IXR_Server { ); /** - * Filter XML-RPC-prepared data for the given page. + * Filters XML-RPC-prepared data for the given page. * * @since 3.4.0 * @@ -1088,7 +1088,7 @@ class wp_xmlrpc_server extends IXR_Server { ); /** - * Filter XML-RPC-prepared data for the given comment. + * Filters XML-RPC-prepared data for the given comment. * * @since 3.4.0 * @@ -1136,7 +1136,7 @@ class wp_xmlrpc_server extends IXR_Server { } /** - * Filter XML-RPC-prepared data for the given user. + * Filters XML-RPC-prepared data for the given user. * * @since 3.5.0 * @@ -1506,7 +1506,7 @@ class wp_xmlrpc_server extends IXR_Server { $this->attach_uploads( $post_ID, $post_data['post_content'] ); /** - * Filter post data array to be inserted via XML-RPC. + * Filters post data array to be inserted via XML-RPC. * * @since 3.4.0 * @@ -1709,7 +1709,7 @@ class wp_xmlrpc_server extends IXR_Server { $fields = $args[4]; } else { /** - * Filter the list of post query fields used by the given XML-RPC method. + * Filters the list of post query fields used by the given XML-RPC method. * * @since 3.4.0 * @@ -2260,7 +2260,7 @@ class wp_xmlrpc_server extends IXR_Server { $fields = $args[4]; } else { /** - * Filter the taxonomy query fields used by the given XML-RPC method. + * Filters the taxonomy query fields used by the given XML-RPC method. * * @since 3.4.0 * @@ -2395,7 +2395,7 @@ class wp_xmlrpc_server extends IXR_Server { $fields = $args[4]; } else { /** - * Filter the default user query fields used by the given XML-RPC method. + * Filters the default user query fields used by the given XML-RPC method. * * @since 3.5.0 * @@ -3508,7 +3508,7 @@ class wp_xmlrpc_server extends IXR_Server { $content_struct = $args[4]; /** - * Filter whether to allow anonymous comments over XML-RPC. + * Filters whether to allow anonymous comments over XML-RPC. * * @since 2.7.0 * @@ -4078,7 +4078,7 @@ class wp_xmlrpc_server extends IXR_Server { $fields = $args[4]; } else { /** - * Filter the default query fields used by the given XML-RPC method. + * Filters the default query fields used by the given XML-RPC method. * * @since 3.4.0 * @@ -4196,7 +4196,7 @@ class wp_xmlrpc_server extends IXR_Server { $fields = $args[4]; } else { /** - * Filter the default revision query fields used by the given XML-RPC method. + * Filters the default revision query fields used by the given XML-RPC method. * * @since 3.5.0 * @@ -5800,7 +5800,7 @@ class wp_xmlrpc_server extends IXR_Server { } /** - * Filter whether to preempt the XML-RPC media upload. + * Filters whether to preempt the XML-RPC media upload. * * Passing a truthy value will effectively short-circuit the media upload, * returning that value as a 500 error instead. @@ -6085,7 +6085,7 @@ class wp_xmlrpc_server extends IXR_Server { do_action( 'xmlrpc_call', 'mt.supportedTextFilters' ); /** - * Filter the MoveableType text filters list for XML-RPC. + * Filters the MoveableType text filters list for XML-RPC. * * @since 2.2.0 * @@ -6213,7 +6213,7 @@ class wp_xmlrpc_server extends IXR_Server { $pagelinkedto = str_replace( '&', '&', $pagelinkedto ); /** - * Filter the pingback source URI. + * Filters the pingback source URI. * * @since 3.6.0 * @@ -6310,7 +6310,7 @@ class wp_xmlrpc_server extends IXR_Server { } /** - * Filter the pingback remote source. + * Filters the pingback remote source. * * @since 2.5.0 * @@ -6456,7 +6456,7 @@ class wp_xmlrpc_server extends IXR_Server { */ protected function pingback_error( $code, $message ) { /** - * Filter the XML-RPC pingback error return. + * Filters the XML-RPC pingback error return. * * @since 3.5.1 * diff --git a/wp-includes/version.php b/wp-includes/version.php index 1f056ddf4e..4df9839473 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -4,7 +4,7 @@ * * @global string $wp_version */ -$wp_version = '4.6-alpha-37491'; +$wp_version = '4.6-alpha-37492'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.