get_users() – WordPress函数

描述

WP_User_Query的包装器。检索符合条件的用户数组$args。

用法


<?php get_users($ args); ?>

参数


 $GLOBALS['blog_id'],
	'role'         => '',
	'role__in'     => array(),
	'role__not_in' => array(),
	'meta_key'     => '',
	'meta_value'   => '',
	'meta_compare' => '',
	'meta_query'   => array(),
	'date_query'   => array(),        
	'include'      => array(),
	'exclude'      => array(),
	'orderby'      => 'login',
	'order'        => 'ASC',
	'offset'       => '',
	'search'       => '',
	'number'       => '',
	'count_total'  => false,
	'fields'       => 'all',
	'who'          => '',
 ); 
get_users( $args ); ?>

blog_id – 当前博客的ID,除非启用了多站点,并提供了另一个ID
角色 – 将返回的用户限制为指定的角色。Roles_and_Capabilities#User_Levels
role__in – 限制具有指定角色之一的返回用户。(自WP 4.4以来)
role__not_in – 排除具有任何指定角色的用户。(自WP 4.4以来)
include – 一个ID数组。只有与这些ID匹配的用户才会被返回。请注意,目前include和exclude(下面)参数不能一起使用。见票#23228
exclude – 一个ID数组。与这些ID匹配的用户将不会返回,无论其他参数如何。如果include参数被设置,它将被忽略。
meta_key -该meta_key在wp_usermeta表为meta_value归还。有关可能的元键,请参阅get_userdata()。
meta_value – 元键的值。
meta_compare – 运算符来测试’ meta_value ‘。可能的值为’!=’,’>’,’> =’,’例子

在无序列表中显示所有订阅者的基本示例。


' . esc_html( $user->user_email ) . '';
}

使用“搜索”字段的示例。


 'john' ) );
// WP_User对象的数组
foreach ( $blogusers as $user ) {
	echo '' . esc_html( $user->user_email ) . '';
}

第一个例子将会显示和显示所有拥有用户名,ID,电子邮件“john”的用户。您还可以通过在搜索查询之前或之后添加*进行通配符搜索。例如,要搜索以“jo”开头的所有用户,您将传递类似“ jo * ”的内容。

结果将是以“jo”开头的用户名,ID或电子邮件的所有用户。*可以在搜索查询之前或之后放置。放置之前,结果将是您查询中结束的所有用户。

一个查询特定字段的示例。


 array( 'display_name' ) ) );
//  stdClass对象的数组.
foreach ( $blogusers as $user ) {
	echo '' . esc_html( $user->display_name ) . '';
}

返回

(阵列)
ID,stdClass对象或WP_User对象的数组,具体取决于’ fields ‘参数的值。
如果’ fields ‘设置为’all’(默认)或’all_with_meta’,它将返回一个WP_User对象数组。
如果’ fields ‘设置为一个wp_users表字段的数组,它将返回一个只有这些字段的stdClass对象的数组。
如果’ fields ‘设置为任何单独的wp_users表字段,将返回一个ID数组。

用户的示例对象


[0] => WP_User Object	(
	[data] => stdClass Object
	(
		[ID] => 3
		[user_login] => dabid
		[user_pass] => $P$BK1deNU7lV/rgwp2oncgESRHRYLedRF.
		[user_nicename] => David
		[user_email] => example@example.com
		[user_url] => 
		[user_registered] => 2017-03-21 14:11:32
		[user_activation_key] => 149492:$P$BV76R0AcpmGMNAStZbdO.uVu7QWF9l1
		[user_status] => 0
		[display_name] => David Example
	)

	[ID] => 3
	[caps] => Array
		(
			[author] => 1
		)
		[cap_key] => llk_capabilities
	[roles] => Array
		(
			[0] => author
		)
		[allcaps] => Array
		(
		[upload_files] => 1
		[edit_posts] => 1
		[edit_published_posts] => 1
		[publish_posts] => 1
		[read] => 1
		[level_2] => 1
		[level_1] => 1
		[level_0] => 1
		[delete_posts] => 1
		[delete_published_posts] => 1
		[author] => 1
		)
	[filter] => 
	)

Previous Post
实现wordpress搜索结果关键词限制在文章标题
Next Post
WordPress后台文章列表添加缩略图

相关文章

Menu