WordPress登录表单标签:wp_login_form

前面介绍了一系列用于制作登录表单的函数,事实上如果我们需要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,转载请注明出处。
0