HTML-шаблон admin.rightsbyitem.tpl в Cotonti

Файл шаблона "admin.rightsbyitem.tpl" отвечает за отображение и управление правами доступа для различных элементов системы в панели администратора движка Cotonti CMF. Основная цель этого шаблона — предоставить интерфейс для администраторов, чтобы они могли настраивать и обновлять права для групп пользователей на уровне отдельных объектов системы (например, страницы, модули, и другие элементы). Он содержит форму с таблицей, где отображаются права пользователей на доступ, чтение, запись и другие действия для каждого элемента, а также кнопки для редактирования и применения этих прав.

Основное назначение файла и его место в системе Cotonti:

1. Управление правами пользователей: Шаблон предоставляет удобный интерфейс для управления правами, с возможностью видеть, редактировать и сохранять настройки доступа для различных групп пользователей.
2. Интеграция с системой прав Cotonti: Этот файл тесно связан с системой ролей и прав доступа движка Cotonti, что позволяет настроить granular control (детализированные настройки доступа) на уровне каждой страницы или элемента.
3. Раздел администрирования: Как часть панели администратора, файл "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:

1. HTML:

   • Структурированность: Используется стандартная структура HTML с таблицами для отображения данных.
   • Элементы формы: Используются формы с методами POST и AJAX для отправки данных без перезагрузки страницы. В таблице используются элементы <input> для чекбоксов и скрытых полей.
   • Теги <a>: Для навигации по ссылкам и действиям (например, для перехода к подробной информации о правах или сохранения изменений).

2. CSS:

   • Классы: Используются CSS-классы, такие как .centerall, .action, .textcenter и другие, для стилизации элементов и выравнивания.
   • Модульность: Применяются классы, которые, вероятно, определены в других частях стилей сайта, что позволяет легко настраивать внешний вид элементов, таких как кнопки или иконки.

3. 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}&nbsp; {PHP.L.Read}</p> <!-- Иконка и описание права на чтение -->
<p>{PHP.R.admin_icon_auth_w}&nbsp; {PHP.L.Write}</p> <!-- Иконка и описание права на запись -->
<!-- IF {PHP.advanced} OR {PHP.ic} == 'page' -->
<p>{PHP.R.admin_icon_auth_1}&nbsp; {PHP.l_custom1}</p> <!-- Дополнительная иконка и описание прав -->
<!-- ENDIF -->
<!-- IF {PHP.advanced} -->
<p>{PHP.R.admin_icon_auth_2}&nbsp; {PHP.L.Custom} #2</p> <!-- Дополнительные кастомные права -->
<p>{PHP.R.admin_icon_auth_3}&nbsp; {PHP.L.Custom} #3</p>
<p>{PHP.R.admin_icon_auth_4}&nbsp; {PHP.L.Custom} #4</p>
<p>{PHP.R.admin_icon_auth_5}&nbsp; {PHP.L.Custom} #5</p>
<!-- ENDIF -->
<p>{PHP.R.admin_icon_auth_a}&nbsp; {PHP.L.Administration}</p> <!-- Иконка для прав администрирования -->
<!-- END: RIGHTSBYITEM_HELP -->