Элемент: различия между версиями
(не показаны 4 промежуточные версии 2 участников) | |||
Строка 1: | Строка 1: | ||
[[Категория:Термины]] | [[Категория:Термины]] | ||
+ | <!-- --> | ||
+ | '''Элемент макета страницы''' в {{NameSystem}} в общем случае выполняет функции по выбору контента, введенному пользователем CMS (см. [[Контент#Редактор контента CMS|Редактор контента]]), удовлетворяющему настройкам элемента и формированию выходного HTML-потока с применением шаблона для подстановки его в место, указанное в макете страницы. | ||
+ | |||
+ | Для группировки HTML-потоков, формируемых элементами с применением шаблона, используются блоки элементов. Для этого в настройках элемента следует указать, к какому блоку он относится. | ||
+ | |||
+ | == Настройки элемента макета страниц == | ||
+ | * {{Setting|Заголовок}} — заголовок элемента. | ||
+ | * {{Setting|Описание}} — описание элемента. | ||
+ | * {{Setting|Информационный блок}} — блок, в котором будет отображаться элемент. | ||
+ | * {{Setting|Пользовательское имя объекта}} — имя объекта, по которому можно будет обратиться к нему из шаблона страницы. Если имя задано, то в процессе наследования элементов макета страницы элементы с одинаковыми именами будут заменяться, а не добавляться к ранее существующим. | ||
+ | * {{Setting|Режим создания объекта}} — данный параметр влияет на поведение объекта при наследовании элементов макета страниц. Если указано «Наследовать далее», то данный элемент будет наследоваться, иначе он будет создан только при формировании HTML-потока во фронт-энде и только на основе текущего макета. | ||
+ | * {{Setting|Экземпляр модуля}} — экземпляр модуля, из которого будет выбираться [[контент]] для вывода текущим элементом. | ||
+ | * {{Setting|Язык элемента}} — если выбрать какой-либо язык, то данный элемент будет отображаться только в случае, если язык системы совпадет с текущим. | ||
+ | * {{Setting|Задействовать расписание}} — если выбран данный пункт, то элемент будет отображаться только в указанный интервал дат. | ||
+ | * {{Setting|Включено}} — включить или выключить элемент. | ||
+ | |||
+ | == Создание элемента == | ||
+ | |||
+ | Элемент создается в 2 этапа. | ||
+ | |||
+ | После того, как вы нажмете кнопку «Создать», элемент перейдет в режим настройки дополнительных параметров, о чем будет выдано соответствующее предупреждение. | ||
+ | |||
+ | Появятся дополнительные поля: | ||
+ | |||
+ | * {{Setting|Режим отображения содержимого}} — это список различных вариантов выборки контента, доступных для выбранного экземпляра модуля. После изменения данного параметра в форме автоматически появятся поля данных, специфические для текущего режима отображения. | ||
+ | |||
+ | {{Attention|Элемент, созданный на основе режима отображения «Внедренный объект системы» экземпляра модуля «Системные функции», не будет наследоваться между макетами страниц и должен быть создан непосредственно на макете страницы, для которого он планируется использоваться, т.к. он является специальным маркером, идентифицирующим макет страницы как пригодный для интеграции построенного на его основе контента с системными функциями {{NameSystem}}.}} | ||
+ | |||
+ | * {{Setting|Шаблон}} — шаблон, который будет применен к контенту; | ||
+ | |||
+ | * {{Setting|Фильтр}} — дополнительные фильтры, с помощью которых можно управлять видимостью элемента специфичным для определенного фильтра образом. | ||
+ | |||
+ | == Шаблон элемента модуля == | ||
+ | |||
+ | Элемент страницы отвечает за подготовку данных для вывода во [[фронт-энд]] и применения к ним шаблона. Данные, которые передаются в шаблон, зависят от полей «Экземпляр модуля» и «Режим отображения содержимого». | ||
+ | |||
+ | === Пример шаблона модуля «Новости» для режима «Определенная новость» === | ||
+ | |||
+ | <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> | ||
+ | |||
+ | == См. также == | ||
+ | * [[Система управления порталом (ЦМС)]] | ||
+ | * [[Контент]] | ||
+ | * [[Фронт-энд]] |
Текущая версия на 22:49, 5 февраля 2016
Элемент макета страницы в Nemo.Travel в общем случае выполняет функции по выбору контента, введенному пользователем CMS (см. Редактор контента), удовлетворяющему настройкам элемента и формированию выходного HTML-потока с применением шаблона для подстановки его в место, указанное в макете страницы.
Для группировки HTML-потоков, формируемых элементами с применением шаблона, используются блоки элементов. Для этого в настройках элемента следует указать, к какому блоку он относится.
Содержание
Настройки элемента макета страниц
- Заголовок — заголовок элемента.
- Описание — описание элемента.
- Информационный блок — блок, в котором будет отображаться элемент.
- Пользовательское имя объекта — имя объекта, по которому можно будет обратиться к нему из шаблона страницы. Если имя задано, то в процессе наследования элементов макета страницы элементы с одинаковыми именами будут заменяться, а не добавляться к ранее существующим.
- Режим создания объекта — данный параметр влияет на поведение объекта при наследовании элементов макета страниц. Если указано «Наследовать далее», то данный элемент будет наследоваться, иначе он будет создан только при формировании HTML-потока во фронт-энде и только на основе текущего макета.
- Экземпляр модуля — экземпляр модуля, из которого будет выбираться контент для вывода текущим элементом.
- Язык элемента — если выбрать какой-либо язык, то данный элемент будет отображаться только в случае, если язык системы совпадет с текущим.
- Задействовать расписание — если выбран данный пункт, то элемент будет отображаться только в указанный интервал дат.
- Включено — включить или выключить элемент.
Создание элемента
Элемент создается в 2 этапа.
После того, как вы нажмете кнопку «Создать», элемент перейдет в режим настройки дополнительных параметров, о чем будет выдано соответствующее предупреждение.
Появятся дополнительные поля:
- Режим отображения содержимого — это список различных вариантов выборки контента, доступных для выбранного экземпляра модуля. После изменения данного параметра в форме автоматически появятся поля данных, специфические для текущего режима отображения.
Внимание! Элемент, созданный на основе режима отображения «Внедренный объект системы» экземпляра модуля «Системные функции», не будет наследоваться между макетами страниц и должен быть создан непосредственно на макете страницы, для которого он планируется использоваться, т.к. он является специальным маркером, идентифицирующим макет страницы как пригодный для интеграции построенного на его основе контента с системными функциями Nemo.Travel.
- Шаблон — шаблон, который будет применен к контенту;
- Фильтр — дополнительные фильтры, с помощью которых можно управлять видимостью элемента специфичным для определенного фильтра образом.
Шаблон элемента модуля
Элемент страницы отвечает за подготовку данных для вывода во фронт-энд и применения к ним шаблона. Данные, которые передаются в шаблон, зависят от полей «Экземпляр модуля» и «Режим отображения содержимого».
Пример шаблона модуля «Новости» для режима «Определенная новость»
<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} | Заголовок шаблона |