"Уже сегодня делай то, о чем другие будут думать завтра!"

Login

Сайдбар

Что такое Login?

Login – это дополнение, реализующее функции безопасности для MODx Revolution, оно позволяет обеспечить вход пользователю в персональный раздел из клиентской области, производить обновления персонального раздела, непосредственно регистрацию, восстановление забытого пароля.

История создания

Login написано Шоном МакКорником в качестве дополнения, реализующего функции входа в систему и обеспечение безопасности процессов, требующих авторизации. Впервые опубликовано 25 июня 2009.

Загрузка

Дополнение может быть загружено с помощью менеджера MODx Revolution, используя Package Management, или из хранилища дополнений MODx.

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

Дополнение Login включает в себя 10 сниппетов:

  • Login – Используется при авторизации.
  • UpdateProfile – Обеспечивает редактирование персонального раздела из клиентской области.
  • Profile – Формирует поля персонального раздела в виде плейсхолдеров, что позволяет вывести на экран персональный раздел пользователя.
  • ForgotPassword – Обеспечивает восстановление утерянного пароля.
  • ResetPassword – Сниппет, обеспечивающий подтверждение сброса пользовательского пароля.
  • Register – Обеспечивает работу формы регистрации.
  • ConfirmRegister – страница подтверждения, используемая для работы Формы регистрации и активации.
  • ChangePassword – Используется для изменение пароля пользователя из клиентской области.
  • ActiveUsers – Выводит список активных, вошедших с паролем пользователей.
  • isLoggedIn – Проверяет, имеет ли вошедший пользователь право доступа к текущему контенту или разделу. Если нет, то пользователь перенаправляется на страницу, сообщающую, что у него нет доступа.

Что такое Login?

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

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

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



Можно задать определенный / специфический шаблон, но при этом нужно убедиться, что вызываются также и параметры &tpl типа:



Для использования дополнительных возможностей ознакомьтесь со свойствами сниппета.

Свойства

Login обладает несколькими свойствами, позволяющими настраивать его работу.


Имя

Описание

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

1

actionKey

Переменная Запрос (REQUEST), отображающая, какое действие запрашивается. По умолчанию 'service'. Удобно использовать, если на сайте уже используется переменная REQUEST со значением 'service' и ее нужно изменить.

service

2

loginKey

Параметр для обеспечения входа / логина на сайт. По умолчанию 'login'. Данный параметр сообщает Login начать работу, только если значением actionKeyявляется 'login'. Например, если значение actionKey 'service' , а loginKey задан как 'login', то процесс входа начнется при обнаружении условия '&service=login'

login

3

logoutKey

Параметр для обеспечения выхода с сайта. По умолчанию 'logout'. Данный параметр сообщает Login начать работу, только если значением actionKeyявляется 'logout'. Например, если значение actionKey 'service' , а loginKey задан как 'logout', то процесс выхода начнется при обнаружении условия '&service=logout'

logout

4

rememberMeKey

Опционально. Имя поля переключателя Напомнить (Remember Me) для обеспечения возможности входа на сайт. По умолчанию "rememberme".

rememberme

5

tplType

Тип шаблона, обеспечивающий работу loginTpl or logoutTpl. Возможные значения описаны в разделах ниже.

inline

6

loginTpl

Шаблон формы входа. Тип определяется значением, заданным в свойствах tplType.

lgnLoginTpl

7

logoutTpl

Шаблон формы выхода. Тип определяется значением, заданным в свойствах. tplType

lgnLogoutTpl

8

errTpl

Шаблон сообщения об ошибке. Тип определяется значением, заданным в свойствах errTplType .

lgnErrTpl

9

errTplType

Тип шаблона, обеспечивающий работу errTpl.

modChunk

10

loginResourceId

Ресурс, перенаправляющий пользователей при успешном входе. 0 перенаправляет в персональный раздел. will redirect to self. Не заполняйте при использовании страницы без авторизации по умолчанию.

