modules/survey/survey.inc.php

   1 <?php
   2 /***************************************************************************
   3  *  Copyright (C) 2003-2010 Polytechnique.org                              *
   4  *  http://opensource.polytechnique.org/                                   *
   5  *                                                                         *
   6  *  This program is free software; you can redistribute it and/or modify   *
   7  *  it under the terms of the GNU General Public License as published by   *
   8  *  the Free Software Foundation; either version 2 of the License, or      *
   9  *  (at your option) any later version.                                    *
  10  *                                                                         *
  11  *  This program is distributed in the hope that it will be useful,        *
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of         *
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the          *
  14  *  GNU General Public License for more details.                           *
  15  *                                                                         *
  16  *  You should have received a copy of the GNU General Public License      *
  17  *  along with this program; if not, write to the Free Software            *
  18  *  Foundation, Inc.,                                                      *
  19  *  59 Temple Place, Suite 330, Boston, MA  02111-1307  USA                *
  20  ***************************************************************************/
  21
  22 // {{{ class Survey : root of any survey, contains all questions
  23 class Survey
  24 {
  25     // {{{ static properties and functions, regarding survey modes and question types
  26     const MODE_ALL    = 0;
  27     const MODE_XANON  = 1;
  28     const MODE_XIDENT = 2;
  29     private static $longModes = array(self::MODE_ALL    => "sondage ouvert à tout le monde, anonyme",
  30                                       self::MODE_XANON  => "sondage restreint aux polytechniciens, anonyme",
  31                                       self::MODE_XIDENT => "sondage restreint aux polytechniciens, non anonyme");
  32     private static $shortModes = array(self::MODE_ALL    => "tout le monde, anonyme",
  33                                        self::MODE_XANON  => "polytechniciens, anonyme",
  34                                        self::MODE_XIDENT => "polytechniciens, non anonyme");
  35
  36     public static function getModes($long = true) {
  37         return ($long)? self::$longModes : self::$shortModes;
  38     }
  39
  40     private static $types = array('text'          => 'Texte court',
  41                                   'textarea'      => 'Texte long',
  42                                   'num'           => 'Numérique',
  43                                   'radio'         => 'Choix multiples (une réponse)',
  44                                   'checkbox'      => 'Choix multiples (plusieurs réponses)',
  45                                   'radiotable'    => 'Questions multiples à choix multiples (une réponse)',
  46                                   'checkboxtable' => 'Questions multiples à choix mutliples (plusieurs réponses)');
  47
  48     public static function getTypes()
  49     {
  50         return self::$types;
  51     }
  52
  53     public static function isType($t)
  54     {
  55         return array_key_exists($t, self::$types);
  56     }
  57     // }}}
  58
  59     // {{{ properties, constructor and basic methods
  60     private $id;
  61     private $title;
  62     private $description;
  63     private $end;
  64     private $mode;
  65     private $promos;
  66     private $valid;
  67     private $questions;
  68
  69     public function __construct($args, $id = -1, $valid = false, $questions = null)
  70     {
  71         $this->update($args);
  72         $this->id = $id;
  73         $this->valid = $valid;
  74         $this->questions = ($questions == null)? array() : $questions;
  75     }
  76
  77     public function update($args)
  78     {
  79         $this->title       = $args['title'];
  80         $this->description = $args['description'];
  81         $this->end         = $args['end'];
  82         $this->mode    = (isset($args['mode']))? $args['mode'] : self::MODE_ALL;
  83         if ($this->mode == self::MODE_ALL) {
  84             $args['promos'] = '';
  85         }
  86         $args['promos'] = str_replace(' ', '', $args['promos']);
  87         $this->promos  = ($args['promos'] == '' || preg_match('#^(\d{4}-?|(\d{4})?-\d{4})(,(\d{4}-?|(\d{4})?-\d{4}))*$#', $args['promos']))? $args['promos'] : '#';
  88     }
  89     // }}}
  90
  91     // {{{ functions to access general information
  92     public function isMode($mode)
  93     {
  94         return ($this->mode == $mode);
  95     }
  96
  97     public function checkPromo($promo)
  98     {
  99         if ($this->promos == '') {
 100             return true;
 101         }
 102         $promos = explode(',', $this->promos);
 103         foreach ($promos as $p) {
 104             if ((preg_match('#^\d{4}$#', $p) && $p == $promo) ||
 105                 (preg_match('#^\d{4}-$#', $p) && intval(substr($p, 0, 4)) <= $promo) ||
 106                 (preg_match('#^-\d{4}$#', $p) && intval(substr($p, 1)) >= $promo) ||
 107                 (preg_match('#^\d{4}-\d{4}$#', $p) && intval(substr($p, 0, 4)) <= $promo && intval(substr($p, 5)) >= $promo)) {
 108                     return true;
 109             }
 110         }
 111         return false;
 112     }
 113
 114     public function isValid()
 115     {
 116         return $this->valid;
 117     }
 118
 119     public function isEnded()
 120     {
 121         return (strtotime($this->end) - time() <= 0);
 122     }
 123
 124     public function getTitle()
 125     {
 126         return $this->title;
 127     }
 128     // }}}
 129
 130     // {{{ function toArray() : converts a question (or the whole survey) to array, with results if the survey is ended
 131     public function toArray($i = 'all')
 132     {
 133         if ($i != 'all' && $i != 'root') { // if a specific question is requested, then just returns this question converted to array
 134             $i = intval($i);
 135             if (array_key_exists($i, $this->questions)) {
 136                 return $this->questions[$i]->toArray();
 137             } else {
 138                 return null;
 139             }
 140         } else { // else returns the root converted to array in any case
 141             $a = array('title'       => $this->title,
 142                        'description' => $this->description,
 143                        'end'         => $this->end,
 144                        'mode'        => $this->mode,
 145                        'promos'      => $this->promos,
 146                        'valid'       => $this->valid,
 147                        'type'        => 'root');
 148             if ($this->id != -1) {
 149                 $a['id'] = $this->id;
 150             }
 151             if ($this->isEnded()) { // if the survey is ended, then adds here the number of votes
 152                 $sql = 'SELECT COUNT(id)
 153                           FROM survey_votes
 154                          WHERE survey_id={?};';
 155                 $tot = XDB::query($sql, $this->id);
 156                 $a['votes'] = $tot->fetchOneCell();
 157             }
 158             if ($i == 'all' && count($this->questions) > 0) { // if the whole survey is requested, then returns all the questions converted to array
 159                 $qArr = array();
 160                 for ($k = 0; $k < count($this->questions); $k++) {
 161                     $q = $this->questions[$k]->toArray();
 162                     $q['id'] = $k;
 163                     if ($this->isEnded()) { // if the survey is ended, then adds here the results of this question
 164                         $q['result'] = $this->questions[$k]->getResultArray($this->id, $k);
 165                     }
 166                     $qArr[$k] = $q;
 167                 }
 168                 $a['questions'] = $qArr;
 169             }
 170             return $a;
 171         }
 172     }
 173     // }}}
 174
 175     // {{{ function toCSV() : builds a CSV file containing all the results of the survey
 176     public function toCSV($sep = ',', $enc = '"', $asep='|')
 177     {
 178         $nbq = count($this->questions);
 179         //require_once dirname(__FILE__) . '/../../classes/varstream.php';
 180         VarStream::init();
 181         global $csv_output;
 182         $csv_output = '';
 183         $csv = fopen('var://csv_output', 'w');
 184         $line = ($this->isMode(self::MODE_XIDENT))? array('id', 'Nom', 'Prenom', 'Promo') : array('id');
 185         $qids = array();
 186         for ($qid = 0; $qid < $nbq; $qid++) {
 187             $qids[$qid] = count($line); // stores the first id of a question (in case of questions with subquestions)
 188             array_splice($line, count($line), 0, $this->questions[$qid]->getCSVColumns()); // the first line contains the questions
 189         }
 190         $nbf = count($line);
 191         $users = array();
 192         if ($this->isMode(self::MODE_XIDENT)) { // if the mode is non anonymous
 193             $users = User::getBulkUsersWithUIDs(XDB::fetchAllAssoc('vid', 'SELECT  v.id AS vid, v.uid
 194                                                                              FROM  survey_votes AS v
 195                                                                             WHERE  v.survey_id = {?}
 196                                                                          ORDER BY  vid ASC',
 197                                                                     $this->id));
 198         }
 199         $sql = 'SELECT v.id AS vid, a.question_id AS qid, a.answer AS answer
 200                   FROM survey_votes AS v
 201              LEFT JOIN survey_answers AS a
 202                     ON a.vote_id=v.id
 203                  WHERE v.survey_id={?}
 204               ORDER BY vid ASC, qid ASC, answer ASC;';
 205         $res = XDB::iterator($sql, $this->id); // retrieves all answers from database
 206         $vid = -1;
 207         $vid_ = 0;
 208         while (($cur = $res->next()) != null) {
 209             if ($vid != $cur['vid']) { // if the vote id changes, then starts a new line
 210                 fputcsv($csv, $line, $sep, $enc); // stores the former line into $csv_output
 211                 $vid = $cur['vid'];
 212                 $line = array_fill(0, $nbf, ''); // creates an array full of empty string
 213                 $line[0] = $vid_; // the first field is a 'clean' vote id (not the one stored in database)
 214                 if ($this->isMode(self::MODE_XIDENT)) { // if the mode is non anonymous
 215                     if (array_key_exists($vid, $users)) { // and if the user data can be found
 216                         $line[1] = $users[$vid]->lastName(); // adds the user data (in the first fields of the line)
 217                         $line[2] = $users[$vid]->firstName();;
 218                         $line[3] = $users[$vid]->promo();
 219                     }
 220                 }
 221                 $vid_++;
 222             }
 223             $ans = $this->questions[$cur['qid']]->formatAnswer($cur['answer']); // formats the current answer
 224             if (!is_null($ans)) {
 225                 if (is_array($ans)) {
 226                     $fid = $qids[$cur['qid']] + $ans['id']; // computes the field id
 227                     $a = $ans['answer'];
 228                 } else {
 229                     $fid = $qids[$cur['qid']];
 230                     $a = $ans;
 231                 }
 232                 if ($line[$fid] != '') {  // if this field already contains something
 233                     $line[$fid] .= $asep; // then adds a separator before adding the new answer
 234                 }
 235                 $line[$fid] .= $a; // adds the current answer to the correct field
 236             }
 237         }
 238         fputcsv($csv, $line, $sep, $enc); // stores the last line into $csv_output
 239         return $csv_output;
 240     }
 241     // }}}
 242
 243     // {{{ function factory($type, $args) : builds a question according to the given type
 244     public function factory($t, $args)
 245     {
 246         switch ($t) {
 247         case 'text':
 248             return new SurveyText($args);
 249         case 'textarea':
 250             return new SurveyTextarea($args);
 251         case 'num':
 252             return new SurveyNum($args);
 253         case 'radio':
 254             return new SurveyRadio($args);
 255         case 'checkbox':
 256             return new SurveyCheckbox($args);
 257         case 'radiotable':
 258             return new SurveyRadioTable($args);
 259         case 'checkboxtable':
 260             return new SurveyCheckboxTable($args);
 261         default:
 262             return null;
 263         }
 264     }
 265     // }}}
 266
 267     // {{{ questions manipulation functions
 268     public function addQuestion($i, $c)
 269     {
 270         $i = intval($i);
 271         if ($this->valid || $i > count($this->questions)) {
 272             return false;
 273         } else {
 274             array_splice($this->questions, $i, 0, array($c));
 275             return true;
 276         }
 277     }
 278
 279     public function delQuestion($i)
 280     {
 281         $i = intval($i);
 282         if ($this->valid || !array_key_exists($i, $this->questions)) {
 283             return false;
 284         } else {
 285             array_splice($this->questions, $i, 1);
 286             return true;
 287         }
 288     }
 289
 290     public function editQuestion($i, $a)
 291     {
 292         if ($i == 'root') {
 293             $this->update($a);
 294         } else {
 295             $i = intval($i);
 296             if ($this->valid ||!array_key_exists($i, $this->questions)) {
 297                 return false;
 298             } else {
 299                 $this->questions[$i]->update($a);
 300             }
 301         }
 302         return true;
 303     }
 304     // }}}
 305
 306     // {{{ function checkSyntax() : checks syntax of the questions (currently the root only) before storing the survey in database
 307     private static $errorMessages = array(
 308         "datepassed"  => "la date de fin de sondage est déjà dépassée : vous devez préciser une date future",
 309         "promoformat" => "les restrictions à certaines promotions sont mal formattées"
 310     );
 311
 312     public function checkSyntax()
 313     {
 314         $rArr = array();
 315         // checks that the end date given is not already passed
 316         // (unless the survey has already been validated : an admin can have a validated survey expired)
 317         if (!$this->valid && $this->isEnded()) {
 318             $rArr[] = array('question' => 'root', 'error' => self::$errorMessages["datepassed"]);
 319         }
 320         if ($this->promos != '' && !preg_match('#^(\d{4}-?|(\d{4})?-\d{4})(,(\d{4}-?|(\d{4})?-\d{4}))*$#', $this->promos)) {
 321             $rArr[] = array('question' => 'root', 'error' => self::$errorMessages["promoformat"]);
 322         }
 323         return (empty($rArr))? null : $rArr;
 324     }
 325     // }}}
 326
 327     // {{{ functions that manipulate surveys in database
 328     // {{{ static function retrieveList() : gets the list of available survey (current, old and not validated surveys)
 329     public static function retrieveList($type, $tpl = true)
 330     {
 331         switch ($type) {
 332         case 'c':
 333         case 'current':
 334             $where = 'end > NOW()';
 335             break;
 336         case 'o':
 337         case 'old':
 338             $where = 'end <= NOW()';
 339             break;
 340         default:
 341             return null;
 342         }
 343         $sql = 'SELECT id, title, end, mode
 344                   FROM surveys
 345                  WHERE '.$where.'
 346               ORDER BY end DESC;';
 347         if ($tpl) {
 348             return XDB::iterator($sql);
 349         } else {
 350             return XDB::iterRow($sql);
 351         }
 352     }
 353     // }}}
 354
 355     // {{{ static function retrieveSurvey() : gets a survey in database (and unserialize the survey object structure)
 356     public static function retrieveSurvey($sid)
 357     {
 358         $sql = 'SELECT questions, title, description, end, mode, promos
 359                   FROM surveys
 360                  WHERE id={?}';
 361         $res = XDB::query($sql, $sid);
 362         $data = $res->fetchOneAssoc();
 363         if (is_null($data) || !is_array($data)) {
 364             return null;
 365         }
 366         $survey = new Survey($data, $sid, true, unserialize($data['questions']));
 367         return $survey;
 368     }
 369     // }}}
 370
 371     // {{{ static function retrieveSurveyInfo() : gets information about a survey (title, description, end date, restrictions) but does not unserialize the survey object structure
 372     public static function retrieveSurveyInfo($sid)
 373     {
 374         $sql = 'SELECT title, description, end, mode, promos
 375                   FROM surveys
 376                  WHERE id={?}';
 377         $res = XDB::query($sql, $sid);
 378         return $res->fetchOneAssoc();
 379     }
 380     // }}}
 381
 382     // {{{ static function retrieveSurveyReq() : gets a survey request to validate
 383     public static function retrieveSurveyReq($id)
 384     {
 385         require_once 'validations.inc.php';
 386         $surveyreq = Validate::get_request_by_id($id);
 387         if ($surveyreq == null) {
 388             return null;
 389         }
 390         $data = array('title'       => $surveyreq->title,
 391                       'description' => $surveyreq->description,
 392                       'end'         => $surveyreq->end,
 393                       'mode'        => $surveyreq->mode,
 394                       'promos'      => $surveyreq->promos);
 395         $survey = new Survey($data, $id, false, $surveyreq->questions);
 396         return $survey;
 397     }
 398     // }}}
 399
 400     // {{{ function proposeSurvey() : stores a proposition of survey in database (before validation)
 401     public function proposeSurvey()
 402     {
 403         require_once 'validations.inc.php';
 404         $surveyreq = new SurveyReq($this->title, $this->description, $this->end, $this->mode, $this->promos, $this->questions, S::user());
 405         return $surveyreq->submit();
 406     }
 407     // }}}
 408
 409     // {{{ function updateSurvey() : updates a survey in database (before validation)
 410     public function updateSurvey()
 411     {
 412         if ($this->valid) {
 413             $sql = 'UPDATE surveys
 414                        SET questions={?},
 415                            title={?},
 416                            description={?},
 417                            end={?},
 418                            mode={?},
 419                            promos={?}
 420                      WHERE id={?};';
 421             return XDB::execute($sql, serialize($this->questions), $this->title, $this->description, $this->end, $this->mode, $this->promos, $this->id);
 422         } else {
 423             require_once 'validations.inc.php';
 424             $surveyreq = Validate::get_request_by_id($this->id);
 425             if ($surveyreq == null) {
 426                 return false;
 427             }
 428             return $surveyreq->updateReq($this->title, $this->description, $this->end, $this->mode, $this->promos, $this->questions);
 429         }
 430     }
 431     // }}}
 432
 433     // {{{ functions vote() and hasVoted() : handles vote to a survey
 434     public function vote($uid, $args)
 435     {
 436         XDB::execute('INSERT INTO  survey_votes
 437                               SET  survey_id = {?}, uid = {?};', $this->id, $uid); // notes the user as having voted
 438         $vid = XDB::insertId();
 439         for ($i = 0; $i < count($this->questions); $i++) {
 440             $ans = $this->questions[$i]->checkAnswer($args[$i]);
 441             if (!is_null($ans) && is_array($ans)) {
 442                 foreach ($ans as $a) {
 443                     XDB::execute('INSERT INTO survey_answers
 444                                           SET vote_id     = {?},
 445                                               question_id = {?},
 446                                               answer      = {?}', $vid, $i, $a);
 447                 }
 448             }
 449         }
 450     }
 451
 452     public function hasVoted($uid)
 453     {
 454         $res = XDB::query('SELECT  id
 455                              FROM  survey_votes
 456                             WHERE  survey_id = {?} AND uid = {?};', $this->id, $uid); // checks whether the user has already voted
 457         return ($res->numRows() != 0);
 458     }
 459     // }}}
 460
 461     // {{{ static function deleteSurvey() : deletes a survey (and all its votes)
 462     public static function deleteSurvey($sid)
 463     {
 464         $sql = 'DELETE s.*, v.*, a.*
 465                   FROM surveys AS s
 466              LEFT JOIN survey_votes AS v
 467                     ON v.survey_id=s.id
 468              LEFT JOIN survey_answers AS a
 469                     ON a.vote_id=v.id
 470                  WHERE s.id={?};';
 471         return XDB::execute($sql, $sid);
 472     }
 473     // }}}
 474
 475     // {{{ static function purgeVotes() : clears all votes concerning a survey (I'm not sure whether it's really useful)
 476     public static function purgeVotes($sid)
 477     {
 478         $sql = 'DELETE v.*, a.*
 479                   FROM survey_votes AS v
 480              LEFT JOIN survey_answers AS a
 481                     ON a.vote_id=v.id
 482                  WHERE v.survey_id={?};';
 483         return XDB::execute($sql, $sid);
 484     }
 485     // }}}
 486
 487     // }}}
 488 }
 489 // }}}
 490
 491 // {{{ abstract class SurveyQuestion
 492 abstract class SurveyQuestion
 493 {
 494     // {{{ common properties, constructor, and basic methods
 495     private $question;
 496     private $comment;
 497
 498     public function __construct($args)
 499     {
 500         $this->update($args);
 501     }
 502
 503     public function update($a)
 504     {
 505         $this->question = $a['question'];
 506         $this->comment  = $a['comment'];
 507     }
 508
 509     abstract protected function getQuestionType();
 510     // }}}
 511
 512     // {{{ function toArray() : converts to array
 513     public function toArray()
 514     {
 515         return array('type' => $this->getQuestionType(), 'question' => $this->question, 'comment' => $this->comment);
 516     }
 517     // }}}
 518
 519     // {{{ function checkSyntax() : checks question elements (before storing into database), not currently needed (with new structure)
 520     protected function checkSyntax()
 521     {
 522         return null;
 523     }
 524     // }}}
 525
 526     // {{{ function checkAnswer : returns a correct answer (or a null value if error)
 527     public function checkAnswer($ans)
 528     {
 529         return null;
 530     }
 531     // }}}
 532
 533     // {{{ functions regarding the results of a survey
 534     abstract public function getResultArray($sid, $qid);
 535
 536     public function formatAnswer($ans)
 537     {
 538         return $ans;
 539     }
 540
 541     public function getCSVColumns()
 542     {
 543         return $this->question;
 544     }
 545     // }}}
 546 }
 547 // }}}
 548
 549 // {{{ abstract class SurveySimple and its derived classes : "open" questions
 550 // {{{ abstract class SurveySimple extends SurveyQuestion
 551 abstract class SurveySimple extends SurveyQuestion
 552 {
 553     public function checkAnswer($ans)
 554     {
 555         return array($ans);
 556     }
 557
 558     public function getResultArray($sid, $qid)
 559     {
 560         $sql = 'SELECT answer
 561                   FROM survey_answers
 562                  WHERE vote_id IN (SELECT id FROM survey_votes WHERE survey_id={?})
 563                    AND question_id={?}
 564               ORDER BY RAND()
 565                  LIMIT 5;';
 566         $res = XDB::query($sql, $sid, $qid);
 567         return $res->fetchAllAssoc();
 568     }
 569 }
 570 // }}}
 571
 572 // {{{ class SurveyText extends SurveySimple : simple text field, allowing a few words
 573 class SurveyText extends SurveySimple
 574 {
 575     public function getQuestionType()
 576     {
 577         return "text";
 578     }
 579 }
 580 // }}}
 581
 582 // {{{ class SurveyTextarea extends SurveySimple : textarea field, allowing longer comments
 583 class SurveyTextarea extends SurveySimple
 584 {
 585     public function getQuestionType()
 586     {
 587         return "textarea";
 588     }
 589 }
 590 // }}}
 591
 592 // {{{ class SurveyNum extends SurveySimple : allows numerical answers
 593 class SurveyNum extends SurveySimple
 594 {
 595     public function checkAnswer($ans)
 596     {
 597         return array(intval($ans));
 598     }
 599
 600     protected function getQuestionType()
 601     {
 602         return "num";
 603     }
 604 }
 605 // }}}
 606 // }}}
 607
 608 // {{{ abstract class SurveyList and its derived classes : restricted questions that allows only a list of possible answers
 609 // {{{ abstract class SurveyList extends SurveyQuestion
 610 abstract class SurveyList extends SurveyQuestion
 611 {
 612     protected $choices;
 613
 614     public function update($args)
 615     {
 616         parent::update($args);
 617         $this->choices = array();
 618         foreach ($args['choices'] as $val) {
 619             if (trim($val) || trim($val) == '0') {
 620                 $this->choices[] = $val;
 621             }
 622         }
 623     }
 624
 625     public function toArray()
 626     {
 627         $rArr = parent::toArray();
 628         $rArr['choices'] = $this->choices;
 629         return $rArr;
 630     }
 631
 632     public function getResultArray($sid, $qid)
 633     {
 634         $sql = 'SELECT answer, COUNT(id) AS count
 635                   FROM survey_answers
 636                  WHERE vote_id IN (SELECT id FROM survey_votes WHERE survey_id={?})
 637                    AND question_id={?}
 638               GROUP BY answer ASC';
 639         $res = XDB::query($sql, $sid, $qid);
 640         return $res->fetchAllAssoc();
 641     }
 642
 643     public function formatAnswer($ans)
 644     {
 645         if (array_key_exists($ans, $this->choices)) {
 646             return $this->choices[$ans];
 647         } else {
 648             return null;
 649         }
 650     }
 651 }
 652 // }}}
 653
 654 // {{{ class SurveyRadio extends SurveyList : radio question, allows one answer among the list offered
 655 class SurveyRadio extends SurveyList
 656 {
 657     public function checkAnswer($ans)
 658     {
 659         $a = intval($ans);
 660         return (array_key_exists($a, $this->choices))? array($a) : null;
 661     }
 662
 663     protected function getQuestionType()
 664     {
 665         return "radio";
 666     }
 667 }
 668 // }}}
 669
 670 // {{{ class SurveyCheckbox extends SurveyList : checkbox question, allows any number of answers among the list offered
 671 class SurveyCheckbox extends SurveyList
 672 {
 673     public function checkAnswer($ans)
 674     {
 675         $rep = array();
 676         foreach ($ans as $a) {
 677             $a = intval($a);
 678             if (array_key_exists($a, $this->choices)) {
 679                 $rep[] = $a;
 680             }
 681         }
 682         return (count($rep) == 0)? null : $rep;
 683     }
 684
 685     protected function getQuestionType()
 686     {
 687         return "checkbox";
 688     }
 689 }
 690 // }}}
 691 // }}}
 692
 693 // {{{ abstract class SurveyTable and its derived classes : table question, each column represents a choice, each line represents a question
 694 // {{{ abstract class SurveyTable extends SurveyList
 695 abstract class SurveyTable extends SurveyList
 696 {
 697     protected $subquestions;
 698
 699     public function update($args)
 700     {
 701         parent::update($args);
 702         $this->subquestions = array();
 703         foreach ($args['subquestions'] as $val) {
 704             if (trim($val) || trim($val) == '0') {
 705                 $this->subquestions[] = $val;
 706             }
 707         }
 708     }
 709
 710     public function toArray()
 711     {
 712         $rArr = parent::toArray();
 713         $rArr['subquestions'] = $this->subquestions;
 714         return $rArr;
 715     }
 716
 717     public function getResultArray($sid, $qid)
 718     {
 719         $sql = 'SELECT answer, COUNT(id) AS count
 720                   FROM survey_answers
 721                  WHERE vote_id IN (SELECT id FROM survey_votes WHERE survey_id={?})
 722                    AND question_id={?}
 723               GROUP BY answer ASC';
 724         $res = XDB::iterator($sql, $sid, $qid);
 725         $result = array();
 726         for ($i = 0; $i < count($this->subquestions); $i++) {
 727             $result[$i] = array_fill(0, count($this->choices), 0);
 728         }
 729         while ($r = $res->next()) {
 730             list($i, $j) = explode(':', $r['answer']);
 731             $result[$i][$j] = $r['count'];
 732         }
 733         return $result;
 734     }
 735
 736     public function formatAnswer($ans)
 737     {
 738         list($q, $c) = explode(':', $ans);
 739         if (array_key_exists($q, $this->subquestions) && array_key_exists($c, $this->choices)) {
 740             return array('id' => $q, 'answer' => $this->choices[$c]);
 741         } else {
 742             return null;
 743         }
 744     }
 745
 746     public function getCSVColumns()
 747     {
 748         $q = parent::getCSVColumns();
 749         if (empty($this->subquestions)) {
 750             return $q;
 751         }
 752         $a = array();
 753         for ($k = 0; $k < count($this->subquestions); $k++) {
 754             $a[$k] = $q.' : '.$this->subquestions[$k];
 755         }
 756         return $a;
 757     }
 758 }
 759 // }}}
 760
 761 // {{{ class SurveyRadioTable extends SurveyTable : SurveyTable with radio type choices
 762 class SurveyRadioTable extends SurveyTable
 763 {
 764     public function checkAnswer($ans)
 765     {
 766         $rep = array();
 767         foreach ($ans as $k => $a) {
 768             if (!array_key_exists($k, $this->subquestions)) {
 769                 continue;
 770             }
 771             $a = intval($a);
 772             if (array_key_exists($a, $this->choices)) {
 773                 $rep[] = $k . ':' . $a;
 774             }
 775         }
 776         return (count($rep) == 0)? null : $rep;
 777     }
 778
 779     protected function getQuestionType()
 780     {
 781         return "radiotable";
 782     }
 783
 784 }
 785 // }}}
 786
 787 // {{{ class SurveyCheckboxTable extends SurveyTable : SurveyTable with checkbox type choices
 788 class SurveyCheckboxTable extends SurveyTable
 789 {
 790     public function checkAnswer($ans)
 791     {
 792         $rep = array();
 793         foreach ($ans as $k => $aa) {
 794             if (!array_key_exists($k, $this->subquestions)) {
 795                 continue;
 796             }
 797             foreach ($aa as $a) {
 798                 $a = intval($a);
 799                 if (array_key_exists($a, $this->choices)) {
 800                     $rep[] = $k . ':' . $a;
 801                 }
 802             }
 803         }
 804         return (count($rep) == 0)? null : $rep;
 805     }
 806
 807     protected function getQuestionType()
 808     {
 809         return "checkboxtable";
 810     }
 811
 812 }
 813 // }}}
 814 // }}}
 815
 816 // vim:set et sw=4 sts=4 ts=4 foldmethod=marker enc=utf-8:
 817 ?>