`wp_dropdown_users`是一个WordPress函数,用于生成一个下拉框,其中包含所有用户的选项。它的详细用法和教程解析如下:

用法:

wp_dropdown_users( $args );

参数:
- `$args`:一个可选的数组,包含用于自定义下拉框的参数。

主要参数:
- `name`:下拉框的名称,可选,默认为 `'author'`。
- `id`:下拉框的ID,可选,默认为 `'user_id'`。
- `selected`:默认选中的用户ID或用户名,可选,默认为当前用户的ID。
- `role`:要显示的用户角色,可选,默认为空。
- `exclude`:要排除的用户ID或用户名,可选,默认为空。
- `show_option_none`:是否显示一个空的选项,可选,默认为 `false`。
- `option_none_value`:空选项的值,可选,默认为空字符串。
- `multi`:是否允许多选,可选,默认为 `false`。

示例用法:

wp_dropdown_users( array(
'name' => 'author',
'id' => 'author',
'selected' => 1,
'role' => 'subscriber',
'exclude' => '2,5',
'show_option_none' => 'Select User',
'option_none_value' => '-1',
'multi' => true
) );

这将生成一个下拉框,其中包含所有拥有`subscriber`角色的用户,排除了ID为2和5的用户,并且默认选中ID为1的用户。该下拉框的名称和ID分别为`author`,并且允许多选。最后,如果没有选择任何用户,将会显示一个空的选项,其值为`-1`。

注意:`wp_dropdown_users`函数通常用于用于显示一个用户选择器,比如在创建文章或页面时选择作者。