Как работают шаблоны сайта и модулей в DIAFAN.CMS

Проще всего разбираться с незнакомыми алгоритмами опираясь на готовые решения. Возьмем страницу списка новостей на стандартном дизайне DIAFAN.CMS. В демо-версии это страница категории Новости туризма

Открыть пример страницы

Чтобы понимать, каким образом DIAFAN.CMS строит эту страницу, нужно знать две вещи:

  • Какой шаблон дизайна используется на текущей странице сайта
  • Какой модуль подключен к текущей странице

Поскольку наша страница находится Главная / Полезное / Новости, открываем Страницы сайта и находим её.

Страницы сайта

Если кликнуть на страницу с подключенным модулем, первым откроется список элементов модуля. Чтобы узнать, какой шаблон подключен к текущей странице сайта, нужно открыть её редактирование. Чтобы сделать это из списка элементов подключенного к странице модуля, нужно нажать изменить.

Страница с подключенным модулем новости

Назначение шаблона - не самая частоиспользуемая функция, поэтому она вынесена в раздел Дополнительно. Раскройте его.

Страницы сайта

Вы увидите, какой шаблон назначен для страницы «Новости». В нашем случае это themes/site.php

Страницы сайта

Далее. Поскольку мы рассматриваем новости из категории «Новости туризма», а не корневые для списка новостей, нам нужно знать, какие шаблоны назначены на эту категорию. Выбираем категорию «Новости туризма» над списком новостей и затем жмем изменить.

Редактирование страницы из панели

Если у Вас подключена панель быстрого редактирования, найти текущую страницу гораздо проще. Просто кликните на иконку-карандашик на панели.

Страницы сайта

Категория «Новости туризма» откроется для редактирования. Раскрываем Дополнительно и видим, что для категории унаследовался основной шаблон сайта themes/site.php, а для модуля используется шаблон модуля новостей modules/news/views/news.view.list.php

Страницы сайта

Теперь можно смело открывать файл шаблона сайта themes/site.php и шаблон модуля новости и вносить там необходимые изменения. Для наглядности, мы изобразили связи между шаблонными тегами и блоками на сайте. А также указали, в каком файле правится каждый шаблонный тег.

Как работают шаблоны сайта и модулей

Открыть схему в исходном размере

Внимание!
В данном разделе документации говорится о стандартном дизайне и базовых шаблонах сайта. Это themes/site.php, themes/site_start.php и прочие, находящиеся в папке themes. А также шаблонах модулей, находящихся по адресам modules/модуль/views/. Однако, если на Вашем сайте используются темы, полученные в результате кастомизации, шаблоны сайта и шаблоны модулей могут находиться в папке ** custom/modules/модуль/views/ **. Подробнее о темах

И еще раз приведем ссылку на справочник всех шаблонных тегов

Ваши комментарии и дополнения

Ваш комментарий будет первым.

Зарегистрируйтесь или авторизируйтесь для того, чтобы оставить комментарий.