Установка и настройка

Внимание! Загружать файлы .pl на сайт нужно в режиме ASCII.

Скопируйте файлы zvote.pl, zvsetup.pl, zvotessi.pl и файлы *.gif в каталог
cgi-bin/zvote, а также создайте в нем каталог data. Установите права доступа (CHMOD) всех файлов *.pl в 755, а для каталога data 766 (Посмотрите как это сделать в документации к FTP-клиенту)

После этого запустите zvsetup.pl. При первом запуске введите пароль (он сохраняется, и после, доступ к администрации будет по этому паролю). После подтверждения URL вашего сайта, Вы увидете главную страницу администрации в ней будут отображаться все созданные вами голосования.

Добавление голосований

1. В zvsetup.pl выбирите добавить и введите данные о голосовании в формы. После ввода всех данных скрипт сгенерирует HTML и SSI-код формы. После этого вставьте полученный HTML-код (либо SSI) в вашу страничку(и).
Для использования SSI-кода:
1) ваш сервер должен поддерживать SSI;
2) измените расширение страницы на .shtm или .shtml.
3) страничка с формой должна быть на том же сервере, где и zvotessi.pl. А если добавлять HTML-код формы, то страница может находится на любом другом сервере

2. Вы можете просто создать страничку с формой голосования, а ZVote при первом ответе на эту форму, просканирует её и найдет все нужные данные.

Для корректной работы сканера-форм необходимо:
1) форма должна быть следующего формата:

Пример:
<form method=post action="http://www.you.com/cgi-bin/zvote.pl">
<table width="100%" border="1" cellspacing="0" cellpadding="0">
<tr align="center">
<td bgcolor="#0000CC">
<b><font color="#FFFFFF" size="3">Тема голосования 1</font></b>
</td></tr><tr><td height="139" bgcolor="#EEEEFF"><p>
<input type=radio name=имя_гол1 value=1><font size=2>Вариант1<br>
<input type=radio name=имя_гол1 value=2>Вариант2<br>
<input type=radio name=имя_гол1 value=n>Вариантn</font><br>
.....

<tr align="center">
<td bgcolor="#0000CC">
<b><font color="#FFFFFF" size="3">Тема голосования 2</font></b>
</td></tr><tr><td height="139" bgcolor="#EEEEFF"><p>
<input type=radio name=имя_гол2 value=1><font size=2>Вариант1<br>
<input type=radio name=имя_гол2 value=2>Вариант2<br>
<input type=radio name=имя_гол2 value=n>Вариантn</font><br>
.......
</form>
В одной форме может быть несколько тем.

Темой голосования (имя_гол1) считается ближайший к тэгу <input... name=имя_гол1> текст. В форму можно добавлять любые тэги см. пример выше
Варианты должны быть записаны в виде
<input type=(radio или сheckbox) name=имя_гол value=X>ВариантX

Имя_гол (внутренее имя голосования) - может состоять из маленьких английских букв a-z, цифр 0-9, и знака подчеркивания _. Если имя содержит другие символы оно игнорируется.

2) форма должна находится на том-же сервере, где скрипт.

Разные типы вывода

Тип вывода это код из 3 символов, например fn1. Вот что он означает:

Первый символ - сортировка результатов по количеству голосов.
n - вывод без сортировки
f - сортировка по убыванию
r - сортировка по возрастанию

Второй символ - масштабирование графика по максимальному количеству голосов.
n - без масштабирования
m - с масштабированием

Третий символ - тип результата.
1 - в процентах от общего числа голосов
2 - отставание от лидера голосования (в количестве голосов)
3 - отставание от лидера голосования (в процентах)

Для вывода результатов в нужном виде, вставьте в форму строку:
<input type=hidden name=TYPE value=xxx>

Слово TYPE только больними буквами. И маленькими буквами вместо xxx желаемый тип результатов. Например:
<input type=hidden name=TYPE value=fn1>

Проблемы

Если скрипт отказывается работать, проверьте:
1. Правильно ли указаны права доступа CHMOD 755 для файлов .pl
2. Убедитесь, что файлы загружались в ASCII режиме
3. Если путь к Perl отличается от /usr/bin/perl, исправьте в файлах .pl первую строку #!путь к Perl.

Если у вас возникнут какие-то проблемы или трудности
пишите на email или в форуме на моём сайте.