Файл resources.rc.php в Cotonti

Файл resources.rc.php в системной папке Cotonti CMF выполняет роль ресурса для управления и хранения различных строк, используемых для вывода данных в интерфейсе системы. Этот файл содержит определения HTML-структур, текстовых меток, строк для обработки форм, пагинации, ошибок и сообщений, а также элементов, используемых в шапке, подвале и других частях сайта.

Основные его функции:

1. Генерация элементов формы: Определяются шаблоны для различных типов HTML-форм, таких как текстовые поля, флажки, радиокнопки, выпадающие списки, кнопки отправки и другие элементы формы.

2. Пагинация: Файл содержит строки для генерации пагинации, включая ссылки на предыдущие, следующие страницы и текущую страницу.

3. Сортировка: Шаблон для создания ссылок для сортировки элементов, включая стрелки вверх и вниз для сортировки по возрастанию и убыванию.

4. Метатеги и базовые ссылки: Включает метатеги для индексации страниц и базовые ссылки для правильного формирования URL на страницах.

5. Обработка сообщений и ошибок: Определяет HTML-шаблоны для вывода сообщений, таких как ошибки, уведомления, сообщения об успехе и другие. Это позволяет легко управлять выводом различных типов сообщений.

6. Шаблоны для графики и иконок: Включает строки для вставки изображений (например, флаги, иконки групп и другие изображения), а также для создания ссылок и вывода атрибутов изображений.

7. Часовые пояса: В более старых версиях PHP (до PHP 5.2) предоставлялась информация о часовых поясах, которые могли использоваться для настройки времени и дат.

Основная цель этого файла — централизовать все строки и HTML-шаблоны, которые используются для отображения контента на сайте, чтобы их можно было легко изменять или переопределять в зависимости от темы оформления или локализации.

/**
 * Статические и динамические строки ресурсов (например, HTML). Могут быть переопределены файлов темы и другим кодом.
 *
 * @package Cotonti
 * @copyright (c) Cotonti Team
 * @license https://github.com/Cotonti/Cotonti/blob/master/License.txt
 */

defined('COT_CODE') or die('Неверный URL'); // Проверка на корректность обращения к файлу, если код не был вызван через Cotonti, скрипт завершится

// Todo: возможно, стоит использовать Cot::$L, Cot::$cfg вместо этого?
global $L, $cfg; // Объявление глобальных переменных для доступа к языковым файлам и конфигурации

if (!isset($L['Delete']))  { // Проверка, не определена ли уже строка 'Delete' в массиве $L
    include cot_langfile('main', 'core'); // Подключение языкового файла для ядра, если строка 'Delete' еще не определена
}

/**
 * Генерация формы
 */
