Разрешает доступ к блоку информации на странице для активных зарегистрированных пользователей указанных групп.
| source |
HTML строка, которая будет показана вместо макроподстановки в случае, если авторизованный активный пользователь принадлежит хотя бы к одной из указанных групп. Обязательный параметр. |
| userset |
Таблицы, содержащие учетные записи пользователей (группы). Допустимо перечисление нескольких групп через запятую. Обязательный ключ. По умолчанию используется значение registers. |
| loginform |
Шаблон (имя файла с html кодом) формы, который будет показан неавторизованному (или не входящему в указанные группы) пользователю. Как правило, выводят форму авторизации со ссылками на форум регистрации пользователей, ссылкой на сервис напоминания пароля и т.п.
Шаблон формы должен располагаться в папке Templates. Для форм в html файлах расширение файла можно не указывать. |
| condition |
Составное условие выполнения макроса. |
| redirect_after |
Псевдоним страницы, переход на который будет осуществлён после успешного входа. Если ключ пустой или не использован - пользователь после успешного входа останется на этой же странице. |
| designfile |
Файл с дизайном для макроса, должен находиться в Templates. Если ключ не задан, используется auth_design.xml. Если расширение не указано, будет автоматически добавлено ".xml". |
Страница (обычно в шаблоне) разбивается на разные "зоны", которые можно закрыть для общего доступа. Если пользователь зарегистрирован (имеет учетную запись), активен (признак state не пустой) и авторизован (ввел логин и пароль) и принадлежит к одной из указанных в ключе userset групп, то он увидит блок текста, определенный в ключе source. В противном случае, на месте "зоны" будет отображена форма авторизации с приглашением ввести логин и пароль, ссылкой на регистрацию для новых пользователей и т.п. Сама форма авторизации может быть произвольного вида, главное, чтобы action в форме был пустой, а поля ввода логина и пароля назывались login и password.
Данный макрос обычно используется в составе набора макроподстановок, которые образуют систему разграничения доступа для посетителей. Для того, чтобы не собирать данную систему вручную из отдельных макроподстановок, мы предлагаем разработчикам скачать архив с готовым их набором. Разработчик может самостоятельно поменять внешний вид и состав форм и в определенных пределах изменить логику работы системы.