Главная / Документация / Полное руководство / Интеграция дизайна, шаблоны и шаблонные функции /

Шаблонные функции и теги

Шаблонные функции – это функции для вывода всевозможного контента в пользовательской части сайта. Шаблонная функция неразрывна с шаблонным тегом, который является инструментом для вызова функции в шаблонах сайта при подключении дизайна к diafan.CMS.

Шаблонные теги

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

<insert [name=""] [module=""] [value=""] [attribute_1=""] [attribute2=""]> Тег включает ряд необязательных атрибутов, делящихся на определенные и неопределенные атрибуты.

Определенные атрибуты:

— name – задает вызываемую функцию или выводимую переменную;

— value, value2, value3, ... – значение. Номер соответствует номеру языка сайта (если сайт мультиязычный);

— module – задает название модуля, к которому относится вызываемая функция.

Неопределенные атрибуты – это все остальные атрибуты. Они передаются функции в качестве массива в формате:

array(название => значение, …);

Значения атрибутов должны быть заключены в кавычки и не должны содержать символы >, <, ", '. Эти символы должны быть заменены HTML-мнемониками или специальными символами:

< надо заменить на < или [
> надо заменить на > или ]
& надо заменить на &
" надо заменить на " или `

Шаблонный тег может быть оформлен и выводить:

1. значение объявленных переменных:

— адрес сайта;

Пример: <insert name="path">
выведет url сайта

2. переводимый текст для мультиязычных сайтов (value="значение", value2="значение2",…);

Пример: <insert value="Русский" value2="English" value2="Deutsch">
выведет в русской языковой версии по умолчанию слово "Русский", в следующей языковой версии слово "English", и при переходе на третью языковую версию, выведет на сайте слово "Deutsch".

3. контент, генерируемый общими шаблонными функциями;

Пример: <insert name="show_year" year="2003">
выведет на сайте 2003-2011

4. контент генерируемый шаблонными фукнциями модулей.

Пример:

<insert name="show_block" module="menu" tag_start_1="[span class=`menutd`]" tag_end_1="[/span][br]" tag_start_2="[span class=`menutd_level`]" tag_end_2="[/span][br]">

выведет меню.

Общие шаблонные функции

Это функции общего назначения из файла /includes/function.php.

show_href – выводит ссылку на страницу сайта. Если текущая страница соответствует адресу, на которую ведет ссылка, то ссылка становится неактивной. Шаблонная функция аналогична стандартной HTML-конструкции <a href=""></a>, но ликвидирует ссылки, которые никуда не ведут.

Атрибуты:

rewrite — псевдоссылка страницы, на которую ведет ссылка, например: news;
img — адрес изображения, использующегося в качестве ссылки, например: img/logo.gif;
img_act — адрес изображения на текущей странице, например: img/home_act.gif;
width — ширина изображения;
height — высота изображения;
alt, alt1, ... — альтернативный тег для изображения или текст ссылки. Номер необходимо заменить номером языка, если на сайте используется мультиязычность.

show_social_links – выводит ссылки на социальные сети.

path_url — адрес сайта, с учетом языка сайта;

Пример: <insert name="path_url">

language — идентификатор языка сайта;

Пример: <insert name="language">

title — название сайта на текущем языке;

Пример: <insert name="title">

module — название модуля, прикрепленного к текущей странице;

Пример: <insert name="module">

Не понятно? Уточните