Содержание
Использование функций-хелперов
Для удобства при работе с шаблонами в движке есть файл с набором функций, «облегчающих жизнь» верстальщикам и в целом людям, работающим с шаблонами InstantCMS. Функции в этом файле возвращают, как правило, некую строку, содержащую HTML код. Например, функция html_link
печатает HTML тег <a>
с переданными в функцию параметрами, при чем сразу же делая атрибуты безопасными от XSS.
Файл с функциями-помощниками по-умолчанию
Файл, где определены все эти функции, находится по пути /system/libs/template.helper.php
. Он подключается всегда, если для шаблона не задан свой такой же файл.
Создание своего файла с функциями-помощниками
Если вы в своем шаблоне хотите изменить возвращаемые указанными функциями данные, например добавить принудительно классы тегам или вообще изменить верстку нужных блоков, то необходимо сделать:
- Скопировать файл
/system/libs/template.helper.php
в/templates/ВАШ_ШАБЛОН/assets/helper.php
, т.е. взять файл по умолчанию, скопировать его в/templates/ВАШ_ШАБЛОН/assets/
и переименовать его вhelper.php
; - Править по своему усмотрению, не изменяя при этом основной логики функций.
Важно понимать, что в файле /templates/ВАШ_ШАБЛОН/assets/helper.php
должны быть определены ВСЕ функции, которые есть изначально в /system/libs/template.helper.php
, даже если вы исправите только лишь одну функцию. А вот добавлять свои функции-помощники и использовать их в своем шаблоне вы конечно же можете.