常用函数-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中。
相关资源
分类:中文手册