Changeset 32684 for trunk/src/wp-includes/user.php
- Timestamp:
- 06/02/2015 01:34:04 PM (10 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/wp-includes/user.php
r32683 r32684 530 530 * Optional. Array or string of Query parameters. 531 531 * 532 * @type int $blog_id The site ID. Default is the global blog id. 533 * @type string $role Role name. Default empty. 534 * @type string $meta_key User meta key. Default empty. 535 * @type string $meta_value User meta value. Default empty. 536 * @type string $meta_compare Comparison operator to test the `$meta_value`. Accepts '=', '!=', 537 * '>', '>=', '<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'BETWEEN', 538 * 'NOT BETWEEN', 'EXISTS', 'NOT EXISTS', 'REGEXP', 'NOT REGEXP', 539 * or 'RLIKE'. Default '='. 540 * @type array $include An array of user IDs to include. Default empty array. 541 * @type array $exclude An array of user IDs to exclude. Default empty array. 542 * @type string $search Search keyword. Searches for possible string matches on columns. 543 * When `$search_columns` is left empty, it tries to determine which 544 * column to search in based on search string. Default empty. 545 * @type array $search_columns Array of column names to be searched. Accepts 'ID', 'login', 546 * 'nicename', 'email', 'url'. Default empty array. 547 * @type string|array $orderby Field(s) to sort the retrieved users by. May be a single value, 548 * an array of values, or a multi-dimensional array with fields as keys 549 * and orders ('ASC' or 'DESC') as values. Accepted values are'ID', 550 * 'display_name' (or 'name'), 'user_login' (or 'login'), 551 * 'user_nicename' (or 'nicename'), 'user_email' (or 'email'), 552 * 'user_url' (or 'url'), 'user_registered' (or 'registered'), 553 * 'post_count', 'meta_value', 'meta_value_num', the value of 554 * `$meta_key`, or an array key of `$meta_query`. To use 'meta_value' 555 * or 'meta_value_num', `$meta_key` must be also be defined. 556 * Default 'user_login'. 557 * @type string $order Designates ascending or descending order of users. Order values 558 * passed as part of an `$orderby` array take precedence over this 559 * parameter. Accepts 'ASC', 'DESC'. Default 'ASC'. 560 * @type int $offset Number of users to offset in retrieved results. Can be used in 561 * conjunction with pagination. Default 0. 562 * @type int $number Number of users to limit the query for. Can be used in conjunction 563 * with pagination. Value -1 (all) is not supported. 564 * Default empty (all users). 565 * @type bool $count_total Whether to count the total number of users found. If pagination is not 566 * needed, setting this to false can improve performance. Default true. 567 * @type string|array $fields Which fields to return. Single or all fields (string), or array 568 * of fields. Accepts 'ID', 'display_name', 'login', 'nicename', 'email', 569 * 'url', 'registered'. Use 'all' for all fields and 'all_with_meta' to 570 * include meta fields. Default 'all'. 571 * @type string $who Type of users to query. Accepts 'authors'. Default empty (all users). 532 * @type int $blog_id The site ID. Default is the global blog id. 533 * @type string $role Role name. Default empty. 534 * @type string $meta_key User meta key. Default empty. 535 * @type string $meta_value User meta value. Default empty. 536 * @type string $meta_compare Comparison operator to test the `$meta_value`. Accepts '=', '!=', 537 * '>', '>=', '<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 538 * 'BETWEEN', 'NOT BETWEEN', 'EXISTS', 'NOT EXISTS', 'REGEXP', 539 * 'NOT REGEXP', or 'RLIKE'. Default '='. 540 * @type array $include An array of user IDs to include. Default empty array. 541 * @type array $exclude An array of user IDs to exclude. Default empty array. 542 * @type string $search Search keyword. Searches for possible string matches on columns. 543 * When `$search_columns` is left empty, it tries to determine which 544 * column to search in based on search string. Default empty. 545 * @type array $search_columns Array of column names to be searched. Accepts 'ID', 'login', 546 * 'nicename', 'email', 'url'. Default empty array. 547 * @type string|array $orderby Field(s) to sort the retrieved users by. May be a single value, 548 * an array of values, or a multi-dimensional array with fields as 549 * keys and orders ('ASC' or 'DESC') as values. Accepted values are 550 * 'ID', 'display_name' (or 'name'), 'user_login' (or 'login'), 551 * 'user_nicename' (or 'nicename'), 'user_email' (or 'email'), 552 * 'user_url' (or 'url'), 'user_registered' (or 'registered'), 553 * 'post_count', 'meta_value', 'meta_value_num', the value of 554 * `$meta_key`, or an array key of `$meta_query`. To use 555 * 'meta_value' or 'meta_value_num', `$meta_key` must be also be 556 * defined. Default 'user_login'. 557 * @type string $order Designates ascending or descending order of users. Order values 558 * passed as part of an `$orderby` array take precedence over this 559 * parameter. Accepts 'ASC', 'DESC'. Default 'ASC'. 560 * @type int $offset Number of users to offset in retrieved results. Can be used in 561 * conjunction with pagination. Default 0. 562 * @type int $number Number of users to limit the query for. Can be used in 563 * conjunction with pagination. Value -1 (all) is not supported. 564 * Default empty (all users). 565 * @type bool $count_total Whether to count the total number of users found. If pagination 566 * is not needed, setting this to false can improve performance. 567 * Default true. 568 * @type string|array $fields Which fields to return. Single or all fields (string), or array 569 * of fields. Accepts 'ID', 'display_name', 'login', 'nicename', 570 * 'email', 'url', 'registered'. Use 'all' for all fields and 571 * 'all_with_meta' to include meta fields. Default 'all'. 572 * @type string $who Type of users to query. Accepts 'authors'. 573 * Default empty (all users). 572 574 * @type bool|array $has_published_posts Pass an array of post types to filter results to users who have 573 575 * published posts in those post types. `true` is an alias for all
Note: See TracChangeset
for help on using the changeset viewer.