Утилиты

Утилиты позволяют выделять и повторно использовать функции шаблонов и разметки.

Обзор

Утилиты являются автономными XSLT модулями, которые можно использовать многократно. Вы сожете включать их с шаблоны любых страниц или в тела других утилит. Они часто используются для решения общих задач форматирования (например, работа с датами и временем) или для выделения часто используемых элементов интерфейса (например, заголовок и подвал страницы).

Утилиты не являются уникальными для Symphony, но они позволяют пользователям создавать надёжные XSLT модули для работы с шаблонами страниц.

Использование

Работа с утилитами осуществляется через меню компонентов (Blueprints > Components) или с помощью непосредственного редактирования XSLT файла (workspace/utilities/utility-name.xsl).

Для работы с утилитами их необходимо предварительно подключить в шаблоне страницы.

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

Так же утлиты можно включать с тело других утилит следующей инструкцией:

Детали

Редактор утилит довольно простой и не нуждается в особом описании. Он содержит одно большое текстовое поле, содержащее полный XSLT код утилиты. На боковой панели спарва расположен список утилит доступных в проекте. Все утилиты используемые в редактируемом шаблоне подсвечены.

The Big Picture

Утилиты имеют большое значение в работе с разметкой и форматированием данных. Любая часть шаблона страниц, которая используется более одного раза может быть вынесена для удобсва в отдельную утилиту. Сейчас количество утилит для Symphony быстро растёт, любую из них вы можете скачать на сайте разработчиков.

Шаблон кода простой утилиты