wp_dropdown_users 创建用户下拉选择表单

函数描述

创建用户下拉选择菜单 HTML 元素。

使用方法

<?php wp_dropdown_users( $args ); ?>

默认使用

$args = [
    '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>

本站提供 WordPress主题定制开发服务

本站长期承接 WordPress主题、插件、基于 WooCommerce 的商店商城开发业务。 我们有 8 年WordPress开发经验,如果你想 用WordPress开发网站, 请联系微信: iwillhappy1314,或邮箱: 4626395@gmail.com 咨询。

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

*