Логотип

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

vote insertvote()

Название

%vote insertvote()% — Выводит указанный опрос.

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

path

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

template

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

Описание

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

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

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

См. описание макроса %vote insertlast()%.

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

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

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

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

vote_block

Общий блок для вывода опроса.

%text%

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

%link%

Url — адрес страницы с результатами.

%lines%

Указывает место, куда будет выведен список с ответами, либо для незарегистрированных и не проголосовавших пользователей он указывает на страницу с опросом.

%submit%

Выводит кнопку «Голосовать», используя блок vote_block_submit данного шаблона.

vote_block_line

Блок для вывода каждого ответа.

%item_id%

id ответа.

%item_name%

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

%list-class-first%

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

%list-class-last%

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

%list-class-odd%

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

%list-class-even%

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

%list-position%

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

vote_block_submit

Блок для вывода кнопки «Голосовать».

%vote_not_selected%

Сообщение о том, что не выбран ни один вариант ответа.

js_block

Блок для задания javascript события при голосовании

%res%

Сообщение из блоков js_block_ok, js_block_voted или js_block_closed, в зависимости от ситуации.

js_block_ok

Блок сообщения при успешном голосовании.

js_block_closed

Блок сообщения в случае, если голосование закрыто.

js_block_voted

Блок сообщения, отображаемый в случае, если пользователь уже проголосовал в этом опросе.

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

Простой вывод опроса: %vote insertvote('/myvote/')%.

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