$R['code_option_empty'] = '---'; // Строка для пустого варианта в выпадающем списке
$R['code_time_separator'] = ':'; // Разделитель времени, используется в форматировании времени
$R['input_checkbox'] = '<input type="hidden" name="{$name}" value="{$value_off}" /><label><input type="checkbox" name="{$name}" value="{$value}"{$checked}{$attrs} /> {$title}</label>'; // Шаблон для чекбокса с значением по умолчанию
$R['input_check'] = '<label><input type="checkbox" name="{$name}" value="{$value}"{$checked}{$attrs} /> {$title}</label>'; // Шаблон для чекбокса без скрытого поля
$R['input_default'] = '<input type="{$type}" name="{$name}" value="{$value}"{$attrs} />'; // Шаблон для стандартного текстового поля
$R['input_option'] = '<option value="{$value}"{$selected}>{$title}</option>'; // Шаблон для опции в выпадающем списке
$R['input_radio'] = '<label class="radio-label"><input type="radio" name="{$name}" value="{$value}"{$checked}{$attrs} /> {$title}</label>'; // Шаблон для радиокнопки
$R['input_radio_separator'] = ' '; // Разделитель для радиокнопок
$R['input_select'] = '<select name="{$name}"{$attrs}>{$options}</select>'; // Шаблон для выпадающего списка
$R['input_submit'] = '<button type="submit" name="{$name}" {$attrs}>{$value}</button>'; // Шаблон для кнопки отправки
$R['input_text'] = '<input type="text" name="{$name}" value="{$value}" {$attrs} />'; // Шаблон для текстового поля
$R['input_textarea'] = '<textarea name="{$name}" rows="{$rows}" cols="{$cols}" {$attrs}>{$value}</textarea>'; // Шаблон для текстовой области
$R['input_textarea_editor'] =  '<textarea class="editor" name="{$name}" rows="{$rows}" cols="{$cols}"{$attrs}>{$value}</textarea>'; // Шаблон для текстовой области с редактором
$R['input_textarea_medieditor'] =  '<textarea class="medieditor" name="{$name}" rows="{$rows}" cols="{$cols}"{$attrs}>{$value}</textarea>'; // Шаблон для текстовой области с медиаредактором
$R['input_textarea_minieditor'] =  '<textarea class="minieditor" name="{$name}" rows="{$rows}" cols="{$cols}"{$attrs}>{$value}</textarea>'; // Шаблон для текстовой области с мини-редактором
$R['input_filebox'] = '<a href="{$filepath}">{$value}</a><br /><input type="file" name="{$name}" {$attrs} /><br /><label><input type="checkbox" name="{$delname}" value="1" /> '.$L['Delete'].'</label>'; // Шаблон для поля загрузки файла с возможностью удаления
$R['input_filebox_empty'] = '<input type="file" name="{$name}" {$attrs} />'; // Шаблон для пустого поля загрузки файла

$R['input_date'] =  '{$day} {$month} {$year} {$hour}: {$minute}'; // Шаблон для отображения даты и времени
$R['input_date_short'] =  '{$day} {$month} {$year}'; // Шаблон для отображения короткой даты

/**
 * Пагинация (Разбиение на страницы)
 */
$R['code_title_page_num'] = ' (' . $L['Page'] . ' {$num})'; // Шаблон для отображения номера страницы в заголовке
$R['link_pagenav_current'] = '<span class="pagenav pagenav_current"><a href="{$url}" class="{$class}" {$rel}>{$num}</a></span>'; // Шаблон для текущей страницы в пагинации
$R['link_pagenav_first'] = '<span class="pagenav pagenav_first"><a href="{$url}" class="{$class}" {$rel}>'.$L['pagenav_first'].'</a></span>'; // Шаблон для первой страницы в пагинации
$R['link_pagenav_gap'] = '<span class="pagenav pagenav_gap">...</span>'; // Шаблон для пропуска страниц (например, когда страницы не последовательные)
$R['link_pagenav_last'] = '<span class="pagenav pagenav pagenav_last"><a href="{$url}" class="{$class}" {$rel}>'.$L['pagenav_last'].'</a></span>'; // Шаблон для последней страницы в пагинации
$R['link_pagenav_main'] = '<span class="pagenav pagenav_pages"><a href="{$url}" class="{$class}" {$rel}>{$num}</a></span>'; // Шаблон для обычной страницы в пагинации
$R['link_pagenav_next'] = '<span class="pagenav pagenav_next"><a href="{$url}" class="{$class}" {$rel}>'.$L['pagenav_next'].'</a></span>'; // Шаблон для ссылки на следующую страницу
$R['link_pagenav_prev'] = '<span class="pagenav pagenav_prev"><a href="{$url}" class="{$class}" {$rel}>'.$L['pagenav_prev'].'</a></span>'; // Шаблон для ссылки на предыдущую страницу

/**
 * Сортировка
 */
$R['link_list_sort'] = '<a href="{$asc_url}" rel="nofollow">{$icon_down}</a> <a href="{$desc_url}" rel="nofollow">{$icon_up}</a> {$text}'; // Шаблон для ссылок сортировки (по возрастанию и убыванию)

/**
 * Заголовки
 */
