Вернуться на сайт x3m.cms

Модуль "Шаблоны"

Все сайты работающие на X3M.CMS построены на шаблонах имеющих произвольную разметку на языке HTML, создавая шаблон (подробнее о правилах разметки шаблонов можно прочитать в разделе "Принципы работы шаблонной системы X3M.CMS") в нем указываются специальные теги (области вывода информации на нашем сайте) - в последствии данные теги в администраторской части системы управления отображаются как слоты страницы (поля ввода информации, в данном случае поля для ввода модулей).

Все шаблоны в системе разделены на "базовые шаблоны" и "шаблоны модулей".

Базовые - определяют структурный вид страниц сайта (о правилах разметки данных шаблонов можно прочитать в разделе "разметка базовых шаблонов"), обычное количество таких шаблонов равно двум или трем, причем один из них всегда является главным шаблоном(в простейшем случае сайт можно построить и на одном главном шаблоне). В системе может существовать только один главный шаблон, остальные являются дочерними к главному, главный шаблон всегда храниться по следующему пути /templates/_common/_index.html (данный путь отсчитан от корневой папки сайта на сервере и менять его нельзя!). Все дочерние шаблоны также хранятся в папке /templates/, выбор имени папки для хранения данных шаблонов произволен. Как главный так и дочерний базовый шаблон имеют одно и тоже именование - _index.html.

mod_temp_index
рис.1

Пример: для хранения дочернего базового шаблона второй страницы в папке templates/ можно создать папку c именем "second_page" и поместить в нее файл с именем _index.html, в котором будет определена HTML структура для внутренних страниц сайта, таким образом полный путь к шаблону будет выглядеть как /templates/second_page/_index.html

И главный и дочерний шаблон имеют одинаковый набор секций, описывающих определенные участки страницы:

  • секция HEAD - в данную секцию обычно помещают заголовочную часть HTML страницы (например тег "<head></head>" со всем содержимым),
  • секция TOP - в данную секцию обычно помещают HTML структуру описывающую шапку сайта,
  • секция MIDDLE - здесь обычно помещают HTML структуру описывающую центральную часть страницы,
  • секция BOTTOM в данной секции размещается HTML структура описывающая подвал(низ) страницы,

но между главным и дочерними шаблонами есть одно важно отличие - дочерний шаблон может замещать секции главного шаблона.

Пример: Если в дочернем шаблоне(для определенности его имя - "second_page") определена только одна секция TOP, то при выводе страницы, которой назначен шаблон "second_page" из главного шаблона будут взяты секции HEAD, MIDDLE, BOTTOM, а секция TOP будет взята из дочернего шаблона "second_page", очевидно, что в дочернем шаблоне можно было бы заместить все секции главного шаблона.

Управление модулем шаблоны администраторской части системы : слева находится дерево шаблонов, нажимая на шаблон будет осуществляться переход к редактированию его содержимого, для сохранения отредактированного шаблона необходимо нажать кнопку "Сохранить". У "базовых шаблонов" в отличии от "шаблонов модулей" существует поле "Алиас".С помощью данного поля базовым шаблонам можно присваивать альтернативные имена (Алиасы), если данное поле не задано шаблоны будут именоваться так, как именуется директория в которой они располагаются.

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

mod_temp_red_slotov
рис.2

© 2009 Все права на систему © X3M.CMS принадлжат OДО «Центр информационных технологий Биконсалт»