模板标签-wp_dropdown_users()

0条评论

说明

创建用户的下拉式菜单HTML文本。

用法

<?php wp_dropdown_users( $args ); ?> 

默认用法

<?php $args = array(
'show_option_all' => ,
'show_option_none' => ,
'orderby' => 'display_name',
'order' => 'ASC',
'include' => ,
'exclude' => ,
'multi' => 0,
'show' => 'display_name',
'echo' => 1,
'selected' => 0,
'name' => 'user',
'class' => ); ?>

参数

show_option_all

(字符串)生成下拉式选项框的HTML,从而允许你选定所有用户。

show_option_none

(字符串)生成下拉式选项框的HTML,从而允许你不选定任何用户。

orderby

(字符串)按某种标准为用户排序。有效值包括:

  • 'ID'
  • 'user_nicename'
  • 'display_name' ——默认值

order

(字符串)为分类目录排序(升序或降序)有效值包括:

  • 'ASC'(升序) ——默认值
  • 'DESC'(降序)

include

(字符串)被包含的用户的ID列表,各ID用逗号隔开,例如, 'include=4,12' 表示显示或返回ID为4和12的用户。默认值为包含所有用户。

exclude

(字符串)将要排除的用户的ID列表,各ID用逗号隔开。例如, 'exclude=4,12' 表示不显示或返回ID为4和12的用户。默认值为不排除任何用户。

multi

(布尔型)是否剥离'select'元素的ID属性。

  • 1 (true)
  • 0(false)——默认值

show

(字符串)将要显示的用户表。如果选定的列表项为空,user_login会显示在括号中。

  • 'ID'
  • 'user_nicename'
  • 'display_name' ——默认值

echo

(布尔型)显示结果(TRUE),或返回结果以供PHP使用(FALSE)

  • 1 (true)——默认值
  • 0(false)

selected

(整数)在显示框中选中/显示的用户的ID。默认为不选中任何用户。

name

(字符串)下拉式选框被赋予的名称。默认为user'。

class

(字符串)被赋给下拉式选项框的类。

示例

带有提交按钮的下拉式选项框

以HTML格式显示一个带有有提交按钮的用户下拉式列表。

<li id="users">
 <h2><?php _e('users:'); ?></h2>
   <form action="<?php bloginfo('url'); ?>" method="get">
   <?php wp_dropdown_users(); ?>
   <input type="submit" name="submit" value="view" />
   </form>
</li>

历史记录

  • 始见于WordPress 2.3.0版本

源文件

wp_dropdown_users()位于wp-includes/user.php