0

11

loginResourceParams

Параметры объекта JSON , присоединяемые к ссылке-редиректу при входе в аккаунт. Пример: {"test":123} преобразуется в url.html?test=123


12

logoutResourceId

ID ресурса, на который перенаправляется пользователь после успешного выхода из аккаунта. 0 перенаправляет на себя.

0

13

logoutResourceParams

Параметры объекта JSON , присоединяемые к ссылке-редиректу при выходе из аккаунта. Пример: {"test":123} преобразуется в url.html?test=123


14

loginMsg

Необязательное сообщение-ярлык при акте входа. Если не заполнена, будет использоваться назначенная по умолчанию строчка из словаря Login.


15

logoutMsg

Необязательное сообщение-ярлык при акте выхода. Если не заполнена, будет использоваться назначенная по умолчанию строчка из словаря Logout.


16

redirectToPrior

После успешного входа пользователь перенаправится на реферральную страницу (HTTP_REFERER), если значение устнаовлено как true / истина.

0

17

contexts

(Экспериментальный параметр) Контекстный список (разделитель - запятая) для входа. По умолчанию для использования текущего контекста не требуется задавать какие-либо параметры.


18

preHooks

Список 'hooks' (или сниппетов), исполняемых перед тем, как пользователь зарегистрируется, но после валидации. В качестве 'hook' можно задать 'recaptcha'


19

postHooks

Список 'hooks' (или сниппетов), исполняемых после того, как пользователь зарегистрируется.


20

toPlaceholder

Если задан, будет направлять выходные данные сниппета-логина в плейсхолдер с данным именем вместо непосредственного вывода возвращаемого контента.


21

redirectToOnFailedAuth

(Для версии 1.6.4-pl & +) Перенаправляет на отдельную страницу при неверном входе.


Опции tplType

tplType и errTplType свойства обладают списком различных опций и позволяют их выбрать. Такими опциями могут быть:

  • modChunk - Обеспечиваемый шаблон должен быть назван именем чанка.
  • file – Должен быть абсолютный путь к файлу шаблона.
  • inline – Контент шаблона будет непосредственно в его свойствах.
  • embedded – Шаблон уже встроен в страницу, просто задайте свойства ошибки как плейсхолдер.

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

Сначала убедитесь, что Системные установки `recaptcha.public_key` и `recaptcha.private_key` установлены в соответствии с вашими reCaptcha API ключами. Затем все, что нужно сделать для их добавления- это добавить "recaptcha" preHook в ваш вызов сниппета.:



Убедитесь, что плейсхолдер является вашим loginTpl чанком. Это сделает reCaptcha необходимым при входе пользователя с паролем.

Logout

Как выполняется выход пользователя (log out)? Просто вызываете страницу, содержащую ваш сниппет Login и передаете определенный 'logout' как сервис / service через URL. В нижеприведенном примере сниппет Login snippet находится на странице 21:

 <a href="
" title="Logout">Logout</a>
(which automatically appends '&service=logout' to your URL)

ChangePassword?

Сниппет ChangePassword

ChangePassword простой сниппет, который используется в сочетании с Login, что позволяет пользователям менять свой пароль на сайте MODX Revolution. Вы можете разместить его в любом месте, и он будет обрабатывать форму для изменения пароля пользователем.

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

Просто создайте форму для восстановления пароля, а также в нужном месте страницы, поставить вызов сниппета. Например:

<h2>Восстановление пароля</h2>

<div class="updprof-error"></div>
<form class="form" action="documentation/login/" method="post">
    <input type="hidden" name="nospam" value="" />
    <div class="ff">
        <label for="password_old">Old Password
            <span class="error"></span>
        </label>
        <input type="password" name="password_old" id="password_old" value="" />
    </div>
    <div class="ff">
        <label for="password_new">New Password
            <span class="error"></span>
        </label>
        <input type="password" name="password_new" id="password_new" value="" />
    </div>
    <div class="ff">
        <label for="password_new_confirm">Confirm New Password
            <span class="error"></span>
        </label>
        <input type="password" name="password_new_confirm" id="password_new_confirm" value="" />
    </div>
    <div class="ff">
        <input type="submit" name="change-password" value="Change Password" />
    </div>
