Размещен: /Polls/Polls.class.php
Описание
Класс модуля "Опросы"
mixed CopyPoll()
mixed CopyPollGroup()
mixed CopyPollReply()
boolean DelPollsGroup()
boolean del_poll()
boolean del_poll_reply()
string GenXml4Poll()
resource GetAllPollReply()
array GetAllPolls()
array GetAllPollsGroups()
int GetCountPolls()
int GetCountPollsGroup()
array GetGroupPollsWithConditions()
mixed GetPoll()
array GetPollsGroup()
string get_polls_name()
bool IncPollReply()
mixed InsertGroupPolls()
boolean InsertVote()
mixed insert_poll()
int insert_poll_reply()
resource SelectPollReply4Poll()
resource select_poll()
resource select_poll_reply()
void ShowPoll()
void ShowPollResult()
void ShowPolls()
void ShowPollsGroup()
mixed UpdateGroupPolls()
void vote_result()
CopyPoll( int $poll_id, [array $param = array()] );
Описание
Копирование опроса
Принимаемые параметры
$poll_id
Идентификатор опроса
$param
Массив дополнительных параметров
Возвращает
Идентификатор скопированной записи или false
[ Наверх ]
CopyPollGroup( int $poll_group_id, [int $site_id = false], [int $new_structure_id = false] );
Описание
Копирование группы опросов
Принимаемые параметры
$poll_group_id
Идентификатор группы опросов
$site_id
идентификатор сайта, на который нужно скопировать группу опросов, если не передан, берется текущий
$new_structure_id
идентификатор структуры, которой будет присвоена скопированная группа опросов, если не передан, берется текущая
<?php $polls = new polls(); $poll_group_id = 1; $newid = $polls->CopyPollGroup($poll_group_id); // Распечатаем результат echo $newid; ?>
Возвращает
Идентификатор скопированной записи или false
[ Наверх ]
CopyPollReply( int $poll_reply_id, [array $param = array()] );
Описание
Копирование ответа на опрос
Принимаемые параметры
$poll_reply_id
$param
Массив параметров
<?php $polls = new polls(); $poll_reply_id = 1; $newid = $polls->CopyPollReply($poll_reply_id); // Распечатаем результат echo $newid; ?>
Возвращает
Идентификатор скопированной записи или false
[ Наверх ]
DelPollsGroup( int $polls_group_id );
Описание
Метод удаления групп опросов
Принимаемые параметры
$polls_group_id
идентификатор удаляемой группы опросов
<?php $polls = new polls(); $polls_group_id = 1; $result = $polls->DelPollsGroup($polls_group_id); if ($result) { echo "Удаление выполнено успешно"; } else { echo "Ошибка удаления"; } ?>
Возвращает
true в случае успешного выполнения метода, false - в противном случае
[ Наверх ]
del_poll( int $poll_id );
Описание
Метод удаления опроса
Принимаемые параметры
$poll_id
– идентификатор удаляемого опроса
Возвращает
true в случае успешного выполнения метода, false - в противном случае
[ Наверх ]
del_poll_reply( int $poll_reply_id );
Описание
Метод удаления варианта ответа
Принимаемые параметры
$poll_reply_id
– идентификатор удаляемого варианта ответа
<?php $polls = new polls(); $poll_reply_id = 9; $result = $polls->del_poll_reply($poll_reply_id); if ($result) { echo "Удаление выполнено успешно"; } else { echo "Ошибка удаления"; } ?>
Возвращает
true в случае успешного выполнения метода, false - в противном случае
[ Наверх ]
GenXml4Poll( int $poll_id, [array $row = array()], [array $param = array()] );
Описание
Формирование XML для опроса
Принимаемые параметры
$poll_id
идентификатор опроса
$row
ассоциативный массив с информацией о опросе *
$param
ассоциативный массив параметров
<?php $polls = new polls(); $poll_id = 1; $newxml = $polls->GenXml4Poll($poll_id); // Распечатаем результат echo htmlspecialchars($newxml); ?>
Возвращает
XML
[ Наверх ]
GetAllPollReply( int $poll_id );
Описание
Получение списка всех ответов на опрос
Принимаемые параметры
$poll_id
<?php $polls = new polls(); $poll_id = 1; $resource = $polls->GetAllPollReply($poll_id); // Распечатаем результат while($row = mysql_fetch_assoc($resource)) { print_r($row); } ?>
[ Наверх ]
GetAllPolls( [array $param = array()] );
Описание
Получение информации обо всех опросах
Принимаемые параметры
$param
массив с параметрами выборки
<?php $polls = new polls(); $param['poll_group_id'] = 1; $param['poll_begin'] = 1; $param['polls_on_page'] = 2; $row = $polls->GetAllPolls($param); // Распечатаем результат print_r ($row); ?>
Возвращает
массив с результатом выборки или false
[ Наверх ]
GetAllPollsGroups( mixed $site_id, [int $structure_id = false] );
Описание
Получение информации о всех группах опросов
Принимаемые параметры
$site_id
идентификатор сайта, для групп опросов которого необходимо
$structure_id
идентификатор узла структуры, если не передан учет структуры не происходит
<?php $polls = new polls(); $site_id = CURRENT_SITE; $resource = $polls->GetAllPollsGroups($site_id); // Распечатаем результат while($row = mysql_fetch_assoc($resource)) { print_r($row); } ?>
[ Наверх ]
GetCountPolls( int $group_id );
Описание
Получение числа опросов в группе
Принимаемые параметры
$group_id
идентификатор группы
<?php $polls = new polls(); $group_id = 1; $result = $polls->GetCountPolls($group_id); // Распечатаем результат echo $result; ?>
Возвращает
число опросов в группе
[ Наверх ]
GetCountPollsGroup( int $site_id );
Описание
Получение числа групп опросов для одного или всех сайтов
Принимаемые параметры
$site_id
идентификатор сайта, для которого необходимо получить число групп опросов,
если $site_id = false, то получаем число групп опросов всех сайтов
<?php $polls = new polls(); $site_id = CURRENT_SITE; $result = $polls->GetCountPollsGroup($site_id); // Распечатаем результат echo $result; ?>
Возвращает
число групп опросов
[ Наверх ]
GetGroupPollsWithConditions( [array $param = array()] );
Описание
Метод для получения списка групп с запросами по условиям
Принимаемые параметры
$param
дополнительные условия
Возвращает
с результатом выборки или false
[ Наверх ]
GetPoll( int $poll_id );
Описание
Метод возвращает данные об опросе
Принимаемые параметры
$poll_id
– идентификатор опроса
Возвращает
ассоциативный массив с данными об опросе или false, если опрос не найден
[ Наверх ]
GetPollsGroup( int $polls_group_id, [array $param = array()] );
Описание
Получение информации о группе опросов
Принимаемые параметры
$polls_group_id
идентификатор группы опросов, о которой необходимо получить данные
$param
ассоциативный массив параметров
<?php $polls = new polls(); $polls_group_id = 2; $row = $polls->GetPollsGroup($polls_group_id); // Распечатаем результат print_r ($row); ?>
Возвращает
ассоциативный массив с данными о группе опросов
[ Наверх ]
get_polls_name( int $poll_id );
Описание
Получение названия опроса
Принимаемые параметры
$poll_id
– идентификатор опроса
<?php $polls = new polls(); $poll_id = 1; $result = $polls->get_polls_name($poll_id); // Распечатаем результат echo $result; ?>
Возвращает
название опроса, если запрос с таким идентификатором существует, или слово «Опросы» в противном случае
[ Наверх ]
IncPollReply( mixed $poll_reply_id, int $poll_id, [bool $use_cookies = true] );
Описание
Увеличивает число ответов для варианта ответа на опрос. Метод рекомендуется использовать вместо update_vote
Принимаемые параметры
$poll_reply_id
идентификатор ответа или массив идентификаторов ответов
$poll_id
идентификатор опроса
$use_cookies
использовать кукисы для защиты от повторного голосования
<?php $polls = new polls(); $poll_reply_id = 1; $poll_id = 1; $result = $polls->IncPollReply($poll_reply_id, $poll_id); if ($result) { echo "Голос принят"; } else { echo "Голос отвергнут"; } ?>
Возвращает
истина - голос принят, false - голос отвергнут
[ Наверх ]
InsertGroupPolls( array $param );
Описание
Вставка информации о группе опросов
Принимаемые параметры
$param
ассоциативный массив параметров метода
<?php $polls = new polls(); $param['site_id'] = CURRENT_SITE; $param['structure_id'] = 33; $param['poll_group_name'] = 'Группа опросов'; $newid = $polls->InsertGroupPolls($param); // Распечатаем результат echo $newid; ?>
Возвращает
идентификатор вставленной группы в случае успешного выполнения, false - в противном случае
[ Наверх ]
InsertVote( int $poll_id, mixed $vote );
Описание
Устаревший метод. Вставка ответа на опрос.
Принимаемые параметры
$poll_id
идентификатор опроса
$vote
идентификатор ответа или массив с ответами на вопрос array(poll_reply_id['poll_reply_id3']=>'1',poll_reply_id['poll_reply_id5']=>'1')
<?php $polls = new polls(); $poll_id = 1; $vote = 1; $result = $polls->InsertVote($poll_id, $vote); if ($result) { echo "Вставка ответа выполнена успешно"; } else { echo "Ошибка вставки"; } ?>
see
[ Наверх ]
insert_poll( int $type, int $poll_id, $poll_group_id, string $poll_name, string $poll_description, int $poll_type, int $poll_vote_public, int $poll_visible, string $poll_begin_date, string $poll_end_date, [int $users_id = false], [int $poll_voted = 0], int $poll_group, int $structure_id, int $site_id );
Описание
Вставка и обновление опроса
Принимаемые параметры
$type
параметр, определяющий производится вставка или обновление опроса (0 – вставка, 1 - обновление)
$poll_id
идентификатор обновляемого опроса (при вставке нового опроса равен 0)
$poll_group
идентификатор группы опросов
$poll_name
название (заголовок) опроса
$poll_description
описание опроса
$structure_id
идентификатор структуры
$site_id
идентификатор сайта
$poll_type
тип опроса (0 – можно выбрать только один вариант ответа, 1- можно выбрать несколько вариантов ответа)
$poll_vote_public
параметр, определяющий показывать пользователю результаты голосования или нет (1 – показывать, 0 – не показывать)
$poll_visible
параметр, определяющий отображать опрос или нет (1 – отображать, 0 – не отображать)
$poll_begin_date
дата начала действия опроса
$poll_end_date
дата окончания действия опроса
$poll_voted
число голосований по опросу
$users_id
идентификатор пользователя, если false - берется текущий пользователь.
<?php $polls = new polls(); $type = 0; $poll_id = 0; $poll_group_id = 1; $poll_name = 'Новый опрос'; $poll_type = 1; $poll_vote_public = 0; $poll_visible = 1; $poll_begin_date = date('Y-m-d H:i:s'); $poll_end_date = '2008-12-1 00:00:00'; $newid = $polls->insert_poll($type, $poll_id, $poll_group_id, $poll_name, $poll_type, $poll_vote_public ,$poll_visible, $poll_begin_date, $poll_end_date); // Распечатаем результат echo $newid; ?>
$poll_group_id
Возвращает
идентификатор вставленного или обновленного опроса в случае успешного выполнеия метода или false - в противном случае
[ Наверх ]
insert_poll_reply( int $type, int $poll_reply_id, string $poll_id, string $poll_reply_text, int $poll_reply_number, int $poll_reply_order, int $poll_reply_grade, [int $users_id = false] );
Описание
Вставка и обновление вариантов ответов
Принимаемые параметры
$type
параметр, определяющий производится вставка или обновление варианта ответа
$poll_reply_id
идентификатор обновляемого варианта ответа (при вставке нового варианта ответа равен 0)
$poll_id
идентификатор опроса, к которому относится обновляемый/добавляемый вариант ответа
$poll_reply_text
текст варианта ответа
$poll_reply_number
количество голосов, отданных за данный вариант ответа
$poll_reply_order
порядковый номер варианта ответа
$poll_reply_grade
количество баллов, назначаемых ответу
$users_id
идентификатор пользователя, если false - берется текущий пользователь.
<?php $polls = new polls(); $type = 0; $poll_reply_id = 0; $poll_id = 3; $poll_reply_text = 'Текст ответа'; $poll_reply_number = 1; $poll_reply_order = 1; $newid = $polls->insert_poll_reply($type, $poll_reply_id, $poll_id,$poll_reply_text, $poll_reply_number, $poll_reply_order); // Распечатаем результат echo $newid; ?>
Возвращает
or boolean идентификатор вставленного или обновленного варианта ответа в случае успешного выполнеия метода или false - в противном случае
[ Наверх ]
SelectPollReply4Poll( int $poll_id, [array $param = array()] );
Описание
Получение списка вариантов ответов на опрос по ID опроса
Принимаемые параметры
$poll_id
идентификатор опроса
$param
ассоциативный массив параметров
<?php $polls = new polls(); $poll_id = 1; $resource = $polls->SelectPollReply4Poll($poll_id); // Распечатаем результат while($row = mysql_fetch_assoc($resource)) { print_r($row); } ?>
[ Наверх ]
select_poll( [mixed $poll_id = false] );
Описание
Метод осуществляет выборку опросов
Принимаемые параметры
$poll_id
идентификатор выбираемого опроса (по умолчанию равен false – выбираем все опросы)
<?php $polls = new polls(); $poll_id = 1; $resource = $polls->select_poll($poll_id); // Распечатаем результат while($row = mysql_fetch_assoc($resource)) { print_r($row); } ?>
[ Наверх ]
select_poll_reply( [mixed $poll_reply_id = false] );
Описание
Метод выбора вариантов ответов по ID ответа
Принимаемые параметры
$poll_reply_id
– идентификатор выбираемого варианта ответа (по умолчанию равен false – выбираем все варианты ответов)
<?php $polls = new polls(); $poll_reply_id = 9; $resource = $polls->select_poll_reply($poll_reply_id); // Распечатаем результат while($row = mysql_fetch_assoc($resource)) { print_r($row); } ?>
[ Наверх ]
ShowPoll( string $xsl_name, [mixed $poll_id = false], [array $external_propertys = array()], [array $param = array()] );
Описание
Метод отображения опроса
Принимаемые параметры
$xsl_name
имя XSL–шаблона для отображения опроса
$poll_id
идентификатор отображаемого опроса (по умолчанию равен false – опрос выбирается случайным образом)
$external_propertys
ассоциативный массив внешних параметров для XML
$param
ассоциативный массив параметров
[ Наверх ]
ShowPollResult( $poll_id, $xsl_name );
Описание
Устаревший метод вывода результатов голосования
Принимаемые параметры
$poll_id
$xsl_name
[ Наверх ]
ShowPolls( string $xsl_name, int $polls_on_page, int $poll_begin, [array $external_propertys = array()], [int $site_id = CURRENT_SITE] );
Описание
Устаревший метод! Метод отображения всех активных опросов
Принимаемые параметры
$xsl_name
– название XSL – шаблона для отображения опросов
$polls_on_page
– число опросов на страницу
$poll_begin
– номер опроса, с которого начинать отображать опросы
$external_propertys
- дополнительные св-ва
$site_id
- идентификатор сайта, по умолчанию равен CURRENT_SITE
[ Наверх ]
ShowPollsGroup( mixed $group_id, $xsl_name, [array $param = array()], [ $external_propertys = array()], string $xsl );
Описание
Отображение групп опросов
Принимаемые параметры
$group_id
идентификатор группы, опросы которой необходимо показать, false - необходимо показать опросы всех групп данного сайта
$xsl
имя XSL-шаблона
$param
массив дополнительных параметров
<?php $polls = new polls(); $group_id = 1; $xsl_name = 'ОтображениеОпросаБезРезультатов'; $polls->ShowPollsGroup($group_id, $xsl_name); ?>
$xsl_name
$external_propertys
[ Наверх ]
UpdateGroupPolls( array $param );
Описание
Метод обновления информаци о группе опросов
Принимаемые параметры
$param
ассоциативный массив параметров метода
<?php $polls = new polls(); $param['poll_group_id'] = 2; $param['structure_id'] = 33; $param['site_id'] = CURRENT_SITE; $param['poll_group_name'] = 'Новая группа опросов'; $newid = $polls->UpdateGroupPolls($param); // Распечатаем результат echo $newid; ?>
Возвращает
идентификатор обновленной группы в случае успешного выполнения, false - в противном случае
[ Наверх ]
vote_result( );
Описание
Устаревший метод
[ Наверх ]