$R['code_basehref'] = '<base href="'.$cfg['mainurl'].'/" />'; // Шаблон для установки базового URL сайта
$R['code_noindex'] = '<meta name="robots" content="noindex" />'; // Шаблон для запрета индексации страницы

$R['form_guest_remember'] = '<input type="checkbox" name="rremember" />'; // Шаблон для поля "Запомнить меня" (для гостей)
$R['form_guest_remember_forced'] = '<input type="checkbox" name="rremember" checked="checked" disabled="disabled" />'; // Шаблон для поля "Запомнить меня", которое заблокировано
$R['form_guest_password'] = '<input type="password" name="rpassword" size="12" maxlength="32" />'; // Шаблон для поля ввода пароля
$R['form_guest_username'] = '<input type="text" name="rusername" size="12" maxlength="100" />'; // Шаблон для поля ввода имени пользователя

/**
 * Сообщения
 */
$R['msg_code_153_date'] = '<br />(-&gt; {$date}GMT)'; // Шаблон для отображения даты в сообщении
$R['msg_code_redir_head'] = '<meta http-equiv="refresh" content="{$delay};url={$url}" />'; // Шаблон для редиректа с задержкой

/**
 * Обработка ошибок
 */
$R['code_error_separator'] = '<br />'; // Разделитель для ошибок
$R['code_msg_begin'] = '<ul class="{$class}">'; // Начало списка сообщений (например, ошибок)
$R['code_msg_end'] = '</ul>'; // Конец списка сообщений
$R['code_msg_line'] = '<li><span class="{$class}">{$text}</span></li>'; // Шаблон для строки в списке сообщений
$R['code_msg_inline'] = '<span class="{$class}">{$text}</span>'; // Шаблон для однострочного сообщения

/**
 * Ресурсы для заголовков/подвалов
 */
$R['notices_container'] = '{$notices}'; // Шаблон для контейнера уведомлений
$R['notices_separator'] = ''; // Разделитель между уведомлениями
$R['notices_link'] = '<a href="{$url}" title="{$title}">{$title}</a>'; // Шаблон для ссылки на уведомление
$R['notices_plain'] = '{$title}'; // Шаблон для отображения уведомления в виде текста
$R['notices_notice'] = '{$notice}'; // Шаблон для конкретного уведомления
$R['code_rc_css_embed'] = '<style type="text/css"{$attr}>
/*<![CDATA[*/
{$code}
/*]]>*/
</style>'; // Шаблон для встраивания CSS-кода непосредственно в страницу
$R['code_rc_css_file'] = '<link href="{$url}" type="text/css" rel="stylesheet" />'; // Шаблон для подключения внешнего CSS-файла
$R['code_rc_js_embed'] = '<script{$attr}>
//<![CDATA[
{$code}
//]]>
</script>'; // Шаблон для встраивания JavaScript-кода
$R['code_rc_js_file'] = '<script src="{$url}"></script>'; // Шаблон для подключения внешнего JavaScript-файла

/**
 * Прочее
 */
$R['icon_flag'] = '<img class="flag" src="images/flags/{$code}.png" alt="{$alt}" />'; // Шаблон для отображения флага по коду страны
$R['icon_group'] = '<img src="{$src}" alt="' . $L['Group'] . '" />'; // Шаблон для отображения иконки группы
$R['icon_group'] = '<img src="{$src}" alt="' . $L['Group'] . '" />'; // Повторный шаблон для отображения иконки группы
$R['img_none'] = '<img src="{$src}" alt="' . $L['Image'] . '" />'; // Шаблон для отображения изображения, если оно отсутствует
$R['img_pixel'] = '<img src="images/pixel.gif" width="{$x}" height="{$y}" alt="" />'; // Шаблон для маленького пиксельного изображения (например, для пустых ячеек)
$R['img_smilie'] = '<img src="{$src}" alt="{$name}" class="icon" />'; // Шаблон для отображения смайлика
$R['link_catpath'] = '<a href="{$url}" title="{$title}">{$title}</a>'; // Шаблон для ссылки на путь категории
$R['link_email'] = '<a href="mailto:{$email}">{$email}</a>'; // Шаблон для создания ссылки на электронную почту
$R['string_catpath'] = '<span>{$title}</span>'; // Шаблон для отображения пути категории без ссылки
$R['users_defaultAvatarSrc'] = 'images/blank-avatar.png'; // Шаблон для аватара по умолчанию

