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

相关函数：

Typora