WordPress函数:wp_login_url
一、函数简介
用于动态生成网站的登录页面URL。该函数在wp-includes/general-template.php文件中定义,是WordPress模板函数库的一部分。
<?php echo wp_login_url( $redirect='', $force_reauth=false); ?>
二、函数参数
- $redirect(字符串):登录成功后重定向的页面路径,默认为空。
$force_reauth(布尔值):是否强制重新认证(即使存在有效Cookie),默认为false。
三、函数案例
(一)、案例1
<p>你必须 <a href="<?php echo wp_login_url( get_permalink() ); ?>">登录</a> 才能发表评论.</p>
四、调试效果
五、源代码
/**
* Retrieves the login URL.
*
* @since 2.7.0
*
* @param string $redirect Path to redirect to on log in.
* @param bool $force_reauth Whether to force reauthorization, even if a cookie is present.
* Default false.
* @return string The login URL. Not HTML-encoded.
*/
function wp_login_url( $redirect = '', $force_reauth = false ) {
$login_url = site_url( 'wp-login.php', 'login' );
if ( ! empty( $redirect ) ) {
$login_url = add_query_arg( 'redirect_to', urlencode( $redirect ), $login_url );
}
if ( $force_reauth ) {
$login_url = add_query_arg( 'reauth', '1', $login_url );
}
/**
* Filters the login URL.
*
* @since 2.8.0
* @since 4.2.0 The `$force_reauth` parameter was added.
*
* @param string $login_url The login URL. Not HTML-encoded.
* @param string $redirect The path to redirect to on login, if supplied.
* @param bool $force_reauth Whether to force reauthorization, even if a cookie is present.
*/
return apply_filters( 'login_url', $login_url, $redirect, $force_reauth );
}
THE END