WP_LOGIN_URL() │ WP 2.7.0

Эта функция используется для получения URL-адреса страницы входа в систему WordPress.

Использование функции

Функция: wp_login_url( $redirect, $force_reauth );

Параметры

• $redirect (строка): Путь, на который пользователь будет перенаправлен после входа. По умолчанию: ''
• $force_reauth (булевый тип): Указывает, нужно ли принудительно переавторизовывать пользователя, даже если куки находятся в наличии. По умолчанию: false

Пример возвращаемого значения

• Возвращает строку с URL-адресом для входа. Адрес не закодирован в формате HTML.

Примеры использования

Пример 1: Основное использование

echo wp_login_url(); // Вернет URL страницы входа, например: https://example.com/wp-login.php

Вы также можете использовать его в HTML:

Войти

Пример 2: Переавторизация и перенаправление на текущую страницу

Войти

Обратите внимание, что если страница имеет ошибку 404 (не найдена), то get_permalink() вернет false. В этом случае лучше извлечь актуальный URL, если текущая страница — это личный пост, к которому пользователь не имеет доступа.

Пример кода для этого сценария:

request ); ?>

Пример 3: Переавторизация и переход на домашнюю страницу

Войти

Изменения

Функция wp_login_url() была добавлена в версии 2.7.0.

Код функции

Ниже приведен код функции wp_login_url(), который можно найти в файле 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 );
}

/**
 * Фильтрует URL для входа.
 *
 * @param string $login_url   URL входа. Не закодирован в формате HTML.
 * @param string $redirect    Путь для перенаправления после входа (если указан).
 * @param bool   $force_reauth Нужно ли принудительно переавторизовать, даже если есть куки.
 */
return apply_filters( 'login_url', $login_url, $redirect, $force_reauth );

}

Связанные функции

В WordPress также есть ряд функций, относящихся к входу и выходу:

• check_password_reset_key(): Проверяет ключ сброса пароля.
• is_user_logged_in(): Проверяет, авторизован ли пользователь.
• wp_logout(): Выход из системы.
• wp_register(): Регистрация нового пользователя.

Эти функции могут быть полезны для создания более комплексных решений для управления пользовательскими сессиями на вашем сайте WordPress.