Логотип

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

vote results()

Название

%vote results()% — Выводит результаты опроса.

Параметры: vote results([path = ', template = 'default'])

path

id или путь к опросу от корня сайта.

template

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

Описание

Макрос выводит результаты опроса, указанного в параметре path. Path может представлять собой id опроса, либо путь к опросу от корня сайта. Если path — пустая строка, то берется id текущей страницы.

Для корректной работы необходимо, чтобы к странице был подключен скрипт guest.js.

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

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

udata://vote/results/39

XML-ответ UData

<udata module="vote" method="insertlast" generation-time="0.053591"> 
  <id>39</id> 
  <text>Какой ваш любимый цвет?</text> 
  <alt_name>lyubimyj_cvet</alt_name> 
  <items> 
    <item score="2" score-rel="13">красный</item> 
    <item score="8" score-rel="50">синий</item> 
    <item score="5" score-rel="31">зеленый</item> 
    <item score="1" score-rel="6">фиолетовый</item> 
  </items> 
  <total_posts>16</total_posts> 
  <link>/lyubimyj_cvet/</link> 
</udata> 

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

id

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

text

Текст вопроса.

alt_name

Имя страницы в URL.

items

Ветвь, описывающая варианты ответов на вопрос со статистикой по частоте — элементы item.

item

Вариант ответа на вопрос.

@score

Статистика по этому варианту ответа: общее число проголосовавших.

@score-rel

Статистика по этому варианту ответа: относительное количество проголосовавших в процентах.

total_posts

Общее число проголосовавших в данном опросе.

link

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

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

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

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

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

result_block

Общий блок для вывода результатов голосования.

%question%

Текст опроса.

%total_posts%

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

%lines%

Указывает место, куда будет выведен список с результатами по каждому ответу.

result_block_line

Блок для вывода каждого результата.

%item_name%

Текст ответа.

%item_result%

Количество голосов.

%item_result_proc%

Относительное количество голосов в процентах.

%item_result_proc_reverce%

Тоже, что и «item_result_proc», но цифра получается вычитанием: «100 — item_result_proc».

%list-class-first%

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

%list-class-last%

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

%list-class-odd%

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

%list-class-even%

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

%list-position%

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

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

Простой вывод результатов опроса: %vote results('/myvote/')%.

Простой вывод результатов по пользовательскому шаблону: %vote results('/myvote/', 'sample')%.