Логотип

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

news lastlents()

Название

%news lastlents()% — Выводит список лент новостей в определенном разделе.

Параметры: news lastlents(element_path [, template = 'default', per_page = '10', ignore_paging = '0'])

element_path

Путь до раздела сайта, либо id раздела сайта, из которого следует брать ленты новостей для вывода. Можно указать несколько путей до разделов (через знак пробела).

template

Имя шаблона, по которому следует вывести список лент новостей.

В XSLT-шаблонизаторе игнорируется.

per_page

Число, которое обозначает максимальное количество лент новостей. Если этот параметр не указывать, будет взято значение, указанное в настройках модуля «Новости».

ignore_paging

Булево значение («1» или «0»), указывающее макросу игнорировать значение текущей страницы списка вывода (параметр http-запроса p). То есть, если указать «1», макрос будет всегда выводить только первую страницу списка новостей (количество на странице определяется параметром per_page макроса). Как правило, данный параметр применяют, когда на той же странице сайта есть макрос, использующий постраничный вывод (например, сообщения форума), и его текущая страница не должна влиять на текущую страницу списка новостей (например, когда по логике сайта на любой странице списка сообщений форума должны выводиться 3 самые свежие новости).

Описание

Выводит список лент новостей раздела сайта или из нескольких разделов сайта, указанных в параметре element_path. Количество выводимых лент новостей можно вручную ограничить параметром per_page.

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

Пример вызова

udata://news/lastlents/(vse_novosti)/notemplate/10/0

XML-ответ UData

<udata module="news" method="lastlents" generation-time="0.007748">
  <items>
    <item id="34" link="/vse_novosti/novosti_sajta/" xlink:href="upage://34">
      Новости сайта
    </item>
    <item id="38" link="/vse_novosti/novosti_mira_homyachkov/" xlink:href="upage://38">
      Новости мира хомячков
    </item>
  </items>
  <total>2</total>
  <per_page>3</per_page>
</udata>

Элементы и атрибуты

<items>

Ветвь, включающая элементы <items> — ленты новостей в данном разделе.

<item>

Элемент, содержащий данные об отдельной ленте в данном разделе. Значение элемента — название ленты.

@id

Идентификатор ленты.

@link

Ссылка на страницу ленты.

@xlink:href

Ссылка UPage на страницу ленты.

<total>

Общее количество элементов — лент новостей в данном разделе.

<per_page>

Количество элементов, отображаемых на странице.

Вывод списка последних новостей осуществляется по шаблону, указанному в параметре template. Вы можете не указывать этот параметр, в этом случае для вывода списка лент новостей будет использован шаблон по умолчанию — default.tpl.

Пример вызова

%news lastlents('vse_novosti', 'default', 10, 0)%

Используемые шаблоны

Макрос оперирует шаблонами, находящимися в каталоге /tpls/news/.

Используемые блоки шаблона

listlents_block

Выводит блок оформления при выводе списка лент новостей.

%items%

Выводит список лент новостей, используя блок listlents_item .

%total%

Выводит общее количество лент новостей. Можно использовать для макроса %system numpages()% .

%per_page%

Выводит значение параметра per_page. Можно использовать для макроса %system numpages()% .

listlents_block_empty

Используется вместо блока listlents_block в том случае, если нет новостных лент, которые необходимо вывести.

listlents_item

Выводит отдельную ленту новостей в списке.

%id%

id выводимой ленты новостей.

%name%

Название выводимой ленты новостей.

%link%

Ссылка на выводимую ленту новостей.

%list-class-first%

в случае, если элемент первый, выводит "first"

%list-class-last%

в случае, если элемент последний, выводит "last"

%list-class-odd%

в случае, если элемент четный, выводит "odd"

%list-class-even%

в случае, если элемент нечетный, выводит "even"

%list-position%

вставляет порядковый номер в списке