Элемент: различия между версиями
м (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} | Заголовок шаблона |