</form>

Свойства ChangePassword

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

Имя Описание По умолчанию
submitVar Если пусто, либо установлено значение false, ChangePassword будет обрабатывать все запросы POST в форме. logcp-submit
fieldOldPassword Имя поля для ввода старого пароля. password_old
fieldNewPassword Название поля для ввода нового пароля. password_new
fieldConfirmNewPassword Необязательно. Если установлено,то новый пароль надо будет подтвердить, повторно ввести. password_new_confirm
validateOldPassword Значение 1 или 0. Определите, требуется ли пользователю ввести текущий пароль, чтобы успешно сбросить пароль. 1
preHooks Список хуков введенных через запятую для проверки формы.
postHooks What scripts to fire, if any, after the user has been registered. This can be a comma-separated list of hooks, and if the first fails, the proceeding ones will not fire. A hook can also be a Snippet name that will execute that Snippet.
redirectToLogin Редирект для пользователей не авторизованных на сайте. Перенаправляет на указанную страницу. 1
reloadOnSuccess Если 1, то страница будет перенаправить к себе с параметром GET для предотвращения двойных обратных передач. 1
successMessage Если reloadOnSuccess установлен на 0, выход это сообщение в [префикса].SuccessMessage заполнителя.
placeholderPrefix Префикс для использования для всех заполнителей, установленных этом фрагменте. logcp.

Сниппет ConfirmRegister?

ConfirmRegister простой фрагмент, С помощью которого пользователь должен подтвердить регистрацию на сайте, когда "активации" в сниппете Register устанавливается в 1 (по умолчанию). вызывать сниппет необходимо на отдельной странице.

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

Сниппет Register по умолчанию требует от пользователя активировать свою учетную запись. Затем пользователь получает электронное письмо с URL, чтобы активировать свою учетную запись. Как только пользователь переходит на страницу активации, он может авторизоваться на сайте.

Вам необходимо создать страницу Активация пользователя с вызовом сниппета:

[[! ConfirmRegister]]

К примеру страница регистрации будет выглядеть так:

таким образом пользователю будет отправлено письмо с содержимым указанным в чанке "myActivationEmailTpl", с указанным адресом(26) страницы для перехода что бы активировать учетную запись - на которой вы поместили вызов сниппета ConfirmRegister.

Свойства по умолчанию

ConfirmRegister имеет некоторые свойства установленные по умолчанию. К ним относятся:

Имя Описание Значение
redirectTo Необязательно. После успешного подтверждения, перенаправит на этот ресурс.
redirectParams Необязательно. Объект JSON параметров для передачи при перенаправлении с использованием redirectTo.
authenticate Аутентификация и авторизация пользователя в текущем контексте после подтверждения регистрации. 1
authenticateContexts Необязательно. Контексты через запятую для проверки подлинности. По умолчанию в текущем контексте.
errorPage Необязательно. Если установлено, будет перенаправлять пользователя на страницу ошибки, если они попытаются открыть страницу после активации своей учетной записи.

Сниппет ForgotPassword?

ForgotPassword простой фрагмента, которая обрабатывает форму, когда пользователь забыл свой пароль и нуждается в его восстановлении.

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

Чтобы воспользоваться функцией восстановления пароля, сначала создайте ресурс для авторизации пользователя, на котором будет ссылка для восстановления пароля, перейдя на которую пользователь сможет ввести свой электронный адрес или логин для восстановления пароля, после чего он будет перенаправлен на страницу с вызовом:

[[ResetPassword!? &LoginResourceId=`72`]]

