首页    >    中文手册    >   常用函数-wp_insert_user()

常用函数-wp_insert_user()

常用函数-wp_insert_user()

说明

在数据库中创建用户。

根据用户编号是否存在对现有用户进行更新或创建一个新用户。

该函数可更新用户信息(见下文),设定用户角色,并使用富文本编辑器来设置用户首选项。

用法

<?php wp_insert_user( $userdata ) ?>

参数

$userdata

(数组)(必需)用户资料数组

默认值: None

返回的值

(整数)

新创建用户的编号

示例

注释

  • 用法: $wpdb WordPress数据库层
  • 用法:apply_filters() 为大多数带有'pre_user'前缀的$userdata字段调用过滤器。参见上文中的“说明”。
  • 用法:更新所给的用户编号时, do_action()调用'profile_update'钩子
  • 用法:根据所给的用户编号创建新用户时, do_action() 调用'user_register'钩子

$userdata数组可能包含以下字段

字段名称 说明 联合过滤器
ID 整数,用来更新已存在用户 (none)
user_pass 字符串,其中包含用户的纯文本密码 pre_user_user_pass
user_login 字符串,其中包含用户登录所用的用户名 pre_user_user_login
user_nicename 字符串,其中包含用户的昵称。默认为用户名。 pre_user_user_nicename
user_url 字符串,其中包含用户网站的URL。 pre_user_user_url
user_email 字符串,其中包含用户的电子邮件地址。 pre_user_user_email
display_name 字符串,将显示在网站上。默认为用户的用户名。出于外观和隐藏安全考虑,最好改变默认显示名称(在不使用默认管理者用户名并将其删除的情况下)。 pre_user_display_name
nickname 用户昵称,默认为用户名。 pre_user_nickname
first_name 用户名称 pre_user_first_name
last_name 用户姓氏 pre_user_last_name
description 字符串,其中包含用户信息 pre_user_description
rich_editing 字符串,决定是否激活富文本编辑器。若字符串不为空则默认值为false (none)
user_registered 用户注册日期。格式为年-月-日 时:分:秒 (none)
role 字符串,用以设定用户的角色 (none)
jabber 用户的jabber账户 (none)
aim 用户的AOL即时通讯账号 (none)
yim 用户的Yahoo即时通讯账号 (none)

修改记录

自2.0.0版本后

源文件

wp_insert_user()位于 wp-includes/registration.php中。

相关资源

分类:中文手册

* 版权声明:作者WordPress啦! 转载请注明出处。