Логотип

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

vote setElementRating()

Название

%vote setElementRating()% — Учитывает голос пользователя в рейтинге.

Параметры: vote setElementRating([template = "default"], elementId, bid)

template

Имя шаблона, по которому следует вывести результаты. В XSLT-шаблонизаторе игнорируется.

elementId

Идентификатор страницы, которую оценивает пользователь.

bid

Выбранная пользователем оценка.


Описание

Для страницы с идентификатором elementId устанавливается рейтинг - оценка, переданная в параметре bid в случае, если пользователь еще не голосовал. В противном случае выводится соответствующее сообщение.


Примечание: Для переключения режима рейтингования с 2-балльного на 5-балльный воспользуйтесь опцией Сделать 5-балльные рейтинги в Настройках модуля "Опросы".

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

udata://vote/setElementRating/notemplate/3/3

XML-ответ UData


<udata module="vote" method="setElementRating" generation-time="0.053591">
	<element_id>3/<element_id>
	<rate_sum>5</rate_sum>
	<rate_voters>1</rate_voters>
	<rate>5</rate>
	<ceil_rate>5</ceil_rate>
</udata>

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

element_id

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

rate_sum

Суммарный рейтинг данной страницы.

rate_voters

Количество пользователей, которые проголосовали на данной странице.

rate

Текущий рейтинг.

ceil_rate

Округленное значение рейтинга.

 

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

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

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

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

rate_permitted

Отвечает за вывод сообщения о том, что голосование запрещено для неавторизованного пользователя .

%element_id%

id страницы.

%rate_sum%

Суммарный рейтинг.

%rate_voters%

Количество проголосовавших.

%rate%

Текущий рейтинг.

%ceil_rate%

Округленное значение рейтинга.

rate_not_found

Отвечает за вывод сообщения об ошибке при голосовании.

rate_ok

Отвечает за вывод сообщения об успешном голосовании.

rate_rated

Отвечает за вывод рейтинга для пользователя, который уже проголосовал.

%element_id%

id страницы.

%rate_sum%

Суммарный рейтинг.

%rate_voters%

Количество проголосовавших.

%rate%

Текущий рейтинг.

%ceil_rate%

Округленное значение рейтинга.