Плагин опроса для WordPress - Democracy Poll

Democracy Polls - альтернатива плагину WP-Polls, плагину для создания опроса(ов) на движке WordPress.

Сегодня хочу рассказать об уже, наверное, забытом и мало используемом плагине опросов Democracy Polls. Забегая вперед скажу, что функциональными преимуществами над WP-polls этот плагин не обладает, однако он намного проще и соответственно менее требовательнее к системе и в целом удовлетворяет всем основным требованиям которым должен отвечать опрос на сайте. Так же в Democracy Polls можно разрешить посетителям добавлять свои ответы, собственно, поэтому он так и называется.

Автором Democracy Polls является Andrew Sutherland (страница плагина). Поддержка плагина прекращена, последняя версия 2.0.1 была выпущена в 2006 году. Тем не менее плагин продолжает успешно функционировать, потому что код написан просто, грамотно и лаконично - это мне и понравилось в этом плагине.

Страница Админки Democracy

Возможности плагина опроса для WordPress Democracy:

1. Можно вставлять опросы в тело поста, для этого вставьте в текст: {democracy:12} 12 - ID опроса;
2. Поддержка виджетов. Виджет democracy активируется отдельно в плагинах. За виджет отвечает файл widget_democracy.php;
3. Контроль голосовавших через куки и IP (контроль IP адреса можно выключить);
4. Редактирование всех настроек в Админ-панели. Можно: создавать, удалять и редактировать опросы;
5. Можно разрешить добавлять ответы посетителям.

Плюс к этим возможностям я внес некоторые изменения в этот плагин:

1. Добавил возможность отключить подгрузку css и JS файлов плагина, с последующим переносом их в свои css и JS файлы;
2. Собрал все настройки плагина в один массив, чтобы получать настройки одним обращением к кешу;
3. Добавил склонение для русского языка ( 3 голоса, 20 голосов );
4. Жестко (в коде) перевел плагин на русский язык;
5. Исправил Баг с добавлением тегов к опросу в посте (опрос обрамляется тегом <div>, для валидности кода).

Скачать плагин

Плагин опроса для WordPress(democracy.zip)Размер: 23.04 KB / дата: 14.Мар.2011

Установка плагина

1. Загрузите папку democracy (из архива) в каталог плагинов WordPress (/wp-content/plugins/)
2. В раздел "Плагины" у вас появится два новых "плагина": Democracy (Kama-fix) и Democracy Widget. Активируйте плагин и если вы используете виджеты активируйте Democracy Widget (если виджет не нужен, то можно удалить файл widget_democracy.php из архива).
3. Зайдите в настройки плагина (записи > Опрос Democracy) и создайте свой первый опрос.

Использование плагина

1. Чтобы вставить опрос в тело поста нужно добавить в запись такой шоткод: {democracy:*}, где * - это ID опроса. Если нужно использовать активный (текущий) опрос то используйте шоткод:  {democracy}
2. Чтобы вывести активный (устанавливается в настройках) опрос в сайдбар: если вы активировали виждет, то опрос выводится через виджет. Если вы не используетете виджеты, то вставьте в шаблон следующий код, который выведет активный опрос:

   <?php jal_democracy() ?>

3. Если нужно создать страницу архива опросов, то используйте в тексте поста/страницы такой шоткод, который выведет архив опросов: {democracy_archives}

Расширенное использование

Функция jal_democracy() может принимать 3 параметра:

1. ID - Идентификатор опроса, который вы хотите вывести;
2. $before_title - HTML код перед заголовком (вопросом) опроса. Если не указывать этот параметр, то берется код из настроек;
3. $after_title - тоже самое что $before_title, только после заголовка.

Создание объекта Democracy

Плагин использует класс Democracy, для создания опроса, поэтому можно создать новый объект так:

$poll = new Democracy($id, $before_title, $after);
// используется такие же переменные, что и в функции <?php jal_democracy() ?>

Создание объекта может пригодится для того, чтобы не выводить на экран полученный опрос, а использовать его для дальнейших действий.
Чтобы вывести на экран полученный порос нужно использовать метод display

$poll->display($showVoteScreen);
// $showVoteScreen - это параметр boolen типа, который отвечает какой вариант опроса выводить: опрос открыт (можно голосовать) или опрос закрыт (голосовать нельзя)
// По умолчанию true - опрос открыт

Использование функции jal_democracy_archives()

Эта функция используется для вывода архива опросов, т.е. всех, когда либо, созданных опросов в порядке их создания (последний созданный опрос наверху)
Параметры:

1. $show_current - boolen тип, по умолчанию false, если поставить true, то в архив опросов будет добавлен текущий активный опрос, который будет открыт к голосованию и будет расположен вверху;
2. $before_title - HTML перед заголовком для каждого опроса из архива;
3. $after_title - HTML после заголовка для каддого опроса из архива.

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

1. Функция jal_democracy()

<?php jal_democracy(25, '<div class="title">', '</div>'); ?>

Этот пример выведет опрос с ID 25 и обвернет заголовок опроса в <div class="title"> и </div>

2. Использование объекта

<?php
	$poll = new Democracy(9, '<h3>', '</h3>');
	$poll->active = false;
	echo $poll->display(false);
?>

Этот пример выведет опрос 9 и заголовок будет выглядеть как: <h3>Вопрос Опроса</h3>. $poll->active = false - деактивирует активность опроса, т.е. будут показаны только результаты опроса без возможности голосовать, если убрать эту строчку, то не голосовавшие смогут проголосовать.

3. Функция jal_democracy_archives()

<?php jal_democracy_archives(true, '<strong>', '</strong>'); ?>

Этот пример выведет список всех прошлых опросов, голосование у которых будет закрыто.