Вышла новая версия Zebrum Lite 1.0.2
В этой версии создавать шаблоны стало удобнее.
Скачать новую версию: Zebrum Lite
Вопросы по использованию системы и ее возможностям можно присылать на электронный адрес support@zebrum.ru
Ниже представлена документация по шаблону.
Файловая структура шаблонов
Пример файловой структуры шаблонов приведён ниже:
templates/
default/
images/
template.php
404.php
styles.css
sometheme/
images/
template.php
mainpage.php
stylesheet.css
Тема сайта
Темы для сайта располагаются в папке templates
. Каждая тема должна иметь как минимум один шаблон с названием template
, файл template.php
.
Для того чтобы выбрать тему сайта, необходимо в конфигурационном файле указать ее название. Например, если необходимо сменить тему сайта на sometheme
, то в файле /zengine/config.ini
нужно изменить следующую строчку (выделена жирным):
[template]
; тема сайта
theme = sometheme
Тогда на сайте будет использоваться тема sometheme
.
Настройки шаблона
По умолчанию система будет искать шаблон template в используемой теме. Если в свойствах страницы задан другой шаблон, то будет использован он. Например, для следующей страницы будет использоваться шаблон mainpage:
@@title=Главная страница
@@template=mainpage
Текст главной страницы
Система будет искать шаблон с названием файла mainpage.php
. Если данный шаблон не будет найден в текущей теме, то будет произведен поиск в теме default
. Если и там нет указанного шаблона, то будет выдано сообщение об ошибке.
Шаблон страницы
Файл шаблона страницы содержит HTML-разметку со вставками PHP-кода. Ниже представлен пример базового шаблона, входящего в дистрибутив системы:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ru" lang="ru">
<head>
<?php z_head(); ?>
<link rel="stylesheet" type="text/css" href="~ztpl/styles.css" />
</head>
<body>
<div id="wrapper">
<div id="header"></div>
<div id="content"><div id="content-inner">
<div id="breadcrumbs"><?php z_breadcrumbs(); ?></div>
<h1><?php z_h1(); ?></h1>
<?php z_content(); ?>
<?php z_subpages(); ?>
</div></div>
<div id="leftcolumn">
<?php z_menu(); ?>
</div>
<div id="footer">
<div id="sitemap"><?php z_sitemap(); ?></div>
<div id="copyrights">© 2008 <a href="http://blog.zebrum.ru/">Zebrum.ru</a> - если сайтов много<br />
Сайт работает на <a href="http://blog.zebrum.ru/">Zebrum Lite</a></div>
</div>
</div>
</body>
</html>
Автоматическая замена ссылок
Для упрощения написания шаблонов в системе используются следующие автоматически замены:
~/
– URI корня сайта;
~ztpl/
– URI папки текущего шаблона.
Например, если наш сайт лежит в папке zebrum_lite
, то путь ~/
будет автоматически заменен на /zebrum_lite/
, а ~ztpl/styles.css
на /zebrum_lite/templates/default/styles.css
. Пример использования:
<a href="~/">Главная страница</a>
<link rel="shortcut icon" href="~/favicon.ico">
<link rel="stylesheet" href="~/css/screen.css">
<script type="text/javascript" src="~/js/scripts.js"></script>
Функции шаблонизатора
В шаблоне можно использовать специальные PHP-функции для разметки страницы. Например, место для заголовка страницы может быть показано следующим образом:
<h1><?php z_title(); ?></h1>
Список всех функций с описанием:
z_head()
Выводит мета-тэги HTML-страницы: заголовок страницы, ключевые слова, описание и кодировку страницы.
z_title()
Выводит название страницы. Например, <?php z_title(); ?>
.
z_h1()
Выводит заголовок страницы.
z_content()
Выводит тело страницы.
z_subpages()
Выводит список дочерних страниц с их названием (@@title
), ссылкой с названия и описанием. В качестве описания страницы берется свойство страницы @@description
. Если оно не задано, то берется первый абзац тела страницы.
z_menu()
Выводит меню сайта. В меню отображаются страницы верхнего уровня, дочерние и родительские страницы относительно текущей открытой. Рекомендуется, если страниц очень много.
z_fullmenu()
Выводит полностью раскрытое меню. Рекомендуется, если страниц мало.
cmsimple_menu()
Выводит меню сайта в стиле CMSimple специально для шаблонов, импортированных из CMSimple.
z_breadcrumbs()
Выводит «хлебные крошки» – элемент навигации по сайту, представляющий собой путь по сайту от его «корня» до текущей страницы, на которой находится пользователь.
z_sitemap()
Выводит ссылку на карту сайта.