Модуль позволяет проводить опросы, состоящие из одного вопроса и 10 фиксированных ответов. Имеется возможность включить альтернативный вариант ответа - текстовое поле, куда голосующий может внести свой вариант.
При создании голосования можно указать:
• право пользователя выбирать несколько вариантов ответа или только один;
• используется ли альтернативный вариант ответа;
• альтернативное значение (надпись) на кнопке голосования;
• условия голосования: один голос с одного IP, cookie, голосуют только зарегистрированные в системе пользователи.
Помимо вспомогательных скриптов, модуль содержит компонент «Опросы». После успешной установки модуля вам будет предложено создать раздел «Опросы» (ссылка «завершение установки» в разделе Модули). К этому разделу будет автоматически подключен соответствующий компонент. Вы также можете подключить этот компонент к любому другому разделу.
Управление модулем осуществляется при помощи стандартного механизма компонентов. Каждый опрос представляет собой объект определенного компонента. Соответственно, можно настраивать модуль, используя все возможные механизмы настройки компонента: изменять формат отображения результатов, выносить опрос на титульную страницу, менять внешний вид опроса в зависимости от подаваемых параметров и пр.
Используемые функции:
• poll_alreadyAnswered($classID, $PollID,$ProtectIP,$ProtectUsers)
Функция проверяет, участвовал ли пользователь в указанном опросе. Проверка происходит по номеру компонента $classID и номеру опроса $PollID, есть ли cookie у пользователя на компьютере. Если $ProtectIP равна 1, то проверяется и IP голосующего. Если $ProtectUsers равна 1, то проверяется, авторизован ли пользователь (по его ID).
• poll_percentLine ($classID, $PollID, $AnswerCount, $MaxWidth, $template)
Функция рисует линию, ширина которой в шаблоне $template соответствует количеству голосов ($AnswerCount), отданных за данный ответ. Максимальная ширина линии задается переменной $MaxWidth. $classID и $PollID – номер компонента и номер опросника соответственно.
В шаблоне $template можно использовать макросы %WIDTH% – ширина линии и %PERCENT% - количество отданных голосов за данный ответ в процентах.
Функция предназначена для использования в компоненте «Опросник».
Пример использования функции:
В качестве результата мы получаем:
Да (23%)
====
Нет (77%)
===============
• poll_alternativeAnswer($classID, $PollID)
Функция выводит список альтернативных вариантов ответа на вопрос с номером $PollID из компонента $classID.