Логотип

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

system order_by()

Название

%system order_by()% — Выводит ссылку для сортировки страницы каталога (или других списков, поддерживающих сортировку и фильтрацию) по указанному свойству.

Параметры: system order_by(field_name, type_id [, template = 'default'])

field_name

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

type_id

Числовой идентификатор типа объектов, которые будут сортироваться. Как правило, макросы, которые поддерживают фильтрацию и сортировку передают его через макрос %type_id%.

template

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

Описание

Макрос отвечает за вывод ссылки, по которой посетитель сайта может увидеть список элементов, отсортированный по указанному свойству field_name.

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

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

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

udata://system/order_by/ignore_discounts/772

XML-ответ UData

<udata module="system" method="order_by" generation-time="0.014137">
  <link>?&amp;order_filter[ignore_discounts]=1</link>
  <title>Игнорировать скидки</title>
</udata>

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

<link>

Параметры и значения, которые необходимо добавить к ссылке, для формирования ссылки фильтра.

<title>

Название свойства.

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

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

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

order_by

Выводит ссылку на отсортированный список по свойству, указанному в параметре field_name, если сортировка еще не совершена на текущей странице.

%link%

Выводит ссылку на страницу с отсортированным списком элементов.

%title%

Выводит название поля field_name.

order_by_a

Выводит ссылку на отсортированный список по свойству, указанному в параметре field_name, если сортировка уже совершена на текущей странице.

%link%

Выводит ссылку на страницу с отсортированным списком элементов.

%title%

Выводит название поля field_name.

Примеры использования

<?php
$FORMS = Array();

$FORMS['order_by'] = <<<END
 <a href="%link%">%title%</a>
END;

$FORMS['order_by_a'] = <<<END
 <span style="color: #000;"><b>%title%</b></span>
END;

?>