Документация InstantCMS

для администраторов и разработчиков

Инструменты пользователя

Инструменты сайта


dev:templates:helpers

Использование функций-хелперов

Для удобства при работе с шаблонами в движке есть файл с набором функций, «облегчающих жизнь» верстальщикам и в целом людям, работающим с шаблонами InstantCMS. Функции в этом файле возвращают, как правило, некую строку, содержащую HTML код. Например, функция html_link печатает HTML тег <a> с переданными в функцию параметрами, при чем сразу же делая атрибуты безопасными от XSS.

Файл с функциями-помощниками по-умолчанию

Файл, где определены все эти функции, находится по пути /system/libs/template.helper.php. Он подключается всегда, если для шаблона не задан свой такой же файл.

Создание своего файла с функциями-помощниками

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

  1. Скопировать файл /system/libs/template.helper.php в /templates/ВАШ_ШАБЛОН/assets/helper.php, т.е. взять файл по умолчанию, скопировать его в /templates/ВАШ_ШАБЛОН/assets/ и переименовать его в helper.php;
  2. Править по своему усмотрению, не изменяя при этом основной логики функций.

Важно понимать, что в файле /templates/ВАШ_ШАБЛОН/assets/helper.php должны быть определены ВСЕ функции, которые есть изначально в /system/libs/template.helper.php, даже если вы исправите только лишь одну функцию. А вот добавлять свои функции-помощники и использовать их в своем шаблоне вы конечно же можете.


Перейти к описанию функций-помощников

К оглавлению раздела

dev/templates/helpers.txt · Последнее изменение: 10.04.2016 23:15 — fuze