Элемент: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
м (1 версия)
Строка 1: Строка 1:
 
[[Категория:Термины]]
 
[[Категория:Термины]]
 +
'''Элемент макета страницы''' в Nemo в общем случае выполняет функции по выбору контента, введенному пользователем CMS (см. [http://mediawiki.mute-lab.com/ru/%D0%9A%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82#.D0.A0.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.BE.D1.80_.D0.BA.D0.BE.D0.BD.D1.82.D0.B5.D0.BD.D1.82.D0.B0_CMS Редактор контента]), удовлетворяющему настройкам элемента и формированию выходного HTML-потока с применением шаблона для подстановки его в место, указанное в макете страницы.
 +
 +
Для группировки HTML-потоков, формируемых элементами с применением шаблона, используются блоки элементов. Для этого в настройках элемента следует указать, к какому блоку он относится.
 +
 +
== Настройки элемента макета страниц ==
 +
*'''Заголовок''' - заголовок элемента;
 +
*'''Описание''' - описание элемента;
 +
*'''Информационный блок''' - блок, в котором будет отображаться элемент;
 +
*'''Пользовательское имя объекта''' - имя объекта, по которому можно будет обратиться к нему из шаблона страницы. Если имя задано, то в процессе наследования элементов макета страницы элементы с одинаковыми именами будут заменяться, а не добавляться к ранее существующим;
 +
*'''Режим создания объекта''' - данный параметр влияет на поведение объекта при наследовании элементов макета страниц. Если указано «Наследовать далее», то данный элемент будет наследоваться, иначе он будет создан только при формировании HTML-потока во фронт-энде и только на основе текущего макета;
 +
*'''Экземпляр модуля''' - экземпляр модуля, из которого будет выбираться [[контент]] для вывода текущим элементом;
 +
*'''Язык элемента''' - если выбрать какой-либо язык, то данный элемент будет отображаться только в случае, если язык системы совпадет с текущим;
 +
*'''Задействовать расписание''' - если выбран данный пункт, то элемент будет отображаться только в указанный интервал дат;
 +
*'''Включено''' - включить или выключить элемент.
 +
 +
== Создание элемента ==
 +
 +
Элемент создается в 2 этапа.
 +
 +
После того, как вы нажмете кнопку «Создать», элемент перейдет в режим настройки дополнительных параметров, о чем будет выдано соответствующее предупреждение.
 +
 +
Появятся дополнительные поля:
 +
 +
*'''Режим отображения содержимого''' - это список различных вариантов выборки контента, доступных для выбранного экземпляра модуля. После изменения данного параметра в форме автоматически появятся поля данных, специфические для текущего режима отображения.
 +
 +
<span style="background-color:#fff0f5;"><span style="font-size:large;"><span style="color:#ff0000;">!</span></span> Элемент, созданный на основе режима отображения «Внедренный объект системы» экземпляра модуля «Системные функции», не будет наследоваться между макетами страниц и должен быть создан непосредственно на макете страницы, для которого он планируется использоваться, т.к. он является специальным маркером, идентифицирующим макет страницы как пригодный для интеграции построенного на его основе контента с системными функциями Nemo.
 +
 +
*'''Шаблон''' - шаблон, который будет применен к контенту;
 +
 +
*'''Фильтр''' - дополнительные фильтры, с помощью которых можно управлять видимостью элемента специфичным для определенного фильтра образом.
 +
 +
== Шаблон элемента модуля ==
 +
 +
Элемент страницы отвечает за подготовку данных для вывода во [[фронт-энд]] и применения к ним шаблона. Данные, которые передаются в шаблон, зависят от полей «Экземпляр модуля» и «Режим отображения содержимого».
 +
 +
'''Пример шаблона модуля «Новости» для режима «Определенная новость»:'''
 +
 +
<pre><h1>{$data.news_title}</h1>
 +
<p>{$data.news_content}</p></pre>
 +
 +
'''Переменные и выражения доступные в шаблонах элементов:'''
 +
<table border="1">
 +
<tr bgcolor="#cccccc">
 +
<th class="col0"> Заголовок </th><th class="col1"> Значение </th>
 +
 +
</tr>
 +
<tr class="row1">
 +
<td class="col0 leftalign">{$parent} </td><td class="col1"> Доступ к переменным, доступным из шаблона макета страницы или блока элементов (в зависимости от того, из какого шаблона был вызван {cms_render_element id=$element.id}) </td>
 +
</tr>
 +
<tr class="row2">
 +
<td class="col0"> {$global} </td><td class="col1">Доступ к переменным, доступным из шаблона макета страницы, в случае, если элемент был вызван из шаблона блока </td>
 +
 +
</tr>
 +
<tr class="row3">
 +
<td class="col0"> {$page} </td><td class="col1">Настройки макета страницы </td>
 +
</tr>
 +
<tr bgcolor="#cccccc">
 +
<th class="col0" colspan="2"> Настройки элемента </th>
 +
 +
</tr>
 +
<tr class="row5">
 +
<td class="col0"> {$id} </td><td class="col1"> ID элемента </td>
 +
</tr>
 +
<tr class="row6">
 +
<td class="col0"> {$element_name} </td><td class="col1"> Пользовательское имя объекта </td>
 +
 +
</tr>
 +
<tr class="row7">
 +
<td class="col0"> {$element_title} </td><td class="col1"> Заголовок элемента </td>
 +
</tr>
 +
<tr class="row8">
 +
<td class="col0"> {$element_description} </td><td class="col1"> Описание элемента </td>
 +
 +
</tr>
 +
<tr class="row9">
 +
<td class="col0"> {$element_template} </td><td class="col1"> Шаблон элемента </td>
 +
</tr>
 +
<tr class="row10">
 +
<td class="col0"> {$date_create} </td><td class="col1"> Дата создания </td>
 +
 +
</tr>
 +
<tr class="row11">
 +
<td class="col0"> {$template_title} </td><td class="col1"> Заголовок шаблона </td>
 +
</tr>
 +
</table>
 +
 +
== См. также ==
 +
[[Контент]]<br>
 +
[[Система управления порталом (ЦМС)]]<br>
 +
[[Контент]]<br>
 +
[[Фронт-энд]]

Версия 05:25, 1 марта 2012

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

Для группировки HTML-потоков, формируемых элементами с применением шаблона, используются блоки элементов. Для этого в настройках элемента следует указать, к какому блоку он относится.

Настройки элемента макета страниц

  • Заголовок - заголовок элемента;
  • Описание - описание элемента;
  • Информационный блок - блок, в котором будет отображаться элемент;
  • Пользовательское имя объекта - имя объекта, по которому можно будет обратиться к нему из шаблона страницы. Если имя задано, то в процессе наследования элементов макета страницы элементы с одинаковыми именами будут заменяться, а не добавляться к ранее существующим;
  • Режим создания объекта - данный параметр влияет на поведение объекта при наследовании элементов макета страниц. Если указано «Наследовать далее», то данный элемент будет наследоваться, иначе он будет создан только при формировании HTML-потока во фронт-энде и только на основе текущего макета;
  • Экземпляр модуля - экземпляр модуля, из которого будет выбираться контент для вывода текущим элементом;
  • Язык элемента - если выбрать какой-либо язык, то данный элемент будет отображаться только в случае, если язык системы совпадет с текущим;
  • Задействовать расписание - если выбран данный пункт, то элемент будет отображаться только в указанный интервал дат;
  • Включено - включить или выключить элемент.

Создание элемента

Элемент создается в 2 этапа.

После того, как вы нажмете кнопку «Создать», элемент перейдет в режим настройки дополнительных параметров, о чем будет выдано соответствующее предупреждение.

Появятся дополнительные поля:

  • Режим отображения содержимого - это список различных вариантов выборки контента, доступных для выбранного экземпляра модуля. После изменения данного параметра в форме автоматически появятся поля данных, специфические для текущего режима отображения.

! Элемент, созданный на основе режима отображения «Внедренный объект системы» экземпляра модуля «Системные функции», не будет наследоваться между макетами страниц и должен быть создан непосредственно на макете страницы, для которого он планируется использоваться, т.к. он является специальным маркером, идентифицирующим макет страницы как пригодный для интеграции построенного на его основе контента с системными функциями Nemo.

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

Шаблон элемента модуля

Элемент страницы отвечает за подготовку данных для вывода во фронт-энд и применения к ним шаблона. Данные, которые передаются в шаблон, зависят от полей «Экземпляр модуля» и «Режим отображения содержимого».

Пример шаблона модуля «Новости» для режима «Определенная новость»:

<h1>{$data.news_title}</h1>
<p>{$data.news_content}</p>

Переменные и выражения доступные в шаблонах элементов:

Заголовок Значение
{$parent} Доступ к переменным, доступным из шаблона макета страницы или блока элементов (в зависимости от того, из какого шаблона был вызван {cms_render_element id=$element.id})
{$global} Доступ к переменным, доступным из шаблона макета страницы, в случае, если элемент был вызван из шаблона блока
{$page} Настройки макета страницы
Настройки элемента
{$id} ID элемента
{$element_name} Пользовательское имя объекта
{$element_title} Заголовок элемента
{$element_description} Описание элемента
{$element_template} Шаблон элемента
{$date_create} Дата создания
{$template_title} Заголовок шаблона

См. также

Контент
Система управления порталом (ЦМС)
Контент
Фронт-энд