前面介绍了一系列用于制作登录表单的函数，事实上如果我们需要WordPress前台输出一个登录表单，只需要WordPress模板标签wp_login_form就够了。
1 | wp_login_form( string|array $args = '' ) |
函数参数
$args
数组或字符串值
wp_login_form()函数$args参数默认的值如下：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | $args = array( 'echo' => true, 'remember' => true, 'redirect' => ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'], 'form_id' => 'loginform', 'id_username' => 'user_login', 'id_password' => 'user_pass', 'id_remember' => 'rememberme', 'id_submit' => 'wp-submit', 'label_username' => __( 'Username' ), 'label_password' => __( 'Password' ), 'label_remember' => __( 'Remember Me' ), 'label_log_in' => __( 'Log In' ), 'value_username' => '', 'value_remember' => false ); |
wp_login_form()函数$args参数可用的值如下：
echo
布尔值，默认值：true
是否输出结果，如果为false，只返回结果而不输出。
redirect
字符串值，默认为当前页面URL
用户登录后返回哪个页面，默认返回到当前页面，通常这是最好的选择。
form_id
字符串值，默认值：loginform
登录表单id属性的值
remember
布尔值，默认值：true
是否显示“记住我的登录信息”选项
value_username
字符串值，默认为空
log文本框默认的value值，也就是用户名输入框默认值。
value_remember
布尔值，默认值：false
这个比较实用，设置“记住我的登录信息”选项是否默认选中状态，默认为不选中。
函数使用示例
设置用户名输入框默认值为“请输入用户名…”，并默认勾选“记住我的登录信息”
1 2 3 4 5 6 7 | <?php $args = array( 'value_remember' => true, 'value_username' => '请输入用户名...' ); wp_login_form($args); ?> |
下面的代码输出一样的结果：
1 | <?php wp_login_form('value_remember=1&value_username=请输入用户名...'); ?> |
扩展阅读
wp_login_form()函数位于：wp-includes/general-template.php
相关函数：
- is_user_logged_in()
- wp_loginout()
- wp_logout()
- wp_register()
- wp_login_url()
- wp_logout_url()
- wp_lostpassword_url()
- wp_registration_url()
原文链接：https://xiaohost.com/2416.html，转载请注明出处。
