wp_logout_url()

Извлекает URL для выхода
Функция WordPress
INT 2.7.0
WordPress Icon

Описание функции

Функция wp_logout_url() возвращает URL-адрес для выхода пользователя из системы. Этот URL-адрес может быть использован в ссылках или кнопках для выхода пользователя из аккаунта на сайте WordPress.

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

wp_logout_url( string $redirect = '' ): string

Функция wp_logout_url() принимает один необязательный параметр:

  • $redirect (строка) — Путь для перенаправления после выхода пользователя. По умолчанию: пустая строка.

Функция возвращает URL-адрес для выхода пользователя из системы. Обратите внимание, что URL-адрес кодируется с использованием функции esc_html() внутри функции wp_nonce_url().

<?php
  $logout_url = wp_logout_url();
  echo 'Ссылка для выхода: <a href="' . $logout_url . '">Выход</a>';
?>

В этом примере мы используем функцию wp_logout_url() для получения URL-адреса для выхода пользователя из системы. Затем мы выводим ссылку на этот URL-адрес, чтобы пользователь мог нажать на нее и выйти из своего аккаунта на сайте WordPress.

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

Получение URL для выхода из системы


$logout_url = wp_logout_url();

Функция wp_logout_url() возвращает URL для выхода из системы. По умолчанию, функция не принимает никаких параметров и возвращает URL для выхода из системы без перенаправления.

Перенаправление пользователя после выхода


$redirect_url = 'https://example.com';
$logout_url = wp_logout_url( $redirect_url );

Если требуется перенаправить пользователя на определенную страницу после выхода из системы, можно передать URL этой страницы в качестве параметра $redirect функции wp_logout_url(). В приведенном примере, пользователь будет перенаправлен на страницу https://example.com после выхода из системы.

Добавление дополнительных параметров в URL выхода


$redirect_url = 'https://example.com';
$logout_url = wp_logout_url( add_query_arg( 'param', 'value', $redirect_url ) );

Если необходимо добавить дополнительные параметры в URL выхода из системы, можно использовать функцию add_query_arg() для создания URL с параметрами. В приведенном примере, параметр param со значением value будет добавлен к URL выхода из системы.

Использование wp_logout_url() в пользовательских шаблонах


$logout_url = wp_logout_url( home_url() );
echo '<a href="' . esc_url( $logout_url ) . '">Logout</a>';

В пользовательских шаблонах можно использовать функцию wp_logout_url() для создания ссылки на выход из системы. В приведенном примере, функция home_url() используется для получения URL главной страницы сайта, которая будет использоваться в качестве перенаправления после выхода. Затем, с помощью функции esc_url() и echo выводится ссылка на выход из системы.

Изменение текста ссылки на выход из системы


$logout_url = wp_logout_url();
$logout_link = '<a href="' . esc_url( $logout_url ) . '">Выйти</a>';
echo $logout_link;

Если требуется изменить текст ссылки на выход из системы, можно создать свою ссылку с помощью функции wp_logout_url() и функции esc_url(). В приведенном примере, создается ссылка с текстом «Выйти», которая ведет на URL выхода из системы.

Вопросы и ответы

Как получить URL для выхода из системы?

Для получения URL для выхода из системы в WordPress используется функция wp_logout_url(). Она возвращает строку с URL для выхода из системы.

Пример использования функции:


$logout_url = wp_logout_url();
echo $logout_url;

Можно ли указать путь для перенаправления после выхода из системы?

Да, можно указать путь для перенаправления после выхода из системы. Для этого в функцию wp_logout_url() передается параметр $redirect с путем для перенаправления.

Пример использования функции с указанием пути для перенаправления:


$redirect_url = '/my-redirect-page';
$logout_url = wp_logout_url($redirect_url);
echo $logout_url;

Как защитить URL для выхода из системы от CSRF-атак?

URL для выхода из системы, возвращаемый функцией wp_logout_url(), уже защищен от CSRF-атак. Он проходит обработку функцией wp_nonce_url(), которая кодирует его с помощью функции esc_html().

Как изменить текст ссылки на выход из системы?

Функция wp_logout_url() возвращает URL для выхода из системы в WordPress. По умолчанию, текст ссылки будет «Выйти».

Чтобы изменить текст ссылки на выход из системы, можно использовать фильтр gettext и изменить значение текста «Выйти».

// Функция для изменения текста ссылки на выход из системы
function custom_logout_link_text( $translated_text, $untranslated_text, $domain ) {
    if ( $untranslated_text === 'Выйти' ) {
        return 'Выйти из системы';
    }
    return $translated_text;
}
add_filter( 'gettext', 'custom_logout_link_text', 10, 3 );

Можно ли использовать wp_logout_url() вне шаблона WordPress?

Да, функцию wp_logout_url() можно использовать вне шаблона WordPress. Она возвращает URL для выхода из системы, который может быть использован в любом месте, где требуется ссылка на выход из системы.

// Использование wp_logout_url() вне шаблона WordPress
$logout_url = wp_logout_url();
echo '<a href="' . $logout_url . '">Выйти из системы</a>';

Как изменить URL для выхода из системы?

Функция wp_logout_url() возвращает URL для выхода из системы по умолчанию. Можно изменить URL, указав путь для перенаправления после выхода из системы.

// Изменение URL для выхода из системы
$redirect_url = '/custom-logout-page/';
$logout_url = wp_logout_url( $redirect_url );
echo '<a href="' . $logout_url . '">Выйти из системы</a>';

Функция wp_logout_url() возвращает URL для выхода из системы в WordPress. Её можно использовать для создания ссылки на выход из системы с возможностью изменения текста ссылки и URL для перенаправления после выхода.

Связанные элементы

  • Функция wp_login_url(): Возвращает URL страницы входа для пользователя.
  • Функция wp_lostpassword_url(): Возвращает URL страницы восстановления пароля.
  • Функция wp_registration_url(): Возвращает URL страницы регистрации нового пользователя.
  • Функция wp_get_current_user(): Возвращает объект текущего пользователя.
  • Функция wp_create_user(): Создает нового пользователя в базе данных.
  • Функция wp_update_user(): Обновляет данные пользователя в базе данных.
  • Функция wp_delete_user(): Удаляет пользователя из базы данных.
  • Функция wp_authenticate(): Аутентификация пользователя по логину и паролю.
  • Хук wp_login: Вызывается после успешной аутентификации пользователя.
Обсуждение