Хуки FormIt. Пишем хук для авторизации пользователя на Frontend

<form>
    <ul class="field_list">
        <li class="field_item">
            <dl class="form_cell form_cell_v1_mod">
                <dt class="form_cell_title form_v1_mod hline_hide_mod">
                    <label for="signin_email2">Email</label>
                </dt>
                <dd class="form_field_wrap form_v1_mod hline_hide_mod">
                    <input class="form_field v2_mod default_mod" type="text" id="signin_email2" placeholder="Email*" name="username"/>
                    <span class="form_field_error" data-error-for="username"></span>
                </dd>
            </dl>
        </li>
        <li class="field_item">
            <dl class="form_cell form_cell_v1_mod">
                <dt class="form_cell_title form_v1_mod hline_hide_mod">
                    <label for="signin_password2">Пароль</label>
                </dt>
                <dd class="form_field_wrap form_v1_mod hline_hide_mod">
                    <input class="form_field v2_mod default_mod" type="password" id="signin_password2" placeholder="Пароль*" name="password"/>
                    <span class="form_field_error" data-error-for="password"></span>
                </dd>
            </dl>
            <span class="btn_field">Показать</span>
        </li>
    </ul>
    <div class="form_btn_w offset_mod">
        <button type="submit" name="sendSignin" value="1" class="btn_form">ВОЙТИ</button>
    </div>
</form>

{$_modx->runSnippet('!AjaxForm', [
    'form' => 'b.signinForm',
    'hooks' => 'ЗДЕСЬ МЫ УКАЖЕМ ИМЯ НАШЕГО ХУКА',
    'validate' => 'username:required,password:required',
    'validationErrorMessage' => 'Во время авторизации возникли ошибки',
    'successMessage' => 'Авторизация успешно завершена',
    'submitVar' => 'sendSignin',
])}

<?php
/**
 * Авторизация пользователя в текущем контексте
 *
 * @var modX $modx
 * @var fiHooks $hook
 */

//Формируем набор свойств, который мы передадим 
//в процессор авторизации, который есть в modx по-умолчанию
$properties = array(
    'login_context' => $modx->context->key,
    'add_contexts' => '',
    //Для обращения к полям, введенным в форме, 
    //используется метод $hook->getValue('имя поля')
    'username' => $hook->getValue('username'),
    'password' => $hook->getValue('password'),
    'returnUrl' => '',
    'rememberme' => true,
);

// Запуск процессора авторизации
/** @var modProcessorResponse $response */
$response = $modx->runProcessor(
    'user/login',
    $properties,
    [
        //Путь к папке процессора
        'processors_path' => MODX_CORE_PATH.'model/modx/processors/security/',
    ]
);

// Проверка результата на ошибки. Возвращение ошибок в форму, если нужно
/** @var modProcessorResponseError[] $errors */
if($errors = $response->getFieldErrors()) {
    foreach ($errors as $error) {
        //Таким образом мы можем добавить ошибку к определенному полю
        $hook->addError($error->getField(), $error->getMessage());
    }

    //Если хук возвращает false, выполнение
    //последующих хуков останавливается
    return false;
}

//Получить объект текущего авторизовавшегося пользователя можно так:
$user = $modx->getAuthenticatedUser($modx->context->key);

//Здесь можно выполнить дополнительную логику после 
//авторизации ползователя (инициализацию каких-либо полей и прочие операции)

//Хук должен вернуть true, тогда будут выполнены 
//все остальные операции и будет считаться, что он завершился успешно
return true;

{$_modx->runSnippet('!AjaxForm', [
    'form' => 'b.signinForm',
    'hooks' => 'loginHook',
    'validate' => 'username:required,password:required',
    'validationErrorMessage' => 'Во время авторизации возникли ошибки',
    'successMessage' => 'Авторизация успешно завершена',
    'submitVar' => 'sendSignin',
])}