Шаблон в DLE: что важно понять сразу

В DLE можно изменить цвет кнопки за пять минут, а потом потратить полдня на поиск причины, почему правка не видна. Проблема обычно не в CSS: шаблон состоит из нескольких файлов, движок подставляет в них свои теги, а включённый кэш способен показывать старую версию. Этот материал рассчитан на DLE 18.x и поможет с нуля понять структуру темы, внести первую правку и проверить результат без риска сломать весь сайт.

Что подготовить до первой правки

Работайте не с боевым сайтом напрямую. Сначала подготовьте:

• доступ к файлам сайта по FTP, SFTP или через файловый менеджер хостинга;
• доступ в админ-панель DLE с правами на управление шаблонами;
• локальную копию папки активного шаблона;
• редактор, который сохраняет файлы в UTF-8 без BOM;
• отдельное окно браузера для проверки сайта и инструменты разработчика.

Название активной темы можно посмотреть в настройках DLE. Запишите его перед началом: файл из папки templates/default/ не изменит сайт, если реально включена тема из другой папки. Путь default здесь только пример — у вашего шаблона может быть другое имя.

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

Как устроена тема DLE

Главная папка шаблона находится внутри templates/. В ней обычно лежат файлы страниц, блоков и стилей. Названия могут отличаться у готовых тем, но роли файлов в DLE повторяются.

Конкретный состав зависит от темы и версии DLE. Не удаляйте файл только потому, что он кажется пустым: его может подключать другой шаблон или плагин.

Первые пять шагов

1. Сделайте копию. Скачайте всю папку активной темы и сохраните исходный архив отдельно. Если сайт перестанет отображаться, верните изменённый файл из копии. Проверка: у вас есть архив с исходными файлами и понятно, к какой теме он относится.
2. Найдите общий каркас. Откройте main.tpl. В нём обычно находятся head, шапка, навигация, контейнер и подвал. Тег {content} обозначает место, куда DLE подставляет основное содержимое страницы. Проверка: вы можете показать участок страницы и найти его HTML в main.tpl.
3. Определите нужный файл. Изменение карточки новости делайте в shortstory.tpl, страницы новости — в fullstory.tpl, комментария — в comments.tpl. Не пытайтесь исправить карточку в main.tpl: там обычно находится только общий каркас. Проверка: изменённый участок встречается именно в том типе страницы, который вы открываете.
4. Сделайте маленькую правку. Например, добавьте класс к заголовку короткой новости:

   <h2 class="news-card__title">{title}</h2>

   Тег {title} оставляет заголовок новости динамическим, а класс позволяет отдельно настроить его в CSS. Проверка: в исходном HTML страницы у заголовка есть класс news-card__title, а сам текст новости не исчез.
5. Проверьте стили и кэш. Добавьте правило в CSS-файл активной темы, очистите кэш DLE и кэш браузера, затем откройте страницу в режиме инкогнито. Проверка: в инструментах разработчика правило находится в загруженном CSS-файле и не перечёркнуто другим правилом.

Названия переменных и тегов DLE нельзя заменять произвольно. Если вы не уверены, поддерживает ли конкретный тег ваша версия, проверьте документацию к DLE 18.x и существующие файлы темы. Не вставляйте в шаблон тег, найденный в инструкции для другой CMS.

Теги DLE: что они делают

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

• {content} — основное содержимое страницы в общем каркасе;
• {title} — заголовок новости в контексте шаблона новости;
• {THEME} — путь к активной теме, который удобно использовать для ресурсов;
• {include file="..."} — подключение отдельного шаблонного фрагмента, если это поддерживается вашей конфигурацией и версией;
• {AJAX}, {headers} и {jsfiles} — служебные конструкции, которые нельзя бездумно удалять из общего шаблона.

Контекст важен: тег, работающий внутри карточки новости, не обязательно даст результат в подвале. Если после переноса тега на другую страницу вместо значения появился пустой участок, верните его в исходный файл и сверяйтесь с документацией.

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

Если правка не появилась

Изменён неактивный шаблон

Признак — в файле есть новая разметка, но исходный HTML сайта не изменился. Сверьте имя темы в настройках DLE и путь к папке. Частая ошибка — редактировать копию, оставшуюся после старого редизайна.

Сработал кэш

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

CSS перекрыт другим правилом

Признак — класс есть в HTML, но стиль в панели разработчика перечёркнут. Найдите правило с большей специфичностью, проверьте порядок подключения CSS и только затем решайте, нужен ли более точный селектор.

Файл сохранён с неправильной кодировкой

Признак — вместо кириллицы появились кракозябры или PHP сообщает об ошибке в файле шаблона. Верните резервную копию и сохраните файл в UTF-8 без BOM. Не меняйте кодировку всей темы без необходимости.

Сломана кавычка или закрывающий тег

Признак — «поехала» вся страница, исчез блок или браузер показывает неожиданную вложенность элементов. Сравните изменённую строку с копией, а затем проверьте HTML через инструменты разработчика. Меняйте по одной небольшой части и обновляйте страницу после каждого изменения.

Что нельзя менять вслепую

Не удаляйте из main.tpl служебные теги только ради чистоты кода. Они могут отвечать за подключение скриптов, заголовков, AJAX-ответов и метаданных. Сначала выясните назначение конструкции, затем проверьте сайт на главной, в новости, в форме входа и в комментариях.

Не смешивайте правку шаблона и редизайн. В первой итерации измените один элемент: например, добавьте класс карточке или поменяйте отступ. Когда результат подтверждён, переносите изменения в остальные файлы. Так проще найти ошибку и откатиться.

Отдельная тема — адаптация шаблона под мобильные устройства. Здесь нужно проверять не только DLE-теги, но и CSS-медиазапросы, размер изображений и работу меню. В этой статье рассматриваем базовую структуру темы, а не полноценную адаптивную вёрстку.

Что делать дальше

Создайте тестовую копию темы и заведите короткий журнал изменений: дата, файл, строка и результат проверки. Следующей задачей сделайте перенос повторяющейся шапки или подвала в отдельный фрагмент, если ваша версия DLE и тема поддерживают такое подключение. После каждого изменения проверяйте четыре сценария: главную страницу, список новостей, полную новость и комментарии. В продакшене дополнительно смотрите HTML-ошибки, консоль браузера и время загрузки CSS и JavaScript.