Документация по макросам и шаблонам UMI.CMS

Предположим, что мы хотим вывести в качестве названия поле h1 для этой страницы и id у этой страницы равен "2". Тогда мы можем получить значение поля, воспользовавшись протоколом Upage. Запросим интересующее нас свойство h1, добавив к запросу ".h1" и выведем результат с помощью value-of:

<xsl:value-of select="document('upage://2.h1')/udata/property/value" />

Структуру возвращаемых xml-данных можно посмотреть, набрав в адресной строке:

http://ваш_сайт/upage/2.h1

Для получения списка лент новостей воспользуемся макросом %news lastlents()%: укажем id страницы раздела, объединяющего ленты ("2"), укажем количество отображаемых названий (предположим, равное "10") и установим значение параметра ignore_paging равное "1" (см. описание макроса).

Для понимания структуры возвращаемых макросом xml-данных, наберите в адресной строке:

http://ваш_сайт/udata/news/lastlents/(2)/notemplate/10/1

В полученном ответе нас интересует ветвь items, в которой к каждому элементу item нам необходимо применить уже свой шаблон — для оформления ссылки с названия ленты. Поэтому мы воспользуемся инструкцией apply-templates и опишем дополнительный шаблон для item (для этого шаблона зададим отдельный mode="news.lents.menu").

Кроме того, нужно предусмотреть варианты "подсветки" текущей ленты, в которой мы в данный момент находимся: либо на странице просмотра ленты, либо на странице просмотра полного текста новости из этой ленты. Для реализации этого вызовем apply-templates с 2 параметрами:

В итоге добавляем вызов шаблона:

<xsl:apply-templates select="document('udata://news/lastlents/(2)/notemplate/10/1')/udata/items" mode="news.lents.menu">
  <xsl:with-param name="thispage-link" select="page/@link"/>
  <xsl:with-param name="parentpage-id" select="parents/page/@id"/>
</xsl:apply-templates>

И добавляем сам шаблон, обрабатывающий каждый элемент item:

<xsl:template match="item" mode="news.lents.menu">
  <param name="thispage-link" />
  <param name="parentpage-id" />
  <li>

   <a href="{@link}">

     <xsl:if test="@link = $thispage-link or @id = $parentpage-id">
       <xsl:attribute name="class">current</xsl:attribute>
     </xsl:if>
   
   <xsl:value-of select="." />
  </a>

  </li>
</xsl:template>

Конструкция <xsl:if>...</xsl:if> проверяет является ли обрабатываемый элемент лентой, страницу которой мы открыли, либо лентой являющейся родительской для открытой страницы. В этих случаях к тегу <a>, содержащему элемент списка, добавляется атрибут class="current", который мы можем описать по своему усмотрению в CSS.

Сведения о том, кем была открыта страница сайта можно получить, обратившись к элементу user в полученных xml-данных UMI Data. В случае запроса страницы авторизованным пользователем у элемента user появляется атрибут status="auth".

Добавим соответствующий вызов шаблона со своим собственным mode="dispatches.for-auth":

<xsl:apply-templates select="user[@status = 'auth']" mode="dispatches.for-auth" /> 

Этот шаблон мы вынесем в отдельный файл, который мы уже подключили выше к default.xsl. Пример создания рабочих шаблонов рассылок описан в отдельной главе данной документации: Подписка на рассылки с сайта средствами XSLT-шаблонизатора.

Заголовок ленты мы можем узнать из переданных xml-данных UMI Data (в этом шаблоне мы обрабатываем ветку page):

<h1>
  <xsl:value-of select="properties/group/property[@name = 'h1']/value" />
</h1>

Атрибуты элемента user позволяет узнать, каким пользователем открыта данная страница. Поэтому в этом месте вставим следующую инструкцию:

<xsl:apply-templates select="/result/user[not(@status = 'auth')]" mode="dispatches.for-guest" />

Пример составления шаблона можно изучить здесь: Подписка на рассылки с сайта средствами XSLT-шаблонизатора

Для получения списка анонсов вызываем макрос %news lastlist()% c переданным параметром и обрабатываем ветку items:

