WordPress登录表单标签：wp_login_form

前面介绍了一系列用于制作登录表单的函数，事实上如果我们需要WordPress前台输出一个登录表单，只需要WordPress模板标签wp_login_form就够了。

wp_login_form( string|array $args = \'\' )

函数参数

$args

数组或字符串值

wp_login_form()函数$args参数默认的值如下：

$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

这个比较实用，设置“记住我的登录信息”选项是否默认选中状态，默认为不选中。

函数使用示例

设置用户名输入框默认值为“请输入用户名…”，并默认勾选“记住我的登录信息”

<?php $args = array(\'value_remember\' => true,\'value_username\' => \'请输入用户名...\');wp_login_form($args);?>

下面的代码输出一样的结果：

<?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()