# =========================================================================== #
# NG CMS // Виджеты // Опросы                                                 #
# =========================================================================== #

Данный модуль позволяет вам проводить опросы Ваших посетителей.
Основные возможности:
* Одновременное проведение нескольких опросов на сайте.
* Возможность посмотреть все активные опросы на странице плагина по URL'у:
  - При включенном ЧПУ: /plugin/voting/
  - При выключенном ЧПУ: /?action=plugin&plugin=voting
* Возможность выбора режима отображения опросов:
  - Всегда отображается конкретный выбранный опрос
  - Режим ротации в котором отображается любой из активных опросов
* Для каждого опроса можно установить следующие флаги:
  - Активен: опрос виден посетителям и в нём можно голосовать
  - Закрыт: опрос виден посетителем, но голосование по нему уже невозможно
  - Только для зарегистрированных: свои голоса могут оставить только 
    зарегистрированные посетители
* Два механизма защиты от накруток:
  - Через Cookie: информация о голосовании записывается в cookie. Низкий уровень
    защиты
  - Через БД: информация о голосовании (для зарегистрированных посетителей)
    записывается в БД. Высокий уровень защиты, но требуются дополнительные SQL
    запросы
* Многоскиновый режим - вы можете создать несколько скинов для плагина и 
  в любой момент переключаться между ними в админ-панели плагина
* Возможность вручную устанавливать счётчики для каждого варианта ответа
* Возможность изменять любые параметры опроса "на лету", т.е. когда опрос уже
  отображается на сайте
* Возможность деактивации вариантов ответа. Деактивированные варианты ответа
  недоступны пользователям, но видны в панели управления плагином

>> FYI: Шаблон по умолчанию, идущий в поставке плагина, работает только в ЧПУ режиме.

==================================================================================
Скины плагина находятся в каталоге: engine/extras/voting/tpl/skins/
Каждый каталог соответствует своему скину.
Скин должен содержать следующие шаблоны:

* lshdr.tpl
  Заголовочные файл с JScript'ом, обеспечивающим генерацию AJAX запроса - вызов
  функции make_voteL(mode, vid) отрабатывающей нажатие кнопок "Голосовать"
  и "Результаты". Используется ТОЛЬКО для страницы плагина (со списком опросов).
  Доступные переменные:
  {home} - URL по которому расположен сайт

# Шаблоны для отображениея списка опросов на странице плагина:
* shls_vote.tpl
  Показать заголовок опроса (опрос в режиме просмотра)
  Доступные переменные:
  {voteid}    - ID опроса
  {votename}  - наименование опроса
  {votedescr} - описание опроса
  {votelines} - строчки опроса (создаются при помощи шаблона shls_vline.tpl)
  {home}      - URL по которому расположен сайт
  {tpl_dir}   - URL по которому расположен данный шаблон
  {vcount}    - общее кол-во принявших участие в опросе
  Доступные блоки:
  [votedescr]..[/votedescr] - содержимое блока выводится в случае, когда для опроса задано описание

* shls_vline.tpl
  Показать строку опроса (опрос в режиме просмотра)
  Доступные переменные:
  {id}        - ID строки опроса
  {name}      - название/текст строки опроса
  {num}       - номер строки опроса в списке по порядку (может использоваться для формирования
                разноцветных графических шкал)
  {count}     - кол-во голосов оставленных по данной строке
  {perc}      - процентное соотношение голосов по данной строке (числом. может использоваться
                для формирования графических шкал)
  {tpl_dir}   - URL по которому расположен данный шаблон

* edls_vote.tpl
  Показать заголовок опроса (опрос с режиме голосования)
  => Список переменных аналогичен шаблону shls_vote.tpl

* edls_vline.tpl
  Показать строку опроса (опрос в режиме голосования)
  => Список переменных аналогичен шаблону shls_vline.tpl

# Шаблоны для отображения текущего активного опроса на основной странице сайта:
* ls_vote.tpl
  Показать заголовок опроса (опрос в режиме просмотра)
  => Список переменных аналогичен шаблону shls_vote.tpl

* ls_vline.tpl
  Показать строку опроса (опрос в режиме просмотра)
  => Список переменных аналогичен шаблону shls_vline.tpl

* ed_vote.tpl
  Показать заголовок опроса (опрос с режиме голосования)
  => Список переменных аналогичен шаблону shls_vote.tpl

* ed_vline.tpl
  Показать строку опроса (опрос в режиме голосования)
  => Список переменных аналогичен шаблону shls_vline.tpl
  В случае если выбранный скин должен поддерживать AJAX, то данный
  шаблон должен в том числе содержать в себе код для генерации AJAX запроса.