<xsl:apply-templates select="$doc-newspage/udata/items" mode="news.lents" />

Теперь нужно описать шаблон обработки результатов макроса. Ситуация практически аналогичная описанной выше в топике «Лента новостей на главной странице сайта». Отличие заключается в том, что здесь нам нужно отобразить также текст анонса новости, которого нет в ответе макроса.

Поэтому добавим шаблон обработки:

<xsl:template match="item" mode="news.lents">

  <li>
    <div class="date">
      <xsl:value-of select="document(concat('udata://system/convertDate/', @publish_time, '/(d.m.Y)/'))/udata"/>
    </div>

    <a href="{@link}">
      <xsl:value-of select="." />
    </a>

    <div class="anons">
      
    </div>

    <div>
      <a href="{@link}#comments" class="comments">Комментарии</a> 
      (<xsl:value-of select="document(concat('udata://comments/countComments/', @id))/udata" />)
    </div>
  </li>

</xsl:template>

Для получения анонса новости воспользуемся протоколом Upage («Страницы: протокол UPage») — запросим страницу новости, добавив к запросу ".anons," и передадим id обрабатываемого элемента:

<xsl:value-of select="document(concat('upage://', @id, '.anons'))/udata/property/value" disable-output-escaping="yes" />

Если вы хотите, чтобы в анонсах отображалась html-разметка необходимо добавить атрибут disable-output-escaping="yes". Если опустить этот атрибут, все html-теги будут экранированы и отображены как текст.

Реализация простейшего постраничного вывода описана в отдельной статье: Постраничный вывод (пейджинг) стредствами XSLT-шаблонизатора.

Заголовок новости — это значение элемента value ветки property c атрибутом name='h1':

<h1>
  <xsl:value-of select="page/properties/group/property[@name = 'h1']/value" />
</h1>

Дата публикации доступна в ветке property с атрибутом name="publish_time" у элемента value в значении атрибута unix-timestamp формата UMI Data. Для вывода ее в нужном нам формате, как и на главной странице сайта и на страницах лент, воспользуемся макросом %system convertDate()%:

<div class="date">
  <xsl:value-of select="document(concat('udata://system/convertDate/', page/properties/group/property/value/@unix-timestamp, '/(d.m.Y)/'))/udata"/>
</div>

Полный текст новости — это контент страницы новости. Поэтому мы выведем значение элемента value ветки property с атрибутом name="content" формата UMI Data:

<div class="content">
  <xsl:value-of select="page/properties/group/property[@name = 'content']/value" disable-output-escaping="yes"/>
</div>

Здесь также обратите внимание на атрибут disable-output-escaping="yes", который в данном случае необходим для отображения html-разметки текста новости.

Здесь надо предусмотреть несколько возможных вариантов, под которые мы напишем отдельные шаблоны:

В формате UMI Data есть два элемента, отвечающих за текст ссылки, и за саму ссылку: это элемент property с атрибутом name="source" и элемент property с атрибутом name="source_url".

Добавим правило применения шаблонов с условием, что хотя бы один из этих элементов присутствует и со своим собственным mode="news.source":

<xsl:apply-templates select="page/properties/group[property[@name = 'source' or @name = 'source_url']]" mode="news.source" />

Теперь опишем шаблоны для каждого случая:

Для отображения списка комментариев воспользуемся макросом %comments insert()%, которому мы передадим id страницы полного текста новости, полученный из значения одноименного атрибута элемента page:

<xsl:apply-templates select="document(concat('udata://comments/insert/', page/@id))/udata" mode="comments.list" />

Пример работающих шаблонов отображения списка комментариев можно посмотреть в главе: Комментарии средствами XSLT-шаблонизатора.

Поскольку мы хотим предусмотреть разные варианты форм для зарегистрированных пользователей сайта, и для гостей, то применим инструкцию apply-templates по ветке user и передадим в качества параметра id страницы:

<xsl:apply-templates select="user" mode="comments.add">
  <xsl:with-param name="page-id" select="page/@id"/>
</xsl:apply-templates>

Описание самих шаблонов отображения форм описано в отдельной главе, посвященной модулю "Комментарии": Комментарии средствами XSLT-шаблонизатора.