Шаблонизатор системы Kasseler CMS 1.X.X

В данной статье мы разберем шаблонизатор Kasseler CMS версий 1.X.X и её обязательные файлы, а также основные теги, которые помогут вам создать свой дизайн для сайта.


На данный момент в системе реализован мощный шаблонизатор, который включает в себя набор обязательных файлов – шаблонов, таких как:

block-center.tpl – Шаблон центральных верхних блоков.
block-down.tpl – Шаблон центральных нижних блоков.
block-footer.tpl – Шаблон нижнего баннера.
block-head.tpl – Шаблон верхнего баннера.
block-left.tpl – Шаблон левых блоков.
block-right.tpl – Шаблон правых блоков.
comment.tpl – Шаблон комментариев.
index.tpl – Главный шаблон сайта в котором размещается содержимое сайта.
inform.tpl – Шаблон информационного сообщения.
message.tpl – Шаблон сообщений на главной странице.
publisher.tpl – Шаблон публикаций (используется для вывода: новостей, медиа, файлов, анекдотов и т.д.).
search.tpl – Шаблон результатов поиска.
table_close.tpl – Шаблон закрытия таблицы.
table_open.tpl – Шаблон открытия таблицы.
warning.tpl – Шаблон сообщений об ошибках.



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

$user – Имя пользователя.
$logo - Лого сайта.
$load_tpl – Название текущего шаблона пользователя.
$link – Заменяется на теги подключения css файлов системы.
$meta – Заменяется на теги meta.
$header – Заменяется на код, расположенный в файле ./includes/header.php.
$script – Заменяется на теги подключения скриптов системы.
$license – Заменяется на сведения о лицензии системы.
$var_info - Заменяется на список глобальных переменных.
$query_info - Заменяется на список запросов в базу данных.
$guery – Информация о количестве запросов в базу данных.
$time – Информация о скорости генерации HTML кода.
$title – Название страницы.
$message – Заменяется на список сообщений на главной странице (сообщения показываются только на главной странице).
$block_left – Заменяется на массив сформированных левых блоков.
$block_right – Заменяется на массив сформированных правых блоков.
$block_center – Заменяется на массив сформированных центральных верхних блоков.
$block_down – Заменяется на массив сформированных центральных нижних блоков.
$topbaner – Заменяется на массив сформированных верхних баннеров.
$footbaner – Заменяется на массив сформированных нижних баннеров.

Файл index.tpl по умолчанию используется для всех модулей системы, если нет специального шаблона для конкретного модуля. Специальный шаблон страницы сайта для определенного модуля называется так: index-название_модуля.tpl.
Кроме того в нем допускается выполнение PHP кода (в качестве примера рассмотрите пример построения меню в базовом шаблоне системы).
Так же в шаблонизаторе реализованы дополнительные возможности размещения блоков. Каждый блоковый файл можно разместить в любом месте страницы.
Например, что бы блоковый файл block-имя_блока.php вынести в шапку сайта, необходимо создать шаблон блока с именем BLOCK-ИМЯ БЛОКА.tpl (т.е. перевести имя файла в верхний регистр и поменять расширение на tpl), а в шапке сайта разместить тег {BLOCK-ИМЯ БЛОКА}.
Дополнительно возможно понадобится перевести в группу верхний баннер , что бы он отображался во всех модулях.
К обязательным параметрам index.tpl относятся id=\"displaynone\" и id=\"rightcolumn\" если их не вписать в контейнер, в котором будут находится левые и правые блоки – то не будет работать функция скрытия этих блоков.



Файлы block-center.tpl, block-down.tpl, block-footer.tpl, block-head.tpl, block-left.tpl, block-right.tpl отвечают за оформление блоков системы.

Основные теги шаблона:
$title – Название блока.
$content – Содержание блока.
$load_tpl – Название текущего шаблона пользователя.
$id_block – Идентификатор блока (уникален для каждого блокового файла).

Файлы block-*.tpl по умолчанию используется для всех блоков системы, если нет специального шаблона для конкретного блока. Специальный шаблон блока называется так: block-имя блока.tpl.


файл publisher.tpl отвечает за оформление модулей системы.
основные теги шаблона :

$title – Название релиза.
$content – Содержание релиза.
$rating – Рейтинг релиза.
$views – Количество просмотров/скачиваний.
$author – Автор релиза
$date – Дата публикации.
$coment – Количество комментариев к релизу.
$detaling – Ссылка к подробному просмотру.
$operation – Операции администратора/модератора относительно текущего релиза.
$load_tpl – Название текущего шаблона пользователя.

Файл publisher.tpl по умолчанию используется для всех модулей системы, если нет специального шаблона для конкретного модуля. Специальный шаблон модуля называется так: название модуля.tpl.
Кроме того для каждого модуля можно задать свою таблицу стилей и разместить в файле style-название модуля.css.



файл comment.tpl отвечает за оформление комментариев.
основные теги шаблона:

$name – Имя пользователя.
$info – Информация о комментарии.
$user – Информация о пользователе.
$comment – Комментарий.
$rating – Рейтинг пользователя.
$operation – Кнопки удаления редактирования комментария (доступны только администраторам или модераторам).
$load_tpl – Название текущего шаблона пользователя.


Все остальные шаблоны не имеют уникальных свойств и больше всего аналогичны блоковым шаблонам.