Файл шаблона "admin.rightsbyitem.tpl" отвечает за отображение и управление правами доступа для различных элементов системы в панели администратора движка Cotonti CMF. Основная цель этого шаблона — предоставить интерфейс для администраторов, чтобы они могли настраивать и обновлять права для групп пользователей на уровне отдельных объектов системы (например, страницы, модули, и другие элементы). Он содержит форму с таблицей, где отображаются права пользователей на доступ, чтение, запись и другие действия для каждого элемента, а также кнопки для редактирования и применения этих прав.
Основное назначение файла и его место в системе Cotonti:
- Управление правами пользователей: Шаблон предоставляет удобный интерфейс для управления правами, с возможностью видеть, редактировать и сохранять настройки доступа для различных групп пользователей.
- Интеграция с системой прав Cotonti: Этот файл тесно связан с системой ролей и прав доступа движка Cotonti, что позволяет настроить granular control (детализированные настройки доступа) на уровне каждой страницы или элемента.
- Раздел администрирования: Как часть панели администратора, файл "admin.rightsbyitem.tpl" помогает администраторам и модераторам легко управлять правами доступа в интерфейсе администрирования, поддерживая эффективное управление пользователями и их ролями.
Возможности admin.tpl:
- Отображение прав доступа: В таблице отображаются права для каждой группы пользователей, с возможностью их редактирования.
- Использование различных иконок для прав: Для каждого права используется своя иконка, что помогает визуально различать права (например, на чтение, запись, и так далее).
- Условное отображение элементов: Используются конструкции IF для отображения дополнительных колонок прав, в зависимости от настроек, таких как
PHP.advanced или PHP.ic.
- Обновление данных: Форма поддерживает возможность отправки и обновления прав, причем это делается через AJAX (асинхронно), что улучшает пользовательский опыт.
Суть содержания кода:
Код в шаблоне служит для отображения таблицы с правами доступа для каждого элемента, где:
- Для каждой строки отображается группа пользователей и доступные права (чтение, запись и другие, в зависимости от конфигурации).
- В таблице есть различные иконки для каждого права, с учетом того, активировано ли оно или заблокировано.
- Используется динамическое заполнение данных с помощью переменных и условных конструкций (например,
{ADMIN_RIGHTSBYITEM_FORM_ITEMS}, {ADMIN_RIGHTSBYITEM_ROW_TITLE}).
- Возможность включать или отключать права с помощью чекбоксов и скрытых полей.
- На основании состояния прав, в шаблоне отображаются различные иконки (например, иконки заблокированных прав или активных прав).
- Также есть дополнительные кнопки для открытия более детальной информации или выполнения действий (например, "More" или "Update").
Разбор конструкций внутри <!-- ... -->:
<!-- BEGIN: MAIN --> и <!-- END: MAIN -->: Это обозначение начала и конца основного контента страницы. Все, что внутри этих тегов, будет обработано движком и отобразится в интерфейсе.<!-- IF {PHP.advanced} OR {PHP.ic} == 'page' --> и <!-- ENDIF -->: Условные блоки, которые отображают дополнительные права, если переменные PHP.advanced или PHP.ic соответствуют определенным значениям.<!-- IF {PHP.advanced} --> и <!-- ENDIF -->: Показывает дополнительные колонки прав, если активирована настройка PHP.advanced.<!-- BEGIN: ROW_ITEMS --> и <!-- END: ROW_ITEMS -->: Этот блок используется для обработки элементов прав для каждой группы пользователей в таблице. Здесь проверяется, заблокированы ли права для пользователя или нет.<!-- BEGIN: RIGHTSBYITEM_ROW --> и <!-- END: RIGHTSBYITEM_ROW -->: Каждый ряд в таблице, представляющий права для конкретной группы или элемента.<!-- BEGIN: RIGHTSBYITEM_HELP --> и <!-- END: RIGHTSBYITEM_HELP -->: Этот блок используется для отображения справочной информации о значении иконок прав (например, что означает иконка для прав на чтение или запись).
Характеристика HTML/CSS/JS:
-
HTML:
- Структурированность: Используется стандартная структура HTML с таблицами для отображения данных.
- Элементы формы: Используются формы с методами POST и AJAX для отправки данных без перезагрузки страницы. В таблице используются элементы
<input> для чекбоксов и скрытых полей.
- Теги
<a>: Для навигации по ссылкам и действиям (например, для перехода к подробной информации о правах или сохранения изменений).
-
CSS:
- Классы: Используются CSS-классы, такие как
.centerall, .action, .textcenter и другие, для стилизации элементов и выравнивания.
- Модульность: Применяются классы, которые, вероятно, определены в других частях стилей сайта, что позволяет легко настраивать внешний вид элементов, таких как кнопки или иконки.
-
JavaScript:
- AJAX: В форме используется класс
ajax, что предполагает использование JavaScript для асинхронной отправки данных.
- Динамичность: JS используется для изменения состояния элементов формы (например, активировать/деактивировать чекбоксы в зависимости от условий).
В общем, файл "admin.rightsbyitem.tpl" демонстрирует хороший баланс между функциональностью и удобством интерфейса для администрирования прав пользователей. Он гибкий и легко настраиваемый в зависимости от конфигурации системы, что позволяет администраторам эффективно управлять доступами и правами на уровне элементов.
находится по адресу: /system/admin/tpl/admin.rightsbyitem.tpl движка php-фреймворка Cotonti
<!-- BEGIN: MAIN -->
{FILE "{PHP.cfg.system_dir}/admin/tpl/warnings.tpl"} <!-- Вставка файла шаблона для предупреждений -->
<div class="block">
<h2>{ADMIN_RIGHTSBYITEM_TITLE}</h2> <!-- Заголовок для прав по элементам, значение из переменной ADMIN_RIGHTSBYITEM_TITLE -->
<div class="wrapper">
<form name="saverightsbyitem" id="saverightsbyitem" action="{ADMIN_RIGHTSBYITEM_FORM_URL}" method="post" class="ajax"> <!-- Форма для сохранения прав по элементам, ссылка на обработчик формы в ADMIN_RIGHTSBYITEM_FORM_URL -->
{ADMIN_RIGHTSBYITEM_FORM_ITEMS} <!-- Вставка дополнительных элементов формы -->
<table class="cells">
<thead>
<tr>
<th class="" rowspan="2"></th>
<th class="" rowspan="2">{PHP.L.Groups}</th> <!-- Группа, значение из PHP.L.Groups -->
<th class="" colspan="{ADMIN_RIGHTSBYITEM_ADV_COLUMNS}">{PHP.L.Rights}</th> <!-- Права, количество колонок в ADMIN_RIGHTSBYITEM_ADV_COLUMNS -->
<th class="" rowspan="2">{PHP.L.Open}</th> <!-- Открыть, значение из PHP.L.Open -->
<th class="" rowspan="2">{PHP.L.adm_setby}</th> <!-- Установлено, значение из PHP.L.adm_setby -->
</tr>
<tr>
<th class="">{PHP.R.admin_icon_auth_r}</th> <!-- Иконка прав на чтение -->
<th class="">{PHP.R.admin_icon_auth_w}</th> <!-- Иконка прав на запись -->
<!-- IF {PHP.advanced} OR {PHP.ic} == 'page' -->
<th class="">{PHP.R.admin_icon_auth_1}</th> <!-- Дополнительная иконка прав в зависимости от переменных PHP.advanced и PHP.ic -->
<!-- ENDIF -->
<!-- IF {PHP.advanced} -->
<th class="">{PHP.R.admin_icon_auth_2}</th> <!-- Иконка дополнительного права -->
<th class="">{PHP.R.admin_icon_auth_3}</th> <!-- Иконка дополнительного права -->
<th class="">{PHP.R.admin_icon_auth_4}</th> <!-- Иконка дополнительного права -->
<th class="">{PHP.R.admin_icon_auth_5}</th> <!-- Иконка дополнительного права -->
<!-- ENDIF -->
<th class="coltop">{PHP.R.admin_icon_auth_a}</th> <!-- Иконка прав на администрирование -->
</tr>
</thead>
<!-- BEGIN: RIGHTSBYITEM_ROW -->
<tr>
<td class="centerall">
<img src="{PHP.cfg.icons_dir}/default/modules/users.png"/> <!-- Иконка пользователя -->
</td>
<td>
<a href="{ADMIN_RIGHTSBYITEM_ROW_LINK}">{ADMIN_RIGHTSBYITEM_ROW_TITLE}</a> <!-- Ссылка на строку с правами, значение из ADMIN_RIGHTSBYITEM_ROW_TITLE -->
</td>
<!-- BEGIN: ROW_ITEMS -->
<td class="centerall">
<!-- IF {ADMIN_RIGHTSBYITEM_ROW_ITEMS_LOCKED} AND {ADMIN_RIGHTSBYITEM_ROW_ITEMS_STATE} -->
<input type="hidden" name="{ADMIN_RIGHTSBYITEM_ROW_ITEMS_NAME}" value="1" /> <!-- Скрытое поле для заблокированных прав -->
{PHP.R.admin_icon_discheck1} <!-- Иконка для заблокированных прав -->
<!-- ENDIF -->
<!-- IF {ADMIN_RIGHTSBYITEM_ROW_ITEMS_LOCKED} AND !{ADMIN_RIGHTSBYITEM_ROW_ITEMS_STATE} -->
{PHP.R.admin_icon_discheck0} <!-- Иконка для разблокированных прав -->
<!-- ENDIF -->
<!-- IF !{ADMIN_RIGHTSBYITEM_ROW_ITEMS_LOCKED} -->
<input type="checkbox" class="checkbox" name="{ADMIN_RIGHTSBYITEM_ROW_ITEMS_NAME}"{ADMIN_RIGHTSBYITEM_ROW_ITEMS_CHECKED}{ADMIN_RIGHTSBYITEM_ROW_ITEMS_DISABLED} /> <!-- Чекбокс для выбора прав, с возможностью включить/выключить -->
<!-- ENDIF -->
</td>
<!-- END: ROW_ITEMS -->
<td class="action">
<a title="{PHP.L.Open}" href="{ADMIN_RIGHTSBYITEM_ROW_JUMPTO}" class="button special">{PHP.L.Open}</a> <!-- Кнопка для открытия элементов -->
<a title="{PHP.L.Open}" href="{ADMIN_RIGHTSBYITEM_ROW_LINK}" class="button">{PHP.L.Rights}</a> <!-- Кнопка для редактирования прав -->
</td>
<td class="textcenter">
{ADMIN_RIGHTSBYITEM_ROW_USER}{ADMIN_RIGHTSBYITEM_ROW_PRESERVE} <!-- Пользователь, информация о сохранении прав -->
</td>
</tr>
<!-- END: RIGHTSBYITEM_ROW -->
<tr>
<td class="action" colspan="{ADMIN_RIGHTSBYITEM_4ADV_COLUMNS}">
<a href="{ADMIN_RIGHTSBYITEM_ADVANCED_URL}" class="button">{PHP.L.More}</a> <!-- Кнопка для более детальных настроек -->
<input type="submit" class="submit" value="{PHP.L.Update}" /> <!-- Кнопка для обновления прав -->
</td>
</tr>
</table>
</form>
</div>
</div>
<!-- END: MAIN -->
<!-- BEGIN: RIGHTSBYITEM_HELP -->
<p>{PHP.R.admin_icon_auth_r} {PHP.L.Read}</p> <!-- Иконка и описание права на чтение -->
<p>{PHP.R.admin_icon_auth_w} {PHP.L.Write}</p> <!-- Иконка и описание права на запись -->
<!-- IF {PHP.advanced} OR {PHP.ic} == 'page' -->
<p>{PHP.R.admin_icon_auth_1} {PHP.l_custom1}</p> <!-- Дополнительная иконка и описание прав -->
<!-- ENDIF -->
<!-- IF {PHP.advanced} -->
<p>{PHP.R.admin_icon_auth_2} {PHP.L.Custom} #2</p> <!-- Дополнительные кастомные права -->
<p>{PHP.R.admin_icon_auth_3} {PHP.L.Custom} #3</p>
<p>{PHP.R.admin_icon_auth_4} {PHP.L.Custom} #4</p>
<p>{PHP.R.admin_icon_auth_5} {PHP.L.Custom} #5</p>
<!-- ENDIF -->
<p>{PHP.R.admin_icon_auth_a} {PHP.L.Administration}</p> <!-- Иконка для прав администрирования -->
<!-- END: RIGHTSBYITEM_HELP -->
6 minutes read Sodium Carbonate
