HybridAuth

Скачать HybridAuth в магазине дополнений →
02 июля 2016, 11:54

Компонент для авторизации через социальные и другие сервисы.

Основное преимущество - работа с сервисами без посредников и возможность привязки нескольких сервисов к одной учетной записи MODX.

Сниппет выводит форму для авторизации на сайте.

Параметры

Название По умолчанию Описание
&activeProviderTpl tpl.HybridAuth.provider.active Чанк для вывода иконки привязанного сервиса.
&addContexts Дополнительные контексты, через запятую. Например, &addContexts=`web,ru,en`
&groups Список групп для регистрации пользователя, через запятую. Можно указывать роль юзера в группе через двоеточие. Например, &groups=`Users:1` добавит юзера в группу "Users" с ролью "member".
&loginContext current context Основной контекст для авторизации. По умолчанию - текущий.
&loginResourceId 0 Идентификатор ресурса, на который отправлять юзера после авторизации. По умолчанию, это 0 - обновляет текущую страницу.
&loginTpl tpl.HybridAuth.login Этот чанк будет показан анонимному пользователю, то есть любому гостю.
&logoutResourceId 0 Идентификатор ресурса, на который отправлять юзера после завершения сессии. По умолчанию, это 0 - обновляет текущую страницу.
&logoutTpl tpl.HybridAuth.logout Этот чанк будет показан авторизованному пользователю.
&providerTpl tpl.HybridAuth.provider Чанк для вывода ссылки на авторизацию или привязку сервиса к учетной записи.
&providers all available Список провайдеров авторизации, через запятую. Все доступные провайдеры находятся тут {core_path}components/hybridauth/model/hybridauth/lib/Providers/. Например, &providers=`Google,Twitter,Facebook`.
&rememberme 1 Запоминает пользователя на долгое время. По умолчанию - включено.

Примеры

Сниппет нужно вызывать некэшированным, так как в зависимости от авторизации пользователя он выводит разные чанки.

При обычном вызове сниппет выведет всех провайдеров, зарегистрированных в системе

[[!HybridAuth]]

Их можно ограничить, указав списком, через запятую:

[[!HybridAuth?
    &providers=`Yandex,Google,Twitter,Facebook,Vkontakte`
]]

Авторизация в 2 контекста сразу:

[[!HybridAuth?
    &providers=`Yandex,Google`
    &loginContext=`web`
    &addContexts=`en`
]]

Настройки провайдеров

Для каждого провайдера авторизации указывается отдельная системная настройка с префиксом ha.keys.:

Значение настройки - JSON массив, содержимое которого зависит от самого провайдера.

Например, для Google нужно указать id и secret, а для Twitter - key и secret. Так что, смотрите внимательно, какие настройки вам выдаят сервис при регистрации.

Ссылки на регистрацию у провайдеров

Для работы компонента нужно получить ключи от провайдера. Поэтому, вот несколько основных ссылок:

Контексты

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

Для этого нужно указывать ключи непосредственно в настройках контекста, а не в общих системных.

Для правильной работы сниппета желательно включить дружественные url.