函数描述
创建用户下拉选择菜单 HTML 元素。
使用方法
<?php wp_dropdown_users( $args ); ?>默认使用
<?php $args = array(
'show_option_all' => null, // string
'show_option_none' => null, // string
'hide_if_only_one_author' => null, // string
'orderby' => 'display_name',
'order' => 'ASC',
'include' => null, // string
'exclude' => null, // string
'multi' => false,
'show' => 'display_name',
'echo' => true,
'selected' => false,
'include_selected' => false,
'name' => 'user', // string
'id' => null, // integer
'class' => null, // string
'blog_id' => $GLOBALS['blog_id'],
'who' => null // string
); ?>参数
- show_option_all
- (
string) 允许在下拉选项中选择所有用户。
- show_option_none
- (
string) 在下拉选择表单的顶部创建一个附加的<OPTION>选项，以便不选择任何用户时使用，次参数的值为实际的字符串，（如，设置此参数的值为 true，我们在下拉选项中看到的值将会是1。 - orderby
- (
string) 排列选项的key，可用的值有：- 'ID'
- 'user_nicename'
- 'display_name' – 默认为此项
- order
- (
string) 排序方式，可用的值有：- 'ASC' – 默认
- 'DESC'
- include
- (
string) 逗号分隔的需要包含的用户id列表，如’include=4,12′ 是指用户id为 4 a和 12 的用户将被返回或显示，默认包含所有用户。
- exclude
- (
string)逗号分隔的需要排除的用户id列表，如’include=4,12′ 是指用户id为 4 a和 12 的用户将不被返回或显示，默认不排除任何用户。
- multi
- (
boolean) 是否在‘select’元素上跳过ID属性。- 1 (True)
- 0 (False) – 默认
- show
- (
string) 需要显示的用户数据列，如果selected为空，将使用 user_login显示。 - 'ID'
- 'user_login'
- 'display_name' – Default
- echo
- (
boolean) 直接显示用户 ( TRUE)，还是返回他们以便在PHP中使用 ( FALSE).- 1 (True) – 默认
- 0 (False)
- selected
- (
integer) 默认选中的用户ID，默认没有选中任何用户。
- include_selected
- (
boolean) 总是在下拉选择中包含已经选中的用户名，默认为 false。
- name
- (
string) 分配给下拉表单的名称，默认为 ‘user’.
- class
- (
string) 分配给下拉表单的css class。
- id
- 下拉选项的ID 属性，默认为‘name’ 参数。
- class
- 下拉选项的CSS Class属性。
- blog_id
- 博客ID (在多站点中使用)，默认id为当前博客。
- who
- 查询哪个用户，目前只支持‘author’，默认为所有用户，在WordPress3.1版本中添加。
使用示例
带提交按钮的下拉选择表单
显示一个带提交按钮的下拉选择表单。
<li id="users">
<h2><?php _e('users:'); ?></h2>
<form action="<?php bloginfo('url'); ?>" method="get">
<?php wp_dropdown_users(array('name' => 'author')); ?>
<input type="submit" name="submit" value="view" />
</form>
</li>