Затем создайте еще одну страницу с вызовом сниппета ForgotPassword и назначить страницу на которой вызван сброс пароля:

[[!ForgotPassword? &ResetResourceId=`123`]]

ForgotPassword Свойства

ForgotPassword поставляется с некоторыми свойствами по умолчанию их можно переопределить. К ним относятся:

Имя Описание Значения
tpl Чанк сообщения о сбросе пароля lgnForgotPassTpl
tplType Тип чанка tpl modChunk
emailTpl Чанк сообщения по электронной почте. lgnForgotPassEmail
emailSubject Тема почтового уведомления Password Retrieval Email
emailTplType Тип TPL, предоставляемой emailTpl modChunk
sentTpl Чанк сообщающий об успешной отправке lgnForgotPassSentTpl
sentTplType Тип TPL, предоставляемой sentTpl modChunk
loginResourceId Ресурс куда будет перенаправлен пользователь для авторизации. 1
resetResourceId Ресурс, который содержит Login.ResetPassword фрагмент. 1

tplType Опции

Имущество tplType занимает различные варианты. Они могут быть:

  • modChunk - TPL условии должно быть название кусок.
  • file - Должен быть абсолютный путь к TPL файла.
  • inline - Содержание TPL будет непосредственно в самой TPL собственности.
  • embedded - TPL уже на странице, просто убедитесь, свойства ошибках быть заполнители.
  • Сниппет Profile?

    Profile устанавливает все текущие поля пользователя (или заданного пользователя) , что позволяет отображать информацию о пользователе на странице.

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

    Просто добавьте вызов сниппета на странице, на которой вы хотите отображать профиль пользователя MODX Revolution:

    </code><p></p>
    И плейсхолдеры<p></p>
    <code><p>Username: </p>
    <p>Email: </p>
    <p>State: </p>

    <u><strong>Поля пароль никогда не установдивайте в качестве заполнителей, по соображениям безопасности.</strong></u>

    Свойства Profile:

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

    Имя Описание Значения
    prefix Строка в качестве префикса все заполнители для полей, которые будут установлены в сниппете.
    user Необязательно. Либо ID пользователя или имя пользователя. Если установлено, будет показан профиль этого пользователя.
    useExtended Если это включено, будет установлено в качестве заполнителей все расширенные поля, а также. 1

    Пример

    Вывод информации вошедшего пользователя

     
    <p>Username: </p>
    <p>Email: </p>

    Отображение вошедшего пользователя информации Любимы цвет с префиксом usr:

    [[!Profile? &prefix=`usr.`]]

    &lt;p>[[+usr.username]]'s favorite color is [[+usr.color]]&lt;/p>

    Сниппет ResetPassword?

    ResetPassword простой сниппет, который используется в сочетании с ForgotPassword, что позволяет пользователям восстанавливать забытый пароль. Этот сниппет размещается на странице, ссылку на которую пользователь получит по электронной почте, и перейдя по которой сбросит свой пароль.

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

    Создайте ресурс с вызовом сниппета:

    [[!ResetPassword? &LoginResourceId=`72`]]

    Затем создайте другой ресурс с вызовом сниппета ForgotPassword, и укажите id ресурса где находиться вызов сниппета ResetPassword:

    [[!ForgotPassword? &ResetResourceId=`123`]]

    Свойства ResetPassword

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

    Name Description Default
    tpl Чанк сброса пароля lgnResetPassTpl
    tplType Тип TPL, предоставляемой TPL modChunk
    loginResourceId Ресурс, куда будет направлен пользователь при успешном сбросе. 1

    tplType Опции

    Свойства tplType имеет различные варианты. Такие как:

    • modChunk - TPL условии для чанка.
    • file - Должен быть абсолютный путь к TPL файлу.
    • inline - Содержание TPL будет непосредственно в самой TPL собственности.
    • embedded - TPL уже на странице, просто убедитесь, свойства ошибках быть заполнители.

    Сниппет UpdateProfile?

    UpdateProfile простой фрагмент, который позволяет пользователям, которые авторизованы на сайте редактировать свой профиль.

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

    Для использования функции редактирования профиля, сначала создайте ресурса перейдя на который пользователь сможет отредактировать свой профиль. Затем добавьте этот вызов сниппета:

    [[!UpdateProfile? &validate=`fullname:required,email:required:email`]]

    Свойства UpdateProfile

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

    Имя Описание Значения
    submitVar The name of the form submit button that triggers the submission. login-updprof-btn
    validate Через запятую список полей для проверки, с каждым именем поля, как имя: валидатор (например: username:required,email:required). валидаторов также может быть прикован, как электронная почта: email:email:required. Это свойство может быть указан на нескольких строках.
    redirectToLogin Редирект на страницу авторизации для анонимных пользователей 1
    reloadOnSuccess Сообщение об успешной отправке 1
    emailField Имя поля email для формы email
    preHooks Через запятую список плейсхолдеров, или сниппеты, которые будут выполняться при обновлении профиля, но после проверки. Также можно указать "капчу", как плейсхолдер.
    postHooks Через запятую список плейсхолдеров, или сниппетов, которые будут обработаны после обновления профиля
    syncUsername Если установлен как имя столбца в профиль, UpdateProfile попытается синхронизировать имя пользователя в этой области после успешного сохранения.
    useExtended Whether or not to set any extra fields in the form to the Profiles extended field. This can be useful for storing extra user fields. 1
    excludeExtended Через запятую список полей для исключения.
    placeholderPrefix Префикс для использования для всех заполнителей, установленных в этом сниппете.

    Форма UpdateProfile

    Затем, ниже вызова сниппета разместите форму html (добавьте любые поля, которые нужны в форме). Эта форма находится в чанке lgnupdateprofile.chunk.tpl.

    <div class="update-profile">
        <div class="updprof-error"></div>
        
     
        <form class="form" action="documentation/login/" method="post">
            <input type="hidden" name="nospam" value="" />
     
            <label for="fullname">login.fullname
                <span class="error"></span>
            </label>
            <input type="text" name="fullname" id="fullname" value="" />
     
            <label for="email">login.email
                <span class="error"></span>
            </label>
            <input type="text" name="email" id="email" value="" />
     
            <label for="phone">login.phone
                <span class="error"></span>
            </label>
            <input type="text" name="phone" id="phone" value="" />
     
            <label for="mobilephone">login.mobilephone
                <span class="error"></span>
            </label>
            <input type="text" name="mobilephone" id="mobilephone" value="" />
     
            <label for="fax">login.fax
                <span class="error"></span>
            </label>
            <input type="text" name="fax" id="fax" value="" />
     
            <label for="address">login.address
                <span class="error"></span>
            </label>
            <input type="text" name="address" id="address" value="" />
     
            <label for="country">login.country
                <span class="error"></span>
            </label>
            <input type="text" name="country" id="country" value="" />
     
            <label for="city">login.city
                <span class="error"></span>
            </label>
            <input type="text" name="city" id="city" value="" />
     
            <label for="state">login.state
                <span class="error"></span>
            </label>
            <input type="text" name="state" id="state" value="" />
     
            <label for="zip">login.zip
                <span class="error"></span>
            </label>
            <input type="text" name="zip" id="zip" value="" />
     
            <label for="website">login.website
                <span class="error"></span>
            </label>
            <input type="text" name="website" id="website" value="" />
     
            <br class="clear" />
     
            <div class="form-buttons">
                <input type="submit" name="login-updprof-btn" value="login.update_profile" />
            </div>
        </form>
    </div>




    Контактная информация

    По всем интересующим вас вопросам связывайтесь при помощи контактной информации приведенной на этой странице!

    telegram: @Accusser
    skype: metsof
    email: accusser@gmail.com

    В социальных сетях...

    Форма обратной связи

    Sign In