wp_login_url() │ WP 2.7.0

Получает URL страницы входа/авторизации: /wp-login.php

В параметре $redirect можно указать URL, куда следует вернутся после авторизации.

Основа для: wp_loginout()

Хуки из функции

login_url

Возвращает

Строку. УРЛ на страницу авторизации.

Использование

<?php echo wp_login_url( $redirect ); ?>

$redirect(строка): URL страницы, на которую нужно перенаправить после авторизации.
По умолчанию: ''
$force_reauth(логический): Включает принудительную ре-авторизацию, даже если куки авторизации уже установлены.
По умолчанию: false

Примеры

#1 Базовое использование:

<a href="<?php echo wp_login_url(); ?>" title="Войти">Войти</a>

#2 Авторизация и возврат на текущую страницу:

<a href="<?php echo wp_login_url( get_permalink() ); ?>" title="Войти">Войти</a>

#3 Авторизация и переход на главную страницу:

<a href="<?php echo wp_login_url( home_url() ); ?>" title="Войти">Войти</a>

Список изменений

С версии 2.7.0

Введена.

Код `wp_login_url() wp login url` ^{WP 6.1.1}

wp-includes/general-template.php

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 );
}