/**
 * Структура
 */
$R['img_structure_cat'] = '<img src="{$icon}" alt="{$title}" title="{$desc}" />'; // Шаблон для изображения категории структуры с подписями

/**
 * Часовые пояса (код страны, смещение GMT, смещение GMT с учётом перехода на летнее/зимнее время).
 * Используется для поиска часовых поясов по коду страны или смещению.
 * Необходимо, поскольку параметр $country в DateTimeZone::listIdentifiers не поддерживается в PHP 5.2.
 *
 * @deprecated PHP 5.2 больше не используется
 * @see https://www.php.net/manual/ru/datetimezone.listidentifiers.php
 * @see DateTimeZone::listIdentifiers()
 */
$cot_timezones = array(

	"Africa/Abidjan" => array("ci", 0, 0), // Часовой пояс для Кот-д'Ивуара (Abidjan), смещение GMT 0, без учёта перехода на летнее время
	"Africa/Accra" => array("gh", 0, 0), // Часовой пояс для Ганы (Accra), смещение GMT 0, без учёта перехода на летнее время
	"Europe/Dublin" => array("ie", 0, 3600), // Часовой пояс для Ирландии (Dublin), смещение GMT 0, с учётом летнего времени 3600 секунд
	"Europe/Gibraltar" => array("gi", 3600, 7200), // Часовой пояс для Гибралтара (Gibraltar), смещение GMT 3600 секунд, с учётом летнего времени 7200 секунд
	"Europe/Guernsey" => array("gg", 0, 3600), // Часовой пояс для Гернси (Guernsey), смещение GMT 0, с учётом летнего времени 3600 секунд
	"Europe/Helsinki" => array("fi", 7200, 10800), // Часовой пояс для Хельсинки (Helsinki), смещение GMT 7200 секунд, с учётом летнего времени 10800 секунд
	"Europe/Isle_of_Man" => array("im", 0, 3600), // Часовой пояс для острова Мэн (Isle of Man), смещение GMT 0, с учётом летнего времени 3600 секунд
	"Europe/Istanbul" => array("tr", 7200, 10800), // Часовой пояс для Стамбула (Istanbul), смещение GMT 7200 секунд, с учётом летнего времени 10800 секунд
	"Europe/Jersey" => array("je", 0, 3600), // Часовой пояс для Джерси (Jersey), смещение GMT 0, с учётом летнего времени 3600 секунд
	"Europe/Kaliningrad" => array("ru", 10800, 10800), // Часовой пояс для Калининграда (Kaliningrad), смещение GMT 10800 секунд, без летнего времени
	"Europe/Kiev" => array("ua", 7200, 10800), // Часовой пояс для Киева (Kiev), смещение GMT 7200 секунд, с учётом летнего времени 10800 секунд
	"Europe/Lisbon" => array("pt", 0, 3600), // Часовой пояс для Лиссабона (Lisbon), смещение GMT 0, с учётом летнего времени 3600 секунд
	"Europe/Ljubljana" => array("si", 3600, 7200), // Часовой пояс для Любляны (Ljubljana), смещение GMT 3600 секунд, с учётом летнего времени 7200 секунд
	"Europe/London" => array("uk", 0, 3600), // Часовой пояс для Лондона (London), смещение GMT 0, с учётом летнего времени 3600 секунд
	"Europe/Luxembourg" => array("lu", 3600, 7200), // Часовой пояс для Люксембурга (Luxembourg), смещение GMT 3600 секунд, с учётом летнего времени 7200 секунд
	"Pacific/Wallis" => array("wf", 43200, 43200) // Часовой пояс для Уоллиса (Wallis), смещение GMT 43200 секунд, без летнего времени
);