Документация WordPress

wp_signon

Q: wp_signon

Функция wp_signon() в WordPress используется для аутентификации пользователя. Она позволяет коду выполнить вход пользователя в систему (например, при обработке формы входа на сайте). Функция возвращает объект пользователя или объект WP_Error в случае ошибки.

Функция wp_signon() в WordPress используется для аутентификации пользователя. Она позволяет коду выполнить вход пользователя в систему (например, при обработке формы входа на сайте). Функция возвращает объект пользователя или объект WP_Error в случае ошибки.

Параметры

$credentials (массив, необязательно): Массив с данными для аутентификации пользователя. Должен содержать следующие ключи:
- user_login (строка): Логин пользователя.
- user_password (строка): Пароль пользователя.
- remember (булевое значение): Если true, создается «запомнить меня» куки.
$secure_cookie (строка, необязательно): Определяет, нужно ли использовать secure cookie. Значение может быть true, false или пустая строка. По умолчанию пустая строка.

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

Обработка ошибок

Функция wp_signon() возвращает объект WP_Error в случае неудачной аутентификации. Вы можете обработать эти ошибки и вывести соответствующие сообщения.

<?php
if ( is_wp_error( $user ) ) {
    $error_code = $user->get_error_code();
    switch ( $error_code ) {
        case 'invalid_username':
            echo 'Invalid username.';
            break;
        case 'incorrect_password':
            echo 'Incorrect password.';
            break;
        default:
            echo 'Login failed.';
    }
} else {
    echo 'Login successful.';
}

//Пример с использованием функции в хуке
function custom_login() {
    if ( isset( $_POST['custom_login_nonce'] ) && wp_verify_nonce( $_POST['custom_login_nonce'], 'custom_login_action' ) ) {
        $creds = array(
            'user_login'    => $_POST['username'],
            'user_password' => $_POST['password'],
            'remember'      => isset( $_POST['remember'] ) ? true : false
        );

$user = wp_signon( $creds, is_ssl() );

if ( is_wp_error( $user ) ) {
            wp_redirect( add_query_arg( 'login', 'failed', wp_get_referer() ) );
            exit;
        } else {
            wp_redirect( home_url() );
            exit;
        }
    }
}
add_action( 'init', 'custom_login' );
?>

Функция wp_signon() является инструментом для аутентификации пользователей в WordPress, обеспечивая гибкость и возможность интеграции кастомных форм входа в темы и плагины.

user