Feature #1742 - Survey completions may be registered in the gradebook. The student may gain maximal score of 1 point for a completed survey. The the gained score is multiplied by the weight given. This implementation does not require database changes for 1.8.7.1.
Ivan Tcholakov
15 years ago
parent
16017dadd7
commit
e5423bbee9
@ -0,0 +1,248 @@ |
||||
<?php |
||||
/* For licensing terms, see /license.txt */ |
||||
|
||||
/** |
||||
* Gradebook link to a survey item |
||||
* @author Ivan Tcholakov <ivantcholakov@gmail.com>, 2010 |
||||
* @package chamilo.gradebook |
||||
*/ |
||||
|
||||
class SurveyLink extends AbstractLink |
||||
{ |
||||
private $survey_table = null; |
||||
|
||||
function SurveyLink() { |
||||
$this->set_type(LINK_SURVEY); |
||||
} |
||||
|
||||
public function get_name() { |
||||
$this->get_survey_data(); |
||||
return $this->survey_data['code'].': '.self::html_to_text($this->survey_data['title']); |
||||
} |
||||
|
||||
public function get_description() { |
||||
$this->get_survey_data(); |
||||
return $this->survey_data['subtitle']; |
||||
} |
||||
|
||||
public function get_type_name() { |
||||
return get_lang('Survey'); |
||||
} |
||||
|
||||
public function is_allowed_to_change_name() { |
||||
return false; |
||||
} |
||||
|
||||
public function needs_name_and_description() { |
||||
return false; |
||||
} |
||||
|
||||
public function needs_max() { |
||||
return false; |
||||
} |
||||
|
||||
public function needs_results() { |
||||
return false; |
||||
} |
||||
|
||||
/** |
||||
* Generates an array of all surveys available. |
||||
* @return array 2-dimensional array - every element contains 2 subelements (id, name) |
||||
*/ |
||||
public function get_all_links() { |
||||
if (empty($this->course_code)) { |
||||
die('Error in get_all_links() : course code not set'); |
||||
} |
||||
$tbl_survey = $this->get_survey_table(); |
||||
$session_id = api_get_session_id(); |
||||
$sql = 'SELECT survey_id, title, code FROM '.$tbl_survey.' WHERE session_id = '.intval($session_id).''; |
||||
$result = Database::query($sql); |
||||
while ($data = Database::fetch_array($result)) { |
||||
$links[] = array($data['survey_id'], api_trunc_str($data['code'].': '.self::html_to_text($data['title']), 80)); |
||||
}; |
||||
return isset($links) ? $links : null; |
||||
} |
||||
|
||||
/** |
||||
* Generates an array of surveys that a teacher hasn't created a link for. |
||||
* @return array 2-dimensional array - every element contains 2 subelements (id, name) |
||||
*/ |
||||
public function get_not_created_links() { |
||||
if (empty($this->course_code)) { |
||||
die('Error in get_not_created_links() : course code not set'); |
||||
} |
||||
$tbl_grade_links = Database :: get_main_table(TABLE_MAIN_GRADEBOOK_LINK); |
||||
|
||||
$sql = 'SELECT survey_id, title, code |
||||
FROM '.$this->get_survey_table().' AS srv |
||||
WHERE survey_id NOT IN |
||||
(SELECT ref_id FROM '.$tbl_grade_links.' |
||||
WHERE type = '.LINK_SURVEY." AND course_code = '".$this->get_course_code()."'" |
||||
.') AND srv.session_id='.api_get_session_id().''; |
||||
$result = Database::query($sql); |
||||
|
||||
$links = array(); |
||||
while ($data = Database::fetch_array($result)) { |
||||
$links[] = array($data['survey_id'], api_trunc_str($data['code'].': '.self::html_to_text($data['title']), 80)); |
||||
} |
||||
return $links; |
||||
} |
||||
|
||||
/** |
||||
* Has anyone done this survey yet? |
||||
*/ |
||||
public function has_results() { |
||||
$course_info = Database :: get_course_info($this->get_course_code()); |
||||
$database_name = (empty($course_info['db_name'])) ? $course_info['dbName'] : $course_info['db_name']; |
||||
|
||||
if ($database_name != '') { |
||||
$ref_id = intval($this->get_ref_id()); |
||||
$session_id = api_get_session_id(); |
||||
$tbl_survey = Database::get_course_table(TABLE_SURVEY, $database_name); |
||||
$tbl_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION, $database_name); |
||||
|
||||
$get_individual_score = !is_null($stud_id); |
||||
|
||||
$sql = 'SELECT COUNT(i.answered) FROM '.$tbl_survey.' AS s JOIN '.$tbl_survey_invitation.' AS i |
||||
ON s.code = i.survey_code |
||||
WHERE s.survey_id = '.$ref_id.' AND i.session_id = '.$session_id; |
||||
|
||||
$sql_result = Database::query($sql); |
||||
$data = Database::fetch_array($sql_result); |
||||
return ($data[0] != 0); |
||||
} |
||||
|
||||
return false; |
||||
} |
||||
|
||||
public function calc_score($stud_id = null) { |
||||
|
||||
// Note: Max score is assumed to be always 1 for surveys, |
||||
// only student's participation is to be taken into account. |
||||
$max_score = 1; |
||||
|
||||
$course_info = Database :: get_course_info($this->get_course_code()); |
||||
$database_name = (empty($course_info['db_name'])) ? $course_info['dbName'] : $course_info['db_name']; |
||||
|
||||
if ($database_name != '') { |
||||
$ref_id = intval($this->get_ref_id()); |
||||
$session_id = api_get_session_id(); |
||||
$tbl_survey = Database::get_course_table(TABLE_SURVEY, $database_name); |
||||
$tbl_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION, $database_name); |
||||
|
||||
$get_individual_score = !is_null($stud_id); |
||||
|
||||
$sql = 'SELECT i.answered FROM '.$tbl_survey.' AS s JOIN '.$tbl_survey_invitation.' AS i |
||||
ON s.code = i.survey_code |
||||
WHERE s.survey_id = '.$ref_id.' AND i.session_id = '.$session_id; |
||||
|
||||
if ($get_individual_score) { |
||||
$sql .= ' AND i.user = '.intval($stud_id); |
||||
} |
||||
|
||||
$sql_result = Database::query($sql); |
||||
|
||||
if ($get_individual_score) { |
||||
|
||||
// for 1 student |
||||
|
||||
if ($data = Database::fetch_array($sql_result)) { |
||||
return array ($data['answered'] ? $max_score : 0, $max_score); |
||||
} |
||||
return array(0, $max_score); |
||||
|
||||
} else { |
||||
|
||||
// for all the students -> get average |
||||
|
||||
$students = array(); |
||||
$rescount = 0; |
||||
$sum = 0; |
||||
|
||||
while ($data = Database::fetch_array($sql_result)) { |
||||
$sum += $data['answered'] ? $max_score : 0; |
||||
$rescount++; |
||||
} |
||||
$sum = $sum / $max_score; |
||||
|
||||
if ($rescount == 0) { |
||||
return null; |
||||
} |
||||
return array($sum, $rescount); |
||||
} |
||||
} |
||||
|
||||
return null; |
||||
} |
||||
|
||||
/** |
||||
* Lazy load function to get the database table of the surveys |
||||
*/ |
||||
private function get_survey_table() { |
||||
$course_info = Database :: get_course_info($this->get_course_code()); |
||||
$database_name = isset($course_info['db_name']) ? $course_info['db_name'] : ''; |
||||
if ($database_name != '') { |
||||
if (!isset($this->survey_table)) { |
||||
$this->survey_table = Database :: get_course_table(TABLE_SURVEY, $database_name); |
||||
} |
||||
return $this->survey_table; |
||||
} else { |
||||
return ''; |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* Check if this still links to a survey |
||||
*/ |
||||
public function is_valid_link() { |
||||
$session_id = api_get_session_id(); |
||||
$sql = 'SELECT count(survey_id) FROM '.$this->get_survey_table().' |
||||
WHERE survey_id = '.intval($this->get_ref_id()).' AND session_id='.intval($session_id).''; |
||||
$result = Database::query($sql); |
||||
$number = Database::fetch_row($result); |
||||
return ($number[0] != 0); |
||||
} |
||||
|
||||
public function get_test_id() { |
||||
return 'DEBUG:ID'; |
||||
} |
||||
|
||||
public function get_link() { |
||||
if (api_is_allowed_to_create_course()) { // Let students make access only through "Surveys" tool. |
||||
$tbl_name = $this->get_survey_table(); |
||||
$session_id = api_get_session_id(); |
||||
if ($tbl_name != '') { |
||||
$sql = 'SELECT survey_id FROM '.$this->get_survey_table().' |
||||
WHERE survey_id = '.intval($this->get_ref_id()).' AND session_id = '.intval($session_id).' '; |
||||
$result = Database::query($sql); |
||||
$row = Database::fetch_array($result, 'ASSOC'); |
||||
$survey_id = $row['survey_id']; |
||||
return api_get_path(WEB_PATH).'main/survey/reporting.php?cidReq='.$this->get_course_code().'&survey_id='.$survey_id; |
||||
} |
||||
} |
||||
return null; |
||||
} |
||||
|
||||
private function get_survey_data() { |
||||
$tbl_name = $this->get_survey_table(); |
||||
$session_id = api_get_session_id(); |
||||
if ($tbl_name == '') { |
||||
return false; |
||||
} elseif (!isset($this->survey_data)) { |
||||
$sql = 'SELECT * FROM '.$tbl_name.' WHERE survey_id = '.intval($this->get_ref_id()).' AND session_id='.intval($session_id).''; |
||||
$query = Database::query($sql); |
||||
$this->survey_data = Database::fetch_array($query); |
||||
} |
||||
return $this->survey_data; |
||||
} |
||||
|
||||
public function get_icon_name() { |
||||
return 'survey'; |
||||
} |
||||
|
||||
private static function html_to_text($string) { |
||||
return trim(api_html_entity_decode(strip_tags(str_ireplace(array('<p>', '</p>', '<br />', '<br/>', '<br>'), array('', ' ', ' ', ' ', ' '), $string)), ENT_QUOTES)); |
||||
} |
||||
|
||||
} |
||||
?> |
||||
Loading…
Reference in new issue