Changeset 49693
- Timestamp:
- 11/24/2020 09:25:46 PM (4 years ago)
- Location:
- trunk/src
- Files:
-
- 18 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/wp-admin/setup-config.php
r48126 r49693 93 93 * @global WP_Locale $wp_locale WordPress date and time locale object. 94 94 * 95 * @param string| array $body_classes95 * @param string|string[] $body_classes Class attribute values for the body tag. 96 96 */ 97 97 function setup_config_display_header( $body_classes = array() ) { -
trunk/src/wp-includes/cache.php
r48586 r49693 248 248 * @global WP_Object_Cache $wp_object_cache Object cache global instance. 249 249 * 250 * @param string| array$groups A group or an array of groups to add.250 * @param string|string[] $groups A group or an array of groups to add. 251 251 */ 252 252 function wp_cache_add_global_groups( $groups ) { … … 261 261 * @since 2.6.0 262 262 * 263 * @param string| array$groups A group or an array of groups to add.263 * @param string|string[] $groups A group or an array of groups to add. 264 264 */ 265 265 function wp_cache_add_non_persistent_groups( $groups ) { -
trunk/src/wp-includes/category-template.php
r49672 r49693 697 697 * @type bool $echo Whether or not to echo the return value. Default true. 698 698 * } 699 * @return void|string| arrayVoid if 'echo' argument is true, or on failure. Otherwise, tag cloud700 * as a string or an array, depending on 'format' argument.699 * @return void|string|string[] Void if 'echo' argument is true, or on failure. Otherwise, tag cloud 700 * as a string or an array, depending on 'format' argument. 701 701 */ 702 702 function wp_tag_cloud( $args = '' ) { … … 758 758 * @since 2.3.0 759 759 * 760 * @param string| array$return Tag cloud as a string or an array, depending on 'format' argument.761 * @param array $args An array of tag cloud arguments.760 * @param string|string[] $return Tag cloud as a string or an array, depending on 'format' argument. 761 * @param array $args An array of tag cloud arguments. 762 762 */ 763 763 $return = apply_filters( 'wp_tag_cloud', $return, $args ); … … 826 826 * 0, 1, or their bool equivalents. 827 827 * } 828 * @return string| arrayTag cloud as a string or an array, depending on 'format' argument.828 * @return string|string[] Tag cloud as a string or an array, depending on 'format' argument. 829 829 */ 830 830 function wp_generate_tag_cloud( $tags, $args = '' ) { … … 980 980 * @since 4.3.0 981 981 * 982 * @param array $tags_data An array of term data for termused to generate the tag cloud.982 * @param array[] $tags_data An array of term data arrays for terms used to generate the tag cloud. 983 983 */ 984 984 $tags_data = apply_filters( 'wp_generate_tag_cloud_data', $tags_data ); … … 1031 1031 * @see wp_generate_tag_cloud() 1032 1032 * 1033 * @param array|string $return String containing the generated HTML tag cloud output1034 * or an array of tag links if the 'format' argument1035 * equals 'array'.1036 * @param WP_Term[] $tags An array of terms used in the tag cloud.1037 * @param array $args An array of wp_generate_tag_cloud() arguments.1033 * @param string[]|string $return String containing the generated HTML tag cloud output 1034 * or an array of tag links if the 'format' argument 1035 * equals 'array'. 1036 * @param WP_Term[] $tags An array of terms used in the tag cloud. 1037 * @param array $args An array of wp_generate_tag_cloud() arguments. 1038 1038 */ 1039 1039 return apply_filters( 'wp_generate_tag_cloud', $return, $tags, $args ); -
trunk/src/wp-includes/class-wp-comment-query.php
r49672 r49693 229 229 * @type string|array $type Include comments of a given type, or array of types. 230 230 * Accepts 'comment', 'pings' (includes 'pingback' and 231 * 'trackback'), or any custom type string. Default empty.232 * @type array$type__in Include comments from a given array of comment types.233 * Default empty. 234 * @type array$type__not_in Exclude comments from a given array of comment types.231 * 'trackback'), or any custom type string. Default empty. 232 * @type string[] $type__in Include comments from a given array of comment types. 233 * Default empty. 234 * @type string[] $type__not_in Exclude comments from a given array of comment types. 235 235 * Default empty. 236 236 * @type int $user_id Include comments for a specific user ID. Default empty. 237 237 * @type bool|string $hierarchical Whether to include comment descendants in the results. 238 * 'threaded' returns a tree, with each comment's children 239 * stored in a `children` property on the `WP_Comment` 240 * object. 'flat' returns a flat array of found comments plus 241 * their children. Pass `false` to leave out descendants. 238 * - 'threaded' returns a tree, with each comment's children 239 * stored in a `children` property on the `WP_Comment` object. 240 * - 'flat' returns a flat array of found comments plus 241 * their children. 242 * - Boolean `false` leaves out descendants. 242 243 * The parameter is ignored (forced to `false`) when 243 244 * `$fields` is 'ids' or 'counts'. Accepts 'threaded', -
trunk/src/wp-includes/class-wp-network-query.php
r49672 r49693 105 105 * @type string $order How to order retrieved networks. Accepts 'ASC', 'DESC'. Default 'ASC'. 106 106 * @type string $domain Limit results to those affiliated with a given domain. Default empty. 107 * @type array$domain__in Array of domains to include affiliated networks for. Default empty.108 * @type array$domain__not_in Array of domains to exclude affiliated networks for. Default empty.107 * @type string[] $domain__in Array of domains to include affiliated networks for. Default empty. 108 * @type string[] $domain__not_in Array of domains to exclude affiliated networks for. Default empty. 109 109 * @type string $path Limit results to those affiliated with a given path. Default empty. 110 * @type array$path__in Array of paths to include affiliated networks for. Default empty.111 * @type array$path__not_in Array of paths to exclude affiliated networks for. Default empty.110 * @type string[] $path__in Array of paths to include affiliated networks for. Default empty. 111 * @type string[] $path__not_in Array of paths to exclude affiliated networks for. Default empty. 112 112 * @type string $search Search term(s) to retrieve matching networks for. Default empty. 113 113 * @type bool $update_network_cache Whether to prime the cache for found networks. Default true. -
trunk/src/wp-includes/class-wp-query.php
r49672 r49693 701 701 * separated IDs will NOT work. 702 702 * @type string $post_mime_type The mime type of the post. Used for 'attachment' post_type. 703 * @type array$post_name__in An array of post slugs that results must match.703 * @type string[] $post_name__in An array of post slugs that results must match. 704 704 * @type int $post_parent Page ID to retrieve child pages for. Use 0 to only retrieve 705 705 * top-level pages. … … 725 725 * @type int[] $tag__not_in An array of tag IDs (NOT in). 726 726 * @type int $tag_id Tag id or comma-separated list of IDs. 727 * @type array$tag_slug__and An array of tag slugs (AND in).728 * @type array$tag_slug__in An array of tag slugs (OR in). unless 'ignore_sticky_posts' is727 * @type string[] $tag_slug__and An array of tag slugs (AND in). 728 * @type string[] $tag_slug__in An array of tag slugs (OR in). unless 'ignore_sticky_posts' is 729 729 * true. Note: a string of comma-separated IDs will NOT work. 730 730 * @type array $tax_query An associative array of WP_Tax_Query arguments. -
trunk/src/wp-includes/class-wp-site-query.php
r49672 r49693 139 139 * @type int[] $network__not_in Array of network IDs to exclude affiliated sites for. Default empty. 140 140 * @type string $domain Limit results to those affiliated with a given domain. Default empty. 141 * @type array$domain__in Array of domains to include affiliated sites for. Default empty.142 * @type array$domain__not_in Array of domains to exclude affiliated sites for. Default empty.141 * @type string[] $domain__in Array of domains to include affiliated sites for. Default empty. 142 * @type string[] $domain__not_in Array of domains to exclude affiliated sites for. Default empty. 143 143 * @type string $path Limit results to those affiliated with a given path. Default empty. 144 * @type array$path__in Array of paths to include affiliated sites for. Default empty.145 * @type array$path__not_in Array of paths to exclude affiliated sites for. Default empty.144 * @type string[] $path__in Array of paths to include affiliated sites for. Default empty. 145 * @type string[] $path__not_in Array of paths to exclude affiliated sites for. Default empty. 146 146 * @type int $public Limit results to public sites. Accepts '1' or '0'. Default empty. 147 147 * @type int $archived Limit results to archived sites. Accepts '1' or '0'. Default empty. … … 150 150 * @type int $deleted Limit results to deleted sites. Accepts '1' or '0'. Default empty. 151 151 * @type int $lang_id Limit results to a language ID. Default empty. 152 * @type array$lang__in Array of language IDs to include affiliated sites for. Default empty.153 * @type array$lang__not_in Array of language IDs to exclude affiliated sites for. Default empty.152 * @type string[] $lang__in Array of language IDs to include affiliated sites for. Default empty. 153 * @type string[] $lang__not_in Array of language IDs to exclude affiliated sites for. Default empty. 154 154 * @type string $search Search term(s) to retrieve matching sites for. Default empty. 155 155 * @type array $search_columns Array of column names to be searched. Accepts 'domain' and 'path'. -
trunk/src/wp-includes/class-wp-user-query.php
r49672 r49693 145 145 * to be included in results. Note that this is an inclusive list: users 146 146 * must match *each* role. Default empty. 147 * @type array$role__in An array of role names. Matched users must have at least one of these147 * @type string[] $role__in An array of role names. Matched users must have at least one of these 148 148 * roles. Default empty array. 149 * @type array$role__not_in An array of role names to exclude. Users matching one or more of these149 * @type string[] $role__not_in An array of role names to exclude. Users matching one or more of these 150 150 * roles will not be included in results. Default empty array. 151 151 * @type string $meta_key User meta key. Default empty. … … 160 160 * When `$search_columns` is left empty, it tries to determine which 161 161 * column to search in based on search string. Default empty. 162 * @type array$search_columns Array of column names to be searched. Accepts 'ID', 'user_login',162 * @type string[] $search_columns Array of column names to be searched. Accepts 'ID', 'user_login', 163 163 * 'user_email', 'user_url', 'user_nicename', 'display_name'. 164 164 * Default empty array. … … 198 198 * public post types. 199 199 * @type string $nicename The user nicename. Default empty. 200 * @type array$nicename__in An array of nicenames to include. Users matching one of these200 * @type string[] $nicename__in An array of nicenames to include. Users matching one of these 201 201 * nicenames will be included in results. Default empty array. 202 * @type array$nicename__not_in An array of nicenames to exclude. Users matching one of these202 * @type string[] $nicename__not_in An array of nicenames to exclude. Users matching one of these 203 203 * nicenames will not be included in results. Default empty array. 204 204 * @type string $login The user login. Default empty. 205 * @type array$login__in An array of logins to include. Users matching one of these205 * @type string[] $login__in An array of logins to include. Users matching one of these 206 206 * logins will be included in results. Default empty array. 207 * @type array$login__not_in An array of logins to exclude. Users matching one of these207 * @type string[] $login__not_in An array of logins to exclude. Users matching one of these 208 208 * logins will not be included in results. Default empty array. 209 209 * } -
trunk/src/wp-includes/comment-template.php
r49355 r49693 423 423 * @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object. 424 424 * 425 * @param string| array$class Optional. One or more classes to add to the class list.426 * Default empty.427 * @param int|WP_Comment $comment Comment ID or WP_Comment object. Default current comment.428 * @param int|WP_Post $post_id Post ID or WP_Post object. Default current post.429 * @param bool $echo Optional. Whether to echo or return the output.430 * Default true.425 * @param string|string[] $class Optional. One or more classes to add to the class list. 426 * Default empty. 427 * @param int|WP_Comment $comment Comment ID or WP_Comment object. Default current comment. 428 * @param int|WP_Post $post_id Post ID or WP_Post object. Default current post. 429 * @param bool $echo Optional. Whether to echo or return the output. 430 * Default true. 431 431 * @return void|string Void if `$echo` argument is true, comment classes if `$echo` is false. 432 432 */ … … 452 452 * @global int $comment_thread_alt 453 453 * 454 * @param string| array$class Optional. One or more classes to add to the class list. Default empty.455 * @param int|WP_Comment $comment_id Comment ID or WP_Comment object. Default current comment.456 * @param int|WP_Post $post_id Post ID or WP_Post object. Default current post.454 * @param string|string[] $class Optional. One or more classes to add to the class list. Default empty. 455 * @param int|WP_Comment $comment_id Comment ID or WP_Comment object. Default current comment. 456 * @param int|WP_Post $post_id Post ID or WP_Post object. Default current post. 457 457 * @return string[] An array of classes. 458 458 */ … … 531 531 * 532 532 * @param string[] $classes An array of comment classes. 533 * @param string $class A comma-separated listof additional classes added to the list.533 * @param string[] $class An array of additional classes added to the list. 534 534 * @param int $comment_id The comment ID. 535 535 * @param WP_Comment $comment The comment object. -
trunk/src/wp-includes/functions.php
r49638 r49693 1160 1160 * @since 1.5.0 1161 1161 * 1162 * @param string| array$key Query key or keys to remove.1163 * @param bool|string$query Optional. When false uses the current URL. Default false.1162 * @param string|string[] $key Query key or keys to remove. 1163 * @param false|string $query Optional. When false uses the current URL. Default false. 1164 1164 * @return string New URL query string. 1165 1165 */ -
trunk/src/wp-includes/ms-site.php
r49672 r49693 438 438 * @type int[] $network__not_in Array of network IDs to exclude affiliated sites for. Default empty. 439 439 * @type string $domain Limit results to those affiliated with a given domain. Default empty. 440 * @type array$domain__in Array of domains to include affiliated sites for. Default empty.441 * @type array$domain__not_in Array of domains to exclude affiliated sites for. Default empty.440 * @type string[] $domain__in Array of domains to include affiliated sites for. Default empty. 441 * @type string[] $domain__not_in Array of domains to exclude affiliated sites for. Default empty. 442 442 * @type string $path Limit results to those affiliated with a given path. Default empty. 443 * @type array$path__in Array of paths to include affiliated sites for. Default empty.444 * @type array$path__not_in Array of paths to exclude affiliated sites for. Default empty.443 * @type string[] $path__in Array of paths to include affiliated sites for. Default empty. 444 * @type string[] $path__not_in Array of paths to exclude affiliated sites for. Default empty. 445 445 * @type int $public Limit results to public sites. Accepts '1' or '0'. Default empty. 446 446 * @type int $archived Limit results to archived sites. Accepts '1' or '0'. Default empty. … … 449 449 * @type int $deleted Limit results to deleted sites. Accepts '1' or '0'. Default empty. 450 450 * @type int $lang_id Limit results to a language ID. Default empty. 451 * @type array$lang__in Array of language IDs to include affiliated sites for. Default empty.452 * @type array$lang__not_in Array of language IDs to exclude affiliated sites for. Default empty.451 * @type string[] $lang__in Array of language IDs to include affiliated sites for. Default empty. 452 * @type string[] $lang__not_in Array of language IDs to exclude affiliated sites for. Default empty. 453 453 * @type string $search Search term(s) to retrieve matching sites for. Default empty. 454 * @type array$search_columns Array of column names to be searched. Accepts 'domain' and 'path'.454 * @type string[] $search_columns Array of column names to be searched. Accepts 'domain' and 'path'. 455 455 * Default empty array. 456 456 * @type bool $update_site_cache Whether to prime the cache for found sites. Default true. -
trunk/src/wp-includes/post-formats.php
r49544 r49693 42 42 * @since 3.1.0 43 43 * 44 * @param string| array$format Optional. The format or formats to check.44 * @param string|string[] $format Optional. The format or formats to check. 45 45 * @param WP_Post|int|null $post Optional. The post to check. Defaults to the current post in the loop. 46 46 * @return bool True if the post has any of the given formats (or any format, if no format specified), -
trunk/src/wp-includes/post-template.php
r49193 r49693 452 452 * @since 2.7.0 453 453 * 454 * @param string| array$class One or more classes to add to the class list.455 * @param int|WP_Post $post_id Optional. Post ID or post object. Defaults to the global `$post`.454 * @param string|string[] $class One or more classes to add to the class list. 455 * @param int|WP_Post $post_id Optional. Post ID or post object. Defaults to the global `$post`. 456 456 */ 457 457 function post_class( $class = '', $post_id = null ) { … … 1750 1750 * @since 4.7.0 Now works with any post type, not just pages. 1751 1751 * 1752 * @param string| array$template The specific template filename or array of templates to match.1752 * @param string|string[] $template The specific template filename or array of templates to match. 1753 1753 * @return bool True on success, false on failure. 1754 1754 */ -
trunk/src/wp-includes/post-thumbnail-template.php
r49021 r49693 216 216 * 217 217 * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. 218 * @param string| array$size Optional. Registered image size to retrieve the source for or a flat218 * @param string|int[] $size Optional. Registered image size to retrieve the source for or a flat 219 219 * array of height and width dimensions. Default 'post-thumbnail'. 220 220 * @return string|false Post thumbnail URL or false if no URL is available. … … 235 235 * @since 4.4.0 236 236 * 237 * @param string| array$size Optional. Image size to use. Accepts any valid image size,237 * @param string|int[] $size Optional. Image size to use. Accepts any valid image size, 238 238 * or an array of width and height values in pixels (in that order). 239 239 * Default 'post-thumbnail'. -
trunk/src/wp-includes/post.php
r49692 r49693 1308 1308 * @type string $label Name of the post type shown in the menu. Usually plural. 1309 1309 * Default is value of $labels['name']. 1310 * @type array$labels An array of labels for this post type. If not set, post1310 * @type string[] $labels An array of labels for this post type. If not set, post 1311 1311 * labels are inherited for non-hierarchical types and page 1312 1312 * labels for hierarchical ones. See get_post_type_labels() for a full … … 1357 1357 * this argument as a base to construct the capabilities, e.g. 1358 1358 * array('story', 'stories'). Default 'post'. 1359 * @type array$capabilities Array of capabilities for this post type. $capability_type is used1359 * @type string[] $capabilities Array of capabilities for this post type. $capability_type is used 1360 1360 * as a base to construct capabilities by default. 1361 1361 * See get_post_type_capabilities(). … … 1376 1376 * edit form. Do remove_meta_box() and add_meta_box() calls in the 1377 1377 * callback. Default null. 1378 * @type array$taxonomies An array of taxonomy identifiers that will be registered for the1378 * @type string[] $taxonomies An array of taxonomy identifiers that will be registered for the 1379 1379 * post type. Taxonomies can be registered later with register_taxonomy() 1380 1380 * or register_taxonomy_for_object_type(). … … 2723 2723 * @global wpdb $wpdb WordPress database abstraction object. 2724 2724 * 2725 * @param string| array$mime_type Optional. Array or comma-separated list of2726 * MIME patterns. Default empty.2725 * @param string|string[] $mime_type Optional. Array or comma-separated list of 2726 * MIME patterns. Default empty. 2727 2727 * @return object An object containing the attachment counts by mime type. 2728 2728 */ … … 2864 2864 * @since 2.5.0 2865 2865 * 2866 * @param string| array$wildcard_mime_types Mime types, e.g. audio/mpeg or image (same as image/*)2867 * or flash (same as *flash*).2868 * @param string| array$real_mime_types Real post mime type values.2866 * @param string|string[] $wildcard_mime_types Mime types, e.g. audio/mpeg or image (same as image/*) 2867 * or flash (same as *flash*). 2868 * @param string|string[] $real_mime_types Real post mime type values. 2869 2869 * @return array array(wildcard=>array(real types)). 2870 2870 */ … … 2916 2916 * @since 2.5.0 2917 2917 * 2918 * @param string| array$post_mime_types List of mime types or comma separated string2919 * of mime types.2920 * @param string $table_alias Optional. Specify a table alias, if needed.2921 * Default empty.2918 * @param string|string[] $post_mime_types List of mime types or comma separated string 2919 * of mime types. 2920 * @param string $table_alias Optional. Specify a table alias, if needed. 2921 * Default empty. 2922 2922 * @return string The SQL AND clause for mime searching. 2923 2923 */ … … 3521 3521 * @since 2.8.0 3522 3522 * 3523 * @param int $post_id Optional. The Post ID. Does not default to the ID of the3524 * global $post. Default 0.3525 * @param string| array$taxonomy Optional. The taxonomy slug or array of slugs for which3526 * to retrieve terms. Default 'post_tag'.3527 * @param array $args {3523 * @param int $post_id Optional. The Post ID. Does not default to the ID of the 3524 * global $post. Default 0. 3525 * @param string|string[] $taxonomy Optional. The taxonomy slug or array of slugs for which 3526 * to retrieve terms. Default 'post_tag'. 3527 * @param array $args { 3528 3528 * Optional. Term query parameters. See WP_Term_Query::__construct() for supported arguments. 3529 3529 * -
trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-controller.php
r48951 r49693 553 553 * 554 554 * @param WP_REST_Request $request Full details about the request. 555 * @return arrayFields to be included in the response.555 * @return string[] Fields to be included in the response. 556 556 */ 557 557 public function get_fields_for_response( $request ) { -
trunk/src/wp-includes/taxonomy.php
r49669 r49693 345 345 * Optional. Array or query string of arguments for registering a taxonomy. 346 346 * 347 * @type array$labels An array of labels for this taxonomy. By default, Tag labels are347 * @type string[] $labels An array of labels for this taxonomy. By default, Tag labels are 348 348 * used for non-hierarchical taxonomies, and Category labels are used 349 349 * for hierarchical taxonomies. See accepted values in … … 383 383 * box. If no callback is defined, an appropriate one is determined 384 384 * based on the value of `$meta_box_cb`. 385 * @type array$capabilities {385 * @type string[] $capabilities { 386 386 * Array of capabilities for this taxonomy. 387 387 * -
trunk/src/wp-includes/user.php
r49672 r49693 1280 1280 * match to be included in results. Note that this is an inclusive 1281 1281 * list: users must match *each* role. Default empty. 1282 * @type array$role__in An array of role names. Matched users must have at least one of1282 * @type string[] $role__in An array of role names. Matched users must have at least one of 1283 1283 * these roles. Default empty array. 1284 * @type array$role__not_in An array of role names to exclude. Users matching one or more of1284 * @type string[] $role__not_in An array of role names to exclude. Users matching one or more of 1285 1285 * these roles will not be included in results. Default empty array. 1286 1286 * }
Note: See TracChangeset
for help on using the changeset viewer.