Merge remote branch 'origin/xorg/1.0.2/master' into xorg/master
[platal.git] / modules / survey / survey.inc.php
index 168a226..3812d2e 100644 (file)
@@ -1,6 +1,6 @@
 <?php
 /***************************************************************************
- *  Copyright (C) 2003-2007 Polytechnique.org                              *
+ *  Copyright (C) 2003-2010 Polytechnique.org                              *
  *  http://opensource.polytechnique.org/                                   *
  *                                                                         *
  *  This program is free software; you can redistribute it and/or modify   *
  *  59 Temple Place, Suite 330, Boston, MA  02111-1307  USA                *
  ***************************************************************************/
 
-// {{{ class Survey : root of any survey, contains all questions
-class Survey
-{
-    // {{{ static properties and functions, regarding survey modes and question types
-    const MODE_ALL    = 0;
-    const MODE_XANON  = 1;
-    const MODE_XIDENT = 2;
-    private static $longModes = array(self::MODE_ALL    => "sondage ouvert &#224; tout le monde, anonyme",
-                                      self::MODE_XANON  => "sondage restreint aux polytechniciens, anonyme",
-                                      self::MODE_XIDENT => "sondage restreint aux polytechniciens, non anonyme");
-    private static $shortModes = array(self::MODE_ALL    => "tout le monde, anonyme",
-                                       self::MODE_XANON  => "polytechniciens, anonyme",
-                                       self::MODE_XIDENT => "polytechniciens, non anonyme");
-
-    public static function getModes($long = true) {
-        return ($long)? self::$longModes : self::$shortModes;
-    }
+require_once dirname(__FILE__) . '/question.inc.php';
+require_once dirname(__FILE__) . '/answer.inc.php';
 
-    private static $types = array('text'     => 'texte court',
-                                  'textarea' => 'texte long',
-                                  'num'      => 'num&#233;rique',
-                                  'radio'    => 'radio',
-                                  'checkbox' => 'checkbox');
-
-    public static function getTypes()
-    {
-        return self::$types;
-    }
-
-    public static function isType($t)
-    {
-        return array_key_exists($t, self::$types);
-    }
-    // }}}
-
-    // {{{ properties, constructor and basic methods
-    private $id;
-    private $title;
-    private $description;
-    private $end;
-    private $mode;
-    private $promos;
-    private $valid;
-    private $questions;
+class Survey extends PlDBTableEntry implements SurveyQuestionContainer
+{
+    private $fetchQuestions = true;
+    public $questions = array();
+    public $viewerFilter = null;
+    public $voterFilter = null;
 
-    public function __construct($args, $id = -1, $valid = false, $questions = null)
+    public function __construct()
     {
-        $this->update($args);
-        $this->id = $id;
-        $this->valid = $valid;
-        $this->questions = ($questions == null)? array() : $questions;
+        parent::__construct('surveys');
+        $this->registerFieldValidator('shortname', 'ShortNameFieldValidator');
+        $this->registerFieldFormatter('voters', 'JSonFieldFormatter');
+        $this->registerFieldFormatter('viewers', 'JSonFieldFormatter');
     }
 
-    public function update($args)
+    protected function postFetch()
     {
-        $this->title       = $args['title'];
-        $this->description = $args['description'];
-        if (preg_match('#^\d{2}/\d{2}/\d{4}$#', $args['end'])) {
-            $this->end = preg_replace('#^(\d{2})/(\d{2})/(\d{4})$#', '\3-\2-\1', $args['end']);
+        if (!is_null($this->voters)) {
+            $this->voterFilter = UserFilter::fromExportedConditions($this->voters);
         } else {
-            $this->end = (preg_match('#^\d{4}-\d{2}-\d{2}$#', $args['end']))? $args['end'] : '#';
+            $this->voterFilter = null;
         }
-        $this->mode    = (isset($args['mode']))? $args['mode'] : self::MODE_ALL;
-        if ($this->mode == self::MODE_ALL) {
-            $args['promos'] = '';
+        if (!is_null($this->viewers)) {
+            $this->viewerFilter = UserFilter::fromExportedConditions($this->viewers);
+        } else {
+            $this->viewerFilter = null;
         }
-        $this->promos  = ($args['promos'] == '' || preg_match('#^(\d{4}-?|(\d{4})?-\d{4})(,(\d{4}-?|(\d{4})?-\d{4}))*$#', $args['promos']))? $args['promos'] : '#';
-    }
-    // }}}
-
-    // {{{ functions to access general information
-    public function isMode($mode)
-    {
-        return ($this->mode == $mode);
-    }
-
-    public function checkPromo($promo)
-    {
-        if ($this->promos == '') {
+        if (!$this->fetchQuestions) {
             return true;
         }
-        $promos = explode('|', $this->promos);
-        foreach ($promos as $p) {
-            if ((preg_match('#^\d{4}$#', $p) && $p == $promo) ||
-                (preg_match('#^\d{4}-$#', $p) && intval(substr($p, 0, 4)) <= $promo) ||
-                (preg_match('#^-\d{4}$#', $p) && intval(substr($p, 1)) >= $promo) ||
-                (preg_match('#^\d{4}-\d{4}$#', $p) && intval(substr($p, 0, 4)) <= $promo && intval(substr($p, 5)) >= $promo)) {
-                    return true;
-            }
-        }
-        return false;
-    }
-
-    public function isValid()
-    {
-        return $this->valid;
-    }
-
-    public function isEnded()
-    {
-        return (strtotime($this->end) - time() <= 0);
-    }
-
-    public function getTitle()
-    {
-        return $this->title;
-    }
-    // }}}
-
-    // {{{ function toArray() : converts a question (or the whole survey) to array, with results if the survey is ended
-    public function toArray($i = 'all')
-    {
-        if ($i != 'all' && $i != 'root') { // if a specific question is requested, then just returns this question converted to array
-            $i = intval($i);
-            if (array_key_exists($i, $this->questions)) {
-                return $this->questions[$i]->toArray();
+        $selector = new SurveyQuestion($this);
+        $selector->sid = $this->id;
+
+        $stack = array();
+        foreach ($selector as $question) {
+            $question = $question->typedInstance();
+            if (is_null($question->parent)) {
+                $this->addQuestion($question);
             } else {
-                return null;
-            }
-        } else { // else returns the root converted to array in any case
-            $a = array('title'       => $this->title,
-                       'description' => $this->description,
-                       'end'         => $this->end,
-                       'mode'        => $this->mode,
-                       'promos'      => $this->promos,
-                       'valid'       => $this->valid,
-                       'type'        => 'root');
-            if ($this->id != -1) {
-                $a['id'] = $this->id;
-            }
-            if ($this->isEnded()) { // if the survey is ended, then adds here the number of votes
-                $sql = 'SELECT COUNT(id)
-                          FROM survey_votes
-                         WHERE survey_id={?};';
-                $tot = XDB::query($sql, $this->id);
-                $a['votes'] = $tot->fetchOneCell();
-            }
-            if ($i == 'all' && count($this->questions) > 0) { // if the whole survey is requested, then returns all the questions converted to array
-                $qArr = array();
-                for ($k = 0; $k < count($this->questions); $k++) {
-                    $q = $this->questions[$k]->toArray();
-                    $q['id'] = $k;
-                    if ($this->isEnded()) { // if the survey is ended, then adds here the results of this question
-                        $sql = $this->questions[$k]->buildResultRequest();
-                        if ($sql != '') {
-                            $q['result'] = XDB::iterator($sql, $this->id, $k);
-                        }
-                    }
-                    $qArr[$k] = $q;
+                $pos = count($stack) - 1;
+                while ($stack[$pos]->qid != $question->parent) {
+                    --$pos;
+                    array_pop($stack);
                 }
-                $a['questions'] = $qArr;
+                Platal::assert(count($stack) > 0, "Invalid question structure");
+                Platal::assert($stack[$pos] instanceof SurveyQuestionContainer, "Invalid question type");
+                $stack[$pos]->addQuestion($question);
             }
-            return $a;
+            array_push($stack, $question);
         }
+        return true;
     }
-    // }}}
 
-    // {{{ function toCSV() : builds a CSV file containing all the results of the survey
-    public function toCSV($sep = ',', $enc = '"', $asep='|')
+    protected function preSave()
     {
-        $nbq = count($this->questions);
-        //require_once dirname(__FILE__) . '/../../classes/varstream.php';
-        VarStream::init();
-        global $csv_output;
-        $csv_output = '';
-        $csv = fopen('var://csv_output', 'w');
-        $line = ($this->isMode(self::MODE_XIDENT))? array('id', 'Nom', 'Prenom', 'Promo') : array('id');
-        for ($qid = 0; $qid < $nbq; $qid++) {
-            $line[] = $this->questions[$qid]->getCSVColumn(); // the fist line contains the questions
-        }
-        $users = array();
-        if ($this->isMode(self::MODE_XIDENT)) { // if the mode is non anonymous
-            $sql = 'SELECT v.id AS vid, a.nom, a.prenom, a.promo
-                      FROM survey_votes AS v
-                INNER JOIN auth_user_md5 AS a
-                        ON a.user_id=v.user_id
-                     WHERE v.survey_id={?}
-                  ORDER BY vid ASC;';
-            $res = XDB::iterator($sql, $this->id); // retrieves all users data
-            for ($u = $res->next(); $u != null; $u = $res->next()) {
-                $users[$u['vid']] = array('nom' => $u['nom'], 'prenom' => $u['prenom'], 'promo' => $u['promo']);
-            }
+        if (!is_null($this->voterFilter)) {
+            $this->voters = $this->voterFilter->exportConditions();
+        } else {
+            $this->voters = null;
         }
-        $sql = 'SELECT v.id AS vid, a.question_id AS qid, a.answer
-                  FROM survey_votes AS v
-             LEFT JOIN survey_answers AS a
-                    ON a.vote_id=v.id
-                 WHERE v.survey_id={?}
-              ORDER BY vid ASC, qid ASC;';
-        $res = XDB::iterator($sql, $this->id); // retrieves all answers from database
-        $cur = $res->next();
-        $vid = -1;
-        $vid_ = 0;
-        $first = ($this->isMode(self::MODE_XIDENT))? 4 : 1;
-        while ($cur != null) {
-            if ($vid != $cur['vid']) { // if the vote id changes, then starts a new line
-                fputcsv($csv, $line, $sep, $enc); // stores the former line into $csv_output
-                $vid = $cur['vid'];
-                $line = array_fill(0, $first + $nbq, ''); // creates an array full of empty string
-                $line[0] = $vid_; // the first field is a 'clean' vote id (not the one stored in database)
-                if ($this->isMode(self::MODE_XIDENT)) { // if the mode is non anonymous
-                    if (array_key_exists($vid, $users) && is_array($users[$vid])) { // and if the user data can be found
-                        $line[1] = $users[$vid]['nom']; // adds the user data (in the first fields of the line)
-                        $line[2] = $users[$vid]['prenom'];
-                        $line[3] = $users[$vid]['promo'];
-                    }
-                }
-                $vid_++;
-            }
-            $fid = $first + $cur['qid']; // computes the field id
-            if ($line[$fid] != '') {  // if this field already contains something
-                $line[$fid] .= $asep; // then adds a separator before adding the new answer
-            }
-            $line[$fid] .= $cur['answer']; // adds the current answer to the correct field
-            $cur = $res->next(); // gets next answer
+        if (!is_null($this->viewerFilter)) {
+            $this->viewers = $this->viewerFilter->exportConditions();
+        } else {
+            $this->viewers = null;
         }
-        fputcsv($csv, $line, $sep, $enc); // stores the last line into $csv_output
-        return $csv_output;
+        return true;
     }
-    // }}}
 
-    // {{{ function factory($type, $args) : builds a question according to the given type
-    public function factory($t, $args)
+    protected function postSave()
     {
-        switch ($t) {
-        case 'text':
-            return new SurveyText($args);
-        case 'textarea':
-            return new SurveyTextarea($args);
-        case 'num':
-            return new SurveyNum($args);
-        case 'radio':
-            return new SurveyRadio($args);
-        case 'checkbox':
-            return new SurveyCheckbox($args);
-        case 'personal':
-            return new SurveyPersonal($args);
-        default:
-            return null;
+        $questions = array();
+        $selector = new SurveyQuestion($this);
+        $selector->sid = $this->id;
+        $selector->delete();
+
+        $this->reassignQuestionIds();
+        foreach ($this->questions as $question) {
+            $question->sid = $this->id;
+            $question->insert();
         }
     }
-    // }}}
 
-    // {{{ questions manipulation functions
-    public function addQuestion($i, $c)
+    public function addQuestion(SurveyQuestion $question, $pos = null)
     {
-        $i = intval($i);
-        if ($this->valid || $i > count($this->questions)) {
-            return false;
+        $question->parent = null;
+        if (is_null($pos)) {
+            $this->questions[] = $question;
         } else {
-            array_splice($this->questions, $i, 0, array($c));
-            return true;
+            array_splice($this->questions, $pos, 0, $question);
         }
     }
 
-    public function delQuestion($i)
+    public function newQuestion($type, $pos = null)
     {
-        $i = intval($i);
-        if ($this->valid || !array_key_exists($i, $this->questions)) {
-            return false;
-        } else {
-            array_splice($this->questions, $i, 1);
-            return true;
-        }
+        $question = SurveyQuestion::instanceForType($this, $type);
+        $this->addQuestion($question, $pos);
+        return $question;
     }
 
-    public function editQuestion($i, $a)
+    public function questionForId($qid)
     {
-        if ($i == 'root') {
-            $this->update($a);
-        } else {
-            $i = intval($i);
-            if ($this->valid ||!array_key_exists($i, $this->questions)) {
-                return false;
-            } else {
-                $this->questions[$i]->update($a);
+        $prev = null;
+        foreach ($this->questions as $question) {
+            if ($qid == $question->qid) {
+                return $question;
+            } else if ($qid < $question->qid) {
+                Platal::assert($prev instanceof SurveyQuestionGroup,
+                               "Id gap must be caused by question groups");
+                return $prev->child($qid);
             }
+            $prev = $question;
         }
-        return true;
+        Platal::assert($prev instanceof SurveyQuestionGroup,
+                       "Id gap must be caused by question groups");
+        return $prev->child($qid);
     }
-    // }}}
-
-    // {{{ function checkSyntax() : checks syntax of the questions (currently the root only) before storing the survey in database
-    private static $errorMessages = array(
-        "dateformat"  => "la date de fin de sondage est mal formatt&#233;e : elle doit respecter la syntaxe dd/mm/aaaa",
-        "datepassed"  => "la date de fin de sondage est d&#233;j&#224; d&#233;pass&#233;e : vous devez pr&#233;ciser une date future",
-        "promoformat" => "les restrictions &#224; certaines promotions sont mal formatt&#233;es"
-    );
 
-    public function checkSyntax()
+    public function reassignQuestionIds()
     {
-        $rArr = array();
-        if (!preg_match('#^\d{4}-\d{2}-\d{2}$#', $this->end)) {
-            $rArr[] = array('question' => 'root', 'error' => self::$errorMessages["dateformat"]);
-        } else {
-            // checks that the end date given is not already passed
-            // (unless the survey has already been validated : an admin can have a validated survey expired)
-            if (!$this->valid && $this->isEnded()) {
-                $rArr[] = array('question' => 'root', 'error' => self::$errorMessages["datepassed"]);
+        $id = 0;
+        foreach ($this->questions as $question) {
+            $question->qid = $id;
+            if ($question instanceof SurveyQuestionContainer) {
+                $id = $question->reassignQuestionIds();
+            } else {
+                $id++;
             }
         }
-        if ($this->promos != '' && !preg_match('#^(\d{4}-?|(\d{4})?-\d{4})(,(\d{4}-?|(\d{4})?-\d{4}))*$#', $this->promos)) {
-            $rArr[] = array('question' => 'root', 'error' => self::$errorMessages["promoformat"]);
-        }
-        return (empty($rArr))? null : $rArr;
+        return $id;
     }
-    // }}}
 
-    // {{{ functions that manipulate surveys in database
-    // {{{ static function retrieveList() : gets the list of available survey (current, old and not validated surveys)
-    public static function retrieveList($type, $tpl = true)
+    public function export()
     {
-        switch ($type) {
-        case 'w':
-        case 'waiting' :
-            $where = 'valid=0';
-            break;
-        case 'c':
-        case 'current':
-            $where = 'valid=1 AND end > NOW()';
-            break;
-        case 'o':
-        case 'old':
-            $where = 'valid=1 AND end <= NOW()';
-            break;
-        default:
-            return null;
-        }
-        $sql = 'SELECT id, title, end, mode
-                  FROM survey_surveys
-                 WHERE '.$where.';';
-        if ($tpl) {
-            return XDB::iterator($sql);
-        } else {
-            return XDB::iterRow($sql);
+        $export = parent::export();
+        $export['questions'] = array();
+        foreach ($this->questions as $question) {
+            $export['questions'][] = $question->export();
         }
+        return $export;
     }
-    // }}}
 
-    // {{{ static function retrieveSurvey() : gets a survey in database (and unserialize the survey object structure)
-    public static function retrieveSurvey($sid)
+    /* Return an indicator of the progression of the survey:
+     *  negative values means 'the survey is not started'
+     *  0 means 'the survey is in progress'
+     *  positive values means 'the survey expired'
+     */
+    public function progression()
     {
-        $sql = 'SELECT questions, title, description, end, mode, promos, valid
-                  FROM survey_surveys
-                 WHERE id={?}';
-        $res = XDB::query($sql, $sid);
-        $data = $res->fetchOneAssoc();
-        if (is_null($data) || !is_array($data)) {
-            return null;
+        if (!$this->flags->hasFlag('validated')) {
+            return -2;
         }
-        $survey = new Survey($data, $sid, (boolean) $data['valid'], unserialize($data['questions']));
-        return $survey;
-    }
-    // }}}
-
-    // {{{ static function retrieveSurveyInfo() : gets information about a survey (title, description, end date, restrictions) but does not unserialize the survey object structure
-    public static function retrieveSurveyInfo($sid)
-    {
-        $sql = 'SELECT title, description, end, mode, promos, valid
-                  FROM survey_surveys
-                 WHERE id={?}';
-        $res = XDB::query($sql, $sid);
-        return $res->fetchOneAssoc();
-    }
-    // }}}
-
-    // {{{ function proposeSurvey() : stores a proposition of survey in database (before validation)
-    public function proposeSurvey()
-    {
-        $sql = 'INSERT INTO survey_surveys
-                        SET questions={?},
-                            title={?},
-                            description={?},
-                            author_id={?},
-                            end={?},
-                            mode={?},
-                            promos={?},
-                            valid=0;';
-        return XDB::execute($sql, serialize($this->questions), $this->title, $this->description, S::v('uid'), $this->end, $this->mode, $this->promos);
-    }
-    // }}}
-
-    // {{{ function updateSurvey() : updates a survey in database (before validation)
-    public function updateSurvey()
-    {
-        if ($this->id == -1) {
-            return false;
+        $now = time();
+        if ($this->begin->format('U') > $now) {
+            return -1;
         }
-        $sql = 'UPDATE survey_surveys
-                   SET questions={?},
-                       title={?},
-                       description={?},
-                       end={?},
-                       mode={?},
-                       promos={?}
-                 WHERE id={?};';
-        return XDB::execute($sql, serialize($this->questions), $this->title, $this->description, $this->end, $this->mode, $this->promos, $this->id);
-    }
-    // }}}
-
-    // {{{ static function validateSurvey() : validates a survey
-    public static function validateSurvey($sid)
-    {
-        $sql = 'UPDATE survey_surveys
-                   SET valid=1
-                 WHERE id={?};';
-        return XDB::execute($sql, $sid);
-    }
-    // }}}
-
-    // {{{ functions vote() and hasVoted() : handles vote to a survey
-    public function vote($uid, $args)
-    {
-        XDB::execute('INSERT INTO survey_votes
-                              SET survey_id={?}, user_id={?};', $this->id, $uid); // notes the user as having voted
-        $vid = XDB::insertId();
-        for ($i = 0; $i < count($this->questions); $i++) {
-            $ans = $this->questions[$i]->checkAnswer($args[$i]);
-            if (!is_null($ans) && is_array($ans)) {
-                foreach ($ans as $a) {
-                    XDB::execute('INSERT INTO survey_answers
-                                          SET vote_id     = {?},
-                                              question_id = {?},
-                                              answer      = {?}', $vid, $i, $a);
-                }
-            }
+        if ($this->end->format('U') <= $now) {
+            return 1;
         }
+        return 0;
     }
 
-    public function hasVoted($uid)
-    {
-        $res = XDB::query('SELECT id
-                             FROM survey_votes
-                            WHERE survey_id={?} AND user_id={?};', $this->id, $uid); // checks whether the user has already voted
-        return ($res->numRows() != 0);
-    }
-    // }}}
-
-    // {{{ static function deleteSurvey() : deletes a survey (and all its votes)
-    public static function deleteSurvey($sid)
-    {
-        $sql = 'DELETE s.*, v.*, a.*
-                  FROM survey_surveys AS s
-             LEFT JOIN survey_votes AS v
-                    ON v.survey_id=s.id
-             LEFT JOIN survey_answers AS a
-                    ON a.vote_id=v.id
-                 WHERE s.id={?};';
-        return XDB::execute($sql, $sid);
-    }
-    // }}}
-
-    // {{{ static function purgeVotes() : clears all votes concerning a survey (I'm not sure whether it's really useful)
-    public static function purgeVotes($sid)
-    {
-        $sql = 'DELETE v.*, a.*
-                  FROM survey_votes AS v
-             LEFT JOIN survey_answers AS a
-                    ON a.vote_id=v.id
-                 WHERE v.survey_id={?};';
-        return XDB::execute($sql, $sid);
-    }
-    // }}}
-
-    // }}}
-}
-// }}}
-
-// {{{ abstract class SurveyQuestion
-abstract class SurveyQuestion
-{
-    // {{{ common properties, constructor, and basic methods
-    private $question;
-    private $comment;
-
-    public function __construct($args)
-    {
-        $this->update($args);
-    }
-
-    public function update($a)
-    {
-        $this->question = $a['question'];
-        $this->comment  = $a['comment'];
-    }
-
-    abstract protected function getQuestionType();
-    // }}}
-
-    // {{{ function toArray() : converts to array
-    public function toArray()
-    {
-        return array('type' => $this->getQuestionType(), 'question' => $this->question, 'comment' => $this->comment);
-    }
-    // }}}
-
-    // {{{ function checkSyntax() : checks question elements (before storing into database), not currently needed (with new structure)
-    protected function checkSyntax()
-    {
-        return null;
-    }
-    // }}}
-
-    // {{{ function checkAnswer : returns a correctly formatted answer (or nothing empty string if error)
-    public function checkAnswer($ans)
-    {
-        return null;
-    }
-    // }}}
-
-    // {{{ functions regarding the results of a survey
-    public function buildResultRequest()
-    {
-        return '';
-    }
-
-    public function getCSVColumn()
-    {
-        return $this->question;
-    }
-    // }}}
-}
-// }}}
-
-// {{{ abstract class SurveySimple and its derived classes : "opended" questions
-// {{{ abstract class SurveySimple extends SurveyQuestion
-abstract class SurveySimple extends SurveyQuestion
-{
-    public function checkAnswer($ans)
-    {
-        return array($ans);
-    }
-
-    public function buildResultRequest()
-    {
-        $sql = 'SELECT answer
-                  FROM survey_answers
-                 WHERE vote_id IN (SELECT id FROM survey_votes WHERE survey_id={?})
-                   AND question_id={?}
-              ORDER BY RAND()
-                 LIMIT 5;';
-        return $sql;
-    }
-}
-// }}}
-
-// {{{ class SurveyText extends SurveySimple : simple text field, allowing a few words
-class SurveyText extends SurveySimple
-{
-    public function getQuestionType()
-    {
-        return "text";
-    }
-}
-// }}}
-
-// {{{ class SurveyTextarea extends SurveySimple : textarea field, allowing longer comments
-class SurveyTextarea extends SurveySimple
-{
-    public function getQuestionType()
+    public function canSee(User $user)
     {
-        return "textarea";
-    }
-}
-// }}}
-
-// {{{ class SurveyNum extends SurveySimple : allows numerical answers
-class SurveyNum extends SurveySimple
-{
-    public function checkAnswer($ans)
-    {
-        return array(intval($ans));
-    }
-
-    protected function getQuestionType()
-    {
-        return "num";
-    }
-}
-// }}}
-// }}}
-
-// {{{ abstract class SurveyList and its derived classes : restricted questions that allows only a list of possible answers
-// {{{ abstract class SurveyList extends SurveyQuestion
-abstract class SurveyList extends SurveyQuestion
-{
-    protected $choices;
-
-    public function update($args)
-    {
-        parent::update($args);
-        $this->choices = explode('|', $args['options']);
+        if ($this->canSeeResults($user) || $this->canVote($user)) {
+            return true;
+        }
+        return false;
     }
 
-    public function toArray()
+    public function canSeeResults(User $user)
     {
-        $rArr = parent::toArray();
-        $rArr['choices'] = $this->choices;
-        $rArr['options'] = implode('|', $this->choices);
-        return $rArr;
+        if ($user->id() == $this->uid || $user->hasFlag('admin')) {
+            return true;
+        }
+        if (is_null($this->viewerFilter)) {
+            return $this->viewerFilter->checkUser($user);
+        }
+        return false;
     }
 
-    public function buildResultRequest()
+    public function canVote(User $user)
     {
-        $sql = 'SELECT answer, COUNT(id) AS count
-                  FROM survey_answers
-                 WHERE vote_id IN (SELECT id FROM survey_votes WHERE survey_id={?})
-                   AND question_id={?}
-              GROUP BY answer ASC';
-        return $sql;
+        $status = $this->progression();
+        if ($status < 0) {
+            return "Ce sondage n'est pas encore commencé";
+        } else if ($status > 0) {
+            return "Ce sondage est terminé";
+        }
+        if (!is_null($this->voterFilter) && !$this->voterFilter->checkUser($user)) {
+            return "Ce sondage ne s'adresse pas à toi";
+        }
+        $vote = SurveyVote::getVote($this, $user, false);
+        if (is_null($vote)) {
+            return "Tu as déjà voté à ce sondage.";
+        }
+        return true;
     }
 
-    public function getCSVColumn()
+    public function vote(User $user, array $answers)
     {
-        $r = parent::getCSVColumn();
-        if (empty($this->choices)) {
-            return $r;
+        if (!$this->canVote($user)) {
+            return array('survey' => "Tu n'es pas autorisé à voter à ce sondage.");
+        }
+        $vote = SurveyVote::getVote($this, $user);
+        if (is_null($vote)) {
+            return $vote;
         }
-        $r .= ' [0 => '.$this->choices[0];
-        for ($k = 1; $k < count($this->choices); $k++) {
-            $r .= ', '.$k.' => '.$this->choices[$k];
+        $answers = new PlDict($answers);
+        foreach ($this->questions as $question) {
+            $question->vote($vote, $answers);
         }
-        $r .= ']';
-        return $r;
+        return $vote;
     }
-}
-// }}}
 
-// {{{ class SurveyRadio extends SurveyList : radio question, allows one answer among the list offered
-class SurveyRadio extends SurveyList
-{
-    public function checkAnswer($ans)
+    public static function get($name, $fetchQuestions = true)
     {
-        return (array_key_exists($ans, $this->choices))? array($ans) : null;
+        if (is_array($name)) {
+            $name = $name[0];
+        }
+        $survey = new Survey();
+        $survey->fetchQuestions = $fetchQuestions;
+        if (can_convert_to_integer($name)) {
+            $survey->id = $name;
+        } else {
+            $survey->shortname = $name;
+        }
+        if (!$survey->fetch()) {
+            return null;
+        }
+        return $survey;
     }
 
-    protected function getQuestionType()
+    public static function iterActive()
     {
-        return "radio";
+        $survey = new Survey();
+        $survey->fetchQuestions = false;
+        return $survey->iterateOnCondition('begin <= CURDATE() AND end >= CURDATE()
+                                            AND FIND_IN_SET(\'validated\', flags)');
     }
 }
-// }}}
 
-// {{{ class SurveyCheckbox extends SurveyList : checkbox question, allows any number of answers among the list offered
-class SurveyCheckbox extends SurveyList
+class ShortNameFieldValidator implements PlDBTableFieldValidator
 {
-    public function checkAnswer($ans)
+    public function __construct(PlDBTableField $field, $value)
     {
-        $rep = array();
-        foreach ($ans as $a) {
-            $a = intval($a);
-            if (array_key_exists($a, $this->choices)) {
-                $rep[] = $a;
-            }
+        if (can_convert_to_integer($value) || !preg_match('/^[a-z0-9]+[-_\.a-z0-9]*[a-z0-9]+$/i', $value)) {
+            throw new PlDBBadValueException($value, $field,
+                                            'The shortname can only contain alphanumerical caracters, dashes, underscores and dots');
         }
-        return (count($rep) == 0)? null : $rep;
-    }
-
-    protected function getQuestionType()
-    {
-        return "checkbox";
     }
 }
-// }}}
-// }}}
 
-// vim:set et sw=4 sts=4 sws=4 foldmethod=marker enc=utf-8:
+// vim:set et sw=4 sts=4 ts=4 foldmethod=marker enc=utf-8:
 ?>