3. Описание MCP-сервера › 3.3 Движок › Шаблоны

Раздел engine_html_* работает с шаблонами модулей — файлами разметки .htm, из которых модуль собирает свой HTML.

Где лежат

templates/<группа>/units/<модуль>/<шаблон>.htm

Путь шаблона всегда состоит из этих частей.

Группа шаблонов — полный набор шаблонов витрины. Групп может быть несколько. Если шаблона в группе нет или он пуст, движок берёт одноимённый шаблон из основной группы, поэтому правка шаблона основной группы меняет и такие группы. Подробно — «Группы шаблонов».

main.htm появляется вместе с модулем, когда его создаёт engine_php_add. Других шаблонов у модуля может быть сколько угодно, их добавляет engine_html_add.

В папке модуля лежат не только шаблоны. Его css, js и psv, которые входят в бандлы, — это статика: их читает и сохраняет раздел «Статика».

Как шаблон выводится

Модуль собирает HTML из шаблонов по имени файла без .htm — методом TplParse и другими методами Tpl*. Другой шаблон того же модуля можно подключить прямо в разметке тегом {^ИМЯ}: {^ORDER_ABSENT} подключит order_absent.htm из той же папки. Подробно — «Методы шаблонизатора» и «Синтаксис шаблонов».

Что делает сохранение

Перезаписывает файл целиком и ничего не создаёт: новый шаблон добавляет engine_html_add.
Сбрасывает кеш своего модуля — базовый и Trick — сразу во всех группах шаблонов, а вместе с ним и статистику Smart этого модуля.
Пишет версию файла, если это включено в настройках среды разработки программы на этом компьютере.
Замечаний не даёт: проверка кода работает только для модулей.

Номер сборки шаблону не нужен: браузер не хранит HTML страницы.