Авторизация пользователей

Авторизация пользователей

Авторизация пользователей в FormLister осуществляется с использованием контроллера Login.

Авторизация может проходить по имени, email или другому полю из учетной записи. Поле задается в параметре loginField. Поле для авторизации должно быть уникальным для каждого веб-пользователя. Обычно для авторизации используются поля username или email.

Дополнительное использование плагина userHelper позволяет:

  • вести учет количества логинов
  • опрееделить время последней авторизации
  • реализовать автологин или выход из учетной записи

Перед использованием плагина userHelper убедитесь что он не отключен:

Не забудьте включить userHelper

Параметры контроллера

model

Класс для работы с пользователями.

Возможные значения - имя класса.

Значение по умолчанию - \modUsers

modelPath

Путь к файлу класса для работы с пользователями.

Возможные значения - относительный путь к файлу.

Значение по умолчанию - assets/lib/MODxAPI/modUsers.php

loginField

Поле, содержащее имя пользователя.

Возможные значения - имя поля.

Значение по умолчанию - username.

passwordField

Поле, содержащее пароль пользователя.

Возможные значения - имя поля.

Значение по умолчанию - password.

rememberField

Поле для запоминания пользователя. Если значение поля приводится к true, то при успешной авторизации будет установлена кука с параметрами автологина. Имя куки и ее время жизни задаются параметрами cookieName и cookieLifetime.

Можно также задать поле rememberme в параметре defaults, чтобы запоминание происходило без участия пользователя:

&defaults=`{"rememberme":1}`

Возможные значения - имя поля.

Значение по умолчанию - rememberme.

checkActivation

Включает проверку активации учетной записи пользователя (см. "Активация учетных записей").

Возможные значения - 0 или 1.

Значение по умолчанию - 1.

context

Контекст авторизации.

Возможные значения - mgr или web.

Значение по умолчанию - web.

cookieName

Имя куки для хранения параметров автологина.

Значение по умолчанию - WebLoginPE.

cookieLifetime

Время жизни вышеуказанной куки.

Возможные значения - число секунд с момента последнего логина.

Значение по умолчанию - 157680000 (5 лет).

redirectTo

Перенаправляет пользователя на страницу c указанным id после авторизации.

Возможные значения - id целевой страницы или массив.

Значение по умолчанию - пусто.

exitTo

Перенаправляет уже авторизованного пользователя на указанную страницу.

Возможные значения - id целевой страницы или массив.

Значение по умолчанию - пусто.

successTpl

Шаблон сообщения об успешной авторизации. В шаблоне можно использовать данные пользователя.

Возможные значения - имя шаблона, указанное по правилам задания шаблонов в DocLister.

Значение по умолчанию - запись из лексикона Login с ключом [+login.default_successTpl+]

skipTpl

Шаблон сообщения о том, что пользователь уже авторизован.

Возможные значения - имя шаблона, указанное по правилам задания шаблонов в DocLister.

Значение по умолчанию - запись из лексикона Login с ключом [+login.default_skipTpl+]

Параметры плагина userHelper

logoutKey

Имя GET-параметра для запуска выхода из учетной записи. Если в ссылке на страницу сайта указан параметр с соответствующим именем (например, http://sitename.ru/page.html?logout), будет произведен выход из учетной записи.

Значение по умолчанию - logout.

cookieName

Имя куки для хранения параметров автологина.

Значение по умолчанию - WebLoginPE.

cookieLifetime

Время жизни вышеуказанной куки.

Возможные значения - число секунд с момента последнего логина.

Значение по умолчанию - 157680000 (5 лет).

Mem: 3.75 mb, MySQL: 0.0024 s, 2 req., PHP: 0.0319 s, all: 0.0343 s, cache.