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