创建用户的下拉HTML内容。

原型

wp_dropdown_users( array|string $args = '' )

描述

可以显示内容,默认情况下也可以通过设置’echo’参数来检索内容。不需要使用’include’和’exclude’参数;在这种情况下,将显示所有用户。只能使用一个,包括’include’或’exclude’,但不能同时使用两者。

参数

$args (array|string) (Optional) 用于生成用户下拉列表的数组或参数字符串。有关其他可用参数,请参阅WP_User_Query :: prepare_query()。 ‘show_option_all’(字符串)显示为下拉默认值(全部)的文本。 ‘show_option_none’(字符串)在未找到用户时显示为下拉默认值的文本。 ‘option_none_value’(int | string)未找到用户时用于$ show_option_non的值。默认-1。 ‘hide_if_only_one_author’(字符串)如果只找到一个用户,是否跳过生成下拉列表。 ‘orderby’(字符串)字段按订单找到用户。接受用户字段。默认’display_name’。 ‘order’(字符串)是否按升序或降序对用户进行排序。接受’ASC’(升序)或’DESC’(降序)。默认’ASC’。 ‘include’(array | string)要包括的用户ID的数组或逗号分隔列表。 ‘exclude’(array | string)要排除的用户ID的数组或逗号分隔列表。 ‘multi’(bool | int)是否跳过’select’元素的ID属性。接受1 | true或0 | false。默认值为0 | false。 ‘show’(字符串)要显示的用户数据。如果所选项目为空,则“user_login”将显示在括号中。接受任何用户字段,或“display_name_with_login”以在括号中显示user_login的显示名称。默认’display_name’。 ‘echo’(int | bool)是否回显或返回下拉列表。接受1 | true(echo)或0 | false(return)。默认1 | true。 ‘selected’(int)应选择哪个用户ID。默认值为0。 ‘include_selected’(bool)是否始终在下拉列表中包含所选用户ID。默认为false。 ‘name’(字符串)select元素的Name属性。默认’用户’。 ‘id’(字符串)select元素的ID属性。默认值是$ name的值。 ‘class’(字符串)select元素的Class属性。 ‘blog_id’(int)博客ID(仅限多站点)。默认值是当前博客的ID。 ‘who’(字符串)要查询的用户类型。只接受空字符串或“作者”。 ‘role’(字符串|数组)用户必须匹配才能包含在结果中的数组或以逗号分隔的角色名称列表。请注意,这是一个包含列表:用户必须匹配* each *角色。 ‘role__in’(array)角色名称数组。匹配用户必须至少具有其中一个角色。默认空数组。 ‘role__not_in’(array)要排除的角色名称数组。匹配一个或多个这些角色的用户将不会包含在结果中。默认空数组。

源文件

路径:“

<?php
...
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_dropdown_users/