%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/* For licensing terms, see /license.txt */
use Chamilo\CoreBundle\Component\Utils\ChamiloApi;
use Chamilo\CoreBundle\Entity\GradebookLink;
use Chamilo\CoreBundle\Entity\TrackEExerciseConfirmation;
use Chamilo\CoreBundle\Entity\TrackEHotspot;
use Chamilo\CourseBundle\Entity\CExerciseCategory;
use ChamiloSession as Session;
use Doctrine\DBAL\Types\Type;
/**
* Class Exercise.
*
* Allows to instantiate an object of type Exercise
*
* @todo use getters and setters correctly
*
* @author Olivier Brouckaert
* @author Julio Montoya Cleaning exercises
* Modified by Hubert Borderiou #294
*/
class Exercise
{
public const PAGINATION_ITEMS_PER_PAGE = 20;
public $iid;
public $name;
public $title;
public $exercise;
public $description;
public $sound;
public $type; //ALL_ON_ONE_PAGE or ONE_PER_PAGE
public $random;
public $random_answers;
public $active;
public $timeLimit;
public $attempts;
public $feedback_type;
public $end_time;
public $start_time;
public $questionList; // array with the list of this exercise's questions
/* including question list of the media */
public $questionListUncompressed;
public $results_disabled;
public $expired_time;
public $course;
public $course_id;
public $propagate_neg;
public $saveCorrectAnswers;
public $review_answers;
public $randomByCat;
public $text_when_finished;
public $text_when_finished_failure;
public $display_category_name;
public $pass_percentage;
public $edit_exercise_in_lp = false;
public $is_gradebook_locked = false;
public $exercise_was_added_in_lp = false;
public $lpList = [];
public $force_edit_exercise_in_lp = false;
public $categories;
public $categories_grouping = true;
public $endButton = 0;
public $categoryWithQuestionList;
public $mediaList;
public $loadQuestionAJAX = false;
// Notification send to the teacher.
public $emailNotificationTemplate = null;
// Notification send to the student.
public $emailNotificationTemplateToUser = null;
public $countQuestions = 0;
public $fastEdition = false;
public $modelType = 1;
public $questionSelectionType = EX_Q_SELECTION_ORDERED;
public $hideQuestionTitle = 0;
public $scoreTypeModel = 0;
public $categoryMinusOne = true; // Shows the category -1: See BT#6540
public $globalCategoryId = null;
public $onSuccessMessage = null;
public $onFailedMessage = null;
public $emailAlert;
public $notifyUserByEmail = '';
public $sessionId = 0;
public $questionFeedbackEnabled = false;
public $questionTypeWithFeedback;
public $showPreviousButton;
public $notifications;
public $export = false;
public $autolaunch;
public $exerciseCategoryId;
public $pageResultConfiguration;
public $hideQuestionNumber;
public $preventBackwards;
public $currentQuestion;
public $hideComment;
public $hideNoAnswer;
public $hideExpectedAnswer;
public $forceShowExpectedChoiceColumn;
public $disableHideCorrectAnsweredQuestions;
public $hideAttemptsTableOnStartPage;
/**
* Constructor of the class.
*
* @param int $courseId
*
* @author Olivier Brouckaert
*/
public function __construct($courseId = 0)
{
$this->iid = 0;
$this->exercise = '';
$this->description = '';
$this->sound = '';
$this->type = ALL_ON_ONE_PAGE;
$this->random = 0;
$this->random_answers = 0;
$this->active = 1;
$this->questionList = [];
$this->timeLimit = 0;
$this->end_time = '';
$this->start_time = '';
$this->results_disabled = 1;
$this->expired_time = 0;
$this->propagate_neg = 0;
$this->saveCorrectAnswers = 0;
$this->review_answers = false;
$this->randomByCat = 0;
$this->text_when_finished = '';
$this->text_when_finished_failure = '';
$this->display_category_name = 0;
$this->pass_percentage = 0;
$this->modelType = 1;
$this->questionSelectionType = EX_Q_SELECTION_ORDERED;
$this->endButton = 0;
$this->scoreTypeModel = 0;
$this->globalCategoryId = null;
$this->notifications = [];
$this->exerciseCategoryId = null;
$this->pageResultConfiguration;
$this->hideQuestionNumber = 0;
$this->preventBackwards = 0;
$this->hideComment = false;
$this->hideNoAnswer = false;
$this->hideExpectedAnswer = false;
$this->disableHideCorrectAnsweredQuestions = false;
$this->hideAttemptsTableOnStartPage = 0;
if (!empty($courseId)) {
$courseInfo = api_get_course_info_by_id($courseId);
} else {
$courseInfo = api_get_course_info();
}
$this->course_id = $courseInfo['real_id'];
$this->course = $courseInfo;
$this->sessionId = api_get_session_id();
// ALTER TABLE c_quiz_question ADD COLUMN feedback text;
$this->questionFeedbackEnabled = api_get_configuration_value('allow_quiz_question_feedback');
$this->showPreviousButton = true;
}
/**
* Reads exercise information from the data base.
*
* @author Olivier Brouckaert
*
* @param int $id - exercise Id
* @param bool $parseQuestionList
*
* @return bool - true if exercise exists, otherwise false
*/
public function read($id, $parseQuestionList = true)
{
$table = Database::get_course_table(TABLE_QUIZ_TEST);
$id = (int) $id;
if (empty($this->course_id)) {
return false;
}
$sql = "SELECT * FROM $table WHERE iid = ".$id;
$result = Database::query($sql);
// if the exercise has been found
if ($object = Database::fetch_object($result)) {
$this->iid = $object->iid;
$this->exercise = $object->title;
$this->name = $object->title;
$this->title = $object->title;
$this->description = $object->description;
$this->sound = $object->sound;
$this->type = $object->type;
if (empty($this->type)) {
$this->type = ONE_PER_PAGE;
}
$this->random = $object->random;
$this->random_answers = $object->random_answers;
$this->active = $object->active;
$this->results_disabled = $object->results_disabled;
$this->attempts = $object->max_attempt;
$this->feedback_type = $object->feedback_type;
$this->sessionId = $object->session_id;
$this->propagate_neg = $object->propagate_neg;
$this->saveCorrectAnswers = $object->save_correct_answers;
$this->randomByCat = $object->random_by_category;
$this->text_when_finished = $object->text_when_finished;
$this->text_when_finished_failure = isset($object->text_when_finished_failure) ? $object->text_when_finished_failure : null;
$this->display_category_name = $object->display_category_name;
$this->pass_percentage = $object->pass_percentage;
$this->is_gradebook_locked = api_resource_is_locked_by_gradebook($id, LINK_EXERCISE);
$this->review_answers = (isset($object->review_answers) && $object->review_answers == 1) ? true : false;
$this->globalCategoryId = isset($object->global_category_id) ? $object->global_category_id : null;
$this->questionSelectionType = isset($object->question_selection_type) ? (int) $object->question_selection_type : null;
$this->hideQuestionTitle = isset($object->hide_question_title) ? (int) $object->hide_question_title : 0;
$this->autolaunch = isset($object->autolaunch) ? (int) $object->autolaunch : 0;
$this->exerciseCategoryId = isset($object->exercise_category_id) ? (int) $object->exercise_category_id : null;
$this->preventBackwards = isset($object->prevent_backwards) ? (int) $object->prevent_backwards : 0;
$this->exercise_was_added_in_lp = false;
$this->lpList = [];
$this->notifications = [];
if (!empty($object->notifications)) {
$this->notifications = explode(',', $object->notifications);
}
if (!empty($object->page_result_configuration)) {
$this->pageResultConfiguration = $object->page_result_configuration;
}
if (isset($object->hide_question_number)) {
$this->hideQuestionNumber = $object->hide_question_number == 1;
}
if (isset($object->hide_attempts_table)) {
$this->hideAttemptsTableOnStartPage = $object->hide_attempts_table == 1;
}
if (isset($object->show_previous_button)) {
$this->showPreviousButton = $object->show_previous_button == 1;
}
$list = self::getLpListFromExercise($id, $this->course_id);
if (!empty($list)) {
$this->exercise_was_added_in_lp = true;
$this->lpList = $list;
}
$this->force_edit_exercise_in_lp = api_get_configuration_value('force_edit_exercise_in_lp');
$this->edit_exercise_in_lp = true;
if ($this->exercise_was_added_in_lp) {
$this->edit_exercise_in_lp = $this->force_edit_exercise_in_lp == true;
}
if (!empty($object->end_time)) {
$this->end_time = $object->end_time;
}
if (!empty($object->start_time)) {
$this->start_time = $object->start_time;
}
// Control time
$this->expired_time = $object->expired_time;
// Checking if question_order is correctly set
if ($parseQuestionList) {
$this->setQuestionList(true);
}
//overload questions list with recorded questions list
//load questions only for exercises of type 'one question per page'
//this is needed only is there is no questions
// @todo not sure were in the code this is used somebody mess with the exercise tool
// @todo don't know who add that config and why $_configuration['live_exercise_tracking']
/*global $_configuration, $questionList;
if ($this->type == ONE_PER_PAGE && $_SERVER['REQUEST_METHOD'] != 'POST'
&& defined('QUESTION_LIST_ALREADY_LOGGED') &&
isset($_configuration['live_exercise_tracking']) && $_configuration['live_exercise_tracking']
) {
$this->questionList = $questionList;
}*/
return true;
}
return false;
}
/**
* @return string
*/
public function getCutTitle()
{
$title = $this->getUnformattedTitle();
return cut($title, EXERCISE_MAX_NAME_SIZE);
}
/**
* returns the exercise ID.
*
* @author Olivier Brouckaert
*
* @return int - exercise ID
*/
public function selectId()
{
return $this->iid;
}
/**
* returns the exercise title.
*
* @author Olivier Brouckaert
*
* @param bool $unformattedText Optional. Get the title without HTML tags
*
* @return string - exercise title
*/
public function selectTitle($unformattedText = false)
{
if ($unformattedText) {
return $this->getUnformattedTitle();
}
return $this->exercise;
}
/**
* Returns the maximum number of attempts set in the exercise configuration.
*
* @return int Maximum attempts allowed (0 if no limit)
*/
public function selectAttempts()
{
return $this->attempts;
}
/**
* Returns the number of FeedbackType
* 0: Feedback , 1: DirectFeedback, 2: NoFeedback.
*
* @return int - exercise attempts
*/
public function getFeedbackType()
{
return (int) $this->feedback_type;
}
/**
* returns the time limit.
*
* @return int
*/
public function selectTimeLimit()
{
return $this->timeLimit;
}
/**
* returns the exercise description.
*
* @author Olivier Brouckaert
*
* @return string - exercise description
*/
public function selectDescription()
{
return $this->description;
}
/**
* returns the exercise sound file.
*
* @author Olivier Brouckaert
*
* @return string - exercise description
*/
public function selectSound()
{
return $this->sound;
}
/**
* returns the exercise type.
*
* @author Olivier Brouckaert
*
* @return int - exercise type
*/
public function selectType()
{
return $this->type;
}
/**
* @return int
*/
public function getModelType()
{
return $this->modelType;
}
/**
* @return int
*/
public function selectEndButton()
{
return $this->endButton;
}
/**
* @author hubert borderiou 30-11-11
*
* @return int : do we display the question category name for students
*/
public function selectDisplayCategoryName()
{
return $this->display_category_name;
}
/**
* @return int
*/
public function selectPassPercentage()
{
return $this->pass_percentage;
}
/**
* Modify object to update the switch display_category_name.
*
* @author hubert borderiou 30-11-11
*
* @param int $value is an integer 0 or 1
*/
public function updateDisplayCategoryName($value)
{
$this->display_category_name = $value;
}
/**
* @author hubert borderiou 28-11-11
*
* @return string html text : the text to display ay the end of the test
*/
public function getTextWhenFinished()
{
return $this->text_when_finished;
}
/**
* @param string $text
*
* @author hubert borderiou 28-11-11
*/
public function updateTextWhenFinished($text)
{
$this->text_when_finished = $text;
}
/**
* Get the text to display when the user has failed the test.
*
* @return string html text : the text to display ay the end of the test
*/
public function getTextWhenFinishedFailure(): string
{
if (empty($this->text_when_finished_failure)) {
return '';
}
return $this->text_when_finished_failure;
}
/**
* Set the text to display when the user has succeeded in the test.
*/
public function setTextWhenFinishedFailure(string $text): void
{
$this->text_when_finished_failure = $text;
}
/**
* return 1 or 2 if randomByCat.
*
* @author hubert borderiou
*
* @return int - quiz random by category
*/
public function getRandomByCategory()
{
return $this->randomByCat;
}
/**
* return 0 if no random by cat
* return 1 if random by cat, categories shuffled
* return 2 if random by cat, categories sorted by alphabetic order.
*
* @author hubert borderiou
*
* @return int - quiz random by category
*/
public function isRandomByCat()
{
$res = EXERCISE_CATEGORY_RANDOM_DISABLED;
if ($this->randomByCat == EXERCISE_CATEGORY_RANDOM_SHUFFLED) {
$res = EXERCISE_CATEGORY_RANDOM_SHUFFLED;
} elseif ($this->randomByCat == EXERCISE_CATEGORY_RANDOM_ORDERED) {
$res = EXERCISE_CATEGORY_RANDOM_ORDERED;
}
return $res;
}
/**
* return nothing
* update randomByCat value for object.
*
* @param int $random
*
* @author hubert borderiou
*/
public function updateRandomByCat($random)
{
$this->randomByCat = EXERCISE_CATEGORY_RANDOM_DISABLED;
if (in_array(
$random,
[
EXERCISE_CATEGORY_RANDOM_SHUFFLED,
EXERCISE_CATEGORY_RANDOM_ORDERED,
EXERCISE_CATEGORY_RANDOM_DISABLED,
]
)) {
$this->randomByCat = $random;
}
}
/**
* Tells if questions are selected randomly, and if so returns the draws.
*
* @author Carlos Vargas
*
* @return int - results disabled exercise
*/
public function selectResultsDisabled()
{
return $this->results_disabled;
}
/**
* tells if questions are selected randomly, and if so returns the draws.
*
* @author Olivier Brouckaert
*
* @return bool
*/
public function isRandom()
{
$isRandom = false;
// "-1" means all questions will be random
if ($this->random > 0 || $this->random == -1) {
$isRandom = true;
}
return $isRandom;
}
/**
* returns random answers status.
*
* @author Juan Carlos Rana
*/
public function getRandomAnswers()
{
return $this->random_answers;
}
/**
* Same as isRandom() but has a name applied to values different than 0 or 1.
*
* @return int
*/
public function getShuffle()
{
return $this->random;
}
/**
* returns the exercise status (1 = enabled ; 0 = disabled).
*
* @author Olivier Brouckaert
*
* @return int - 1 if enabled, otherwise 0
*/
public function selectStatus()
{
return $this->active;
}
/**
* If false the question list will be managed as always if true
* the question will be filtered
* depending of the exercise settings (table c_quiz_rel_category).
*
* @param bool $status active or inactive grouping
*/
public function setCategoriesGrouping($status)
{
$this->categories_grouping = (bool) $status;
}
/**
* @return int
*/
public function getHideQuestionTitle()
{
return $this->hideQuestionTitle;
}
/**
* @param $value
*/
public function setHideQuestionTitle($value)
{
$this->hideQuestionTitle = (int) $value;
}
/**
* @return int
*/
public function getScoreTypeModel()
{
return $this->scoreTypeModel;
}
/**
* @param int $value
*/
public function setScoreTypeModel($value)
{
$this->scoreTypeModel = (int) $value;
}
/**
* @return int
*/
public function getGlobalCategoryId()
{
return $this->globalCategoryId;
}
/**
* @param int $value
*/
public function setGlobalCategoryId($value)
{
if (is_array($value) && isset($value[0])) {
$value = $value[0];
}
$this->globalCategoryId = (int) $value;
}
/**
* @param int $start
* @param int $limit
* @param int $sidx
* @param string $sord
* @param array $whereCondition
* @param array $extraFields
*
* @return array
*/
public function getQuestionListPagination(
$start,
$limit,
$sidx,
$sord,
$whereCondition = [],
$extraFields = []
) {
if (!empty($this->iid)) {
$category_list = TestCategory::getListOfCategoriesNameForTest(
$this->iid,
false
);
$TBL_EXERCICE_QUESTION = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$TBL_QUESTIONS = Database::get_course_table(TABLE_QUIZ_QUESTION);
$sql = "SELECT q.iid
FROM $TBL_EXERCICE_QUESTION e
INNER JOIN $TBL_QUESTIONS q ON e.question_id = q.iid
WHERE e.exercice_id = ".$this->iid." AND e.c_id = {$this->course_id}";
$orderCondition = ' ORDER BY question_order ';
if (!empty($sidx) && !empty($sord)) {
if ('question' === $sidx) {
if (in_array(strtolower($sord), ['desc', 'asc'])) {
$orderCondition = " ORDER BY q.question $sord";
}
}
}
$sql .= $orderCondition;
$limitCondition = null;
if (isset($start) && isset($limit)) {
$start = (int) $start;
$limit = (int) $limit;
$limitCondition = " LIMIT $start, $limit";
}
$sql .= $limitCondition;
$result = Database::query($sql);
$questions = [];
if (Database::num_rows($result)) {
if (!empty($extraFields)) {
$extraFieldValue = new ExtraFieldValue('question');
}
while ($question = Database::fetch_array($result, 'ASSOC')) {
/** @var Question $objQuestionTmp */
$objQuestionTmp = Question::read($question['iid']);
$category_labels = TestCategory::return_category_labels(
$objQuestionTmp->category_list,
$category_list
);
if (empty($category_labels)) {
$category_labels = '-';
}
// Question type
$typeImg = $objQuestionTmp->getTypePicture();
$typeExpl = $objQuestionTmp->getExplanation();
$question_media = null;
if (!empty($objQuestionTmp->parent_id)) {
$objQuestionMedia = Question::read($objQuestionTmp->parent_id);
$question_media = Question::getMediaLabel($objQuestionMedia->question);
}
$questionType = Display::tag(
'div',
Display::return_icon($typeImg, $typeExpl, [], ICON_SIZE_MEDIUM).$question_media
);
$question = [
'iid' => $question['iid'],
'question' => $objQuestionTmp->selectTitle(),
'type' => $questionType,
'category' => Display::tag(
'div',
'<a href="#" style="padding:0px; margin:0px;">'.$category_labels.'</a>'
),
'score' => $objQuestionTmp->selectWeighting(),
'level' => $objQuestionTmp->level,
];
if (!empty($extraFields)) {
foreach ($extraFields as $extraField) {
$value = $extraFieldValue->get_values_by_handler_and_field_id(
$question['iid'],
$extraField['id']
);
$stringValue = null;
if ($value) {
$stringValue = $value['field_value'];
}
$question[$extraField['field_variable']] = $stringValue;
}
}
$questions[] = $question;
}
}
return $questions;
}
}
/**
* Get question count per exercise from DB (any special treatment).
*
* @return int
*/
public function getQuestionCount()
{
$TBL_EXERCICE_QUESTION = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$TBL_QUESTIONS = Database::get_course_table(TABLE_QUIZ_QUESTION);
$sql = "SELECT count(q.iid) as count
FROM $TBL_EXERCICE_QUESTION e
INNER JOIN $TBL_QUESTIONS q
ON e.question_id = q.iid
WHERE
e.c_id = {$this->course_id} AND
e.exercice_id = {$this->iid}";
$result = Database::query($sql);
$count = 0;
if (Database::num_rows($result)) {
$row = Database::fetch_array($result);
$count = (int) $row['count'];
}
return $count;
}
/**
* @return array
*/
public function getQuestionOrderedListByName()
{
if (empty($this->course_id) || empty($this->iid)) {
return [];
}
$exerciseQuestionTable = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$questionTable = Database::get_course_table(TABLE_QUIZ_QUESTION);
// Getting question list from the order (question list drag n drop interface ).
$sql = "SELECT e.question_id
FROM $exerciseQuestionTable e
INNER JOIN $questionTable q
ON e.question_id= q.iid
WHERE
e.c_id = {$this->course_id} AND
e.exercice_id = {$this->iid}
ORDER BY q.question";
$result = Database::query($sql);
$list = [];
if (Database::num_rows($result)) {
$list = Database::store_result($result, 'ASSOC');
}
return $list;
}
/**
* Selecting question list depending in the exercise-category
* relationship (category table in exercise settings).
*
* @param array $question_list
* @param int $questionSelectionType
*
* @return array
*/
public function getQuestionListWithCategoryListFilteredByCategorySettings(
$question_list,
$questionSelectionType
) {
$result = [
'question_list' => [],
'category_with_questions_list' => [],
];
// Order/random categories
$cat = new TestCategory();
// Setting category order.
switch ($questionSelectionType) {
case EX_Q_SELECTION_ORDERED: // 1
case EX_Q_SELECTION_RANDOM: // 2
// This options are not allowed here.
break;
case EX_Q_SELECTION_CATEGORIES_ORDERED_QUESTIONS_ORDERED: // 3
$categoriesAddedInExercise = $cat->getCategoryExerciseTree(
$this,
$this->course['real_id'],
'title ASC',
false,
true
);
$questions_by_category = TestCategory::getQuestionsByCat(
$this->iid,
$question_list,
$categoriesAddedInExercise
);
$question_list = $this->pickQuestionsPerCategory(
$categoriesAddedInExercise,
$question_list,
$questions_by_category,
true,
false
);
break;
case EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_ORDERED: // 4
case EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_ORDERED_NO_GROUPED: // 7
$categoriesAddedInExercise = $cat->getCategoryExerciseTree(
$this,
$this->course['real_id'],
null,
true,
true
);
$questions_by_category = TestCategory::getQuestionsByCat(
$this->iid,
$question_list,
$categoriesAddedInExercise
);
$question_list = $this->pickQuestionsPerCategory(
$categoriesAddedInExercise,
$question_list,
$questions_by_category,
true,
false
);
break;
case EX_Q_SELECTION_CATEGORIES_ORDERED_QUESTIONS_RANDOM: // 5
$categoriesAddedInExercise = $cat->getCategoryExerciseTree(
$this,
$this->course['real_id'],
'title ASC',
false,
true
);
$questions_by_category = TestCategory::getQuestionsByCat(
$this->iid,
$question_list,
$categoriesAddedInExercise
);
$questionsByCategoryMandatory = [];
if (EX_Q_SELECTION_CATEGORIES_ORDERED_QUESTIONS_RANDOM == $this->getQuestionSelectionType() &&
api_get_configuration_value('allow_mandatory_question_in_category')
) {
$questionsByCategoryMandatory = TestCategory::getQuestionsByCat(
$this->iid,
$question_list,
$categoriesAddedInExercise,
true
);
}
$question_list = $this->pickQuestionsPerCategory(
$categoriesAddedInExercise,
$question_list,
$questions_by_category,
true,
true,
$questionsByCategoryMandatory
);
break;
case EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_RANDOM: // 6
case EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_RANDOM_NO_GROUPED:
$categoriesAddedInExercise = $cat->getCategoryExerciseTree(
$this,
$this->course['real_id'],
null,
true,
true
);
$questions_by_category = TestCategory::getQuestionsByCat(
$this->iid,
$question_list,
$categoriesAddedInExercise
);
$question_list = $this->pickQuestionsPerCategory(
$categoriesAddedInExercise,
$question_list,
$questions_by_category,
true,
true
);
break;
case EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_ORDERED_NO_GROUPED: // 7
break;
case EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_RANDOM_NO_GROUPED: // 8
break;
case EX_Q_SELECTION_CATEGORIES_ORDERED_BY_PARENT_QUESTIONS_ORDERED: // 9
$categoriesAddedInExercise = $cat->getCategoryExerciseTree(
$this,
$this->course['real_id'],
'root ASC, lft ASC',
false,
true
);
$questions_by_category = TestCategory::getQuestionsByCat(
$this->iid,
$question_list,
$categoriesAddedInExercise
);
$question_list = $this->pickQuestionsPerCategory(
$categoriesAddedInExercise,
$question_list,
$questions_by_category,
true,
false
);
break;
case EX_Q_SELECTION_CATEGORIES_ORDERED_BY_PARENT_QUESTIONS_RANDOM: // 10
$categoriesAddedInExercise = $cat->getCategoryExerciseTree(
$this,
$this->course['real_id'],
'root, lft ASC',
false,
true
);
$questions_by_category = TestCategory::getQuestionsByCat(
$this->iid,
$question_list,
$categoriesAddedInExercise
);
$question_list = $this->pickQuestionsPerCategory(
$categoriesAddedInExercise,
$question_list,
$questions_by_category,
true,
true
);
break;
}
$result['question_list'] = isset($question_list) ? $question_list : [];
$result['category_with_questions_list'] = isset($questions_by_category) ? $questions_by_category : [];
$parentsLoaded = [];
// Adding category info in the category list with question list:
if (!empty($questions_by_category)) {
$newCategoryList = [];
$em = Database::getManager();
$repo = $em->getRepository('ChamiloCourseBundle:CQuizCategory');
foreach ($questions_by_category as $categoryId => $questionList) {
$cat = new TestCategory();
$cat = $cat->getCategory($categoryId);
if ($cat) {
$cat = (array) $cat;
}
$categoryParentInfo = null;
// Parent is not set no loop here
if (isset($cat['parent_id']) && !empty($cat['parent_id'])) {
/** @var \Chamilo\CourseBundle\Entity\CQuizCategory $categoryEntity */
if (!isset($parentsLoaded[$cat['parent_id']])) {
$categoryEntity = $em->find('ChamiloCourseBundle:CQuizCategory', $cat['parent_id']);
$parentsLoaded[$cat['parent_id']] = $categoryEntity;
} else {
$categoryEntity = $parentsLoaded[$cat['parent_id']];
}
$path = $repo->getPath($categoryEntity);
$index = 0;
if ($this->categoryMinusOne) {
//$index = 1;
}
/** @var \Chamilo\CourseBundle\Entity\CQuizCategory $categoryParent */
foreach ($path as $categoryParent) {
$visibility = $categoryParent->getVisibility();
if (0 == $visibility) {
$categoryParentId = $categoryId;
$categoryTitle = $cat['title'];
if (count($path) > 1) {
continue;
}
} else {
$categoryParentId = $categoryParent->getIid();
$categoryTitle = $categoryParent->getTitle();
}
$categoryParentInfo['id'] = $categoryParentId;
$categoryParentInfo['iid'] = $categoryParentId;
$categoryParentInfo['parent_path'] = null;
$categoryParentInfo['title'] = $categoryTitle;
$categoryParentInfo['name'] = $categoryTitle;
$categoryParentInfo['parent_id'] = null;
break;
}
}
$cat['parent_info'] = $categoryParentInfo;
$newCategoryList[$categoryId] = [
'category' => $cat,
'question_list' => $questionList,
];
}
$result['category_with_questions_list'] = $newCategoryList;
}
return $result;
}
/**
* returns the array with the question ID list.
*
* @param bool $fromDatabase Whether the results should be fetched in the database or just from memory
* @param bool $adminView Whether we should return all questions (admin view) or
* just a list limited by the max number of random questions
*
* @author Olivier Brouckaert
*
* @return array - question ID list
*/
public function selectQuestionList($fromDatabase = false, $adminView = false)
{
if ($fromDatabase && !empty($this->iid)) {
$nbQuestions = $this->getQuestionCount();
$questionSelectionType = $this->getQuestionSelectionType();
switch ($questionSelectionType) {
case EX_Q_SELECTION_ORDERED:
$questionList = $this->getQuestionOrderedList($adminView);
break;
case EX_Q_SELECTION_RANDOM:
// Not a random exercise, or if there are not at least 2 questions
if ($this->random == 0 || $nbQuestions < 2) {
$questionList = $this->getQuestionOrderedList($adminView);
} else {
$questionList = $this->getRandomList($adminView);
}
break;
default:
$questionList = $this->getQuestionOrderedList($adminView);
$result = $this->getQuestionListWithCategoryListFilteredByCategorySettings(
$questionList,
$questionSelectionType
);
$this->categoryWithQuestionList = $result['category_with_questions_list'];
$questionList = $result['question_list'];
break;
}
return $questionList;
}
return $this->questionList;
}
/**
* returns the number of questions in this exercise.
*
* @author Olivier Brouckaert
*
* @return int - number of questions
*/
public function selectNbrQuestions()
{
return count($this->questionList);
}
/**
* @return int
*/
public function selectPropagateNeg()
{
return $this->propagate_neg;
}
/**
* @return int
*/
public function getSaveCorrectAnswers()
{
return $this->saveCorrectAnswers;
}
/**
* Selects questions randomly in the question list.
*
* @author Olivier Brouckaert
* @author Hubert Borderiou 15 nov 2011
*
* @param bool $adminView Whether we should return all
* questions (admin view) or just a list limited by the max number of random questions
*
* @return array - if the exercise is not set to take questions randomly, returns the question list
* without randomizing, otherwise, returns the list with questions selected randomly
*/
public function getRandomList($adminView = false)
{
$quizRelQuestion = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$question = Database::get_course_table(TABLE_QUIZ_QUESTION);
$random = isset($this->random) && !empty($this->random) ? $this->random : 0;
// Random with limit
$randomLimit = " ORDER BY RAND() LIMIT $random";
// Random with no limit
if (-1 == $random) {
$randomLimit = ' ORDER BY RAND() ';
}
// Admin see the list in default order
if (true === $adminView) {
// If viewing it as admin for edition, don't show it randomly, use title + id
$randomLimit = 'ORDER BY e.question_order';
}
$sql = "SELECT e.question_id
FROM $quizRelQuestion e
INNER JOIN $question q
ON e.question_id= q.iid
WHERE
e.c_id = {$this->course_id} AND
e.exercice_id = '".Database::escape_string($this->iid)."'
$randomLimit ";
$result = Database::query($sql);
$questionList = [];
while ($row = Database::fetch_object($result)) {
$questionList[] = $row->question_id;
}
return $questionList;
}
/**
* returns 'true' if the question ID is in the question list.
*
* @author Olivier Brouckaert
*
* @param int $questionId - question ID
*
* @return bool - true if in the list, otherwise false
*/
public function isInList($questionId)
{
$inList = false;
if (is_array($this->questionList)) {
$inList = in_array($questionId, $this->questionList);
}
return $inList;
}
/**
* If current exercise has a question.
*
* @param int $questionId
*
* @return int
*/
public function hasQuestion($questionId)
{
$questionId = (int) $questionId;
$TBL_EXERCICE_QUESTION = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$TBL_QUESTIONS = Database::get_course_table(TABLE_QUIZ_QUESTION);
$sql = "SELECT q.iid
FROM $TBL_EXERCICE_QUESTION e
INNER JOIN $TBL_QUESTIONS q
ON e.question_id = q.iid
WHERE
q.iid = $questionId AND
e.c_id = {$this->course_id} AND
e.exercice_id = ".$this->iid;
$result = Database::query($sql);
return Database::num_rows($result) > 0;
}
public function hasQuestionWithType($type)
{
$type = (int) $type;
$table = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$tableQuestion = Database::get_course_table(TABLE_QUIZ_QUESTION);
$sql = "SELECT q.iid
FROM $table e
INNER JOIN $tableQuestion q
ON e.question_id = q.iid
WHERE
q.type = $type AND
e.c_id = {$this->course_id} AND
e.exercice_id = ".$this->iid;
$result = Database::query($sql);
return Database::num_rows($result) > 0;
}
public function hasQuestionWithTypeNotInList(array $questionTypeList)
{
if (empty($questionTypeList)) {
return false;
}
$questionTypeToString = implode("','", array_map('intval', $questionTypeList));
$table = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$tableQuestion = Database::get_course_table(TABLE_QUIZ_QUESTION);
$sql = "SELECT q.iid
FROM $table e
INNER JOIN $tableQuestion q
ON e.question_id = q.iid
WHERE
q.type NOT IN ('$questionTypeToString') AND
e.c_id = {$this->course_id} AND
e.exercice_id = ".$this->iid;
$result = Database::query($sql);
return Database::num_rows($result) > 0;
}
/**
* changes the exercise title.
*
* @author Olivier Brouckaert
*
* @param string $title - exercise title
*/
public function updateTitle($title)
{
$this->title = $this->exercise = $title;
}
/**
* changes the exercise max attempts.
*
* @param int $attempts - exercise max attempts
*/
public function updateAttempts($attempts)
{
$this->attempts = $attempts;
}
/**
* changes the exercise feedback type.
*
* @param int $feedback_type
*/
public function updateFeedbackType($feedback_type)
{
$this->feedback_type = $feedback_type;
}
/**
* changes the exercise description.
*
* @author Olivier Brouckaert
*
* @param string $description - exercise description
*/
public function updateDescription($description)
{
$this->description = $description;
}
/**
* changes the exercise expired_time.
*
* @author Isaac flores
*
* @param int $expired_time The expired time of the quiz
*/
public function updateExpiredTime($expired_time)
{
$this->expired_time = $expired_time;
}
/**
* @param $value
*/
public function updatePropagateNegative($value)
{
$this->propagate_neg = $value;
}
/**
* @param int $value
*/
public function updateSaveCorrectAnswers($value)
{
$this->saveCorrectAnswers = (int) $value;
}
/**
* @param $value
*/
public function updateReviewAnswers($value)
{
$this->review_answers = isset($value) && $value ? true : false;
}
/**
* @param $value
*/
public function updatePassPercentage($value)
{
$this->pass_percentage = $value;
}
/**
* @param string $text
*/
public function updateEmailNotificationTemplate($text)
{
$this->emailNotificationTemplate = $text;
}
/**
* @param string $text
*/
public function setEmailNotificationTemplateToUser($text)
{
$this->emailNotificationTemplateToUser = $text;
}
/**
* @param string $value
*/
public function setNotifyUserByEmail($value)
{
$this->notifyUserByEmail = $value;
}
/**
* @param int $value
*/
public function updateEndButton($value)
{
$this->endButton = (int) $value;
}
/**
* @param string $value
*/
public function setOnSuccessMessage($value)
{
$this->onSuccessMessage = $value;
}
/**
* @param string $value
*/
public function setOnFailedMessage($value)
{
$this->onFailedMessage = $value;
}
/**
* @param $value
*/
public function setModelType($value)
{
$this->modelType = (int) $value;
}
/**
* @param int $value
*/
public function setQuestionSelectionType($value)
{
$this->questionSelectionType = (int) $value;
}
/**
* @return int
*/
public function getQuestionSelectionType()
{
return (int) $this->questionSelectionType;
}
/**
* @param array $categories
*/
public function updateCategories($categories)
{
if (!empty($categories)) {
$categories = array_map('intval', $categories);
$this->categories = $categories;
}
}
/**
* changes the exercise sound file.
*
* @author Olivier Brouckaert
*
* @param string $sound - exercise sound file
* @param string $delete - ask to delete the file
*/
public function updateSound($sound, $delete)
{
global $audioPath, $documentPath;
$TBL_DOCUMENT = Database::get_course_table(TABLE_DOCUMENT);
if ($sound['size'] && (strstr($sound['type'], 'audio') || strstr($sound['type'], 'video'))) {
$this->sound = $sound['name'];
if (@move_uploaded_file($sound['tmp_name'], $audioPath.'/'.$this->sound)) {
$sql = "SELECT 1 FROM $TBL_DOCUMENT
WHERE
c_id = ".$this->course_id." AND
path = '".str_replace($documentPath, '', $audioPath).'/'.$this->sound."'";
$result = Database::query($sql);
if (!Database::num_rows($result)) {
$id = add_document(
$this->course,
str_replace($documentPath, '', $audioPath).'/'.$this->sound,
'file',
$sound['size'],
$sound['name']
);
api_item_property_update(
$this->course,
TOOL_DOCUMENT,
$id,
'DocumentAdded',
api_get_user_id()
);
item_property_update_on_folder(
$this->course,
str_replace($documentPath, '', $audioPath),
api_get_user_id()
);
}
}
} elseif ($delete && is_file($audioPath.'/'.$this->sound)) {
$this->sound = '';
}
}
/**
* changes the exercise type.
*
* @author Olivier Brouckaert
*
* @param int $type - exercise type
*/
public function updateType($type)
{
$this->type = $type;
}
/**
* sets to 0 if questions are not selected randomly
* if questions are selected randomly, sets the draws.
*
* @author Olivier Brouckaert
*
* @param int $random - 0 if not random, otherwise the draws
*/
public function setRandom($random)
{
$this->random = $random;
}
/**
* sets to 0 if answers are not selected randomly
* if answers are selected randomly.
*
* @author Juan Carlos Rana
*
* @param int $random_answers - random answers
*/
public function updateRandomAnswers($random_answers)
{
$this->random_answers = $random_answers;
}
/**
* enables the exercise.
*
* @author Olivier Brouckaert
*/
public function enable()
{
$this->active = 1;
}
/**
* disables the exercise.
*
* @author Olivier Brouckaert
*/
public function disable()
{
$this->active = 0;
}
/**
* Set disable results.
*/
public function disable_results()
{
$this->results_disabled = true;
}
/**
* Enable results.
*/
public function enable_results()
{
$this->results_disabled = false;
}
/**
* @param int $results_disabled
*/
public function updateResultsDisabled($results_disabled)
{
$this->results_disabled = (int) $results_disabled;
}
/**
* updates the exercise in the data base.
*
* @param string $type_e
*
* @author Olivier Brouckaert
*/
public function save($type_e = '')
{
$_course = $this->course;
$TBL_EXERCISES = Database::get_course_table(TABLE_QUIZ_TEST);
$id = $this->iid;
$exercise = $this->exercise;
$description = $this->description;
$sound = $this->sound;
$type = $this->type;
$attempts = isset($this->attempts) ? $this->attempts : 0;
$feedback_type = isset($this->feedback_type) ? $this->feedback_type : 0;
$random = $this->random;
$random_answers = $this->random_answers;
$active = $this->active;
$propagate_neg = (int) $this->propagate_neg;
$saveCorrectAnswers = isset($this->saveCorrectAnswers) ? (int) $this->saveCorrectAnswers : 0;
$review_answers = isset($this->review_answers) && $this->review_answers ? 1 : 0;
$randomByCat = (int) $this->randomByCat;
$text_when_finished = $this->text_when_finished;
$text_when_finished_failure = $this->text_when_finished_failure;
$display_category_name = (int) $this->display_category_name;
$pass_percentage = (int) $this->pass_percentage;
$session_id = $this->sessionId;
// If direct we do not show results
$results_disabled = (int) $this->results_disabled;
if (in_array($feedback_type, [EXERCISE_FEEDBACK_TYPE_DIRECT, EXERCISE_FEEDBACK_TYPE_POPUP])) {
$results_disabled = 0;
}
$expired_time = (int) $this->expired_time;
$showHideConfiguration = api_get_configuration_value('quiz_hide_question_number');
// Exercise already exists
if ($id) {
// we prepare date in the database using the api_get_utc_datetime() function
$start_time = null;
if (!empty($this->start_time)) {
$start_time = $this->start_time;
}
$end_time = null;
if (!empty($this->end_time)) {
$end_time = $this->end_time;
}
$params = [
'title' => $exercise,
'description' => $description,
];
$paramsExtra = [];
if ($type_e != 'simple') {
$paramsExtra = [
'sound' => $sound,
'type' => $type,
'random' => $random,
'random_answers' => $random_answers,
'active' => $active,
'feedback_type' => $feedback_type,
'start_time' => $start_time,
'end_time' => $end_time,
'max_attempt' => $attempts,
'expired_time' => $expired_time,
'propagate_neg' => $propagate_neg,
'save_correct_answers' => $saveCorrectAnswers,
'review_answers' => $review_answers,
'random_by_category' => $randomByCat,
'text_when_finished' => $text_when_finished,
'display_category_name' => $display_category_name,
'pass_percentage' => $pass_percentage,
'results_disabled' => $results_disabled,
'question_selection_type' => $this->getQuestionSelectionType(),
'hide_question_title' => $this->getHideQuestionTitle(),
];
if (true === api_get_configuration_value('exercise_text_when_finished_failure')) {
$paramsExtra['text_when_finished_failure'] = $text_when_finished_failure;
}
$allow = api_get_configuration_value('allow_quiz_show_previous_button_setting');
if ($allow === true) {
$paramsExtra['show_previous_button'] = $this->showPreviousButton();
}
if (api_get_configuration_value('quiz_prevent_backwards_move')) {
$paramsExtra['prevent_backwards'] = $this->getPreventBackwards();
}
$allow = api_get_configuration_value('allow_exercise_categories');
if ($allow === true) {
if (!empty($this->getExerciseCategoryId())) {
$paramsExtra['exercise_category_id'] = $this->getExerciseCategoryId();
}
}
$allow = api_get_configuration_value('allow_notification_setting_per_exercise');
if ($allow === true) {
$notifications = $this->getNotifications();
$notifications = implode(',', $notifications);
$paramsExtra['notifications'] = $notifications;
}
$pageConfig = api_get_configuration_value('allow_quiz_results_page_config');
if ($pageConfig && !empty($this->pageResultConfiguration)) {
$paramsExtra['page_result_configuration'] = $this->pageResultConfiguration;
}
}
if ($showHideConfiguration) {
$paramsExtra['hide_question_number'] = $this->hideQuestionNumber;
}
if (true === api_get_configuration_value('quiz_hide_attempts_table_on_start_page')) {
$paramsExtra['hide_attempts_table'] = $this->getHideAttemptsTableOnStartPage();
}
$params = array_merge($params, $paramsExtra);
Database::update(
$TBL_EXERCISES,
$params,
['c_id = ? AND iid = ?' => [$this->course_id, $id]]
);
// update into the item_property table
api_item_property_update(
$_course,
TOOL_QUIZ,
$id,
'QuizUpdated',
api_get_user_id()
);
if (api_get_setting('search_enabled') === 'true') {
$this->search_engine_edit();
}
Event::addEvent(
LOG_EXERCISE_UPDATE,
LOG_EXERCISE_ID,
$id
);
} else {
// Creates a new exercise
// In this case of new exercise, we don't do the api_get_utc_datetime()
// for date because, bellow, we call function api_set_default_visibility()
// In this function, api_set_default_visibility,
// the Quiz is saved too, with an $id and api_get_utc_datetime() is done.
// If we do it now, it will be done twice (cf. https://support.chamilo.org/issues/6586)
$start_time = null;
if (!empty($this->start_time)) {
$start_time = $this->start_time;
}
$end_time = null;
if (!empty($this->end_time)) {
$end_time = $this->end_time;
}
$params = [
'c_id' => $this->course_id,
'start_time' => $start_time,
'end_time' => $end_time,
'title' => $exercise,
'description' => $description,
'sound' => $sound,
'type' => $type,
'random' => $random,
'random_answers' => $random_answers,
'active' => $active,
'results_disabled' => $results_disabled,
'max_attempt' => $attempts,
'feedback_type' => $feedback_type,
'expired_time' => $expired_time,
'session_id' => $session_id,
'review_answers' => $review_answers,
'random_by_category' => $randomByCat,
'text_when_finished' => $text_when_finished,
'display_category_name' => $display_category_name,
'pass_percentage' => $pass_percentage,
'save_correct_answers' => $saveCorrectAnswers,
'propagate_neg' => $propagate_neg,
'hide_question_title' => $this->getHideQuestionTitle(),
];
if (true === api_get_configuration_value('exercise_text_when_finished_failure')) {
$params['text_when_finished_failure'] = $text_when_finished_failure;
}
$allow = api_get_configuration_value('allow_exercise_categories');
if (true === $allow) {
if (!empty($this->getExerciseCategoryId())) {
$params['exercise_category_id'] = $this->getExerciseCategoryId();
}
}
if (api_get_configuration_value('quiz_prevent_backwards_move')) {
$params['prevent_backwards'] = $this->getPreventBackwards();
}
$allow = api_get_configuration_value('allow_quiz_show_previous_button_setting');
if (true === $allow) {
$params['show_previous_button'] = $this->showPreviousButton();
}
$allow = api_get_configuration_value('allow_notification_setting_per_exercise');
if (true === $allow) {
$notifications = $this->getNotifications();
$params['notifications'] = '';
if (!empty($notifications)) {
$notifications = implode(',', $notifications);
$params['notifications'] = $notifications;
}
}
$pageConfig = api_get_configuration_value('allow_quiz_results_page_config');
if ($pageConfig && !empty($this->pageResultConfiguration)) {
$params['page_result_configuration'] = $this->pageResultConfiguration;
}
if ($showHideConfiguration) {
$params['hide_question_number'] = $this->hideQuestionNumber;
}
$this->iid = Database::insert($TBL_EXERCISES, $params);
if ($this->iid) {
$sql = "UPDATE $TBL_EXERCISES
SET question_selection_type= ".$this->getQuestionSelectionType()."
WHERE iid = ".$this->iid;
Database::query($sql);
// insert into the item_property table
api_item_property_update(
$this->course,
TOOL_QUIZ,
$this->iid,
'QuizAdded',
api_get_user_id()
);
// This function save the quiz again, carefull about start_time
// and end_time if you remove this line (see above)
api_set_default_visibility(
$this->iid,
TOOL_QUIZ,
null,
$this->course
);
if (api_get_setting('search_enabled') === 'true' && extension_loaded('xapian')) {
$this->search_engine_save();
}
Event::addEvent(
LOG_EXERCISE_CREATE,
LOG_EXERCISE_ID,
$this->iid
);
}
}
$this->save_categories_in_exercise($this->categories);
return $this->iid;
}
/**
* Updates question position.
*
* @return bool
*/
public function update_question_positions()
{
$table = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
// Fixes #3483 when updating order
$questionList = $this->selectQuestionList(true);
if (empty($this->iid)) {
return false;
}
if (!empty($questionList)) {
foreach ($questionList as $position => $questionId) {
$position = (int) $position;
$questionId = (int) $questionId;
$sql = "UPDATE $table SET
question_order ='".$position."'
WHERE
question_id = ".$questionId." AND
exercice_id=".$this->iid;
Database::query($sql);
}
}
return true;
}
/**
* Adds a question into the question list.
*
* @author Olivier Brouckaert
*
* @param int $questionId - question ID
*
* @return bool - true if the question has been added, otherwise false
*/
public function addToList($questionId)
{
// checks if the question ID is not in the list
if (!$this->isInList($questionId)) {
// selects the max position
if (!$this->selectNbrQuestions()) {
$pos = 1;
} else {
if (is_array($this->questionList)) {
$pos = max(array_keys($this->questionList)) + 1;
}
}
$this->questionList[$pos] = $questionId;
return true;
}
return false;
}
/**
* removes a question from the question list.
*
* @author Olivier Brouckaert
*
* @param int $questionId - question ID
*
* @return bool - true if the question has been removed, otherwise false
*/
public function removeFromList($questionId)
{
// searches the position of the question ID in the list
$pos = array_search($questionId, $this->questionList);
// question not found
if (false === $pos) {
return false;
} else {
// dont reduce the number of random question if we use random by category option, or if
// random all questions
if ($this->isRandom() && 0 == $this->isRandomByCat()) {
if (count($this->questionList) >= $this->random && $this->random > 0) {
$this->random--;
$this->save();
}
}
// deletes the position from the array containing the wanted question ID
unset($this->questionList[$pos]);
return true;
}
}
/**
* Marks the exercise as deleted.
* If $delete argument set, completely deletes it from the database.
* Note: leaves the questions in the database as "orphan" questions
* (unless used by other tests).
*
* @param bool $delete Whether to really delete the test (true) or only mark it (false = default)
* @param bool $deleteQuestions Whether to delete the test questions (true)
*
* @return bool Whether the operation was successful or not
*
* @author Olivier Brouckaert
* @author Yannick Warnier
*/
public function delete(bool $delete = false, bool $deleteQuestions = false): bool
{
$limitTeacherAccess = api_get_configuration_value('limit_exercise_teacher_access');
if ($limitTeacherAccess && !api_is_platform_admin()) {
return false;
}
$locked = api_resource_is_locked_by_gradebook(
$this->iid,
LINK_EXERCISE
);
if ($locked) {
return false;
}
$table = Database::get_course_table(TABLE_QUIZ_TEST);
$sql = "UPDATE $table SET active='-1'
WHERE iid = ".$this->iid;
Database::query($sql);
api_item_property_update(
$this->course,
TOOL_QUIZ,
$this->iid,
'QuizDeleted',
api_get_user_id()
);
api_item_property_update(
$this->course,
TOOL_QUIZ,
$this->iid,
'delete',
api_get_user_id()
);
Skill::deleteSkillsFromItem($this->iid, ITEM_TYPE_EXERCISE);
if (api_get_setting('search_enabled') === 'true' &&
extension_loaded('xapian')
) {
$this->search_engine_delete();
}
$linkInfo = GradebookUtils::isResourceInCourseGradebook(
$this->course['code'],
LINK_EXERCISE,
$this->iid,
$this->sessionId
);
if ($linkInfo !== false) {
GradebookUtils::remove_resource_from_course_gradebook($linkInfo['id']);
}
$questions = [];
if ($delete || $deleteQuestions) {
$questions = $this->getQuestionOrderedList(true);
}
if ($deleteQuestions) {
// Delete the questions of the test (this could delete questions reused on other tests)
foreach ($questions as $order => $questionId) {
$masterExerciseId = Question::getMasterQuizForQuestion($questionId);
if ($masterExerciseId == $this->iid) {
$objQuestionTmp = Question::read($questionId);
$objQuestionTmp->delete();
$this->removeFromList($questionId);
}
}
}
if ($delete) {
// Really delete the test (if questions were not previously deleted these will be orphaned)
foreach ($questions as $order => $questionId) {
$question = Question::read($questionId, $this->course);
$question->delete($this->course_id);
}
$sql = "DELETE FROM $table
WHERE iid = ".$this->iid;
Database::query($sql);
}
Event::addEvent(
LOG_EXERCISE_DELETE,
LOG_EXERCISE_ID,
$this->iid
);
return true;
}
/**
* Creates the form to create / edit an exercise.
*
* @param FormValidator $form
* @param string $type
*/
public function createForm($form, $type = 'full')
{
if (empty($type)) {
$type = 'full';
}
// Form title
$form_title = get_lang('NewEx');
if (!empty($_GET['exerciseId'])) {
$form_title = get_lang('ModifyExercise');
}
$form->addHeader($form_title);
$form->protect();
// Title.
if (api_get_configuration_value('save_titles_as_html')) {
$form->addHtmlEditor(
'exerciseTitle',
get_lang('ExerciseName'),
false,
false,
['ToolbarSet' => 'TitleAsHtml']
);
} else {
$form->addElement(
'text',
'exerciseTitle',
get_lang('ExerciseName'),
['id' => 'exercise_title']
);
}
$form->addElement('advanced_settings', 'advanced_params', get_lang('AdvancedParameters'));
$form->addElement('html', '<div id="advanced_params_options" style="display:none">');
if (api_get_configuration_value('allow_exercise_categories')) {
$categoryManager = new ExerciseCategoryManager();
$categories = $categoryManager->getCategories(api_get_course_int_id());
$options = [];
if (!empty($categories)) {
/** @var CExerciseCategory $category */
foreach ($categories as $category) {
$options[$category->getId()] = $category->getName();
}
}
$form->addSelect(
'exercise_category_id',
get_lang('Category'),
$options,
['placeholder' => get_lang('SelectAnOption')]
);
}
$editor_config = [
'ToolbarSet' => 'TestQuestionDescription',
'Width' => '100%',
'Height' => '150',
];
if (is_array($type)) {
$editor_config = array_merge($editor_config, $type);
}
$form->addHtmlEditor(
'exerciseDescription',
get_lang('ExerciseDescription'),
false,
false,
$editor_config
);
$skillList = [];
if ('full' === $type) {
// Can't modify a DirectFeedback question.
if (!in_array($this->getFeedbackType(), [EXERCISE_FEEDBACK_TYPE_DIRECT, EXERCISE_FEEDBACK_TYPE_POPUP])) {
$this->setResultFeedbackGroup($form);
// Type of results display on the final page
$this->setResultDisabledGroup($form);
// Type of questions disposition on page
$radios = [];
$radios[] = $form->createElement(
'radio',
'exerciseType',
null,
get_lang('SimpleExercise'),
'1',
[
'onclick' => 'check_per_page_all()',
'id' => 'option_page_all',
]
);
$radios[] = $form->createElement(
'radio',
'exerciseType',
null,
get_lang('SequentialExercise'),
'2',
[
'onclick' => 'check_per_page_one()',
'id' => 'option_page_one',
]
);
$form->addGroup($radios, null, get_lang('QuestionsPerPage'));
} else {
// if is Direct feedback but has not questions we can allow to modify the question type
if (empty($this->iid) || 0 === $this->getQuestionCount()) {
$this->setResultFeedbackGroup($form);
$this->setResultDisabledGroup($form);
// Type of questions disposition on page
$radios = [];
$radios[] = $form->createElement('radio', 'exerciseType', null, get_lang('SimpleExercise'), '1');
$radios[] = $form->createElement(
'radio',
'exerciseType',
null,
get_lang('SequentialExercise'),
'2'
);
$form->addGroup($radios, null, get_lang('ExerciseType'));
} else {
$this->setResultFeedbackGroup($form, true);
$group = $this->setResultDisabledGroup($form);
$group->freeze();
// we force the options to the DirectFeedback exercisetype
//$form->addElement('hidden', 'exerciseFeedbackType', $this->getFeedbackType());
//$form->addElement('hidden', 'exerciseType', ONE_PER_PAGE);
// Type of questions disposition on page
$radios[] = $form->createElement(
'radio',
'exerciseType',
null,
get_lang('SimpleExercise'),
'1',
[
'onclick' => 'check_per_page_all()',
'id' => 'option_page_all',
]
);
$radios[] = $form->createElement(
'radio',
'exerciseType',
null,
get_lang('SequentialExercise'),
'2',
[
'onclick' => 'check_per_page_one()',
'id' => 'option_page_one',
]
);
$type_group = $form->addGroup($radios, null, get_lang('QuestionsPerPage'));
$type_group->freeze();
}
}
$option = [
EX_Q_SELECTION_ORDERED => get_lang('OrderedByUser'),
// Defined by user
EX_Q_SELECTION_RANDOM => get_lang('Random'),
// 1-10, All
'per_categories' => '--------'.get_lang('UsingCategories').'----------',
// Base (A 123 {3} B 456 {3} C 789{2} D 0{0}) --> Matrix {3, 3, 2, 0}
EX_Q_SELECTION_CATEGORIES_ORDERED_QUESTIONS_ORDERED => get_lang('OrderedCategoriesAlphabeticallyWithQuestionsOrdered'),
// A 123 B 456 C 78 (0, 1, all)
EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_ORDERED => get_lang('RandomCategoriesWithQuestionsOrdered'),
// C 78 B 456 A 123
EX_Q_SELECTION_CATEGORIES_ORDERED_QUESTIONS_RANDOM => get_lang('OrderedCategoriesAlphabeticallyWithRandomQuestions'),
// A 321 B 654 C 87
EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_RANDOM => get_lang('RandomCategoriesWithRandomQuestions'),
// C 87 B 654 A 321
//EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_ORDERED_NO_GROUPED => get_lang('RandomCategoriesWithQuestionsOrderedNoQuestionGrouped'),
/* B 456 C 78 A 123
456 78 123
123 456 78
*/
//EX_Q_SELECTION_CATEGORIES_RANDOM_QUESTIONS_RANDOM_NO_GROUPED => get_lang('RandomCategoriesWithRandomQuestionsNoQuestionGrouped'),
/*
A 123 B 456 C 78
B 456 C 78 A 123
B 654 C 87 A 321
654 87 321
165 842 73
*/
//EX_Q_SELECTION_CATEGORIES_ORDERED_BY_PARENT_QUESTIONS_ORDERED => get_lang('OrderedCategoriesByParentWithQuestionsOrdered'),
//EX_Q_SELECTION_CATEGORIES_ORDERED_BY_PARENT_QUESTIONS_RANDOM => get_lang('OrderedCategoriesByParentWithQuestionsRandom'),
];
$form->addElement(
'select',
'question_selection_type',
[get_lang('QuestionSelection')],
$option,
[
'id' => 'questionSelection',
'onchange' => 'checkQuestionSelection()',
]
);
$pageConfig = api_get_configuration_value('allow_quiz_results_page_config');
if ($pageConfig) {
$group = [
$form->createElement(
'checkbox',
'hide_expected_answer',
null,
get_lang('HideExpectedAnswer')
),
$form->createElement(
'checkbox',
'hide_total_score',
null,
get_lang('HideTotalScore')
),
$form->createElement(
'checkbox',
'hide_question_score',
null,
get_lang('HideQuestionScore')
),
$form->createElement(
'checkbox',
'hide_category_table',
null,
get_lang('HideCategoryTable')
),
$form->createElement(
'checkbox',
'hide_correct_answered_questions',
null,
get_lang('HideCorrectAnsweredQuestions')
),
$form->createElement(
'checkbox',
'hide_comment',
null,
get_lang('HideComment')
),
];
$form->addGroup($group, null, get_lang('ResultsConfigurationPage'));
}
$showHideConfiguration = api_get_configuration_value('quiz_hide_question_number');
if ($showHideConfiguration) {
$group = [
$form->createElement('radio', 'hide_question_number', null, get_lang('Yes'), '1'),
$form->createElement('radio', 'hide_question_number', null, get_lang('No'), '0'),
];
$form->addGroup($group, null, get_lang('HideQuestionNumber'));
}
$displayMatrix = 'none';
$displayRandom = 'none';
$selectionType = $this->getQuestionSelectionType();
switch ($selectionType) {
case EX_Q_SELECTION_RANDOM:
$displayRandom = 'block';
break;
case $selectionType >= EX_Q_SELECTION_CATEGORIES_ORDERED_QUESTIONS_ORDERED:
$displayMatrix = 'block';
break;
}
$form->addHtml('<div id="hidden_random" style="display:'.$displayRandom.'">');
// Number of random question.
$max = ($this->iid > 0) ? $this->getQuestionCount() : 10;
$option = range(0, $max);
$option[0] = get_lang('No');
$option[-1] = get_lang('AllQuestionsShort');
$form->addElement(
'select',
'randomQuestions',
[
get_lang('RandomQuestions'),
get_lang('RandomQuestionsHelp'),
],
$option,
['id' => 'randomQuestions']
);
$form->addHtml('</div>');
$form->addHtml('<div id="hidden_matrix" style="display:'.$displayMatrix.'">');
// Category selection.
$cat = new TestCategory();
$cat_form = $cat->returnCategoryForm($this);
if (empty($cat_form)) {
$cat_form = '<span class="label label-warning">'.get_lang('NoCategoriesDefined').'</span>';
}
$form->addElement('label', null, $cat_form);
$form->addHtml('</div>');
// Random answers.
$radios_random_answers = [
$form->createElement('radio', 'randomAnswers', null, get_lang('Yes'), '1'),
$form->createElement('radio', 'randomAnswers', null, get_lang('No'), '0'),
];
$form->addGroup($radios_random_answers, null, get_lang('RandomAnswers'));
// Category name.
$radio_display_cat_name = [
$form->createElement('radio', 'display_category_name', null, get_lang('Yes'), '1'),
$form->createElement('radio', 'display_category_name', null, get_lang('No'), '0'),
];
$form->addGroup($radio_display_cat_name, null, get_lang('QuestionDisplayCategoryName'));
// Hide question title.
$group = [
$form->createElement('radio', 'hide_question_title', null, get_lang('Yes'), '1'),
$form->createElement('radio', 'hide_question_title', null, get_lang('No'), '0'),
];
$form->addGroup($group, null, get_lang('HideQuestionTitle'));
$allow = api_get_configuration_value('allow_quiz_show_previous_button_setting');
if (true === $allow) {
// Hide question title.
$group = [
$form->createElement(
'radio',
'show_previous_button',
null,
get_lang('Yes'),
'1'
),
$form->createElement(
'radio',
'show_previous_button',
null,
get_lang('No'),
'0'
),
];
$form->addGroup($group, null, get_lang('ShowPreviousButton'));
}
$form->addElement(
'number',
'exerciseAttempts',
get_lang('ExerciseAttempts'),
null,
['id' => 'exerciseAttempts']
);
// Exercise time limit
$form->addElement(
'checkbox',
'activate_start_date_check',
null,
get_lang('EnableStartTime'),
['onclick' => 'activate_start_date()']
);
if (!empty($this->start_time)) {
$form->addElement('html', '<div id="start_date_div" style="display:block;">');
} else {
$form->addElement('html', '<div id="start_date_div" style="display:none;">');
}
$form->addElement('date_time_picker', 'start_time');
$form->addElement('html', '</div>');
$form->addElement(
'checkbox',
'activate_end_date_check',
null,
get_lang('EnableEndTime'),
['onclick' => 'activate_end_date()']
);
if (!empty($this->end_time)) {
$form->addHtml('<div id="end_date_div" style="display:block;">');
} else {
$form->addHtml('<div id="end_date_div" style="display:none;">');
}
$form->addElement('date_time_picker', 'end_time');
$form->addElement('html', '</div>');
$display = 'block';
$form->addElement(
'checkbox',
'propagate_neg',
null,
get_lang('PropagateNegativeResults')
);
if (api_get_configuration_value('allow_quiz_save_correct_options')) {
$options = [
'' => get_lang('SelectAnOption'),
1 => get_lang('SaveTheCorrectAnswersForTheNextAttempt'),
2 => get_lang('SaveAllAnswers'),
];
$form->addSelect(
'save_correct_answers',
get_lang('SaveAnswers'),
$options
);
} else {
$form->addCheckBox(
'save_correct_answers',
null,
get_lang('SaveTheCorrectAnswersForTheNextAttempt')
);
}
$form->addElement('html', '<div class="clear"> </div>');
$form->addElement('checkbox', 'review_answers', null, get_lang('ReviewAnswers'));
$form->addElement('html', '<div id="divtimecontrol" style="display:'.$display.';">');
// Timer control
$form->addElement(
'checkbox',
'enabletimercontrol',
null,
get_lang('EnableTimerControl'),
[
'onclick' => 'option_time_expired()',
'id' => 'enabletimercontrol',
'onload' => 'check_load_time()',
]
);
$expired_date = (int) $this->selectExpiredTime();
if (($expired_date != '0')) {
$form->addElement('html', '<div id="timercontrol" style="display:block;">');
} else {
$form->addElement('html', '<div id="timercontrol" style="display:none;">');
}
$form->addText(
'enabletimercontroltotalminutes',
get_lang('ExerciseTotalDurationInMinutes'),
false,
[
'id' => 'enabletimercontroltotalminutes',
'cols-size' => [2, 2, 8],
]
);
$form->addElement('html', '</div>');
if (api_get_configuration_value('quiz_prevent_backwards_move')) {
$form->addCheckBox(
'prevent_backwards',
null,
get_lang('QuizPreventBackwards')
);
}
$form->addElement(
'text',
'pass_percentage',
[get_lang('PassPercentage'), null, '%'],
['id' => 'pass_percentage']
);
$form->addRule('pass_percentage', get_lang('Numeric'), 'numeric');
$form->addRule('pass_percentage', get_lang('ValueTooSmall'), 'min_numeric_length', 0);
$form->addRule('pass_percentage', get_lang('ValueTooBig'), 'max_numeric_length', 100);
// add the text_when_finished textbox
$form->addHtmlEditor(
'text_when_finished',
get_lang('TextWhenFinished'),
false,
false,
$editor_config
);
if (true === api_get_configuration_value('exercise_text_when_finished_failure')) {
$form->addHtmlEditor(
'text_when_finished_failure',
get_lang('TextAppearingAtTheEndOfTheTestWhenTheUserHasFailed'),
false,
false,
$editor_config
);
}
$allow = api_get_configuration_value('allow_notification_setting_per_exercise');
if ($allow === true) {
$settings = ExerciseLib::getNotificationSettings();
$group = [];
foreach ($settings as $itemId => $label) {
$group[] = $form->createElement(
'checkbox',
'notifications[]',
null,
$label,
['value' => $itemId]
);
}
$form->addGroup($group, '', [get_lang('EmailNotifications')]);
}
$form->addCheckBox(
'update_title_in_lps',
null,
get_lang('UpdateTitleInLps')
);
$allowHideAttempts = api_get_configuration_value('quiz_hide_attempts_table_on_start_page');
if ($allowHideAttempts) {
$group = [
$form->createElement('radio', 'hide_attempts_table', null, get_lang('Yes'), '1'),
$form->createElement('radio', 'hide_attempts_table', null, get_lang('No'), '0'),
];
$form->addGroup($group, null, get_lang('HideAttemptsTableOnStartPage'));
}
$defaults = [];
if (api_get_setting('search_enabled') === 'true') {
require_once api_get_path(LIBRARY_PATH).'specific_fields_manager.lib.php';
$form->addElement('checkbox', 'index_document', '', get_lang('SearchFeatureDoIndexDocument'));
$form->addSelectLanguage('language', get_lang('SearchFeatureDocumentLanguage'));
$specific_fields = get_specific_field_list();
foreach ($specific_fields as $specific_field) {
$form->addElement('text', $specific_field['code'], $specific_field['name']);
$filter = [
'c_id' => api_get_course_int_id(),
'field_id' => $specific_field['id'],
'ref_id' => $this->iid,
'tool_id' => "'".TOOL_QUIZ."'",
];
$values = get_specific_field_values_list($filter, ['value']);
if (!empty($values)) {
$arr_str_values = [];
foreach ($values as $value) {
$arr_str_values[] = $value['value'];
}
$defaults[$specific_field['code']] = implode(', ', $arr_str_values);
}
}
}
Skill::addSkillsToForm($form, api_get_course_int_id(), api_get_session_id(), ITEM_TYPE_EXERCISE, $this->iid);
$extraField = new ExtraField('exercise');
$extraField->addElements(
$form,
$this->iid,
[
'notifications',
'remedialcourselist',
'advancedcourselist',
'subscribe_session_when_finished_failure',
], //exclude
false, // filter
false, // tag as select
[], //show only fields
[], // order fields
[] // extra data
);
// See BT#18165
$remedialList = [
'remedialcourselist' => 'RemedialCourses',
'advancedcourselist' => 'AdvancedCourses',
];
$extraFieldExercice = new ExtraField('exercise');
$extraFieldExerciceValue = new ExtraFieldValue('exercise');
$pluginRemedial = api_get_plugin_setting('remedial_course', 'enabled') === 'true';
if ($pluginRemedial) {
$sessionId = api_get_session_id();
$userId = api_get_user_id();
foreach ($remedialList as $item => $label) {
$remedialField = $extraFieldExercice->get_handler_field_info_by_field_variable($item);
$optionRemedial = [];
$defaults[$item] = [];
$remedialExtraValue = $extraFieldExerciceValue->get_values_by_handler_and_field_id($this->iid, $remedialField['id']);
$defaults[$item] = isset($remedialExtraValue['value']) ? explode(';', $remedialExtraValue['value']) : [];
if ($sessionId != 0) {
$courseList = SessionManager::getCoursesInSession($sessionId);
foreach ($courseList as $course) {
$courseSession = api_get_course_info_by_id($course);
if (!empty($courseSession) && isset($courseSession['real_id'])) {
$courseId = $courseSession['real_id'];
if (api_get_course_int_id() != $courseId) {
$optionRemedial[$courseId] = $courseSession['title'];
}
}
}
} else {
$courseList = CourseManager::get_course_list();
foreach ($courseList as $course) {
if (!empty($course) && isset($course['real_id'])) {
$courseId = $course['real_id'];
if (api_get_course_int_id() != $courseId) {
$optionRemedial[$courseId] = $course['title'];
}
}
}
}
unset($optionRemedial[0]);
$form->addSelect(
"extra_".$item,
get_plugin_lang($label, RemedialCoursePlugin::class),
$optionRemedial,
[
'placeholder' => get_lang('SelectAnOption'),
'multiple' => 'multiple',
]
);
}
}
if (true === api_get_configuration_value('exercise_subscribe_session_when_finished_failure')) {
$optionSessionWhenFailure = [];
if ($failureSession = ExerciseLib::getSessionWhenFinishedFailure($this->iid)) {
$defaults['subscribe_session_when_finished_failure'] = $failureSession->getId();
$optionSessionWhenFailure[$failureSession->getId()] = $failureSession->getName();
}
$form->addSelectAjax(
'extra_subscribe_session_when_finished_failure',
get_lang('SubscribeSessionWhenFinishedFailure'),
$optionSessionWhenFailure,
[
'url' => api_get_path(WEB_AJAX_PATH).'session.ajax.php?'
.http_build_query(['a' => 'search_session']),
]
);
}
$settings = api_get_configuration_value('exercise_finished_notification_settings');
if (!empty($settings)) {
$options = [];
foreach ($settings as $name => $data) {
$options[$name] = $name;
}
$form->addSelect(
'extra_notifications',
get_lang('Notifications'),
$options,
['placeholder' => get_lang('SelectAnOption')]
);
}
$form->addElement('html', '</div>'); //End advanced setting
$form->addElement('html', '</div>');
}
// submit
if (isset($_GET['exerciseId'])) {
$form->addButtonSave(get_lang('ModifyExercise'), 'submitExercise');
} else {
$form->addButtonUpdate(get_lang('ProcedToQuestions'), 'submitExercise');
}
$form->addRule('exerciseTitle', get_lang('GiveExerciseName'), 'required');
// defaults
if ($type == 'full') {
// rules
$form->addRule('exerciseAttempts', get_lang('Numeric'), 'numeric');
$form->addRule('start_time', get_lang('InvalidDate'), 'datetime');
$form->addRule('end_time', get_lang('InvalidDate'), 'datetime');
if ($this->iid > 0) {
$defaults['randomQuestions'] = $this->random;
$defaults['randomAnswers'] = $this->getRandomAnswers();
$defaults['exerciseType'] = $this->selectType();
$defaults['exerciseTitle'] = $this->get_formated_title();
$defaults['exerciseDescription'] = $this->selectDescription();
$defaults['exerciseAttempts'] = $this->selectAttempts();
$defaults['exerciseFeedbackType'] = $this->getFeedbackType();
$defaults['results_disabled'] = $this->selectResultsDisabled();
$defaults['propagate_neg'] = $this->selectPropagateNeg();
$defaults['save_correct_answers'] = $this->getSaveCorrectAnswers();
$defaults['review_answers'] = $this->review_answers;
$defaults['randomByCat'] = $this->getRandomByCategory();
$defaults['text_when_finished'] = $this->getTextWhenFinished();
$defaults['display_category_name'] = $this->selectDisplayCategoryName();
$defaults['pass_percentage'] = $this->selectPassPercentage();
$defaults['question_selection_type'] = $this->getQuestionSelectionType();
$defaults['hide_question_title'] = $this->getHideQuestionTitle();
$defaults['show_previous_button'] = $this->showPreviousButton();
$defaults['exercise_category_id'] = $this->getExerciseCategoryId();
$defaults['prevent_backwards'] = $this->getPreventBackwards();
if (true === api_get_configuration_value('exercise_text_when_finished_failure')) {
$defaults['text_when_finished_failure'] = $this->getTextWhenFinishedFailure();
}
if (!empty($this->start_time)) {
$defaults['activate_start_date_check'] = 1;
}
if (!empty($this->end_time)) {
$defaults['activate_end_date_check'] = 1;
}
$defaults['start_time'] = !empty($this->start_time) ? api_get_local_time($this->start_time) : date('Y-m-d 12:00:00');
$defaults['end_time'] = !empty($this->end_time) ? api_get_local_time($this->end_time) : date('Y-m-d 12:00:00', time() + 84600);
// Get expired time
if ($this->expired_time != '0') {
$defaults['enabletimercontrol'] = 1;
$defaults['enabletimercontroltotalminutes'] = $this->expired_time;
} else {
$defaults['enabletimercontroltotalminutes'] = 0;
}
$defaults['notifications'] = $this->getNotifications();
} else {
$defaults['exerciseType'] = 2;
$defaults['exerciseAttempts'] = 0;
$defaults['randomQuestions'] = 0;
$defaults['randomAnswers'] = 0;
$defaults['exerciseDescription'] = '';
$defaults['exerciseFeedbackType'] = 0;
$defaults['results_disabled'] = 0;
$defaults['randomByCat'] = 0;
$defaults['text_when_finished'] = '';
if (true === api_get_configuration_value('exercise_text_when_finished_failure')) {
$defaults['text_when_finished_failure'] = '';
}
$defaults['start_time'] = date('Y-m-d 12:00:00');
$defaults['display_category_name'] = 1;
$defaults['end_time'] = date('Y-m-d 12:00:00', time() + 84600);
$defaults['pass_percentage'] = '';
$defaults['end_button'] = $this->selectEndButton();
$defaults['question_selection_type'] = 1;
$defaults['hide_question_title'] = 0;
$defaults['show_previous_button'] = 1;
$defaults['on_success_message'] = null;
$defaults['on_failed_message'] = null;
}
} else {
$defaults['exerciseTitle'] = $this->selectTitle();
$defaults['exerciseDescription'] = $this->selectDescription();
}
if (api_get_setting('search_enabled') === 'true') {
$defaults['index_document'] = 'checked="checked"';
}
$this->setPageResultConfigurationDefaults($defaults);
$this->setHideQuestionNumberDefaults($defaults);
$this->setHideAttemptsTableOnStartPageDefaults($defaults);
$form->setDefaults($defaults);
// Freeze some elements.
if ($this->iid != 0 && $this->edit_exercise_in_lp == false) {
$elementsToFreeze = [
'randomQuestions',
//'randomByCat',
'exerciseAttempts',
'propagate_neg',
'enabletimercontrol',
'review_answers',
];
foreach ($elementsToFreeze as $elementName) {
/** @var HTML_QuickForm_element $element */
$element = $form->getElement($elementName);
$element->freeze();
}
}
}
public function setResultFeedbackGroup(FormValidator $form, $checkFreeze = true)
{
// Feedback type.
$feedback = [];
$warning = sprintf(
get_lang('TheSettingXWillChangeToX'),
get_lang('ShowResultsToStudents'),
get_lang('ShowScoreAndRightAnswer')
);
$endTest = $form->createElement(
'radio',
'exerciseFeedbackType',
null,
get_lang('ExerciseAtTheEndOfTheTest'),
EXERCISE_FEEDBACK_TYPE_END,
[
'id' => 'exerciseType_'.EXERCISE_FEEDBACK_TYPE_END,
//'onclick' => 'if confirm() check_feedback()',
'onclick' => 'javascript:if(confirm('."'".addslashes($warning)."'".')) { check_feedback(); } else { return false;} ',
]
);
$noFeedBack = $form->createElement(
'radio',
'exerciseFeedbackType',
null,
get_lang('NoFeedback'),
EXERCISE_FEEDBACK_TYPE_EXAM,
[
'id' => 'exerciseType_'.EXERCISE_FEEDBACK_TYPE_EXAM,
]
);
$feedback[] = $endTest;
$feedback[] = $noFeedBack;
$scenarioEnabled = 'true' === api_get_setting('enable_quiz_scenario');
$freeze = true;
if ($scenarioEnabled) {
if ($this->getQuestionCount() > 0) {
$hasDifferentQuestion = $this->hasQuestionWithTypeNotInList([UNIQUE_ANSWER, HOT_SPOT_DELINEATION]);
if (false === $hasDifferentQuestion) {
$freeze = false;
}
} else {
$freeze = false;
}
$direct = $form->createElement(
'radio',
'exerciseFeedbackType',
null,
get_lang('DirectFeedback'),
EXERCISE_FEEDBACK_TYPE_DIRECT,
[
'id' => 'exerciseType_'.EXERCISE_FEEDBACK_TYPE_DIRECT,
'onclick' => 'check_direct_feedback()',
]
);
$directPopUp = $form->createElement(
'radio',
'exerciseFeedbackType',
null,
get_lang('ExerciseDirectPopUp'),
EXERCISE_FEEDBACK_TYPE_POPUP,
['id' => 'exerciseType_'.EXERCISE_FEEDBACK_TYPE_POPUP, 'onclick' => 'check_direct_feedback()']
);
if ($freeze) {
$direct->freeze();
$directPopUp->freeze();
}
// If has delineation freeze all.
$hasDelineation = $this->hasQuestionWithType(HOT_SPOT_DELINEATION);
if ($hasDelineation) {
$endTest->freeze();
$noFeedBack->freeze();
$direct->freeze();
$directPopUp->freeze();
}
$feedback[] = $direct;
$feedback[] = $directPopUp;
}
$form->addGroup(
$feedback,
null,
[
get_lang('FeedbackType'),
get_lang('FeedbackDisplayOptions'),
]
);
}
/**
* function which process the creation of exercises.
*
* @param FormValidator $form
* @param string
*
* @return int c_quiz.iid
*/
public function processCreation($form, $type = '')
{
$this->updateTitle(self::format_title_variable($form->getSubmitValue('exerciseTitle')));
$this->updateDescription($form->getSubmitValue('exerciseDescription'));
$this->updateAttempts($form->getSubmitValue('exerciseAttempts'));
$this->updateFeedbackType($form->getSubmitValue('exerciseFeedbackType'));
$this->updateType($form->getSubmitValue('exerciseType'));
// If direct feedback then force to One per page
if (EXERCISE_FEEDBACK_TYPE_DIRECT == $form->getSubmitValue('exerciseFeedbackType')) {
$this->updateType(ONE_PER_PAGE);
}
$this->setRandom($form->getSubmitValue('randomQuestions'));
$this->updateRandomAnswers($form->getSubmitValue('randomAnswers'));
$this->updateResultsDisabled($form->getSubmitValue('results_disabled'));
$this->updateExpiredTime($form->getSubmitValue('enabletimercontroltotalminutes'));
$this->updatePropagateNegative($form->getSubmitValue('propagate_neg'));
$this->updateSaveCorrectAnswers($form->getSubmitValue('save_correct_answers'));
$this->updateRandomByCat($form->getSubmitValue('randomByCat'));
$this->updateTextWhenFinished($form->getSubmitValue('text_when_finished'));
if (true === api_get_configuration_value('exercise_text_when_finished_failure')) {
$this->setTextWhenFinishedFailure($form->getSubmitValue('text_when_finished_failure'));
}
$this->updateDisplayCategoryName($form->getSubmitValue('display_category_name'));
$this->updateReviewAnswers($form->getSubmitValue('review_answers'));
$this->updatePassPercentage($form->getSubmitValue('pass_percentage'));
$this->updateCategories($form->getSubmitValue('category'));
$this->updateEndButton($form->getSubmitValue('end_button'));
$this->setOnSuccessMessage($form->getSubmitValue('on_success_message'));
$this->setOnFailedMessage($form->getSubmitValue('on_failed_message'));
$this->updateEmailNotificationTemplate($form->getSubmitValue('email_notification_template'));
$this->setEmailNotificationTemplateToUser($form->getSubmitValue('email_notification_template_to_user'));
$this->setNotifyUserByEmail($form->getSubmitValue('notify_user_by_email'));
$this->setModelType($form->getSubmitValue('model_type'));
$this->setQuestionSelectionType($form->getSubmitValue('question_selection_type'));
$this->setHideQuestionTitle($form->getSubmitValue('hide_question_title'));
$this->sessionId = api_get_session_id();
$this->setQuestionSelectionType($form->getSubmitValue('question_selection_type'));
$this->setScoreTypeModel($form->getSubmitValue('score_type_model'));
$this->setGlobalCategoryId($form->getSubmitValue('global_category_id'));
$this->setShowPreviousButton($form->getSubmitValue('show_previous_button'));
$this->setNotifications($form->getSubmitValue('notifications'));
$this->setExerciseCategoryId($form->getSubmitValue('exercise_category_id'));
$this->setPageResultConfiguration($form->getSubmitValues());
$showHideConfiguration = api_get_configuration_value('quiz_hide_question_number');
if ($showHideConfiguration) {
$this->setHideQuestionNumber($form->getSubmitValue('hide_question_number'));
}
$this->setHideAttemptsTableOnStartPage($form->getSubmitValue('hide_attempts_table'));
$this->preventBackwards = (int) $form->getSubmitValue('prevent_backwards');
$this->start_time = null;
if ($form->getSubmitValue('activate_start_date_check') == 1) {
$start_time = $form->getSubmitValue('start_time');
$this->start_time = api_get_utc_datetime($start_time);
}
$this->end_time = null;
if ($form->getSubmitValue('activate_end_date_check') == 1) {
$end_time = $form->getSubmitValue('end_time');
$this->end_time = api_get_utc_datetime($end_time);
}
$this->expired_time = 0;
if ($form->getSubmitValue('enabletimercontrol') == 1) {
$expired_total_time = $form->getSubmitValue('enabletimercontroltotalminutes');
if ($this->expired_time == 0) {
$this->expired_time = $expired_total_time;
}
}
$this->random_answers = 0;
if ($form->getSubmitValue('randomAnswers') == 1) {
$this->random_answers = 1;
}
// Update title in all LPs that have this quiz added
if ($form->getSubmitValue('update_title_in_lps') == 1) {
$courseId = api_get_course_int_id();
$table = Database::get_course_table(TABLE_LP_ITEM);
$sql = "SELECT * FROM $table
WHERE
c_id = $courseId AND
item_type = 'quiz' AND
path = '".$this->iid."'
";
$result = Database::query($sql);
$items = Database::store_result($result);
if (!empty($items)) {
foreach ($items as $item) {
$itemId = $item['iid'];
$sql = "UPDATE $table SET title = '".$this->title."'
WHERE iid = $itemId AND c_id = $courseId ";
Database::query($sql);
}
}
}
$iid = $this->save($type);
if (!empty($iid)) {
$values = $form->getSubmitValues();
$values['item_id'] = $iid;
$extraFieldValue = new ExtraFieldValue('exercise');
$extraFieldValue->saveFieldValues($values);
Skill::saveSkills($form, ITEM_TYPE_EXERCISE, $iid);
}
}
public function search_engine_save()
{
if ($_POST['index_document'] != 1) {
return;
}
$course_id = api_get_course_id();
require_once api_get_path(LIBRARY_PATH).'specific_fields_manager.lib.php';
$specific_fields = get_specific_field_list();
$ic_slide = new IndexableChunk();
$all_specific_terms = '';
foreach ($specific_fields as $specific_field) {
if (isset($_REQUEST[$specific_field['code']])) {
$sterms = trim($_REQUEST[$specific_field['code']]);
if (!empty($sterms)) {
$all_specific_terms .= ' '.$sterms;
$sterms = explode(',', $sterms);
foreach ($sterms as $sterm) {
$ic_slide->addTerm(trim($sterm), $specific_field['code']);
add_specific_field_value($specific_field['id'], $course_id, TOOL_QUIZ, $this->iid, $sterm);
}
}
}
}
// build the chunk to index
$ic_slide->addValue("title", $this->exercise);
$ic_slide->addCourseId($course_id);
$ic_slide->addToolId(TOOL_QUIZ);
$xapian_data = [
SE_COURSE_ID => $course_id,
SE_TOOL_ID => TOOL_QUIZ,
SE_DATA => ['type' => SE_DOCTYPE_EXERCISE_EXERCISE, 'exercise_id' => (int) $this->iid],
SE_USER => (int) api_get_user_id(),
];
$ic_slide->xapian_data = serialize($xapian_data);
$exercise_description = $all_specific_terms.' '.$this->description;
$ic_slide->addValue("content", $exercise_description);
$di = new ChamiloIndexer();
isset($_POST['language']) ? $lang = Database::escape_string($_POST['language']) : $lang = 'english';
$di->connectDb(null, null, $lang);
$di->addChunk($ic_slide);
//index and return search engine document id
$did = $di->index();
if ($did) {
// save it to db
$tbl_se_ref = Database::get_main_table(TABLE_MAIN_SEARCH_ENGINE_REF);
$sql = 'INSERT INTO %s (id, course_code, tool_id, ref_id_high_level, search_did)
VALUES (NULL , \'%s\', \'%s\', %s, %s)';
$sql = sprintf($sql, $tbl_se_ref, $course_id, TOOL_QUIZ, $this->iid, $did);
Database::query($sql);
}
}
public function search_engine_edit()
{
// update search enchine and its values table if enabled
if (api_get_setting('search_enabled') == 'true' && extension_loaded('xapian')) {
$course_id = api_get_course_id();
// actually, it consists on delete terms from db,
// insert new ones, create a new search engine document, and remove the old one
// get search_did
$tbl_se_ref = Database::get_main_table(TABLE_MAIN_SEARCH_ENGINE_REF);
$sql = 'SELECT * FROM %s WHERE course_code=\'%s\' AND tool_id=\'%s\' AND ref_id_high_level=%s LIMIT 1';
$sql = sprintf($sql, $tbl_se_ref, $course_id, TOOL_QUIZ, $this->iid);
$res = Database::query($sql);
if (Database::num_rows($res) > 0) {
require_once api_get_path(LIBRARY_PATH).'specific_fields_manager.lib.php';
$se_ref = Database::fetch_array($res);
$specific_fields = get_specific_field_list();
$ic_slide = new IndexableChunk();
$all_specific_terms = '';
foreach ($specific_fields as $specific_field) {
delete_all_specific_field_value($course_id, $specific_field['id'], TOOL_QUIZ, $this->iid);
if (isset($_REQUEST[$specific_field['code']])) {
$sterms = trim($_REQUEST[$specific_field['code']]);
$all_specific_terms .= ' '.$sterms;
$sterms = explode(',', $sterms);
foreach ($sterms as $sterm) {
$ic_slide->addTerm(trim($sterm), $specific_field['code']);
add_specific_field_value($specific_field['id'], $course_id, TOOL_QUIZ, $this->iid, $sterm);
}
}
}
// build the chunk to index
$ic_slide->addValue('title', $this->exercise);
$ic_slide->addCourseId($course_id);
$ic_slide->addToolId(TOOL_QUIZ);
$xapian_data = [
SE_COURSE_ID => $course_id,
SE_TOOL_ID => TOOL_QUIZ,
SE_DATA => ['type' => SE_DOCTYPE_EXERCISE_EXERCISE, 'exercise_id' => $this->iid],
SE_USER => api_get_user_id(),
];
$ic_slide->xapian_data = serialize($xapian_data);
$exercise_description = $all_specific_terms.' '.$this->description;
$ic_slide->addValue('content', $exercise_description);
$di = new ChamiloIndexer();
isset($_POST['language']) ? $lang = Database::escape_string($_POST['language']) : $lang = 'english';
$di->connectDb(null, null, $lang);
$di->remove_document($se_ref['search_did']);
$di->addChunk($ic_slide);
//index and return search engine document id
$did = $di->index();
if ($did) {
// save it to db
$sql = 'DELETE FROM %s WHERE course_code=\'%s\' AND tool_id=\'%s\' AND ref_id_high_level=\'%s\'';
$sql = sprintf($sql, $tbl_se_ref, $course_id, TOOL_QUIZ, $this->iid);
Database::query($sql);
$sql = 'INSERT INTO %s (id, course_code, tool_id, ref_id_high_level, search_did)
VALUES (NULL , \'%s\', \'%s\', %s, %s)';
$sql = sprintf($sql, $tbl_se_ref, $course_id, TOOL_QUIZ, $this->iid, $did);
Database::query($sql);
}
} else {
$this->search_engine_save();
}
}
}
public function search_engine_delete()
{
// remove from search engine if enabled
if ('true' == api_get_setting('search_enabled') && extension_loaded('xapian')) {
$course_id = api_get_course_id();
$tbl_se_ref = Database::get_main_table(TABLE_MAIN_SEARCH_ENGINE_REF);
$sql = 'SELECT * FROM %s
WHERE course_code=\'%s\' AND tool_id=\'%s\' AND ref_id_high_level=%s AND ref_id_second_level IS NULL
LIMIT 1';
$sql = sprintf($sql, $tbl_se_ref, $course_id, TOOL_QUIZ, $this->iid);
$res = Database::query($sql);
if (Database::num_rows($res) > 0) {
$row = Database::fetch_array($res);
$di = new ChamiloIndexer();
$di->remove_document($row['search_did']);
unset($di);
$tbl_quiz_question = Database::get_course_table(TABLE_QUIZ_QUESTION);
foreach ($this->questionList as $question_i) {
$sql = 'SELECT type FROM %s WHERE iid = %s';
$sql = sprintf($sql, $tbl_quiz_question, $question_i);
$qres = Database::query($sql);
if (Database::num_rows($qres) > 0) {
$qrow = Database::fetch_array($qres);
$objQuestion = Question::getInstance($qrow['type']);
$objQuestion = Question::read((int) $question_i);
$objQuestion->search_engine_edit($this->iid, false, true);
unset($objQuestion);
}
}
}
$sql = 'DELETE FROM %s
WHERE course_code=\'%s\' AND tool_id=\'%s\' AND ref_id_high_level=%s AND ref_id_second_level IS NULL
LIMIT 1';
$sql = sprintf($sql, $tbl_se_ref, $course_id, TOOL_QUIZ, $this->iid);
Database::query($sql);
// remove terms from db
require_once api_get_path(LIBRARY_PATH).'specific_fields_manager.lib.php';
delete_all_values_for_item($course_id, TOOL_QUIZ, $this->iid);
}
}
public function selectExpiredTime()
{
return $this->expired_time;
}
/**
* Cleans the student's results only for the Exercise tool (Not from the LP)
* The LP results are NOT deleted by default, otherwise put $cleanLpTests = true
* Works with exercises in sessions.
*
* @param bool $cleanLpTests
* @param string $cleanResultBeforeDate
*
* @return int quantity of user's exercises deleted
*/
public function cleanResults($cleanLpTests = false, $cleanResultBeforeDate = null)
{
$sessionId = api_get_session_id();
$table_track_e_exercises = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$table_track_e_attempt = Database::get_main_table(TABLE_STATISTIC_TRACK_E_ATTEMPT);
$sql_where = ' AND
orig_lp_id = 0 AND
orig_lp_item_id = 0';
// if we want to delete results from LP too
if ($cleanLpTests) {
$sql_where = '';
}
// if we want to delete attempts before date $cleanResultBeforeDate
// $cleanResultBeforeDate must be a valid UTC-0 date yyyy-mm-dd
if (!empty($cleanResultBeforeDate)) {
$cleanResultBeforeDate = Database::escape_string($cleanResultBeforeDate);
if (api_is_valid_date($cleanResultBeforeDate)) {
$sql_where .= " AND exe_date <= '$cleanResultBeforeDate' ";
} else {
return 0;
}
}
$sql = "SELECT exe_id
FROM $table_track_e_exercises
WHERE
c_id = ".api_get_course_int_id()." AND
exe_exo_id = ".$this->iid." AND
session_id = ".$sessionId." ".
$sql_where;
$result = Database::query($sql);
$exe_list = Database::store_result($result);
// deleting TRACK_E_ATTEMPT table
// check if exe in learning path or not
$i = 0;
if (is_array($exe_list) && count($exe_list) > 0) {
foreach ($exe_list as $item) {
$sql = "DELETE FROM $table_track_e_attempt
WHERE exe_id = '".$item['exe_id']."'";
Database::query($sql);
$i++;
}
}
// delete TRACK_E_EXERCISES table
$sql = "DELETE FROM $table_track_e_exercises
WHERE
c_id = ".api_get_course_int_id()." AND
exe_exo_id = ".$this->iid." $sql_where AND
session_id = ".$sessionId;
Database::query($sql);
$this->generateStats($this->iid, api_get_course_info(), $sessionId);
Event::addEvent(
LOG_EXERCISE_RESULT_DELETE,
LOG_EXERCISE_ID,
$this->iid,
null,
null,
api_get_course_int_id(),
$sessionId
);
return $i;
}
/**
* Copies an exercise (duplicate all questions and answers).
*/
public function copyExercise()
{
$exerciseObject = $this;
$categories = $exerciseObject->getCategoriesInExercise(true);
// Get all questions no matter the order/category settings
$questionList = $exerciseObject->getQuestionOrderedList();
$sourceId = $exerciseObject->iid;
// Force the creation of a new exercise
$exerciseObject->updateTitle($exerciseObject->selectTitle().' - '.get_lang('Copy'));
// Hides the new exercise
$exerciseObject->updateStatus(false);
$exerciseObject->updateId(0);
$exerciseObject->sessionId = api_get_session_id();
$courseId = api_get_course_int_id();
$exerciseObject->save();
$newId = $exerciseObject->selectId();
$exerciseRelQuestionTable = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$count = 1;
$batchSize = 20;
$em = Database::getManager();
if ($newId && !empty($questionList)) {
$extraField = new ExtraFieldValue('exercise');
$extraField->copy($sourceId, $newId);
// Question creation
foreach ($questionList as $oldQuestionId) {
$oldQuestionObj = Question::read($oldQuestionId, null, false);
$newQuestionId = $oldQuestionObj->duplicate();
if ($newQuestionId) {
$newQuestionObj = Question::read($newQuestionId, null, false);
if (isset($newQuestionObj) && $newQuestionObj) {
$sql = "INSERT INTO $exerciseRelQuestionTable (c_id, question_id, exercice_id, question_order)
VALUES ($courseId, ".$newQuestionId.", ".$newId.", '$count')";
Database::query($sql);
$count++;
if (!empty($oldQuestionObj->category)) {
$newQuestionObj->saveCategory($oldQuestionObj->category);
}
// This should be moved to the duplicate function
$newAnswerObj = new Answer($oldQuestionId, $courseId, $exerciseObject);
$newAnswerObj->read();
$newAnswerObj->duplicate($newQuestionObj);
if (($count % $batchSize) === 0) {
$em->clear(); // Detaches all objects from Doctrine!
}
}
}
}
if (!empty($categories)) {
$newCategoryList = [];
foreach ($categories as $category) {
$newCategoryList[$category['category_id']] = $category['count_questions'];
}
$exerciseObject->save_categories_in_exercise($newCategoryList);
}
}
}
/**
* Changes the exercise status.
*
* @param string $status - exercise status
*/
public function updateStatus($status)
{
$this->active = $status;
}
/**
* Get the contents of the track_e_exercises table for the current
* exercise object, in the specific context (if defined) of a
* learning path and optionally a current progress status.
*
* @param int $lp_id
* @param int $lp_item_id
* @param int $lp_item_view_id
* @param string $status
*
* @return array
*/
public function get_stat_track_exercise_info(
$lp_id = 0,
$lp_item_id = 0,
$lp_item_view_id = 0,
$status = 'incomplete'
) {
$track_exercises = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
if (empty($lp_id)) {
$lp_id = 0;
}
if (empty($lp_item_id)) {
$lp_item_id = 0;
}
if (empty($lp_item_view_id)) {
$lp_item_view_id = 0;
}
$condition = ' WHERE exe_exo_id = '.$this->iid.' AND
exe_user_id = '.api_get_user_id().' AND
c_id = '.api_get_course_int_id().' AND
status = \''.Database::escape_string($status).'\' AND
orig_lp_id = \''.$lp_id.'\' AND
orig_lp_item_id = \''.$lp_item_id.'\' AND
orig_lp_item_view_id = \''.$lp_item_view_id.'\' AND
session_id = \''.api_get_session_id().'\' LIMIT 1'; //Adding limit 1 just in case
$sql_track = 'SELECT * FROM '.$track_exercises.$condition;
$result = Database::query($sql_track);
$new_array = [];
if (Database::num_rows($result) > 0) {
$new_array = Database::fetch_array($result, 'ASSOC');
$new_array['num_exe'] = Database::num_rows($result);
}
return $new_array;
}
/**
* Saves a test attempt.
*
* @param int $clock_expired_time clock_expired_time
* @param int int lp id
* @param int int lp item id
* @param int int lp item_view id
* @param array $questionList
* @param float $weight
*
* @return int
*/
public function save_stat_track_exercise_info(
$clock_expired_time = 0,
$safe_lp_id = 0,
$safe_lp_item_id = 0,
$safe_lp_item_view_id = 0,
$questionList = [],
$weight = 0
) {
$track_exercises = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$safe_lp_id = (int) $safe_lp_id;
$safe_lp_item_id = (int) $safe_lp_item_id;
$safe_lp_item_view_id = (int) $safe_lp_item_view_id;
if (empty($clock_expired_time)) {
$clock_expired_time = null;
}
$questionList = array_map('intval', $questionList);
$params = [
'exe_exo_id' => $this->iid,
'exe_user_id' => api_get_user_id(),
'c_id' => api_get_course_int_id(),
'status' => 'incomplete',
'session_id' => api_get_session_id(),
'data_tracking' => implode(',', $questionList),
'start_date' => api_get_utc_datetime(),
'orig_lp_id' => $safe_lp_id,
'orig_lp_item_id' => $safe_lp_item_id,
'orig_lp_item_view_id' => $safe_lp_item_view_id,
'exe_weighting' => $weight,
'user_ip' => Database::escape_string(api_get_real_ip()),
'exe_date' => api_get_utc_datetime(),
'exe_result' => 0,
'steps_counter' => 0,
'exe_duration' => 0,
'expired_time_control' => $clock_expired_time,
'questions_to_check' => '',
];
return Database::insert($track_exercises, $params);
}
/**
* @param int $question_id
* @param int $questionNum
* @param array $questions_in_media
* @param string $currentAnswer
* @param array $myRemindList
* @param bool $showPreviousButton
*
* @return string
*/
public function show_button(
$question_id,
$questionNum,
$questions_in_media = [],
$currentAnswer = '',
$myRemindList = [],
$showPreviousButton = true,
int $lpId = 0,
int $lpItemId = 0,
int $lpItemViewId = 0
) {
$nbrQuestions = $this->countQuestionsInExercise();
$buttonList = [];
$html = $label = '';
$hotspotGet = isset($_POST['hotspot']) ? Security::remove_XSS($_POST['hotspot']) : null;
if (in_array($this->getFeedbackType(), [EXERCISE_FEEDBACK_TYPE_DIRECT, EXERCISE_FEEDBACK_TYPE_POPUP]) &&
$this->type == ONE_PER_PAGE
) {
$urlTitle = get_lang('ContinueTest');
if ($questionNum == count($this->questionList)) {
$urlTitle = get_lang('EndTest');
}
$url = api_get_path(WEB_CODE_PATH).'exercise/exercise_submit_modal.php?'.api_get_cidreq();
$url .= '&'.http_build_query([
'learnpath_id' => $lpId,
'learnpath_item_id' => $lpItemId,
'learnpath_item_view_id' => $lpItemViewId,
'hotspot' => $hotspotGet,
'nbrQuestions' => $nbrQuestions,
'num' => $questionNum,
'exerciseType' => $this->type,
'exerciseId' => $this->iid,
'reminder' => empty($myRemindList) ? null : 2,
'tryagain' => isset($_REQUEST['tryagain']) && 1 === (int) $_REQUEST['tryagain'] ? 1 : 0,
]);
$params = [
'class' => 'ajax btn btn-default no-close-button',
'data-title' => Security::remove_XSS(get_lang('Comment')),
'data-size' => 'md',
'id' => "button_$question_id",
];
if ($this->getFeedbackType() === EXERCISE_FEEDBACK_TYPE_POPUP) {
$params['data-block-closing'] = 'true';
$params['class'] .= ' no-header ';
}
$html .= Display::url($urlTitle, $url, $params);
$html .= '<br />';
return $html;
}
if (!api_is_allowed_to_session_edit()) {
return '';
}
$isReviewingAnswers = isset($_REQUEST['reminder']) && 2 === (int) $_REQUEST['reminder'];
$endReminderValue = false;
if (!empty($myRemindList) && $isReviewingAnswers) {
$endValue = end($myRemindList);
if ($endValue == $question_id) {
$endReminderValue = true;
}
}
$endTest = false;
if ($this->type == ALL_ON_ONE_PAGE || $nbrQuestions == $questionNum || $endReminderValue) {
if ($this->review_answers) {
$label = get_lang('ReviewQuestions');
$class = 'btn btn-success';
} else {
$endTest = true;
$label = get_lang('EndTest');
$class = 'btn btn-warning';
}
} else {
$label = get_lang('NextQuestion');
$class = 'btn btn-primary';
}
// used to select it with jquery
$class .= ' question-validate-btn';
if ($this->type == ONE_PER_PAGE) {
if ($questionNum != 1 && $this->showPreviousButton()) {
$prev_question = $questionNum - 2;
$showPreview = true;
if (!empty($myRemindList) && $isReviewingAnswers) {
$beforeId = null;
for ($i = 0; $i < count($myRemindList); $i++) {
if (isset($myRemindList[$i]) && $myRemindList[$i] == $question_id) {
$beforeId = isset($myRemindList[$i - 1]) ? $myRemindList[$i - 1] : null;
break;
}
}
if (empty($beforeId)) {
$showPreview = false;
} else {
$num = 0;
foreach ($this->questionList as $originalQuestionId) {
if ($originalQuestionId == $beforeId) {
break;
}
$num++;
}
$prev_question = $num;
}
}
if ($showPreviousButton && $showPreview && 0 === $this->getPreventBackwards()) {
$buttonList[] = Display::button(
'previous_question_and_save',
get_lang('PreviousQuestion'),
[
'type' => 'button',
'class' => 'btn btn-default',
'data-prev' => $prev_question,
'data-question' => $question_id,
]
);
}
}
// Next question
if (!empty($questions_in_media)) {
$buttonList[] = Display::button(
'save_question_list',
$label,
[
'type' => 'button',
'class' => $class,
'data-list' => implode(",", $questions_in_media),
]
);
} else {
$attributes = ['type' => 'button', 'class' => $class, 'data-question' => $question_id];
$name = 'save_now';
if ($endTest && api_get_configuration_value('quiz_check_all_answers_before_end_test')) {
$name = 'check_answers';
}
$buttonList[] = Display::button(
$name,
$label,
$attributes
);
}
$buttonList[] = '<span id="save_for_now_'.$question_id.'" class="exercise_save_mini_message"></span>';
$html .= implode(PHP_EOL, $buttonList).PHP_EOL;
return $html;
}
if ($this->review_answers) {
$all_label = get_lang('ReviewQuestions');
$class = 'btn btn-success';
} else {
$all_label = get_lang('EndTest');
$class = 'btn btn-warning';
}
// used to select it with jquery
$class .= ' question-validate-btn';
$buttonList[] = Display::button(
'validate_all',
$all_label,
['type' => 'button', 'class' => $class]
);
$buttonList[] = Display::span(null, ['id' => 'save_all_response']);
$html .= implode(PHP_EOL, $buttonList).PHP_EOL;
return $html;
}
/**
* @param int $timeLeft in seconds
* @param string $url
*
* @return string
*/
public function showSimpleTimeControl($timeLeft, $url = '')
{
$timeLeft = (int) $timeLeft;
return "<script>
function openClockWarning() {
$('#clock_warning').dialog({
modal:true,
height:320,
width:550,
closeOnEscape: false,
resizable: false,
buttons: {
'".addslashes(get_lang('Close'))."': function() {
$('#clock_warning').dialog('close');
}
},
close: function() {
window.location.href = '$url';
}
});
$('#clock_warning').dialog('open');
$('#counter_to_redirect').epiclock({
mode: $.epiclock.modes.countdown,
offset: {seconds: 5},
format: 's'
}).bind('timer', function () {
window.location.href = '$url';
});
}
function onExpiredTimeExercise() {
$('#wrapper-clock').hide();
$('#expired-message-id').show();
// Fixes bug #5263
$('#num_current_id').attr('value', '".$this->selectNbrQuestions()."');
openClockWarning();
}
$(function() {
// time in seconds when using minutes there are some seconds lost
var time_left = parseInt(".$timeLeft.");
$('#exercise_clock_warning').epiclock({
mode: $.epiclock.modes.countdown,
offset: {seconds: time_left},
format: 'x:i:s',
renderer: 'minute'
}).bind('timer', function () {
onExpiredTimeExercise();
});
$('#submit_save').click(function () {});
});
</script>";
}
/**
* So the time control will work.
*
* @param int $timeLeft
* @param string $redirectToUrl
*
* @return string
*/
public function showTimeControlJS($timeLeft, $redirectToUrl = '')
{
$timeLeft = (int) $timeLeft;
$script = 'redirectExerciseToResult();';
if (ALL_ON_ONE_PAGE == $this->type) {
$script = "save_now_all('validate');";
} elseif (ONE_PER_PAGE == $this->type) {
$script = 'window.quizTimeEnding = true;
$(\'[name="save_now"]\').trigger(\'click\');';
}
$exerciseSubmitRedirect = '';
if (!empty($redirectToUrl)) {
$exerciseSubmitRedirect = "window.location = '$redirectToUrl'";
}
return "<script>
function openClockWarning() {
$('#clock_warning').dialog({
modal:true,
height:320,
width:550,
closeOnEscape: false,
resizable: false,
buttons: {
'".addslashes(get_lang('EndTest'))."': function() {
$('#clock_warning').dialog('close');
}
},
close: function() {
send_form();
}
});
$('#clock_warning').dialog('open');
$('#counter_to_redirect').epiclock({
mode: $.epiclock.modes.countdown,
offset: {seconds: 5},
format: 's'
}).bind('timer', function () {
send_form();
});
}
function send_form() {
if ($('#exercise_form').length) {
$script
} else {
$exerciseSubmitRedirect
// In exercise_reminder.php
final_submit();
}
}
function onExpiredTimeExercise() {
$('#wrapper-clock').hide();
$('#expired-message-id').show();
// Fixes bug #5263
$('#num_current_id').attr('value', '".$this->selectNbrQuestions()."');
openClockWarning();
}
$(function() {
// time in seconds when using minutes there are some seconds lost
var time_left = parseInt(".$timeLeft.");
$('#exercise_clock_warning').epiclock({
mode: $.epiclock.modes.countdown,
offset: {seconds: time_left},
format: 'x:C:s',
renderer: 'minute'
}).bind('timer', function () {
onExpiredTimeExercise();
});
$('#submit_save').click(function () {});
});
</script>";
}
/**
* Prepare, calculate result and save answer to the database by calling
* Event::saveQuestionAttempt() once everything is ready.
*
* @param int $exeId
* @param int $questionId
* @param mixed $choice the user-selected option
* @param string $from function is called from 'exercise_show' or 'exercise_result'
* @param array $exerciseResultCoordinates the hotspot coordinates $hotspot[$question_id] = coordinates
* @param bool $save_results save results in the DB or just show the response
* @param bool $from_database gets information from DB or from the current selection
* @param bool $show_result show results or not
* @param int $propagate_neg
* @param array $hotspot_delineation_result
* @param bool $showTotalScoreAndUserChoicesInLastAttempt
* @param bool $updateResults
* @param bool $showHotSpotDelineationTable
* @param int $questionDuration seconds
*
* @return array|false
*/
public function manage_answer(
$exeId,
$questionId,
$choice,
$from = 'exercise_show',
$exerciseResultCoordinates = [],
$save_results = true,
$from_database = false,
$show_result = true,
$propagate_neg = 0,
$hotspot_delineation_result = [],
$showTotalScoreAndUserChoicesInLastAttempt = true,
$updateResults = false,
$showHotSpotDelineationTable = false,
$questionDuration = 0
) {
$debug = false;
//needed in order to use in the exercise_attempt() for the time
global $learnpath_id, $learnpath_item_id;
require_once api_get_path(LIBRARY_PATH).'geometry.lib.php';
$em = Database::getManager();
$feedback_type = $this->getFeedbackType();
$results_disabled = $this->selectResultsDisabled();
$questionDuration = (int) $questionDuration;
if ($debug) {
error_log("<------ manage_answer ------> ");
error_log('exe_id: '.$exeId);
error_log('$from: '.$from);
error_log('$save_results: '.intval($save_results));
error_log('$from_database: '.intval($from_database));
error_log('$show_result: '.intval($show_result));
error_log('$propagate_neg: '.$propagate_neg);
error_log('$exerciseResultCoordinates: '.print_r($exerciseResultCoordinates, 1));
error_log('$hotspot_delineation_result: '.print_r($hotspot_delineation_result, 1));
error_log('$learnpath_id: '.$learnpath_id);
error_log('$learnpath_item_id: '.$learnpath_item_id);
error_log('$choice: '.print_r($choice, 1));
error_log('-----------------------------');
}
$final_overlap = 0;
$final_missing = 0;
$final_excess = 0;
$overlap_color = 0;
$missing_color = 0;
$excess_color = 0;
$threadhold1 = 0;
$threadhold2 = 0;
$threadhold3 = 0;
$arrques = null;
$arrans = null;
$studentChoice = null;
$expectedAnswer = '';
$calculatedChoice = '';
$calculatedStatus = '';
$questionId = (int) $questionId;
$exeId = (int) $exeId;
$TBL_TRACK_ATTEMPT = Database::get_main_table(TABLE_STATISTIC_TRACK_E_ATTEMPT);
$table_ans = Database::get_course_table(TABLE_QUIZ_ANSWER);
$studentChoiceDegree = null;
// Creates a temporary Question object
$course_id = $this->course_id;
$objQuestionTmp = Question::read($questionId, $this->course);
if (false === $objQuestionTmp) {
return false;
}
$questionName = $objQuestionTmp->selectTitle();
$questionWeighting = $objQuestionTmp->selectWeighting();
$answerType = $objQuestionTmp->selectType();
$quesId = $objQuestionTmp->selectId();
$extra = $objQuestionTmp->extra;
$next = 1; //not for now
$totalWeighting = 0;
$totalScore = 0;
// Extra information of the question
if ((
$answerType == MULTIPLE_ANSWER_TRUE_FALSE ||
$answerType == MULTIPLE_ANSWER_TRUE_FALSE_DEGREE_CERTAINTY
)
&& !empty($extra)
) {
$extra = explode(':', $extra);
// Fixes problems with negatives values using intval
$true_score = (float) trim($extra[0]);
$false_score = (float) trim($extra[1]);
$doubt_score = (float) trim($extra[2]);
}
// Construction of the Answer object
$objAnswerTmp = new Answer($questionId, $course_id);
$nbrAnswers = $objAnswerTmp->selectNbrAnswers();
if ($debug) {
error_log('Count of possible answers: '.$nbrAnswers);
error_log('$answerType: '.$answerType);
}
if ($answerType == MULTIPLE_ANSWER_TRUE_FALSE_DEGREE_CERTAINTY) {
$choiceTmp = $choice;
$choice = $choiceTmp['choice'] ?? '';
$choiceDegreeCertainty = $choiceTmp['choiceDegreeCertainty'] ?? '';
}
if ($answerType == FREE_ANSWER ||
$answerType == ORAL_EXPRESSION ||
$answerType == CALCULATED_ANSWER ||
$answerType == ANNOTATION ||
$answerType == UPLOAD_ANSWER ||
$answerType == ANSWER_IN_OFFICE_DOC
) {
$nbrAnswers = 1;
}
$generatedFile = '';
if ($answerType == ORAL_EXPRESSION) {
$exe_info = Event::get_exercise_results_by_attempt($exeId);
$exe_info = $exe_info[$exeId] ?? null;
$objQuestionTmp->initFile(
api_get_session_id(),
$exe_info['exe_user_id'] ?? api_get_user_id(),
$exe_info['exe_exo_id'] ?? $this->iid,
$exe_info['exe_id'] ?? $exeId
);
// Probably this attempt came in an exercise all question by page
if ($feedback_type == 0) {
$objQuestionTmp->replaceWithRealExe($exeId);
}
$generatedFile = $objQuestionTmp->getFileUrl();
}
$user_answer = '';
// Get answer list for matching.
$sql = "SELECT iid, answer
FROM $table_ans
WHERE question_id = $questionId";
$res_answer = Database::query($sql);
$answerMatching = [];
while ($real_answer = Database::fetch_array($res_answer)) {
$answerMatching[$real_answer['iid']] = $real_answer['answer'];
}
// Get first answer needed for global question, no matter the answer shuffle option;
$firstAnswer = [];
if ($answerType == MULTIPLE_ANSWER_COMBINATION ||
$answerType == MULTIPLE_ANSWER_COMBINATION_TRUE_FALSE
) {
$sql = "SELECT *
FROM $table_ans
WHERE question_id = $questionId
ORDER BY position
LIMIT 1";
$result = Database::query($sql);
if (Database::num_rows($result)) {
$firstAnswer = Database::fetch_array($result);
}
}
$real_answers = [];
$quiz_question_options = Question::readQuestionOption($questionId, $course_id);
$organs_at_risk_hit = 0;
$questionScore = 0;
$orderedHotSpots = [];
if (in_array($answerType, [HOT_SPOT_COMBINATION, HOT_SPOT, ANNOTATION])) {
$orderedHotSpots = $em->getRepository('ChamiloCoreBundle:TrackEHotspot')->findBy(
[
'hotspotQuestionId' => $questionId,
'cId' => $course_id,
'hotspotExeId' => $exeId,
],
['hotspotAnswerId' => 'ASC']
);
}
if (in_array($answerType, [MULTIPLE_ANSWER_DROPDOWN, MULTIPLE_ANSWER_DROPDOWN_COMBINATION])) {
if (MULTIPLE_ANSWER_DROPDOWN_COMBINATION == $answerType) {
$questionScore = $questionWeighting;
}
if ($from_database) {
$studentChoices = Database::store_result(
Database::query(
"SELECT answer FROM $TBL_TRACK_ATTEMPT WHERE exe_id = $exeId AND question_id = $questionId"
),
'ASSOC'
);
$studentChoices = array_column($studentChoices, 'answer');
} else {
$studentChoices = array_values($choice);
}
$correctChoices = array_filter(
$answerMatching,
function ($answerId) use ($objAnswerTmp) {
$index = array_search($answerId, $objAnswerTmp->iid);
return true === (bool) $objAnswerTmp->correct[$index];
},
ARRAY_FILTER_USE_KEY
);
$correctChoices = array_keys($correctChoices);
if (MULTIPLE_ANSWER_DROPDOWN_COMBINATION == $answerType
&& (array_diff($studentChoices, $correctChoices) || array_diff($correctChoices, $studentChoices))
) {
$questionScore = 0;
}
if ($show_result) {
echo ExerciseShowFunctions::displayMultipleAnswerDropdown(
$this,
$objAnswerTmp,
$correctChoices,
$studentChoices,
$showTotalScoreAndUserChoicesInLastAttempt
);
}
}
if ($debug) {
error_log('-- Start answer loop --');
}
$answerDestination = null;
$userAnsweredQuestion = false;
$correctAnswerId = [];
$matchingCorrectAnswers = [];
for ($answerId = 1; $answerId <= $nbrAnswers; $answerId++) {
$answer = $objAnswerTmp->selectAnswer($answerId);
$hideComment = (int) $this->getPageConfigurationAttribute('hide_comment');
if (1 === $hideComment) {
$answerComment = null;
} else {
$answerComment = $objAnswerTmp->selectComment($answerId);
}
$answerCorrect = $objAnswerTmp->isCorrect($answerId);
$answerWeighting = (float) $objAnswerTmp->selectWeighting($answerId);
$answerAutoId = $objAnswerTmp->selectId($answerId);
$answerIid = isset($objAnswerTmp->iid[$answerId]) ? (int) $objAnswerTmp->iid[$answerId] : 0;
if ($debug) {
error_log("c_quiz_answer.iid: $answerAutoId ");
error_log("Answer marked as correct in db (0/1)?: $answerCorrect ");
error_log("answerWeighting: $answerWeighting");
}
// Delineation.
$delineation_cord = $objAnswerTmp->selectHotspotCoordinates(1);
$answer_delineation_destination = $objAnswerTmp->selectDestination(1);
switch ($answerType) {
case UNIQUE_ANSWER:
case UNIQUE_ANSWER_IMAGE:
case UNIQUE_ANSWER_NO_OPTION:
case READING_COMPREHENSION:
if ($from_database) {
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id = $questionId";
$result = Database::query($sql);
$choice = Database::result($result, 0, 'answer');
if (false === $userAnsweredQuestion) {
$userAnsweredQuestion = !empty($choice);
}
$studentChoice = $choice == $answerAutoId ? 1 : 0;
if ($studentChoice) {
$questionScore += $answerWeighting;
$answerDestination = $objAnswerTmp->selectDestination($answerId);
$correctAnswerId[] = $answerId;
}
} else {
$studentChoice = $choice == $answerAutoId ? 1 : 0;
if ($studentChoice) {
$questionScore += $answerWeighting;
$answerDestination = $objAnswerTmp->selectDestination($answerId);
$correctAnswerId[] = $answerAutoId;
}
}
break;
case MULTIPLE_ANSWER_TRUE_FALSE:
if ($from_database) {
$choice = [];
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id = ".$questionId;
$result = Database::query($sql);
while ($row = Database::fetch_array($result)) {
$values = explode(':', $row['answer']);
$my_answer_id = isset($values[0]) ? $values[0] : '';
$option = isset($values[1]) ? $values[1] : '';
$choice[$my_answer_id] = $option;
}
$userAnsweredQuestion = !empty($choice);
}
$studentChoice = $choice[$answerAutoId] ?? null;
if (isset($studentChoice)) {
$correctAnswerId[] = $answerAutoId;
if ($studentChoice == $answerCorrect) {
$questionScore += $true_score;
} else {
if ($quiz_question_options[$studentChoice]['name'] === "Don't know" ||
$quiz_question_options[$studentChoice]['name'] === "DoubtScore"
) {
$questionScore += $doubt_score;
} else {
$questionScore += $false_score;
}
}
} else {
// If no result then the user just hit don't know
$studentChoice = 3;
$questionScore += $doubt_score;
}
$totalScore = $questionScore;
break;
case MULTIPLE_ANSWER_TRUE_FALSE_DEGREE_CERTAINTY:
if ($from_database) {
$choice = [];
$choiceDegreeCertainty = [];
$sql = "SELECT answer
FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND question_id = $questionId";
$result = Database::query($sql);
while ($row = Database::fetch_array($result)) {
$ind = $row['answer'];
$values = explode(':', $ind);
$myAnswerId = $values[0];
$option = $values[1];
$percent = $values[2];
$choice[$myAnswerId] = $option;
$choiceDegreeCertainty[$myAnswerId] = $percent;
}
}
$studentChoice = $choice[$answerAutoId] ?? null;
$studentChoiceDegree = $choiceDegreeCertainty[$answerAutoId] ?? null;
// student score update
if (!empty($studentChoice)) {
if ($studentChoice == $answerCorrect) {
// correct answer and student is Unsure or PrettySur
if (isset($quiz_question_options[$studentChoiceDegree]) &&
$quiz_question_options[$studentChoiceDegree]['position'] >= 3 &&
$quiz_question_options[$studentChoiceDegree]['position'] < 9
) {
$questionScore += $true_score;
} else {
// student ignore correct answer
$questionScore += $doubt_score;
}
} else {
// false answer and student is Unsure or PrettySur
if ($quiz_question_options[$studentChoiceDegree]['position'] >= 3
&& $quiz_question_options[$studentChoiceDegree]['position'] < 9) {
$questionScore += $false_score;
} else {
// student ignore correct answer
$questionScore += $doubt_score;
}
}
}
$totalScore = $questionScore;
break;
case MULTIPLE_ANSWER:
case MULTIPLE_ANSWER_DROPDOWN:
if ($from_database) {
$choice = [];
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE exe_id = $exeId AND question_id = $questionId ";
$resultans = Database::query($sql);
while ($row = Database::fetch_array($resultans)) {
$choice[$row['answer']] = 1;
}
$studentChoice = $choice[$answerAutoId] ?? null;
$real_answers[$answerId] = (bool) $studentChoice;
if ($studentChoice) {
$questionScore += $answerWeighting;
}
} else {
$studentChoice = $choice[$answerAutoId] ?? null;
$real_answers[$answerId] = (bool) $studentChoice;
if (isset($studentChoice)
|| (MULTIPLE_ANSWER_DROPDOWN == $answerType && in_array($answerAutoId, $choice))
) {
$correctAnswerId[] = $answerAutoId;
$questionScore += $answerWeighting;
}
}
$totalScore += $answerWeighting;
break;
case GLOBAL_MULTIPLE_ANSWER:
if ($from_database) {
$choice = [];
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE exe_id = $exeId AND question_id = $questionId ";
$resultans = Database::query($sql);
while ($row = Database::fetch_array($resultans)) {
$choice[$row['answer']] = 1;
}
$studentChoice = $choice[$answerAutoId] ?? null;
$real_answers[$answerId] = (bool) $studentChoice;
if ($studentChoice) {
$questionScore += $answerWeighting;
}
} else {
$studentChoice = $choice[$answerAutoId] ?? null;
if (isset($studentChoice)) {
$questionScore += $answerWeighting;
}
$real_answers[$answerId] = (bool) $studentChoice;
}
$totalScore += $answerWeighting;
if ($debug) {
error_log("studentChoice: $studentChoice");
}
break;
case MULTIPLE_ANSWER_COMBINATION_TRUE_FALSE:
if ($from_database) {
$choice = [];
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE exe_id = $exeId AND question_id = $questionId";
$resultans = Database::query($sql);
while ($row = Database::fetch_array($resultans)) {
$result = explode(':', $row['answer']);
if (isset($result[0])) {
$my_answer_id = isset($result[0]) ? $result[0] : '';
$option = isset($result[1]) ? $result[1] : '';
$choice[$my_answer_id] = $option;
}
}
$studentChoice = $choice[$answerAutoId] ?? '';
$real_answers[$answerId] = false;
if ($answerCorrect == $studentChoice) {
$real_answers[$answerId] = true;
}
} else {
$studentChoice = $choice[$answerAutoId] ?? '';
$real_answers[$answerId] = false;
if ($answerCorrect == $studentChoice) {
$real_answers[$answerId] = true;
}
}
break;
case MULTIPLE_ANSWER_COMBINATION:
if ($from_database) {
$choice = [];
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE exe_id = $exeId AND question_id = $questionId";
$resultans = Database::query($sql);
while ($row = Database::fetch_array($resultans)) {
$choice[$row['answer']] = 1;
}
$studentChoice = $choice[$answerAutoId] ?? null;
if (1 == $answerCorrect) {
$real_answers[$answerId] = false;
if ($studentChoice) {
$real_answers[$answerId] = true;
}
} else {
$real_answers[$answerId] = true;
if ($studentChoice) {
$real_answers[$answerId] = false;
}
}
} else {
$studentChoice = $choice[$answerAutoId] ?? null;
if (1 == $answerCorrect) {
$real_answers[$answerId] = false;
if ($studentChoice) {
$real_answers[$answerId] = true;
}
} else {
$real_answers[$answerId] = true;
if ($studentChoice) {
$real_answers[$answerId] = false;
}
}
}
break;
case FILL_IN_BLANKS:
case FILL_IN_BLANKS_COMBINATION:
$str = '';
$answerFromDatabase = '';
if ($from_database) {
$sql = "SELECT answer
FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id= $questionId ";
$result = Database::query($sql);
$str = $answerFromDatabase = Database::result($result, 0, 'answer');
}
// if ($save_results == false && strpos($answerFromDatabase, 'font color') !== false) {
if (false) {
// the question is encoded like this
// [A] B [C] D [E] F::10,10,10@1
// number 1 before the "@" means that is a switchable fill in blank question
// [A] B [C] D [E] F::10,10,10@ or [A] B [C] D [E] F::10,10,10
// means that is a normal fill blank question
// first we explode the "::"
$pre_array = explode('::', $answer);
// is switchable fill blank or not
$last = count($pre_array) - 1;
$is_set_switchable = explode('@', $pre_array[$last]);
$switchable_answer_set = false;
if (isset($is_set_switchable[1]) && 1 == $is_set_switchable[1]) {
$switchable_answer_set = true;
}
$answer = '';
for ($k = 0; $k < $last; $k++) {
$answer .= $pre_array[$k];
}
// splits weightings that are joined with a comma
$answerWeighting = explode(',', $is_set_switchable[0]);
// we save the answer because it will be modified
$temp = $answer;
$answer = '';
$j = 0;
//initialise answer tags
$user_tags = $correct_tags = $real_text = [];
// the loop will stop at the end of the text
while (1) {
// quits the loop if there are no more blanks (detect '[')
if ($temp == false || ($pos = api_strpos($temp, '[')) === false) {
// adds the end of the text
$answer = $temp;
$real_text[] = $answer;
break; //no more "blanks", quit the loop
}
// adds the piece of text that is before the blank
//and ends with '[' into a general storage array
$real_text[] = api_substr($temp, 0, $pos + 1);
$answer .= api_substr($temp, 0, $pos + 1);
//take the string remaining (after the last "[" we found)
$temp = api_substr($temp, $pos + 1);
// quit the loop if there are no more blanks, and update $pos to the position of next ']'
if (($pos = api_strpos($temp, ']')) === false) {
// adds the end of the text
$answer .= $temp;
break;
}
if ($from_database) {
$str = $answerFromDatabase;
api_preg_match_all('#\[([^[]*)\]#', $str, $arr);
$str = str_replace('\r\n', '', $str);
$choice = $arr[1];
if (isset($choice[$j])) {
$tmp = api_strrpos($choice[$j], ' / ');
$choice[$j] = api_substr($choice[$j], 0, $tmp);
$choice[$j] = trim($choice[$j]);
// Needed to let characters ' and " to work as part of an answer
$choice[$j] = stripslashes($choice[$j]);
} else {
$choice[$j] = null;
}
} else {
// This value is the user input, not escaped while correct answer is escaped by ckeditor
$choice[$j] = api_htmlentities(trim($choice[$j]));
}
$user_tags[] = $choice[$j];
// Put the contents of the [] answer tag into correct_tags[]
$correct_tags[] = api_substr($temp, 0, $pos);
$j++;
$temp = api_substr($temp, $pos + 1);
}
$answer = '';
$real_correct_tags = $correct_tags;
$chosen_list = [];
for ($i = 0; $i < count($real_correct_tags); $i++) {
if (0 == $i) {
$answer .= $real_text[0];
}
if (!$switchable_answer_set) {
// Needed to parse ' and " characters
$user_tags[$i] = stripslashes($user_tags[$i]);
if ($correct_tags[$i] == $user_tags[$i]) {
// gives the related weighting to the student
$questionScore += $answerWeighting[$i];
// increments total score
$totalScore += $answerWeighting[$i];
// adds the word in green at the end of the string
$answer .= $correct_tags[$i];
} elseif (!empty($user_tags[$i])) {
// else if the word entered by the student IS NOT the same as
// the one defined by the professor
// adds the word in red at the end of the string, and strikes it
$answer .= '<font color="red"><s>'.$user_tags[$i].'</s></font>';
} else {
// adds a tabulation if no word has been typed by the student
$answer .= ''; // remove that causes issue
}
} else {
// switchable fill in the blanks
if (in_array($user_tags[$i], $correct_tags)) {
$chosen_list[] = $user_tags[$i];
$correct_tags = array_diff($correct_tags, $chosen_list);
// gives the related weighting to the student
$questionScore += $answerWeighting[$i];
// increments total score
$totalScore += $answerWeighting[$i];
// adds the word in green at the end of the string
$answer .= $user_tags[$i];
} elseif (!empty($user_tags[$i])) {
// else if the word entered by the student IS NOT the same
// as the one defined by the professor
// adds the word in red at the end of the string, and strikes it
$answer .= '<font color="red"><s>'.$user_tags[$i].'</s></font>';
} else {
// adds a tabulation if no word has been typed by the student
$answer .= ''; // remove that causes issue
}
}
// adds the correct word, followed by ] to close the blank
$answer .= ' / <font color="green"><b>'.$real_correct_tags[$i].'</b></font>]';
if (isset($real_text[$i + 1])) {
$answer .= $real_text[$i + 1];
}
}
} else {
// insert the student result in the track_e_attempt table, field answer
// $answer is the answer like in the c_quiz_answer table for the question
// student data are choice[]
$listCorrectAnswers = FillBlanks::getAnswerInfo($answer);
$switchableAnswerSet = $listCorrectAnswers['switchable'];
$answerWeighting = $listCorrectAnswers['weighting'];
// user choices is an array $choice
// get existing user data in n the BDD
if ($from_database) {
$listStudentResults = FillBlanks::getAnswerInfo(
$answerFromDatabase,
true
);
$choice = $listStudentResults['student_answer'];
}
// loop other all blanks words
if (!$switchableAnswerSet) {
// not switchable answer, must be in the same place than teacher order
for ($i = 0; $i < count($listCorrectAnswers['words']); $i++) {
$studentAnswer = isset($choice[$i]) ? $choice[$i] : '';
$correctAnswer = $listCorrectAnswers['words'][$i];
if ($debug) {
error_log("Student answer: $i");
error_log($studentAnswer);
}
// This value is the user input, not escaped while correct answer is escaped by ckeditor
// Works with cyrillic alphabet and when using ">" chars see #7718 #7610 #7618
// ENT_QUOTES is used in order to transform ' to '
if (!$from_database) {
$studentAnswer = FillBlanks::clearStudentAnswer($studentAnswer);
if ($debug) {
error_log('Student answer cleaned:');
error_log($studentAnswer);
}
}
$isAnswerCorrect = 0;
if (FillBlanks::isStudentAnswerGood($studentAnswer, $correctAnswer, $from_database)) {
// gives the related weighting to the student
$questionScore += $answerWeighting[$i];
// increments total score
$totalScore += $answerWeighting[$i];
$isAnswerCorrect = 1;
}
if ($debug) {
error_log("isAnswerCorrect $i: $isAnswerCorrect");
}
$studentAnswerToShow = $studentAnswer;
$type = FillBlanks::getFillTheBlankAnswerType($correctAnswer);
if ($debug) {
error_log("Fill in blank type: $type");
}
if ($type == FillBlanks::FILL_THE_BLANK_MENU) {
$listMenu = FillBlanks::getFillTheBlankMenuAnswers($correctAnswer, false);
if ($studentAnswer != '') {
foreach ($listMenu as $item) {
if (sha1($item) == $studentAnswer) {
$studentAnswerToShow = $item;
}
}
}
}
$listCorrectAnswers['student_answer'][$i] = $studentAnswerToShow;
$listCorrectAnswers['student_score'][$i] = $isAnswerCorrect;
}
} else {
// switchable answer
$listStudentAnswerTemp = $choice;
$listTeacherAnswerTemp = $listCorrectAnswers['words'];
// for every teacher answer, check if there is a student answer
for ($i = 0; $i < count($listStudentAnswerTemp); $i++) {
$studentAnswer = trim($listStudentAnswerTemp[$i]);
$studentAnswerToShow = $studentAnswer;
if (empty($studentAnswer)) {
break;
}
if ($debug) {
error_log("Student answer: $i");
error_log($studentAnswer);
}
if (!$from_database) {
$studentAnswer = FillBlanks::clearStudentAnswer($studentAnswer);
if ($debug) {
error_log("Student answer cleaned:");
error_log($studentAnswer);
}
}
$found = false;
for ($j = 0; $j < count($listTeacherAnswerTemp); $j++) {
$correctAnswer = isset($listTeacherAnswerTemp[$j]) ? $listTeacherAnswerTemp[$j] : '';
if (is_array($listTeacherAnswerTemp)) {
$correctAnswer = implode('||', $listTeacherAnswerTemp);
}
if (empty($correctAnswer)) {
break;
}
if (FillBlanks::isStudentAnswerGood(
$studentAnswer,
$correctAnswer,
$from_database,
true
)) {
$questionScore += $answerWeighting[$i];
$totalScore += $answerWeighting[$i];
if (is_array($listTeacherAnswerTemp)) {
$searchAnswer = array_search(api_htmlentities($studentAnswer), $listTeacherAnswerTemp);
if (false !== $searchAnswer) {
// Remove from array
unset($listTeacherAnswerTemp[$searchAnswer]);
}
} else {
$listTeacherAnswerTemp[$j] = null;
}
$found = true;
}
if (FillBlanks::FILL_THE_BLANK_MENU != $listCorrectAnswers['words_types'][$j]) {
break;
}
$listMenu = FillBlanks::getFillTheBlankMenuAnswers($correctAnswer, false);
foreach ($listMenu as $item) {
if (sha1($item) === $studentAnswer) {
$studentAnswerToShow = $item;
}
}
}
$listCorrectAnswers['student_answer'][$i] = $studentAnswerToShow;
$listCorrectAnswers['student_score'][$i] = $found ? 1 : 0;
}
}
$answer = FillBlanks::getAnswerInStudentAttempt($listCorrectAnswers);
}
break;
case CALCULATED_ANSWER:
$calculatedAnswerList = Session::read('calculatedAnswerId');
$calculatedAnswerId = null;
if (!empty($calculatedAnswerList) && isset($calculatedAnswerList[$questionId])) {
$calculatedAnswerId = $calculatedAnswerList[$questionId];
$answer = $objAnswerTmp->selectAnswer($calculatedAnswerId);
$preArray = explode('@@', $answer);
$last = count($preArray) - 1;
$answer = '';
for ($k = 0; $k < $last; $k++) {
$answer .= $preArray[$k];
}
$answerWeighting = [$answerWeighting];
// we save the answer because it will be modified
$temp = $answer;
$answer = '';
$j = 0;
// initialise answer tags
$userTags = $correctTags = $realText = [];
// the loop will stop at the end of the text
while (1) {
// quits the loop if there are no more blanks (detect '[')
if ($temp == false || ($pos = api_strpos($temp, '[')) === false) {
// adds the end of the text
$answer = $temp;
$realText[] = $answer;
break; //no more "blanks", quit the loop
}
// adds the piece of text that is before the blank
// and ends with '[' into a general storage array
$realText[] = api_substr($temp, 0, $pos + 1);
$answer .= api_substr($temp, 0, $pos + 1);
// take the string remaining (after the last "[" we found)
$temp = api_substr($temp, $pos + 1);
// quit the loop if there are no more blanks, and update $pos to the position of next ']'
if (false === ($pos = api_strpos($temp, ']'))) {
// adds the end of the text
$answer .= $temp;
break;
}
if ($from_database) {
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id = $questionId ";
$result = Database::query($sql);
$str = Database::result($result, 0, 'answer');
api_preg_match_all('#\[([^[]*)\]#', $str, $arr);
$str = str_replace('\r\n', '', $str);
$choice = $arr[1];
if (isset($choice[$j])) {
$tmp = api_strrpos($choice[$j], ' / ');
if ($tmp) {
$choice[$j] = api_substr($choice[$j], 0, $tmp);
} else {
$tmp = ltrim($tmp, '[');
$tmp = rtrim($tmp, ']');
}
$choice[$j] = trim($choice[$j]);
// Needed to let characters ' and " to work as part of an answer
$choice[$j] = stripslashes($choice[$j]);
} else {
$choice[$j] = null;
}
} else {
// This value is the user input not escaped while correct answer is escaped by ckeditor
$choice[$j] = api_htmlentities(trim($choice[$j]));
}
$userTags[] = $choice[$j];
// put the contents of the [] answer tag into correct_tags[]
$correctTags[] = api_substr($temp, 0, $pos);
$j++;
$temp = api_substr($temp, $pos + 1);
}
$answer = '';
$realCorrectTags = $correctTags;
$calculatedStatus = Display::label(get_lang('Incorrect'), 'danger');
$expectedAnswer = '';
$calculatedChoice = '';
for ($i = 0; $i < count($realCorrectTags); $i++) {
if (0 == $i) {
$answer .= $realText[0];
}
// Needed to parse ' and " characters
$userTags[$i] = stripslashes($userTags[$i]);
if ($correctTags[$i] == $userTags[$i]) {
// gives the related weighting to the student
$questionScore += $answerWeighting[$i];
// increments total score
$totalScore += $answerWeighting[$i];
// adds the word in green at the end of the string
$answer .= $correctTags[$i];
$calculatedChoice = $correctTags[$i];
} elseif (!empty($userTags[$i])) {
// else if the word entered by the student IS NOT the same as
// the one defined by the professor
// adds the word in red at the end of the string, and strikes it
$answer .= '<font color="red"><s>'.$userTags[$i].'</s></font>';
$calculatedChoice = $userTags[$i];
} else {
// adds a tabulation if no word has been typed by the student
$answer .= ''; // remove that causes issue
}
// adds the correct word, followed by ] to close the blank
if (EXERCISE_FEEDBACK_TYPE_EXAM != $this->results_disabled) {
$answer .= ' / <font color="green"><b>'.$realCorrectTags[$i].'</b></font>';
$calculatedStatus = Display::label(get_lang('Correct'), 'success');
$expectedAnswer = $realCorrectTags[$i];
}
$answer .= ']';
if (isset($realText[$i + 1])) {
$answer .= $realText[$i + 1];
}
}
} else {
if ($from_database) {
$sql = "SELECT *
FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id = $questionId ";
$result = Database::query($sql);
$resultData = Database::fetch_array($result, 'ASSOC');
$answer = $resultData['answer'];
$questionScore = $resultData['marks'];
}
}
break;
case UPLOAD_ANSWER:
case FREE_ANSWER:
case ANSWER_IN_OFFICE_DOC:
if ($from_database) {
$sql = "SELECT answer, marks FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id= ".$questionId;
$result = Database::query($sql);
$data = Database::fetch_array($result);
$choice = '';
$questionScore = 0;
if ($data) {
$choice = $data['answer'];
$questionScore = $data['marks'];
}
$choice = str_replace('\r\n', '', $choice);
$choice = stripslashes($choice);
if (-1 == $questionScore) {
$totalScore += 0;
} else {
$totalScore += $questionScore;
}
if ('' == $questionScore) {
$questionScore = 0;
}
$arrques = $questionName;
$arrans = $choice;
} else {
$studentChoice = $choice;
if ($studentChoice) {
//Fixing negative puntation see #2193
$questionScore = 0;
$totalScore += 0;
}
}
break;
case ORAL_EXPRESSION:
if ($from_database) {
$query = "SELECT answer, marks
FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id = $questionId
";
$resq = Database::query($query);
$row = Database::fetch_assoc($resq);
$choice = [
'answer' => '',
'marks' => 0,
];
$questionScore = 0;
if (is_array($row)) {
$choice = $row['answer'];
$choice = str_replace('\r\n', '', $choice);
$choice = stripslashes($choice);
$questionScore = $row['marks'];
}
if ($questionScore == -1) {
$totalScore += 0;
} else {
$totalScore += $questionScore;
}
$arrques = $questionName;
$arrans = $choice;
} else {
$studentChoice = $choice;
if ($studentChoice) {
//Fixing negative puntation see #2193
$questionScore = 0;
$totalScore += 0;
}
}
break;
case DRAGGABLE:
case MATCHING_DRAGGABLE:
case MATCHING_DRAGGABLE_COMBINATION:
case MATCHING_COMBINATION:
case MATCHING:
if ($from_database) {
$sql = "SELECT iid, answer, id_auto
FROM $table_ans
WHERE
question_id = $questionId AND
correct = 0
";
$result = Database::query($sql);
// Getting the real answer
$real_list = [];
while ($realAnswer = Database::fetch_array($result)) {
$real_list[$realAnswer['iid']] = $realAnswer['answer'];
}
$orderBy = ' ORDER BY iid ';
if (DRAGGABLE == $answerType) {
$orderBy = ' ORDER BY correct ';
}
$sql = "SELECT iid, answer, correct, id_auto, ponderation
FROM $table_ans
WHERE
question_id = $questionId AND
correct <> 0
$orderBy";
$result = Database::query($sql);
$options = [];
$correctAnswers = [];
while ($row = Database::fetch_array($result, 'ASSOC')) {
$options[] = $row;
$correctAnswers[$row['correct']] = $row['answer'];
}
$questionScore = 0;
$counterAnswer = 1;
foreach ($options as $a_answers) {
$i_answer_id = $a_answers['iid']; //3
$s_answer_label = $a_answers['answer']; // your daddy - your mother
$i_answer_correct_answer = $a_answers['correct']; //1 - 2
$sql = "SELECT answer FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = '$exeId' AND
question_id = '$questionId' AND
position = '$i_answer_id'";
$result = Database::query($sql);
$s_user_answer = 0;
if (Database::num_rows($result) > 0) {
// rich - good looking
$s_user_answer = Database::result($result, 0, 0);
}
$i_answerWeighting = $a_answers['ponderation'];
$user_answer = '';
$status = Display::label(get_lang('Incorrect'), 'danger');
if (!empty($s_user_answer)) {
if (DRAGGABLE == $answerType) {
$sql = "SELECT answer FROM $table_ans WHERE iid = $s_user_answer";
$rsDragAnswer = Database::query($sql);
$dragAns = Database::result($rsDragAnswer, 0, 0);
if ($s_user_answer == $i_answer_correct_answer) {
$questionScore += $i_answerWeighting;
$totalScore += $i_answerWeighting;
$user_answer = Display::label(get_lang('Correct'), 'success');
if ($this->showExpectedChoice() && !empty($i_answer_id)) {
$user_answer = $answerMatching[$i_answer_id];
} else {
$user_answer = $dragAns;
}
$status = Display::label(get_lang('Correct'), 'success');
} else {
$user_answer = Display::label(get_lang('Incorrect'), 'danger');
if ($this->showExpectedChoice() && !empty($s_user_answer)) {
/*$data = $options[$real_list[$s_user_answer] - 1];
$user_answer = $data['answer'];*/
$user_answer = $correctAnswers[$s_user_answer] ?? '';
} else {
$user_answer = $dragAns;
}
}
} else {
if ($s_user_answer == $i_answer_correct_answer) {
$questionScore += $i_answerWeighting;
$totalScore += $i_answerWeighting;
$status = Display::label(get_lang('Correct'), 'success');
// Try with id
if (isset($real_list[$i_answer_id])) {
$user_answer = Display::span(
$real_list[$i_answer_id],
['style' => 'color: #008000; font-weight: bold;']
);
}
// Try with $i_answer_id_auto
if (empty($user_answer)) {
if (isset($real_list[$i_answer_id])) {
$user_answer = Display::span(
$real_list[$i_answer_id],
['style' => 'color: #008000; font-weight: bold;']
);
}
}
if (isset($real_list[$i_answer_correct_answer])) {
$matchingCorrectAnswers[$questionId]['from_database']['correct'][$i_answer_correct_answer] = $real_list[$i_answer_correct_answer];
$user_answer = Display::span(
$real_list[$i_answer_correct_answer],
['style' => 'color: #008000; font-weight: bold;']
);
}
} else {
$user_answer = Display::span(
$real_list[$s_user_answer],
['style' => 'color: #FF0000; text-decoration: line-through;']
);
if ($this->showExpectedChoice()) {
if (isset($real_list[$s_user_answer])) {
$user_answer = Display::span($real_list[$s_user_answer]);
}
}
}
}
} elseif (DRAGGABLE == $answerType) {
$user_answer = Display::label(get_lang('Incorrect'), 'danger');
if ($this->showExpectedChoice()) {
$user_answer = '';
}
} else {
$user_answer = Display::span(
get_lang('Incorrect').' ',
['style' => 'color: #FF0000; text-decoration: line-through;']
);
if ($this->showExpectedChoice()) {
$user_answer = '';
}
}
if ($show_result) {
if (false === $this->showExpectedChoice() &&
false === $showTotalScoreAndUserChoicesInLastAttempt
) {
$user_answer = '';
}
switch ($answerType) {
case MATCHING:
case MATCHING_COMBINATION:
case MATCHING_DRAGGABLE_COMBINATION:
case MATCHING_DRAGGABLE:
if (RESULT_DISABLE_SHOW_SCORE_ATTEMPT_SHOW_ANSWERS_LAST_ATTEMPT_NO_FEEDBACK == $this->results_disabled) {
if (false === $showTotalScoreAndUserChoicesInLastAttempt && empty($s_user_answer)) {
break;
}
}
echo '<tr>';
if (!in_array(
$this->results_disabled,
[
RESULT_DISABLE_SHOW_ONLY_IN_CORRECT_ANSWER,
]
)
) {
echo '<td>'.$s_answer_label.'</td>';
echo '<td>'.$user_answer.'</td>';
} else {
echo '<td>'.$s_answer_label.'</td>';
$status = Display::label(get_lang('Correct'), 'success');
}
if ($this->showExpectedChoice()) {
if ($this->showExpectedChoiceColumn()) {
echo '<td>';
if (in_array($answerType, [MATCHING, MATCHING_COMBINATION, MATCHING_DRAGGABLE, MATCHING_DRAGGABLE_COMBINATION])) {
if (isset($real_list[$i_answer_correct_answer]) &&
$showTotalScoreAndUserChoicesInLastAttempt == true
) {
echo Display::span(
$real_list[$i_answer_correct_answer]
);
}
}
echo '</td>';
}
echo '<td>'.$status.'</td>';
} else {
if (in_array($answerType, [MATCHING, MATCHING_COMBINATION, MATCHING_DRAGGABLE, MATCHING_DRAGGABLE_COMBINATION])) {
if (isset($real_list[$i_answer_correct_answer]) &&
$showTotalScoreAndUserChoicesInLastAttempt === true
) {
if ($this->showExpectedChoiceColumn()) {
echo '<td>';
echo Display::span(
$real_list[$i_answer_correct_answer],
['style' => 'color: #008000; font-weight: bold;']
);
echo '</td>';
}
}
}
}
echo '</tr>';
break;
case DRAGGABLE:
if (false == $showTotalScoreAndUserChoicesInLastAttempt) {
$s_answer_label = '';
}
if (RESULT_DISABLE_SHOW_SCORE_ATTEMPT_SHOW_ANSWERS_LAST_ATTEMPT_NO_FEEDBACK == $this->results_disabled) {
if (false === $showTotalScoreAndUserChoicesInLastAttempt && empty($s_user_answer)) {
break;
}
}
echo '<tr>';
if ($this->showExpectedChoice()) {
if (!in_array($this->results_disabled, [
RESULT_DISABLE_SHOW_ONLY_IN_CORRECT_ANSWER,
//RESULT_DISABLE_SHOW_SCORE_AND_EXPECTED_ANSWERS_AND_RANKING,
])
) {
echo '<td>'.$user_answer.'</td>';
} else {
$status = Display::label(get_lang('Correct'), 'success');
}
echo '<td>'.$s_answer_label.'</td>';
echo '<td>'.$status.'</td>';
} else {
echo '<td>'.$s_answer_label.'</td>';
echo '<td>'.$user_answer.'</td>';
echo '<td>'.$counterAnswer.'</td>';
echo '<td>'.$status.'</td>';
echo '<td>';
if (in_array($answerType, [MATCHING, MATCHING_COMBINATION, MATCHING_DRAGGABLE, MATCHING_DRAGGABLE_COMBINATION])) {
if (isset($real_list[$i_answer_correct_answer]) &&
$showTotalScoreAndUserChoicesInLastAttempt === true
) {
echo Display::span(
$real_list[$i_answer_correct_answer],
['style' => 'color: #008000; font-weight: bold;']
);
}
}
echo '</td>';
}
echo '</tr>';
break;
}
}
$counterAnswer++;
}
$matchingCorrectAnswers[$questionId]['from_database']['count_options'] = count($options);
break 2; // break the switch and the "for" condition
} else {
if ($answerCorrect) {
if (isset($choice[$answerAutoId]) &&
$answerCorrect == $choice[$answerAutoId]
) {
$matchingCorrectAnswers[$questionId]['form_values']['correct'][$answerAutoId] = $choice[$answerAutoId];
$correctAnswerId[] = $answerAutoId;
$questionScore += $answerWeighting;
$totalScore += $answerWeighting;
$user_answer = Display::span($answerMatching[$choice[$answerAutoId]]);
} else {
if (isset($answerMatching[$choice[$answerAutoId]])) {
$user_answer = Display::span(
$answerMatching[$choice[$answerAutoId]],
['style' => 'color: #FF0000; text-decoration: line-through;']
);
}
}
$matching[$answerAutoId] = $choice[$answerAutoId];
}
$matchingCorrectAnswers[$questionId]['form_values']['count_options'] = count($choice);
}
break;
case HOT_SPOT:
case HOT_SPOT_COMBINATION:
if ($from_database) {
$TBL_TRACK_HOTSPOT = Database::get_main_table(TABLE_STATISTIC_TRACK_E_HOTSPOT);
// Check auto id
$foundAnswerId = $answerAutoId;
$sql = "SELECT hotspot_correct
FROM $TBL_TRACK_HOTSPOT
WHERE
hotspot_exe_id = $exeId AND
hotspot_question_id= $questionId AND
hotspot_answer_id = $answerAutoId
ORDER BY hotspot_id ASC";
$result = Database::query($sql);
if (Database::num_rows($result)) {
$studentChoice = Database::result(
$result,
0,
'hotspot_correct'
);
if ($studentChoice) {
$questionScore += $answerWeighting;
$totalScore += $answerWeighting;
}
} else {
// If answer.id is different:
$sql = "SELECT hotspot_correct
FROM $TBL_TRACK_HOTSPOT
WHERE
hotspot_exe_id = $exeId AND
hotspot_question_id= $questionId AND
hotspot_answer_id = ".intval($answerId)."
ORDER BY hotspot_id ASC";
$result = Database::query($sql);
$foundAnswerId = $answerId;
if (Database::num_rows($result)) {
$studentChoice = Database::result(
$result,
0,
'hotspot_correct'
);
if ($studentChoice) {
$questionScore += $answerWeighting;
$totalScore += $answerWeighting;
}
} else {
// check answer.iid
if (!empty($answerIid)) {
$sql = "SELECT hotspot_correct
FROM $TBL_TRACK_HOTSPOT
WHERE
hotspot_exe_id = $exeId AND
hotspot_question_id= $questionId AND
hotspot_answer_id = $answerIid
ORDER BY hotspot_id ASC";
$result = Database::query($sql);
$foundAnswerId = $answerIid;
$studentChoice = Database::result(
$result,
0,
'hotspot_correct'
);
if ($studentChoice) {
$questionScore += $answerWeighting;
$totalScore += $answerWeighting;
}
}
}
}
} else {
if (!isset($choice[$answerAutoId]) && !isset($choice[$answerIid])) {
$choice[$answerAutoId] = 0;
$choice[$answerIid] = 0;
} else {
$studentChoice = $choice[$answerAutoId];
if (empty($studentChoice)) {
$studentChoice = $choice[$answerIid];
}
$choiceIsValid = false;
if (!empty($studentChoice)) {
$hotspotType = $objAnswerTmp->selectHotspotType($answerId);
$hotspotCoordinates = $objAnswerTmp->selectHotspotCoordinates($answerId);
$choicePoint = Geometry::decodePoint($studentChoice);
switch ($hotspotType) {
case 'square':
$hotspotProperties = Geometry::decodeSquare($hotspotCoordinates);
$choiceIsValid = Geometry::pointIsInSquare($hotspotProperties, $choicePoint);
break;
case 'circle':
$hotspotProperties = Geometry::decodeEllipse($hotspotCoordinates);
$choiceIsValid = Geometry::pointIsInEllipse($hotspotProperties, $choicePoint);
break;
case 'poly':
$hotspotProperties = Geometry::decodePolygon($hotspotCoordinates);
$choiceIsValid = Geometry::pointIsInPolygon($hotspotProperties, $choicePoint);
break;
}
}
$choice[$answerAutoId] = 0;
if ($choiceIsValid) {
$questionScore += $answerWeighting;
$totalScore += $answerWeighting;
$choice[$answerAutoId] = 1;
$choice[$answerIid] = 1;
}
}
}
break;
case HOT_SPOT_ORDER:
// @todo never added to chamilo
// for hotspot with fixed order
$studentChoice = $choice['order'][$answerId];
if ($studentChoice == $answerId) {
$questionScore += $answerWeighting;
$totalScore += $answerWeighting;
$studentChoice = true;
} else {
$studentChoice = false;
}
break;
case HOT_SPOT_DELINEATION:
// for hotspot with delineation
if ($from_database) {
// getting the user answer
$TBL_TRACK_HOTSPOT = Database::get_main_table(TABLE_STATISTIC_TRACK_E_HOTSPOT);
$query = "SELECT hotspot_correct, hotspot_coordinate
FROM $TBL_TRACK_HOTSPOT
WHERE
hotspot_exe_id = $exeId AND
hotspot_question_id= $questionId AND
hotspot_answer_id = '1'";
// By default we take 1 because it's a delineation
$resq = Database::query($query);
$row = Database::fetch_array($resq, 'ASSOC');
$choice = $row['hotspot_correct'];
$user_answer = $row['hotspot_coordinate'];
// THIS is very important otherwise the poly_compile will throw an error!!
// round-up the coordinates
$coords = explode('/', $user_answer);
$coords = array_filter($coords);
$user_array = '';
foreach ($coords as $coord) {
[$x, $y] = explode(';', $coord);
$user_array .= round($x).';'.round($y).'/';
}
$user_array = substr($user_array, 0, -1) ?: '';
} else {
if (!empty($studentChoice)) {
$correctAnswerId[] = $answerAutoId;
$newquestionList[] = $questionId;
}
if (1 === $answerId) {
$studentChoice = $choice[$answerId];
$questionScore += $answerWeighting;
}
if (isset($_SESSION['exerciseResultCoordinates'][$questionId])) {
$user_array = $_SESSION['exerciseResultCoordinates'][$questionId];
}
}
$_SESSION['hotspot_coord'][$questionId][1] = $delineation_cord;
$_SESSION['hotspot_dest'][$questionId][1] = $answer_delineation_destination;
break;
case ANNOTATION:
if ($from_database) {
$sql = "SELECT answer, marks
FROM $TBL_TRACK_ATTEMPT
WHERE
exe_id = $exeId AND
question_id = $questionId ";
$resq = Database::query($sql);
$data = Database::fetch_array($resq);
$questionScore = empty($data['marks']) ? 0 : $data['marks'];
$arrques = $questionName;
break;
}
$studentChoice = $choice;
if ($studentChoice) {
$questionScore = 0;
}
break;
}
if ($show_result) {
if ('exercise_result' === $from) {
// Display answers (if not matching type, or if the answer is correct)
if (!in_array($answerType, [MATCHING, MATCHING_COMBINATION, DRAGGABLE, MATCHING_DRAGGABLE, MATCHING_DRAGGABLE_COMBINATION]) ||
$answerCorrect
) {
if (in_array(
$answerType,
[
UNIQUE_ANSWER,
UNIQUE_ANSWER_IMAGE,
UNIQUE_ANSWER_NO_OPTION,
MULTIPLE_ANSWER,
MULTIPLE_ANSWER_COMBINATION,
GLOBAL_MULTIPLE_ANSWER,
READING_COMPREHENSION,
]
)) {
ExerciseShowFunctions::display_unique_or_multiple_answer(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
0,
0,
0,
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt,
$this->export
);
} elseif ($answerType == MULTIPLE_ANSWER_TRUE_FALSE) {
ExerciseShowFunctions::display_multiple_answer_true_false(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
0,
$questionId,
0,
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt
);
} elseif ($answerType == MULTIPLE_ANSWER_TRUE_FALSE_DEGREE_CERTAINTY) {
ExerciseShowFunctions::displayMultipleAnswerTrueFalseDegreeCertainty(
$this,
$feedback_type,
$studentChoice,
$studentChoiceDegree,
$answer,
$answerComment,
$answerCorrect,
$questionId,
$results_disabled
);
} elseif ($answerType == MULTIPLE_ANSWER_COMBINATION_TRUE_FALSE) {
ExerciseShowFunctions::display_multiple_answer_combination_true_false(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
0,
0,
0,
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt
);
} elseif (in_array($answerType, [FILL_IN_BLANKS, FILL_IN_BLANKS_COMBINATION])) {
ExerciseShowFunctions::display_fill_in_blanks_answer(
$this,
$feedback_type,
$answer,
0,
0,
$results_disabled,
'',
$showTotalScoreAndUserChoicesInLastAttempt
);
} elseif ($answerType == CALCULATED_ANSWER) {
ExerciseShowFunctions::display_calculated_answer(
$this,
$feedback_type,
$answer,
0,
0,
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt,
$expectedAnswer,
$calculatedChoice,
$calculatedStatus
);
} elseif ($answerType == FREE_ANSWER) {
ExerciseShowFunctions::display_free_answer(
$feedback_type,
$choice,
$exeId,
$questionId,
$questionScore,
$results_disabled
);
} elseif ($answerType == UPLOAD_ANSWER) {
ExerciseShowFunctions::displayUploadAnswer(
$feedback_type,
$choice,
$exeId,
$questionId,
$questionScore,
$results_disabled
);
} elseif ($answerType == ANSWER_IN_OFFICE_DOC) {
$exe_info = Event::get_exercise_results_by_attempt($exeId);
$exe_info = $exe_info[$exeId] ?? null;
ExerciseShowFunctions::displayOnlyOfficeAnswer(
$feedback_type,
$exeId,
$exe_info['exe_user_id'] ?? api_get_user_id(),
$this->iid,
$questionId,
$questionScore,
true
);
} elseif ($answerType == ORAL_EXPRESSION) {
// to store the details of open questions in an array to be used in mail
/** @var OralExpression $objQuestionTmp */
ExerciseShowFunctions::display_oral_expression_answer(
$feedback_type,
$choice,
0,
0,
$objQuestionTmp->getFileUrl(true),
$results_disabled,
$questionScore
);
} elseif (in_array($answerType, [HOT_SPOT, HOT_SPOT_COMBINATION])) {
$correctAnswerId = 0;
/** @var TrackEHotspot $hotspot */
foreach ($orderedHotSpots as $correctAnswerId => $hotspot) {
if ($hotspot->getHotspotAnswerId() == $answerIid) {
break;
}
}
// force to show whether the choice is correct or not
$showTotalScoreAndUserChoicesInLastAttempt = true;
ExerciseShowFunctions::display_hotspot_answer(
$this,
$feedback_type,
$answerId,
$answer,
$studentChoice,
$answerComment,
$results_disabled,
$answerId,
$showTotalScoreAndUserChoicesInLastAttempt
);
} elseif ($answerType == HOT_SPOT_ORDER) {
ExerciseShowFunctions::display_hotspot_order_answer(
$feedback_type,
$answerId,
$answer,
$studentChoice,
$answerComment
);
} elseif ($answerType == HOT_SPOT_DELINEATION) {
$user_answer = $_SESSION['exerciseResultCoordinates'][$questionId];
// Round-up the coordinates
$coords = explode('/', $user_answer);
$coords = array_filter($coords);
$user_array = '';
foreach ($coords as $coord) {
if (!empty($coord)) {
$parts = explode(';', $coord);
if (!empty($parts)) {
$user_array .= round($parts[0]).';'.round($parts[1]).'/';
}
}
}
$user_array = substr($user_array, 0, -1) ?: '';
if ($next) {
$user_answer = $user_array;
// We compare only the delineation not the other points
$answer_question = $_SESSION['hotspot_coord'][$questionId][1];
$answerDestination = $_SESSION['hotspot_dest'][$questionId][1];
// Calculating the area
$poly_user = convert_coordinates($user_answer, '/');
$poly_answer = convert_coordinates($answer_question, '|');
$max_coord = poly_get_max($poly_user, $poly_answer);
$poly_user_compiled = poly_compile($poly_user, $max_coord);
$poly_answer_compiled = poly_compile($poly_answer, $max_coord);
$poly_results = poly_result($poly_answer_compiled, $poly_user_compiled, $max_coord);
$overlap = $poly_results['both'];
$poly_answer_area = $poly_results['s1'];
$poly_user_area = $poly_results['s2'];
$missing = $poly_results['s1Only'];
$excess = $poly_results['s2Only'];
// //this is an area in pixels
if ($debug > 0) {
error_log(__LINE__.' - Polygons results are '.print_r($poly_results, 1), 0);
}
if ($overlap < 1) {
// Shortcut to avoid complicated calculations
$final_overlap = 0;
$final_missing = 100;
$final_excess = 100;
} else {
// the final overlap is the percentage of the initial polygon
// that is overlapped by the user's polygon
$final_overlap = round(((float) $overlap / (float) $poly_answer_area) * 100);
if ($debug > 1) {
error_log(__LINE__.' - Final overlap is '.$final_overlap, 0);
}
// the final missing area is the percentage of the initial polygon
// that is not overlapped by the user's polygon
$final_missing = 100 - $final_overlap;
if ($debug > 1) {
error_log(__LINE__.' - Final missing is '.$final_missing, 0);
}
// the final excess area is the percentage of the initial polygon's size
// that is covered by the user's polygon outside of the initial polygon
$final_excess = round((((float) $poly_user_area - (float) $overlap) / (float) $poly_answer_area) * 100);
if ($debug > 1) {
error_log(__LINE__.' - Final excess is '.$final_excess, 0);
}
}
// Checking the destination parameters parsing the "@@"
$destination_items = explode('@@', $answerDestination);
$threadhold_total = $destination_items[0];
$threadhold_items = explode(';', $threadhold_total);
$threadhold1 = $threadhold_items[0]; // overlap
$threadhold2 = $threadhold_items[1]; // excess
$threadhold3 = $threadhold_items[2]; // missing
// if is delineation
if ($answerId === 1) {
//setting colors
if ($final_overlap >= $threadhold1) {
$overlap_color = true;
}
if ($final_excess <= $threadhold2) {
$excess_color = true;
}
if ($final_missing <= $threadhold3) {
$missing_color = true;
}
// if pass
if ($final_overlap >= $threadhold1 &&
$final_missing <= $threadhold3 &&
$final_excess <= $threadhold2
) {
$next = 1; //go to the oars
$result_comment = get_lang('Acceptable');
$final_answer = 1; // do not update with update_exercise_attempt
} else {
$next = 0;
$result_comment = get_lang('Unacceptable');
$comment = $answerDestination = $objAnswerTmp->selectComment(1);
$answerDestination = $objAnswerTmp->selectDestination(1);
// checking the destination parameters parsing the "@@"
$destination_items = explode('@@', $answerDestination);
}
} elseif ($answerId > 1) {
if ($objAnswerTmp->selectHotspotType($answerId) == 'noerror') {
if ($debug > 0) {
error_log(__LINE__.' - answerId is of type noerror', 0);
}
//type no error shouldn't be treated
$next = 1;
continue;
}
if ($debug > 0) {
error_log(__LINE__.' - answerId is >1 so we\'re probably in OAR', 0);
}
$delineation_cord = $objAnswerTmp->selectHotspotCoordinates($answerId);
$poly_answer = convert_coordinates($delineation_cord, '|');
$max_coord = poly_get_max($poly_user, $poly_answer);
$poly_answer_compiled = poly_compile($poly_answer, $max_coord);
$overlap = poly_touch($poly_user_compiled, $poly_answer_compiled, $max_coord);
if ($overlap == false) {
//all good, no overlap
$next = 1;
continue;
} else {
if ($debug > 0) {
error_log(__LINE__.' - Overlap is '.$overlap.': OAR hit', 0);
}
$organs_at_risk_hit++;
//show the feedback
$next = 0;
$comment = $answerDestination = $objAnswerTmp->selectComment($answerId);
$answerDestination = $objAnswerTmp->selectDestination($answerId);
$destination_items = explode('@@', $answerDestination);
$try_hotspot = $destination_items[1];
$lp_hotspot = $destination_items[2];
$select_question_hotspot = $destination_items[3];
$url_hotspot = $destination_items[4];
}
}
} else {
// the first delineation feedback
if ($debug > 0) {
error_log(__LINE__.' first', 0);
}
}
} elseif (in_array($answerType, [MATCHING, MATCHING_COMBINATION, MATCHING_DRAGGABLE, MATCHING_DRAGGABLE_COMBINATION])) {
echo '<tr>';
echo Display::tag('td', $answerMatching[$answerId]);
echo Display::tag(
'td',
"$user_answer / ".Display::tag(
'strong',
$answerMatching[$answerCorrect],
['style' => 'color: #008000; font-weight: bold;']
)
);
echo '</tr>';
} elseif ($answerType == ANNOTATION) {
ExerciseShowFunctions::displayAnnotationAnswer(
$feedback_type,
$exeId,
$questionId,
$questionScore,
$results_disabled
);
}
}
} else {
if ($debug) {
error_log('Showing questions $from '.$from);
}
switch ($answerType) {
case UNIQUE_ANSWER:
case UNIQUE_ANSWER_IMAGE:
case UNIQUE_ANSWER_NO_OPTION:
case MULTIPLE_ANSWER:
case GLOBAL_MULTIPLE_ANSWER:
case MULTIPLE_ANSWER_COMBINATION:
case READING_COMPREHENSION:
if ($answerId == 1) {
ExerciseShowFunctions::display_unique_or_multiple_answer(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
$exeId,
$questionId,
$answerId,
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt,
$this->export
);
} else {
ExerciseShowFunctions::display_unique_or_multiple_answer(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
$exeId,
$questionId,
'',
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt,
$this->export
);
}
break;
case MULTIPLE_ANSWER_COMBINATION_TRUE_FALSE:
if ($answerId == 1) {
ExerciseShowFunctions::display_multiple_answer_combination_true_false(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
$exeId,
$questionId,
$answerId,
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt
);
} else {
ExerciseShowFunctions::display_multiple_answer_combination_true_false(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
$exeId,
$questionId,
'',
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt
);
}
break;
case MULTIPLE_ANSWER_TRUE_FALSE:
if ($answerId == 1) {
ExerciseShowFunctions::display_multiple_answer_true_false(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
$exeId,
$questionId,
$answerId,
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt
);
} else {
ExerciseShowFunctions::display_multiple_answer_true_false(
$this,
$feedback_type,
$answerType,
$studentChoice,
$answer,
$answerComment,
$answerCorrect,
$exeId,
$questionId,
'',
$results_disabled,
$showTotalScoreAndUserChoicesInLastAttempt
);
}
break;
case MULTIPLE_ANSWER_TRUE_FALSE_DEGREE_CERTAINTY:
if ($answerId == 1) {
ExerciseShowFunctions::displayMultipleAnswerTrueFalseDegreeCertainty(
$this,
$feedback_type,
$studentChoice,
$studentChoiceDegree,
$answer,
$answerComment,
$answerCorrect,
$questionId,
$results_disabled
);
} else {
ExerciseShowFunctions::displayMultipleAnswerTrueFalseDegreeCertainty(
$this,
$feedback_type,
$studentChoice,
$studentChoiceDegree,
$answer,
$answerComment,
$answerCorrect,
$questionId,
$results_disabled
);
}
break;
case FILL_IN_BLANKS:
case FILL_IN_BLANKS_COMBINATION:
ExerciseShowFunctions::display_fill_in_blanks_answer(
$this,
$feedback_type,
$answer,
$exeId,
$questionId,
$results_disabled,
$str,
$showTotalScoreAndUserChoicesInLastAttempt
);
break;
case CALCULATED_ANSWER:
ExerciseShowFunctions::display_calculated_answer(
$this,
$feedback_type,
$answer,
$exeId,
$questionId,
$results_disabled,
'',
$showTotalScoreAndUserChoicesInLastAttempt
);
break;
case FREE_ANSWER:
echo ExerciseShowFunctions::display_free_answer(
$feedback_type,
$choice,
$exeId,
$questionId,
$questionScore,
$results_disabled
);
break;
case UPLOAD_ANSWER:
echo ExerciseShowFunctions::displayUploadAnswer(
$feedback_type,
$choice,
$exeId,
$questionId,
$questionScore,
$results_disabled
);
break;
case ANSWER_IN_OFFICE_DOC:
$exe_info = Event::get_exercise_results_by_attempt($exeId);
$exe_info = $exe_info[$exeId] ?? null;
ExerciseShowFunctions::displayOnlyOfficeAnswer(
$feedback_type,
$exeId,
$exe_info['exe_user_id'] ?? api_get_user_id(),
$this->iid,
$questionId,
$questionScore
);
break;
case ORAL_EXPRESSION:
echo '<tr>
<td>'.
ExerciseShowFunctions::display_oral_expression_answer(
$feedback_type,
$choice,
$exeId,
$questionId,
$objQuestionTmp->getFileUrl(),
$results_disabled,
$questionScore
).'</td>
</tr>
</table>';
break;
case HOT_SPOT:
case HOT_SPOT_COMBINATION:
$correctAnswerId = 0;
/** @var TrackEHotspot $hotspot */
foreach ($orderedHotSpots as $correctAnswerId => $hotspot) {
if ($hotspot->getHotspotAnswerId() == $foundAnswerId) {
break;
}
}
ExerciseShowFunctions::display_hotspot_answer(
$this,
$feedback_type,
$answerId,
$answer,
$studentChoice,
$answerComment,
$results_disabled,
$answerId,
$showTotalScoreAndUserChoicesInLastAttempt
);
break;
case HOT_SPOT_DELINEATION:
$user_answer = $user_array;
if ($next) {
$user_answer = $user_array;
// we compare only the delineation not the other points
$answer_question = $_SESSION['hotspot_coord'][$questionId][1];
$answerDestination = $_SESSION['hotspot_dest'][$questionId][1];
// calculating the area
$poly_user = convert_coordinates($user_answer, '/');
$poly_answer = convert_coordinates($answer_question, '|');
$max_coord = poly_get_max($poly_user, $poly_answer);
$poly_user_compiled = poly_compile($poly_user, $max_coord);
$poly_answer_compiled = poly_compile($poly_answer, $max_coord);
$poly_results = poly_result($poly_answer_compiled, $poly_user_compiled, $max_coord);
$overlap = $poly_results['both'];
$poly_answer_area = $poly_results['s1'];
$poly_user_area = $poly_results['s2'];
$missing = $poly_results['s1Only'];
$excess = $poly_results['s2Only'];
if ($debug > 0) {
error_log(__LINE__.' - Polygons results are '.print_r($poly_results, 1), 0);
}
if ($overlap < 1) {
//shortcut to avoid complicated calculations
$final_overlap = 0;
$final_missing = 100;
$final_excess = 100;
} else {
// the final overlap is the percentage of the initial polygon
// that is overlapped by the user's polygon
$final_overlap = round(((float) $overlap / (float) $poly_answer_area) * 100);
// the final missing area is the percentage of the initial polygon that
// is not overlapped by the user's polygon
$final_missing = 100 - $final_overlap;
// the final excess area is the percentage of the initial polygon's size that is
// covered by the user's polygon outside of the initial polygon
$final_excess = round((((float) $poly_user_area - (float) $overlap) / (float) $poly_answer_area) * 100);
if ($debug > 1) {
error_log(__LINE__.' - Final overlap is '.$final_overlap);
error_log(__LINE__.' - Final excess is '.$final_excess);
error_log(__LINE__.' - Final missing is '.$final_missing);
}
}
// Checking the destination parameters parsing the "@@"
$destination_items = explode('@@', $answerDestination);
$threadhold_total = $destination_items[0];
$threadhold_items = explode(';', $threadhold_total);
$threadhold1 = $threadhold_items[0]; // overlap
$threadhold2 = $threadhold_items[1]; // excess
$threadhold3 = $threadhold_items[2]; //missing
// if is delineation
if ($answerId === 1) {
//setting colors
if ($final_overlap >= $threadhold1) {
$overlap_color = true;
}
if ($final_excess <= $threadhold2) {
$excess_color = true;
}
if ($final_missing <= $threadhold3) {
$missing_color = true;
}
// if pass
if ($final_overlap >= $threadhold1 &&
$final_missing <= $threadhold3 &&
$final_excess <= $threadhold2
) {
$next = 1; //go to the oars
$result_comment = get_lang('Acceptable');
$final_answer = 1; // do not update with update_exercise_attempt
} else {
$next = 0;
$result_comment = get_lang('Unacceptable');
$comment = $answerDestination = $objAnswerTmp->selectComment(1);
$answerDestination = $objAnswerTmp->selectDestination(1);
//checking the destination parameters parsing the "@@"
$destination_items = explode('@@', $answerDestination);
}
} elseif ($answerId > 1) {
if ($objAnswerTmp->selectHotspotType($answerId) === 'noerror') {
if ($debug > 0) {
error_log(__LINE__.' - answerId is of type noerror', 0);
}
//type no error shouldn't be treated
$next = 1;
break;
}
if ($debug > 0) {
error_log(__LINE__.' - answerId is >1 so we\'re probably in OAR', 0);
}
$delineation_cord = $objAnswerTmp->selectHotspotCoordinates($answerId);
$poly_answer = convert_coordinates($delineation_cord, '|');
$max_coord = poly_get_max($poly_user, $poly_answer);
$poly_answer_compiled = poly_compile($poly_answer, $max_coord);
$overlap = poly_touch($poly_user_compiled, $poly_answer_compiled, $max_coord);
if ($overlap == false) {
//all good, no overlap
$next = 1;
break;
} else {
if ($debug > 0) {
error_log(__LINE__.' - Overlap is '.$overlap.': OAR hit', 0);
}
$organs_at_risk_hit++;
//show the feedback
$next = 0;
$comment = $answerDestination = $objAnswerTmp->selectComment($answerId);
$answerDestination = $objAnswerTmp->selectDestination($answerId);
$destination_items = explode('@@', $answerDestination);
$try_hotspot = $destination_items[1];
$lp_hotspot = $destination_items[2];
$select_question_hotspot = $destination_items[3];
$url_hotspot = $destination_items[4];
}
}
}
break;
case HOT_SPOT_ORDER:
ExerciseShowFunctions::display_hotspot_order_answer(
$feedback_type,
$answerId,
$answer,
$studentChoice,
$answerComment
);
break;
case DRAGGABLE:
case MATCHING_DRAGGABLE:
case MATCHING_DRAGGABLE_COMBINATION:
case MATCHING_COMBINATION:
case MATCHING:
echo '<tr>';
echo Display::tag('td', $answerMatching[$answerId]);
echo Display::tag(
'td',
"$user_answer / ".Display::tag(
'strong',
$answerMatching[$answerCorrect],
['style' => 'color: #008000; font-weight: bold;']
)
);
echo '</tr>';
break;
case ANNOTATION:
ExerciseShowFunctions::displayAnnotationAnswer(
$feedback_type,
$exeId,
$questionId,
$questionScore,
$results_disabled
);
break;
}
}
}
} // end for that loops over all answers of the current question
// It validates unique score when all answers are correct for global questions
if (FILL_IN_BLANKS_COMBINATION === $answerType) {
$questionScore = ExerciseLib::getUserQuestionScoreGlobal(
$answerType,
$listCorrectAnswers,
$exeId,
$questionId,
$questionWeighting
);
}
if (HOT_SPOT_COMBINATION === $answerType) {
$listCorrectAnswers = isset($exerciseResultCoordinates[$questionId]) ? $exerciseResultCoordinates[$questionId] : [];
$questionScore = ExerciseLib::getUserQuestionScoreGlobal(
$answerType,
$listCorrectAnswers,
$exeId,
$questionId,
$questionWeighting,
$choice,
$nbrAnswers
);
}
if (in_array($answerType, [MATCHING_COMBINATION, MATCHING_DRAGGABLE_COMBINATION])) {
$questionScore = ExerciseLib::getUserQuestionScoreGlobal(
$answerType,
$matchingCorrectAnswers[$questionId],
$exeId,
$questionId,
$questionWeighting
);
}
if ($debug) {
error_log('-- End answer loop --');
}
$final_answer = true;
foreach ($real_answers as $my_answer) {
if (!$my_answer) {
$final_answer = false;
}
}
// We add the total score after dealing with the answers.
if ($answerType == MULTIPLE_ANSWER_COMBINATION ||
$answerType == MULTIPLE_ANSWER_COMBINATION_TRUE_FALSE
) {
if ($final_answer) {
//getting only the first score where we save the weight of all the question
$answerWeighting = $objAnswerTmp->selectWeighting(1);
if (empty($answerWeighting) && !empty($firstAnswer) && isset($firstAnswer['ponderation'])) {
$answerWeighting = $firstAnswer['ponderation'];
}
$questionScore += $answerWeighting;
}
}
$extra_data = [
'final_overlap' => $final_overlap,
'final_missing' => $final_missing,
'final_excess' => $final_excess,
'overlap_color' => $overlap_color,
'missing_color' => $missing_color,
'excess_color' => $excess_color,
'threadhold1' => $threadhold1,
'threadhold2' => $threadhold2,
'threadhold3' => $threadhold3,
];
if ($from === 'exercise_result') {
// if answer is hotspot. To the difference of exercise_show.php,
// we use the results from the session (from_db=0)
// TODO Change this, because it is wrong to show the user
// some results that haven't been stored in the database yet
if (in_array($answerType, [HOT_SPOT, HOT_SPOT_ORDER, HOT_SPOT_DELINEATION, HOT_SPOT_COMBINATION])) {
if ($debug) {
error_log('$from AND this is a hotspot kind of question ');
}
if ($answerType === HOT_SPOT_DELINEATION) {
if ($showHotSpotDelineationTable) {
if (!is_numeric($final_overlap)) {
$final_overlap = 0;
}
if (!is_numeric($final_missing)) {
$final_missing = 0;
}
if (!is_numeric($final_excess)) {
$final_excess = 0;
}
if ($final_overlap > 100) {
$final_overlap = 100;
}
$table_resume = '<table class="table table-hover table-striped data_table">
<tr class="row_odd" >
<td></td>
<td ><b>'.get_lang('Requirements').'</b></td>
<td><b>'.get_lang('YourAnswer').'</b></td>
</tr>
<tr class="row_even">
<td><b>'.get_lang('Overlap').'</b></td>
<td>'.get_lang('Min').' '.$threadhold1.'</td>
<td class="text-right '.($overlap_color ? 'text-success' : 'text-danger').'">'
.(($final_overlap < 0) ? 0 : intval($final_overlap)).'</td>
</tr>
<tr>
<td><b>'.get_lang('Excess').'</b></td>
<td>'.get_lang('Max').' '.$threadhold2.'</td>
<td class="text-right '.($excess_color ? 'text-success' : 'text-danger').'">'
.(($final_excess < 0) ? 0 : intval($final_excess)).'</td>
</tr>
<tr class="row_even">
<td><b>'.get_lang('Missing').'</b></td>
<td>'.get_lang('Max').' '.$threadhold3.'</td>
<td class="text-right '.($missing_color ? 'text-success' : 'text-danger').'">'
.(($final_missing < 0) ? 0 : intval($final_missing)).'</td>
</tr>
</table>';
if ($next == 0) {
} else {
$comment = $answerComment = $objAnswerTmp->selectComment($nbrAnswers);
$answerDestination = $objAnswerTmp->selectDestination($nbrAnswers);
}
$message = '<h1><div style="color:#333;">'.get_lang('Feedback').'</div></h1>
<p style="text-align:center">';
$message .= '<p>'.get_lang('YourDelineation').'</p>';
$message .= $table_resume;
$message .= '<br />'.get_lang('ResultIs').' '.$result_comment.'<br />';
if ($organs_at_risk_hit > 0) {
$message .= '<p><b>'.get_lang('OARHit').'</b></p>';
}
$message .= '<p>'.$comment.'</p>';
echo $message;
$_SESSION['hotspot_delineation_result'][$this->selectId()][$questionId][0] = $message;
$_SESSION['hotspot_delineation_result'][$this->selectId()][$questionId][1] = $_SESSION['exerciseResultCoordinates'][$questionId];
} else {
echo $hotspot_delineation_result[0];
}
// Save the score attempts
if (1) {
//getting the answer 1 or 0 comes from exercise_submit_modal.php
$final_answer = isset($hotspot_delineation_result[1]) ? $hotspot_delineation_result[1] : '';
if ($final_answer == 0) {
$questionScore = 0;
}
// we always insert the answer_id 1 = delineation
Event::saveQuestionAttempt($questionScore, 1, $quesId, $exeId, 0);
//in delineation mode, get the answer from $hotspot_delineation_result[1]
$hotspotValue = isset($hotspot_delineation_result[1]) ? (int) $hotspot_delineation_result[1] === 1 ? 1 : 0 : 0;
Event::saveExerciseAttemptHotspot(
$exeId,
$quesId,
1,
$hotspotValue,
$exerciseResultCoordinates[$quesId],
false,
0,
$learnpath_id,
$learnpath_item_id
);
} else {
if ($final_answer == 0) {
$questionScore = 0;
$answer = 0;
Event::saveQuestionAttempt($questionScore, $answer, $quesId, $exeId, 0);
if (is_array($exerciseResultCoordinates[$quesId])) {
foreach ($exerciseResultCoordinates[$quesId] as $idx => $val) {
Event::saveExerciseAttemptHotspot(
$exeId,
$quesId,
$idx,
0,
$val,
false,
0,
$learnpath_id,
$learnpath_item_id
);
}
}
} else {
Event::saveQuestionAttempt($questionScore, $answer, $quesId, $exeId, 0);
if (is_array($exerciseResultCoordinates[$quesId])) {
foreach ($exerciseResultCoordinates[$quesId] as $idx => $val) {
$hotspotValue = (int) $choice[$idx] === 1 ? 1 : 0;
Event::saveExerciseAttemptHotspot(
$exeId,
$quesId,
$idx,
$hotspotValue,
$val,
false,
0,
$learnpath_id,
$learnpath_item_id
);
}
}
}
}
}
}
$relPath = api_get_path(WEB_CODE_PATH);
if (in_array($answerType, [HOT_SPOT, HOT_SPOT_COMBINATION, HOT_SPOT_ORDER])) {
// We made an extra table for the answers
if ($show_result) {
echo '</table></td></tr>';
echo "
<tr>
<td>
<p><em>".get_lang('HotSpot')."</em></p>
<div id=\"hotspot-solution-$questionId\"></div>
<script>
$(function() {
new HotspotQuestion({
questionId: $questionId,
exerciseId: {$this->iid},
exeId: $exeId,
selector: '#hotspot-solution-$questionId',
for: 'solution',
relPath: '$relPath'
});
});
</script>
</td>
</tr>
";
}
} elseif ($answerType == ANNOTATION) {
if ($show_result) {
echo '
<p><em>'.get_lang('Annotation').'</em></p>
<div id="annotation-canvas-'.$questionId.'"></div>
<script>
AnnotationQuestion({
questionId: parseInt('.$questionId.'),
exerciseId: parseInt('.$exeId.'),
relPath: \''.$relPath.'\',
courseId: parseInt('.$course_id.')
});
</script>
';
}
}
if ($show_result && $answerType != ANNOTATION) {
echo '</table>';
}
}
unset($objAnswerTmp);
$totalWeighting += $questionWeighting;
// Store results directly in the database
// For all in one page exercises, the results will be
// stored by exercise_results.php (using the session)
if ($save_results) {
if ($debug) {
error_log("Save question results $save_results");
error_log("Question score: $questionScore");
error_log('choice: ');
error_log(print_r($choice, 1));
}
if (empty($choice)) {
$choice = 0;
}
// with certainty degree
if (empty($choiceDegreeCertainty)) {
$choiceDegreeCertainty = 0;
}
if ($answerType == MULTIPLE_ANSWER_TRUE_FALSE ||
$answerType == MULTIPLE_ANSWER_COMBINATION_TRUE_FALSE ||
$answerType == MULTIPLE_ANSWER_TRUE_FALSE_DEGREE_CERTAINTY
) {
if ($choice != 0) {
$reply = array_keys($choice);
$countReply = count($reply);
for ($i = 0; $i < $countReply; $i++) {
$chosenAnswer = $reply[$i];
if ($answerType == MULTIPLE_ANSWER_TRUE_FALSE_DEGREE_CERTAINTY) {
if ($choiceDegreeCertainty != 0) {
$replyDegreeCertainty = array_keys($choiceDegreeCertainty);
$answerDegreeCertainty = isset($replyDegreeCertainty[$i]) ? $replyDegreeCertainty[$i] : '';
$answerValue = isset($choiceDegreeCertainty[$answerDegreeCertainty]) ? $choiceDegreeCertainty[$answerDegreeCertainty] : '';
Event::saveQuestionAttempt(
$questionScore,
$chosenAnswer.':'.$choice[$chosenAnswer].':'.$answerValue,
$quesId,
$exeId,
$i,
$this->iid,
$updateResults,
$questionDuration
);
}
} else {
Event::saveQuestionAttempt(
$questionScore,
$chosenAnswer.':'.$choice[$chosenAnswer],
$quesId,
$exeId,
$i,
$this->iid,
$updateResults,
$questionDuration
);
}
if ($debug) {
error_log('result =>'.$questionScore.' '.$chosenAnswer.':'.$choice[$chosenAnswer]);
}
}
} else {
Event::saveQuestionAttempt(
$questionScore,
0,
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration
);
}
} elseif (
in_array(
$answerType,
[
MULTIPLE_ANSWER,
GLOBAL_MULTIPLE_ANSWER,
MULTIPLE_ANSWER_DROPDOWN,
MULTIPLE_ANSWER_DROPDOWN_COMBINATION,
]
)
) {
if ($choice != 0) {
if (in_array($answerType, [MULTIPLE_ANSWER_DROPDOWN, MULTIPLE_ANSWER_DROPDOWN_COMBINATION])) {
$reply = array_values($choice);
} else {
$reply = array_keys($choice);
}
for ($i = 0; $i < count($reply); $i++) {
$ans = $reply[$i];
Event::saveQuestionAttempt(
$questionScore,
$ans,
$quesId,
$exeId,
$i,
$this->iid,
false,
$questionDuration
);
}
} else {
Event::saveQuestionAttempt(
$questionScore,
0,
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration
);
}
} elseif ($answerType == MULTIPLE_ANSWER_COMBINATION) {
if ($choice != 0) {
$reply = array_keys($choice);
for ($i = 0; $i < count($reply); $i++) {
$ans = $reply[$i];
Event::saveQuestionAttempt(
$questionScore,
$ans,
$quesId,
$exeId,
$i,
$this->iid,
false,
$questionDuration
);
}
} else {
Event::saveQuestionAttempt(
$questionScore,
0,
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration
);
}
} elseif (in_array($answerType, [MATCHING, MATCHING_COMBINATION, DRAGGABLE, MATCHING_DRAGGABLE, MATCHING_DRAGGABLE_COMBINATION])) {
if (isset($matching)) {
foreach ($matching as $j => $val) {
Event::saveQuestionAttempt(
$questionScore,
$val,
$quesId,
$exeId,
$j,
$this->iid,
false,
$questionDuration
);
}
}
} elseif ($answerType == FREE_ANSWER) {
$answer = $choice;
Event::saveQuestionAttempt(
$questionScore,
$answer,
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration
);
} elseif ($answerType == UPLOAD_ANSWER) {
$answer = $choice;
Event::saveQuestionAttempt(
$questionScore,
$answer,
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration
);
} elseif ($answerType == ANSWER_IN_OFFICE_DOC) {
$answer = $choice;
$exerciseId = $this->iid;
$questionId = $quesId;
$originalFilePath = $objQuestionTmp->getFileUrl();
$originalExtension = !empty($originalFilePath) ? pathinfo($originalFilePath, PATHINFO_EXTENSION) : 'docx';
$fileName = "response_{$exeId}.{$originalExtension}";
Event::saveQuestionAttempt(
$questionScore,
$answer,
$questionId,
$exeId,
0,
$exerciseId,
false,
$questionDuration,
$fileName
);
} elseif ($answerType == ORAL_EXPRESSION) {
$answer = $choice;
$absFilePath = $objQuestionTmp->getAbsoluteFilePath();
if (empty($answer) && !empty($absFilePath)) {
// it takes the filename as answer to recognise has been saved
$answer = basename($absFilePath);
}
Event::saveQuestionAttempt(
$questionScore,
$answer,
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration,
$absFilePath
);
} elseif (
in_array(
$answerType,
[UNIQUE_ANSWER, UNIQUE_ANSWER_IMAGE, UNIQUE_ANSWER_NO_OPTION, READING_COMPREHENSION]
)
) {
$answer = $choice;
Event::saveQuestionAttempt($questionScore, $answer, $quesId, $exeId, 0, $this->iid, false, $questionDuration);
} elseif (in_array($answerType, [HOT_SPOT, HOT_SPOT_COMBINATION, ANNOTATION])) {
$answer = [];
if (isset($exerciseResultCoordinates[$questionId]) && !empty($exerciseResultCoordinates[$questionId])) {
if ($debug) {
error_log('Checking result coordinates');
}
Database::delete(
Database::get_main_table(TABLE_STATISTIC_TRACK_E_HOTSPOT),
[
'hotspot_exe_id = ? AND hotspot_question_id = ? AND c_id = ?' => [
$exeId,
$questionId,
api_get_course_int_id(),
],
]
);
foreach ($exerciseResultCoordinates[$questionId] as $idx => $val) {
$answer[] = $val;
$hotspotValue = (int) $choice[$idx] === 1 ? 1 : 0;
if ($debug) {
error_log('Hotspot value: '.$hotspotValue);
}
Event::saveExerciseAttemptHotspot(
$exeId,
$quesId,
$idx,
$hotspotValue,
$val,
false,
$this->iid,
$learnpath_id,
$learnpath_item_id
);
}
} else {
if ($debug) {
error_log('Empty: exerciseResultCoordinates');
}
}
Event::saveQuestionAttempt(
$questionScore,
implode('|', $answer),
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration
);
} else {
if ($answerType === CALCULATED_ANSWER && !empty($calculatedAnswerId)) {
$answer .= ':::'.$calculatedAnswerId;
}
Event::saveQuestionAttempt(
$questionScore,
$answer,
$quesId,
$exeId,
0,
$this->iid,
false,
$questionDuration
);
}
}
if ($propagate_neg == 0 && $questionScore < 0) {
$questionScore = 0;
}
if ($save_results) {
$statsTable = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$sql = "UPDATE $statsTable SET
exe_result = exe_result + ".floatval($questionScore)."
WHERE exe_id = $exeId";
Database::query($sql);
}
return [
'score' => $questionScore,
'weight' => $questionWeighting,
'extra' => $extra_data,
'open_question' => $arrques,
'open_answer' => $arrans,
'answer_type' => $answerType,
'generated_oral_file' => $generatedFile,
'user_answered' => $userAnsweredQuestion,
'correct_answer_id' => $correctAnswerId,
'answer_destination' => $answerDestination,
];
}
/**
* Sends a notification when a user ends an examn.
*
* @param string $type 'start' or 'end' of an exercise
* @param array $question_list_answers
* @param string $origin
* @param int $exe_id
* @param float $score
* @param float $weight
*
* @return bool
*/
public function send_mail_notification_for_exam(
$type,
$question_list_answers,
$origin,
$exe_id,
$score = null,
$weight = null
) {
$setting = api_get_course_setting('email_alert_manager_on_new_quiz');
if (empty($setting) && empty($this->getNotifications())) {
return false;
}
$settingFromExercise = $this->getNotifications();
if (!empty($settingFromExercise)) {
$setting = $settingFromExercise;
}
// Email configuration settings
$courseCode = api_get_course_id();
$courseInfo = api_get_course_info($courseCode);
if (empty($courseInfo)) {
return false;
}
$sessionId = api_get_session_id();
$sessionData = '';
if (!empty($sessionId)) {
$sessionInfo = api_get_session_info($sessionId);
if (!empty($sessionInfo)) {
$sessionData = '<tr>'
.'<td>'.get_lang('SessionName').'</td>'
.'<td>'.$sessionInfo['name'].'</td>'
.'</tr>';
}
}
$sendStart = false;
$sendEnd = false;
$sendEndOpenQuestion = false;
$sendEndOralQuestion = false;
foreach ($setting as $option) {
switch ($option) {
case 0:
return false;
break;
case 1: // End
if ($type === 'end') {
$sendEnd = true;
}
break;
case 2: // start
if ($type === 'start') {
$sendStart = true;
}
break;
case 3: // end + open
if ($type === 'end') {
$sendEndOpenQuestion = true;
}
break;
case 4: // end + oral
if ($type === 'end') {
$sendEndOralQuestion = true;
}
break;
}
}
$user_info = api_get_user_info(api_get_user_id());
$url = api_get_path(WEB_CODE_PATH).'exercise/exercise_show.php?'.
api_get_cidreq(true, true, 'qualify').'&id='.$exe_id.'&action=qualify';
if (!empty($sessionId)) {
$addGeneralCoach = true;
$setting = api_get_configuration_value('block_quiz_mail_notification_general_coach');
if ($setting === true) {
$addGeneralCoach = false;
}
$teachers = CourseManager::get_coach_list_from_course_code(
$courseCode,
$sessionId,
$addGeneralCoach
);
} else {
$teachers = CourseManager::get_teacher_list_from_course_code($courseCode);
}
if ($sendEndOpenQuestion) {
$this->sendNotificationForOpenQuestions(
$question_list_answers,
$origin,
$user_info,
$url,
$teachers
);
}
if ($sendEndOralQuestion) {
$this->sendNotificationForOralQuestions(
$question_list_answers,
$origin,
$exe_id,
$user_info,
$url,
$teachers
);
}
if (!$sendEnd && !$sendStart) {
return false;
}
$scoreLabel = '';
if ($sendEnd &&
api_get_configuration_value('send_score_in_exam_notification_mail_to_manager') == true
) {
$notificationPercentage = api_get_configuration_value('send_notification_score_in_percentage');
$scoreLabel = ExerciseLib::show_score($score, $weight, $notificationPercentage, true);
$scoreLabel = "<tr>
<td>".get_lang('Score')."</td>
<td> $scoreLabel</td>
</tr>";
}
if ($sendEnd) {
$msg = get_lang('ExerciseAttempted').'<br /><br />';
} else {
$msg = get_lang('StudentStartExercise').'<br /><br />';
}
$msg .= get_lang('AttemptDetails').' : <br /><br />
<table>
<tr>
<td>'.get_lang('CourseName').'</td>
<td>#course#</td>
</tr>
'.$sessionData.'
<tr>
<td>'.get_lang('Exercise').'</td>
<td> #exercise#</td>
</tr>
<tr>
<td>'.get_lang('StudentName').'</td>
<td> #student_complete_name#</td>
</tr>
<tr>
<td>'.get_lang('StudentEmail').'</td>
<td> #email#</td>
</tr>
'.$scoreLabel.'
</table>';
$variables = [
'#email#' => $user_info['email'],
'#exercise#' => $this->exercise,
'#student_complete_name#' => $user_info['complete_name'],
'#course#' => Display::url(
$courseInfo['title'],
$courseInfo['course_public_url'].'?id_session='.$sessionId
),
];
if ($sendEnd) {
$msg .= '<br /><a href="#url#">'.get_lang('ClickToCommentAndGiveFeedback').'</a>';
$variables['#url#'] = $url;
}
$content = str_replace(array_keys($variables), array_values($variables), $msg);
if ($sendEnd) {
$subject = get_lang('ExerciseAttempted');
} else {
$subject = get_lang('StudentStartExercise');
}
if (!empty($teachers)) {
foreach ($teachers as $user_id => $teacher_data) {
MessageManager::send_message_simple(
$user_id,
$subject,
$content
);
}
}
}
/**
* @param array $user_data result of api_get_user_info()
* @param array $trackExerciseInfo result of get_stat_track_exercise_info
* @param bool $saveUserResult
* @param bool $allowSignature
* @param bool $allowExportPdf
*
* @return string
*/
public function showExerciseResultHeader(
$user_data,
$trackExerciseInfo,
$saveUserResult,
$allowSignature = false,
$allowExportPdf = false
) {
if (api_get_configuration_value('hide_user_info_in_quiz_result')) {
return '';
}
$start_date = null;
if (isset($trackExerciseInfo['start_date'])) {
$start_date = api_convert_and_format_date($trackExerciseInfo['start_date']);
}
$duration = isset($trackExerciseInfo['duration_formatted']) ? $trackExerciseInfo['duration_formatted'] : null;
$ip = isset($trackExerciseInfo['user_ip']) ? $trackExerciseInfo['user_ip'] : null;
if (!empty($user_data)) {
$userFullName = $user_data['complete_name'];
if (api_is_teacher() || api_is_platform_admin(true, true)) {
$userFullName = '<a href="'.$user_data['profile_url'].'" title="'.get_lang('GoToStudentDetails').'">'.
$user_data['complete_name'].'</a>';
}
$data = [
'name_url' => $userFullName,
'complete_name' => $user_data['complete_name'],
'username' => $user_data['username'],
'avatar' => $user_data['avatar_medium'],
'url' => $user_data['profile_url'],
];
if (!empty($user_data['official_code'])) {
$data['code'] = $user_data['official_code'];
}
}
// Description can be very long and is generally meant to explain
// rules *before* the exam. Leaving here to make display easier if
// necessary
/*
if (!empty($this->description)) {
$array[] = array('title' => get_lang("Description"), 'content' => $this->description);
}
*/
if (!empty($start_date)) {
$data['start_date'] = $start_date;
}
if (!empty($duration)) {
$data['duration'] = $duration;
}
if (!empty($ip)) {
$data['ip'] = $ip;
}
if (true === api_get_configuration_value('exercise_hide_ip')) {
unset($data['ip']);
}
if (api_get_configuration_value('save_titles_as_html')) {
$data['title'] = Security::remove_XSS($this->get_formated_title()).get_lang('Result');
} else {
$data['title'] = PHP_EOL.Security::remove_XSS($this->exercise).' : '.get_lang('Result');
}
$questionsCount = count(explode(',', $trackExerciseInfo['data_tracking']));
$savedAnswersCount = $this->countUserAnswersSavedInExercise($trackExerciseInfo['exe_id']);
$data['number_of_answers'] = $questionsCount;
$data['number_of_answers_saved'] = $savedAnswersCount;
$exeId = $trackExerciseInfo['exe_id'];
if (false !== api_get_configuration_value('quiz_confirm_saved_answers')) {
$em = Database::getManager();
if ($saveUserResult) {
$trackConfirmation = new TrackEExerciseConfirmation();
$trackConfirmation
->setUserId($trackExerciseInfo['exe_user_id'])
->setQuizId($trackExerciseInfo['exe_exo_id'])
->setAttemptId($trackExerciseInfo['exe_id'])
->setQuestionsCount($questionsCount)
->setSavedAnswersCount($savedAnswersCount)
->setCourseId($trackExerciseInfo['c_id'])
->setSessionId($trackExerciseInfo['session_id'])
->setCreatedAt(api_get_utc_datetime(null, false, true));
$em->persist($trackConfirmation);
$em->flush();
} else {
$trackConfirmation = $em
->getRepository('ChamiloCoreBundle:TrackEExerciseConfirmation')
->findOneBy(
[
'attemptId' => $trackExerciseInfo['exe_id'],
'quizId' => $trackExerciseInfo['exe_exo_id'],
'courseId' => $trackExerciseInfo['c_id'],
'sessionId' => $trackExerciseInfo['session_id'],
]
);
}
$data['track_confirmation'] = $trackConfirmation;
}
$signature = '';
if (ExerciseSignaturePlugin::exerciseHasSignatureActivated($this)) {
$signature = ExerciseSignaturePlugin::getSignature($trackExerciseInfo['exe_user_id'], $trackExerciseInfo);
}
$tpl = new Template(null, false, false, false, false, false, false);
$tpl->assign('data', $data);
$tpl->assign('allow_signature', $allowSignature);
$tpl->assign('signature', $signature);
$tpl->assign('allow_export_pdf', $allowExportPdf);
$tpl->assign('export_url', api_get_path(WEB_CODE_PATH).'exercise/result.php?action=export&id='.$exeId.'&'.api_get_cidreq());
$layoutTemplate = $tpl->get_template('exercise/partials/result_exercise.tpl');
return $tpl->fetch($layoutTemplate);
}
/**
* Returns the exercise result.
*
* @param int attempt id
*
* @return array
*/
public function get_exercise_result($exe_id)
{
$result = [];
$track_exercise_info = ExerciseLib::get_exercise_track_exercise_info($exe_id);
if (!empty($track_exercise_info)) {
$totalScore = 0;
$objExercise = new self();
$objExercise->read($track_exercise_info['exe_exo_id']);
if (!empty($track_exercise_info['data_tracking'])) {
$question_list = explode(',', $track_exercise_info['data_tracking']);
}
foreach ($question_list as $questionId) {
$question_result = $objExercise->manage_answer(
$exe_id,
$questionId,
'',
'exercise_show',
[],
false,
true,
false,
$objExercise->selectPropagateNeg()
);
$totalScore += $question_result['score'];
}
if ($objExercise->selectPropagateNeg() == 0 && $totalScore < 0) {
$totalScore = 0;
}
$result = [
'score' => $totalScore,
'weight' => $track_exercise_info['exe_weighting'],
];
}
return $result;
}
/**
* Checks if the exercise is visible due a lot of conditions
* visibility, time limits, student attempts
* Return associative array
* value : true if exercise visible
* message : HTML formatted message
* rawMessage : text message.
*
* @param int $lpId
* @param int $lpItemId
* @param int $lpItemViewId
* @param bool $filterByAdmin
*
* @return array
*/
public function is_visible(
$lpId = 0,
$lpItemId = 0,
$lpItemViewId = 0,
$filterByAdmin = true,
$sessionId = 0
) {
$sessionId = (int) $sessionId;
if ($sessionId == 0) {
$sessionId = $this->sessionId;
}
// 1. By default the exercise is visible
$isVisible = true;
$message = null;
// 1.1 Admins, teachers and tutors can access to the exercise
if ($filterByAdmin) {
if (api_is_platform_admin() || api_is_course_admin() || api_is_course_tutor() || api_is_session_general_coach()) {
return ['value' => true, 'message' => ''];
}
}
// Deleted exercise.
if ($this->active == -1) {
return [
'value' => false,
'message' => Display::return_message(
get_lang('ExerciseNotFound'),
'warning',
false
),
'rawMessage' => get_lang('ExerciseNotFound'),
];
}
// Checking visibility in the item_property table.
$visibility = api_get_item_visibility(
api_get_course_info(),
TOOL_QUIZ,
$this->iid,
api_get_session_id()
);
if ($visibility == 0 || $visibility == 2) {
$this->active = 0;
}
// 2. If the exercise is not active.
if (empty($lpId)) {
// 2.1 LP is OFF
if ($this->active == 0) {
return [
'value' => false,
'message' => Display::return_message(
get_lang('ExerciseNotFound'),
'warning',
false
),
'rawMessage' => get_lang('ExerciseNotFound'),
];
}
} else {
// 2.1 LP is loaded
if ($this->active == 0 &&
!learnpath::is_lp_visible_for_student($lpId, api_get_user_id())
) {
return [
'value' => false,
'message' => Display::return_message(
get_lang('ExerciseNotFound'),
'warning',
false
),
'rawMessage' => get_lang('ExerciseNotFound'),
];
}
}
// 3. We check if the time limits are on
$limitTimeExists = false;
if (!empty($this->start_time) || !empty($this->end_time)) {
$limitTimeExists = true;
}
if ($limitTimeExists) {
$timeNow = time();
$existsStartDate = false;
$nowIsAfterStartDate = true;
$existsEndDate = false;
$nowIsBeforeEndDate = true;
if (!empty($this->start_time)) {
$existsStartDate = true;
}
if (!empty($this->end_time)) {
$existsEndDate = true;
}
// check if we are before-or-after end-or-start date
if ($existsStartDate && $timeNow < api_strtotime($this->start_time, 'UTC')) {
$nowIsAfterStartDate = false;
}
if ($existsEndDate & $timeNow >= api_strtotime($this->end_time, 'UTC')) {
$nowIsBeforeEndDate = false;
}
// lets check all cases
if ($existsStartDate && !$existsEndDate) {
// exists start date and dont exists end date
if ($nowIsAfterStartDate) {
// after start date, no end date
$isVisible = true;
$message = sprintf(
get_lang('ExerciseAvailableSinceX'),
api_convert_and_format_date($this->start_time)
);
} else {
// before start date, no end date
$isVisible = false;
$message = sprintf(
get_lang('ExerciseAvailableFromX'),
api_convert_and_format_date($this->start_time)
);
}
} elseif (!$existsStartDate && $existsEndDate) {
// doesnt exist start date, exists end date
if ($nowIsBeforeEndDate) {
// before end date, no start date
$isVisible = true;
$message = sprintf(
get_lang('ExerciseAvailableUntilX'),
api_convert_and_format_date($this->end_time)
);
} else {
// after end date, no start date
$isVisible = false;
$message = sprintf(
get_lang('ExerciseAvailableUntilX'),
api_convert_and_format_date($this->end_time)
);
}
} elseif ($existsStartDate && $existsEndDate) {
// exists start date and end date
if ($nowIsAfterStartDate) {
if ($nowIsBeforeEndDate) {
// after start date and before end date
$isVisible = true;
$message = sprintf(
get_lang('ExerciseIsActivatedFromXToY'),
api_convert_and_format_date($this->start_time),
api_convert_and_format_date($this->end_time)
);
} else {
// after start date and after end date
$isVisible = false;
$message = sprintf(
get_lang('ExerciseWasActivatedFromXToY'),
api_convert_and_format_date($this->start_time),
api_convert_and_format_date($this->end_time)
);
}
} else {
if ($nowIsBeforeEndDate) {
// before start date and before end date
$isVisible = false;
$message = sprintf(
get_lang('ExerciseWillBeActivatedFromXToY'),
api_convert_and_format_date($this->start_time),
api_convert_and_format_date($this->end_time)
);
}
// case before start date and after end date is impossible
}
} elseif (!$existsStartDate && !$existsEndDate) {
// doesnt exist start date nor end date
$isVisible = true;
$message = '';
}
}
$remedialCoursePlugin = RemedialCoursePlugin::create();
// BT#18165
$exerciseAttempts = $this->selectAttempts();
if ($exerciseAttempts > 0) {
$userId = api_get_user_id();
$attemptCount = Event::get_attempt_count_not_finished(
$userId,
$this->iid,
$lpId,
$lpItemId,
$lpItemViewId
);
$message .= $remedialCoursePlugin->getAdvancedCourseList(
$this,
$userId,
api_get_session_id(),
$lpId ?: 0,
$lpItemId ?: 0
);
if ($attemptCount >= $exerciseAttempts) {
$message .= $remedialCoursePlugin->getRemedialCourseList(
$this,
$userId,
api_get_session_id(),
false,
$lpId ?: 0,
$lpItemId ?: 0
);
}
}
// 4. We check if the student have attempts
if ($isVisible) {
$exerciseAttempts = $this->selectAttempts();
if ($exerciseAttempts > 0) {
$attemptCount = Event::get_attempt_count_not_finished(
api_get_user_id(),
$this->iid,
$lpId,
$lpItemId,
$lpItemViewId
);
if ($attemptCount >= $exerciseAttempts) {
$message = sprintf(
get_lang('ReachedMaxAttempts'),
$this->name,
$exerciseAttempts
);
$isVisible = false;
} else {
// Check blocking exercise.
$extraFieldValue = new ExtraFieldValue('exercise');
$blockExercise = $extraFieldValue->get_values_by_handler_and_field_variable(
$this->iid,
'blocking_percentage'
);
if ($blockExercise && isset($blockExercise['value']) && !empty($blockExercise['value'])) {
$blockPercentage = (int) $blockExercise['value'];
$userAttempts = Event::getExerciseResultsByUser(
api_get_user_id(),
$this->iid,
$this->course_id,
$sessionId,
$lpId,
$lpItemId
);
if (!empty($userAttempts)) {
$currentAttempt = current($userAttempts);
if ($currentAttempt['total_percentage'] <= $blockPercentage) {
$message = sprintf(
get_lang('ExerciseBlockBecausePercentageX'),
$blockPercentage
);
$isVisible = false; // See BT#18165
$message .= $remedialCoursePlugin->getRemedialCourseList(
$this,
api_get_user_id(),
api_get_session_id(),
false,
$lpId,
$lpItemId
);
}
}
}
}
}
}
$rawMessage = '';
if (!empty($message)) {
$rawMessage = $message;
$message = Display::return_message($message, 'warning', false);
}
return [
'value' => $isVisible,
'message' => $message,
'rawMessage' => $rawMessage,
];
}
/**
* @return bool
*/
public function added_in_lp()
{
$TBL_LP_ITEM = Database::get_course_table(TABLE_LP_ITEM);
$sql = "SELECT max_score FROM $TBL_LP_ITEM
WHERE
c_id = {$this->course_id} AND
item_type = '".TOOL_QUIZ."' AND
path = '{$this->iid}'";
$result = Database::query($sql);
if (Database::num_rows($result) > 0) {
return true;
}
return false;
}
/**
* Returns an array with this form.
*
* @example
* <code>
* array (size=3)
* 999 =>
* array (size=3)
* 0 => int 3422
* 1 => int 3423
* 2 => int 3424
* 100 =>
* array (size=2)
* 0 => int 3469
* 1 => int 3470
* 101 =>
* array (size=1)
* 0 => int 3482
* </code>
* The array inside the key 999 means the question list that belongs to the media id = 999,
* this case is special because 999 means "no media".
*
* @return array
*/
public function getMediaList()
{
return $this->mediaList;
}
/**
* Is media question activated?
*
* @return bool
*/
public function mediaIsActivated()
{
$mediaQuestions = $this->getMediaList();
$active = false;
if (isset($mediaQuestions) && !empty($mediaQuestions)) {
$media_count = count($mediaQuestions);
if ($media_count > 1) {
return true;
} elseif ($media_count == 1) {
if (isset($mediaQuestions[999])) {
return false;
} else {
return true;
}
}
}
return $active;
}
/**
* Gets question list from the exercise.
*
* @return array
*/
public function getQuestionList()
{
return $this->questionList;
}
/**
* Question list with medias compressed like this.
*
* @example
* <code>
* array(
* question_id_1,
* question_id_2,
* media_id, <- this media id contains question ids
* question_id_3,
* )
* </code>
*
* @return array
*/
public function getQuestionListWithMediasCompressed()
{
return $this->questionList;
}
/**
* Question list with medias uncompressed like this.
*
* @example
* <code>
* array(
* question_id,
* question_id,
* question_id, <- belongs to a media id
* question_id, <- belongs to a media id
* question_id,
* )
* </code>
*
* @return array
*/
public function getQuestionListWithMediasUncompressed()
{
return $this->questionListUncompressed;
}
/**
* Sets the question list when the exercise->read() is executed.
*
* @param bool $adminView Whether to view the set the list of *all* questions or just the normal student view
*/
public function setQuestionList($adminView = false)
{
// Getting question list.
$questionList = $this->selectQuestionList(true, $adminView);
$this->setMediaList($questionList);
$this->questionList = $this->transformQuestionListWithMedias($questionList, false);
$this->questionListUncompressed = $this->transformQuestionListWithMedias(
$questionList,
true
);
}
/**
* @params array question list
* @params bool expand or not question list (true show all questions,
* false show media question id instead of the question ids)
*/
public function transformQuestionListWithMedias(
$question_list,
$expand_media_questions = false
) {
$new_question_list = [];
if (!empty($question_list)) {
$media_questions = $this->getMediaList();
$media_active = $this->mediaIsActivated($media_questions);
if ($media_active) {
$counter = 1;
foreach ($question_list as $question_id) {
$add_question = true;
foreach ($media_questions as $media_id => $question_list_in_media) {
if ($media_id != 999 && in_array($question_id, $question_list_in_media)) {
$add_question = false;
if (!in_array($media_id, $new_question_list)) {
$new_question_list[$counter] = $media_id;
$counter++;
}
break;
}
}
if ($add_question) {
$new_question_list[$counter] = $question_id;
$counter++;
}
}
if ($expand_media_questions) {
$media_key_list = array_keys($media_questions);
foreach ($new_question_list as &$question_id) {
if (in_array($question_id, $media_key_list)) {
$question_id = $media_questions[$question_id];
}
}
$new_question_list = array_flatten($new_question_list);
}
} else {
$new_question_list = $question_list;
}
}
return $new_question_list;
}
/**
* Get sorted question list based on the random order settings.
*
* @return array
*/
public function get_validated_question_list()
{
$isRandomByCategory = $this->isRandomByCat();
if ($isRandomByCategory == 0) {
if ($this->isRandom()) {
return $this->getRandomList();
}
return $this->selectQuestionList();
}
if ($this->isRandom()) {
// USE question categories
// get questions by category for this exercise
// we have to choice $objExercise->random question in each array values of $categoryQuestions
// key of $categoryQuestions are the categopy id (0 for not in a category)
// value is the array of question id of this category
$questionList = [];
$categoryQuestions = TestCategory::getQuestionsByCat($this->iid);
$isRandomByCategory = $this->getRandomByCategory();
// We sort categories based on the term between [] in the head
// of the category's description
/* examples of categories :
* [biologie] Maitriser les mecanismes de base de la genetique
* [biologie] Relier les moyens de depenses et les agents infectieux
* [biologie] Savoir ou est produite l'enrgie dans les cellules et sous quelle forme
* [chimie] Classer les molles suivant leur pouvoir oxydant ou reacteur
* [chimie] Connaître la denition de la theoie acide/base selon Brönsted
* [chimie] Connaître les charges des particules
* We want that in the order of the groups defined by the term
* between brackets at the beginning of the category title
*/
// If test option is Grouped By Categories
if ($isRandomByCategory == 2) {
$categoryQuestions = TestCategory::sortTabByBracketLabel($categoryQuestions);
}
foreach ($categoryQuestions as $question) {
$number_of_random_question = $this->random;
if ($this->random == -1) {
$number_of_random_question = count($this->questionList);
}
$questionList = array_merge(
$questionList,
TestCategory::getNElementsFromArray(
$question,
$number_of_random_question
)
);
}
// shuffle the question list if test is not grouped by categories
if ($isRandomByCategory == 1) {
shuffle($questionList); // or not
}
return $questionList;
}
// Problem, random by category has been selected and
// we have no $this->isRandom number of question selected
// Should not happened
return [];
}
public function get_question_list($expand_media_questions = false)
{
$question_list = $this->get_validated_question_list();
$question_list = $this->transform_question_list_with_medias($question_list, $expand_media_questions);
return $question_list;
}
public function transform_question_list_with_medias($question_list, $expand_media_questions = false)
{
$new_question_list = [];
if (!empty($question_list)) {
$media_questions = $this->getMediaList();
$media_active = $this->mediaIsActivated($media_questions);
if ($media_active) {
$counter = 1;
foreach ($question_list as $question_id) {
$add_question = true;
foreach ($media_questions as $media_id => $question_list_in_media) {
if ($media_id != 999 && in_array($question_id, $question_list_in_media)) {
$add_question = false;
if (!in_array($media_id, $new_question_list)) {
$new_question_list[$counter] = $media_id;
$counter++;
}
break;
}
}
if ($add_question) {
$new_question_list[$counter] = $question_id;
$counter++;
}
}
if ($expand_media_questions) {
$media_key_list = array_keys($media_questions);
foreach ($new_question_list as &$question_id) {
if (in_array($question_id, $media_key_list)) {
$question_id = $media_questions[$question_id];
}
}
$new_question_list = array_flatten($new_question_list);
}
} else {
$new_question_list = $question_list;
}
}
return $new_question_list;
}
/**
* @param int $exe_id
*
* @return array
*/
public function get_stat_track_exercise_info_by_exe_id($exe_id)
{
$table = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$exe_id = (int) $exe_id;
$sql_track = "SELECT * FROM $table WHERE exe_id = $exe_id ";
$result = Database::query($sql_track);
$new_array = [];
if (Database::num_rows($result) > 0) {
$new_array = Database::fetch_array($result, 'ASSOC');
$start_date = api_get_utc_datetime($new_array['start_date'], true);
$end_date = api_get_utc_datetime($new_array['exe_date'], true);
$new_array['duration_formatted'] = '';
if (!empty($new_array['exe_duration']) && !empty($start_date) && !empty($end_date)) {
$time = api_format_time($new_array['exe_duration'], 'js');
$new_array['duration_formatted'] = $time;
}
}
return $new_array;
}
/**
* @param int $exeId
*
* @return bool
*/
public function removeAllQuestionToRemind($exeId)
{
$table = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$exeId = (int) $exeId;
if (empty($exeId)) {
return false;
}
$sql = "UPDATE $table
SET questions_to_check = ''
WHERE exe_id = $exeId ";
Database::query($sql);
return true;
}
/**
* @param int $exeId
* @param array $questionList
*
* @return bool
*/
public function addAllQuestionToRemind($exeId, $questionList = [])
{
$exeId = (int) $exeId;
if (empty($questionList)) {
return false;
}
$questionListToString = implode(',', $questionList);
$questionListToString = Database::escape_string($questionListToString);
$table = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$sql = "UPDATE $table
SET questions_to_check = '$questionListToString'
WHERE exe_id = $exeId";
Database::query($sql);
return true;
}
/**
* @param int $exeId
* @param int $questionId
* @param string $action
*/
public function editQuestionToRemind($exeId, $questionId, $action = 'add')
{
$exercise_info = self::get_stat_track_exercise_info_by_exe_id($exeId);
$questionId = (int) $questionId;
$exeId = (int) $exeId;
if ($exercise_info) {
$track_exercises = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
if (empty($exercise_info['questions_to_check'])) {
if ($action === 'add') {
$sql = "UPDATE $track_exercises
SET questions_to_check = '$questionId'
WHERE exe_id = $exeId ";
Database::query($sql);
}
} else {
$remind_list = explode(',', $exercise_info['questions_to_check']);
$remind_list_string = '';
if ($action === 'add') {
if (!in_array($questionId, $remind_list)) {
$newRemindList = [];
$remind_list[] = $questionId;
$questionListInSession = Session::read('questionList');
if (!empty($questionListInSession)) {
foreach ($questionListInSession as $originalQuestionId) {
if (in_array($originalQuestionId, $remind_list)) {
$newRemindList[] = $originalQuestionId;
}
}
}
$remind_list_string = implode(',', $newRemindList);
}
} elseif ($action === 'delete') {
if (!empty($remind_list)) {
if (in_array($questionId, $remind_list)) {
$remind_list = array_flip($remind_list);
unset($remind_list[$questionId]);
$remind_list = array_flip($remind_list);
if (!empty($remind_list)) {
sort($remind_list);
array_filter($remind_list);
$remind_list_string = implode(',', $remind_list);
}
}
}
}
$value = Database::escape_string($remind_list_string);
$sql = "UPDATE $track_exercises
SET questions_to_check = '$value'
WHERE exe_id = $exeId ";
Database::query($sql);
}
}
}
/**
* @param string $answer
*
* @return mixed
*/
public function fill_in_blank_answer_to_array($answer)
{
$listStudentResults = FillBlanks::getAnswerInfo(
$answer,
true
);
$teacherAnswerList = $listStudentResults['student_answer'];
return $teacherAnswerList;
}
/**
* @param string $answer
*
* @return string
*/
public function fill_in_blank_answer_to_string($answer)
{
$teacher_answer_list = $this->fill_in_blank_answer_to_array($answer);
$result = '';
if (!empty($teacher_answer_list)) {
foreach ($teacher_answer_list as $teacher_item) {
// Cleaning student answer list
$value = strip_tags($teacher_item);
if (strlen($value) > 2 && false !== strpos($value, '/')) {
$value = api_substr($value, 1, api_strlen($value) - 2);
$value = explode('/', $value);
if (!empty($value[0])) {
$value = trim($value[0]);
$value = str_replace(' ', '', $value);
$result .= $value;
}
} else {
$result .= $value;
}
}
}
return $result;
}
/**
* @return string
*/
public function returnTimeLeftDiv()
{
$html = '<div id="clock_warning" style="display:none">';
$html .= Display::return_message(
get_lang('ReachedTimeLimit'),
'warning'
);
$html .= ' ';
$html .= sprintf(
get_lang('YouWillBeRedirectedInXSeconds'),
'<span id="counter_to_redirect" class="red_alert"></span>'
);
$html .= '</div>';
$icon = Display::returnFontAwesomeIcon('clock-o');
$html .= '<div class="count_down">
'.get_lang('RemainingTimeToFinishExercise').'
'.$icon.'<span id="exercise_clock_warning"></span>
</div>';
return $html;
}
/**
* Get categories added in the exercise--category matrix.
*
* @return array
*/
public function getCategoriesInExercise()
{
$table = Database::get_course_table(TABLE_QUIZ_REL_CATEGORY);
if (!empty($this->iid)) {
$sql = "SELECT * FROM $table
WHERE exercise_id = {$this->iid} AND c_id = {$this->course_id} ";
$result = Database::query($sql);
$list = [];
if (Database::num_rows($result)) {
while ($row = Database::fetch_array($result, 'ASSOC')) {
$list[$row['category_id']] = $row;
}
return $list;
}
}
return [];
}
/**
* Get total number of question that will be parsed when using the category/exercise.
*
* @return int
*/
public function getNumberQuestionExerciseCategory()
{
$table = Database::get_course_table(TABLE_QUIZ_REL_CATEGORY);
if (!empty($this->iid)) {
$sql = "SELECT SUM(count_questions) count_questions
FROM $table
WHERE exercise_id = {$this->iid} AND c_id = {$this->course_id}";
$result = Database::query($sql);
if (Database::num_rows($result)) {
$row = Database::fetch_array($result);
return (int) $row['count_questions'];
}
}
return 0;
}
/**
* Save categories in the TABLE_QUIZ_REL_CATEGORY table.
*
* @param array $categories
*/
public function save_categories_in_exercise($categories)
{
if (!empty($categories) && !empty($this->iid)) {
$table = Database::get_course_table(TABLE_QUIZ_REL_CATEGORY);
$sql = "DELETE FROM $table
WHERE exercise_id = {$this->iid} AND c_id = {$this->course_id}";
Database::query($sql);
if (!empty($categories)) {
foreach ($categories as $categoryId => $countQuestions) {
$params = [
'c_id' => $this->course_id,
'exercise_id' => $this->iid,
'category_id' => $categoryId,
'count_questions' => $countQuestions,
];
Database::insert($table, $params);
}
}
}
}
/**
* @param array $questionList
* @param int $currentQuestion
* @param array $conditions
* @param string $link
*
* @return string
*/
public function progressExercisePaginationBar(
$questionList,
$currentQuestion,
$conditions,
$link
) {
$mediaQuestions = $this->getMediaList();
$html = '<div class="exercise_pagination pagination pagination-mini"><ul>';
$counter = 0;
$nextValue = 0;
$wasMedia = false;
$before = 0;
$counterNoMedias = 0;
foreach ($questionList as $questionId) {
$isCurrent = $currentQuestion == ($counterNoMedias + 1) ? true : false;
if (!empty($nextValue)) {
if ($wasMedia) {
$nextValue = $nextValue - $before + 1;
}
}
if (isset($mediaQuestions) && isset($mediaQuestions[$questionId])) {
$fixedValue = $counterNoMedias;
$html .= Display::progressPaginationBar(
$nextValue,
$mediaQuestions[$questionId],
$currentQuestion,
$fixedValue,
$conditions,
$link,
true,
true
);
$counter += count($mediaQuestions[$questionId]) - 1;
$before = count($questionList);
$wasMedia = true;
$nextValue += count($questionList);
} else {
$html .= Display::parsePaginationItem(
$questionId,
$isCurrent,
$conditions,
$link,
$counter
);
$counter++;
$nextValue++;
$wasMedia = false;
}
$counterNoMedias++;
}
$html .= '</ul></div>';
return $html;
}
/**
* Shows a list of numbers that represents the question to answer in a exercise.
*
* @param array $categories
* @param int $current
* @param array $conditions
* @param string $link
*
* @return string
*/
public function progressExercisePaginationBarWithCategories(
$categories,
$current,
$conditions = [],
$link = null
) {
$html = null;
$counterNoMedias = 0;
$nextValue = 0;
$wasMedia = false;
$before = 0;
if (!empty($categories)) {
$selectionType = $this->getQuestionSelectionType();
$useRootAsCategoryTitle = false;
// Grouping questions per parent category see BT#6540
if (in_array(
$selectionType,
[
EX_Q_SELECTION_CATEGORIES_ORDERED_BY_PARENT_QUESTIONS_ORDERED,
EX_Q_SELECTION_CATEGORIES_ORDERED_BY_PARENT_QUESTIONS_RANDOM,
]
)) {
$useRootAsCategoryTitle = true;
}
// If the exercise is set to only show the titles of the categories
// at the root of the tree, then pre-order the categories tree by
// removing children and summing their questions into the parent
// categories
if ($useRootAsCategoryTitle) {
// The new categories list starts empty
$newCategoryList = [];
foreach ($categories as $category) {
$rootElement = $category['root'];
if (isset($category['parent_info'])) {
$rootElement = $category['parent_info']['iid'];
}
//$rootElement = $category['iid'];
// If the current category's ancestor was never seen
// before, then declare it and assign the current
// category to it.
if (!isset($newCategoryList[$rootElement])) {
$newCategoryList[$rootElement] = $category;
} else {
// If it was already seen, then merge the previous with
// the current category
$oldQuestionList = $newCategoryList[$rootElement]['question_list'];
$category['question_list'] = array_merge($oldQuestionList, $category['question_list']);
$newCategoryList[$rootElement] = $category;
}
}
// Now use the newly built categories list, with only parents
$categories = $newCategoryList;
}
foreach ($categories as $category) {
$questionList = $category['question_list'];
// Check if in this category there questions added in a media
$mediaQuestionId = $category['media_question'];
$isMedia = false;
$fixedValue = null;
// Media exists!
if ($mediaQuestionId != 999) {
$isMedia = true;
$fixedValue = $counterNoMedias;
}
//$categoryName = $category['path']; << show the path
$categoryName = $category['name'];
if ($useRootAsCategoryTitle) {
if (isset($category['parent_info'])) {
$categoryName = $category['parent_info']['title'];
}
}
$html .= '<div class="row">';
$html .= '<div class="span2">'.$categoryName.'</div>';
$html .= '<div class="span8">';
if (!empty($nextValue)) {
if ($wasMedia) {
$nextValue = $nextValue - $before + 1;
}
}
$html .= Display::progressPaginationBar(
$nextValue,
$questionList,
$current,
$fixedValue,
$conditions,
$link,
$isMedia,
true
);
$html .= '</div>';
$html .= '</div>';
if ($mediaQuestionId == 999) {
$counterNoMedias += count($questionList);
} else {
$counterNoMedias++;
}
$nextValue += count($questionList);
$before = count($questionList);
if ($mediaQuestionId != 999) {
$wasMedia = true;
} else {
$wasMedia = false;
}
}
}
return $html;
}
/**
* Renders a question list.
*
* @param array $questionList (with media questions compressed)
* @param int $currentQuestion
* @param array $exerciseResult
* @param array $attemptList
* @param array $remindList
*/
public function renderQuestionList(
$questionList,
$currentQuestion,
$exerciseResult,
$attemptList,
$remindList
) {
$mediaQuestions = $this->getMediaList();
$i = 0;
// Normal question list render (medias compressed)
foreach ($questionList as $questionId) {
$i++;
// For sequential exercises
if ($this->type == ONE_PER_PAGE) {
// If it is not the right question, goes to the next loop iteration
if ($currentQuestion != $i) {
continue;
} else {
if (!in_array(
$this->getFeedbackType(),
[EXERCISE_FEEDBACK_TYPE_DIRECT, EXERCISE_FEEDBACK_TYPE_POPUP]
)) {
// if the user has already answered this question
if (isset($exerciseResult[$questionId])) {
echo Display::return_message(
get_lang('AlreadyAnswered'),
'normal'
);
break;
}
}
}
}
// The $questionList contains the media id we check
// if this questionId is a media question type
if (isset($mediaQuestions[$questionId]) &&
$mediaQuestions[$questionId] != 999
) {
// The question belongs to a media
$mediaQuestionList = $mediaQuestions[$questionId];
$objQuestionTmp = Question::read($questionId);
$counter = 1;
if ($objQuestionTmp->type == MEDIA_QUESTION) {
echo $objQuestionTmp->show_media_content();
$countQuestionsInsideMedia = count($mediaQuestionList);
// Show questions that belongs to a media
if (!empty($mediaQuestionList)) {
// In order to parse media questions we use letters a, b, c, etc.
$letterCounter = 97;
foreach ($mediaQuestionList as $questionIdInsideMedia) {
$isLastQuestionInMedia = false;
if ($counter == $countQuestionsInsideMedia) {
$isLastQuestionInMedia = true;
}
$this->renderQuestion(
$questionIdInsideMedia,
$attemptList,
$remindList,
chr($letterCounter),
$currentQuestion,
$mediaQuestionList,
$isLastQuestionInMedia,
$questionList
);
$letterCounter++;
$counter++;
}
}
} else {
$this->renderQuestion(
$questionId,
$attemptList,
$remindList,
$i,
$currentQuestion,
null,
null,
$questionList
);
$i++;
}
} else {
// Normal question render.
$this->renderQuestion(
$questionId,
$attemptList,
$remindList,
$i,
$currentQuestion,
null,
null,
$questionList
);
}
// For sequential exercises.
if ($this->type == ONE_PER_PAGE) {
// quits the loop
break;
}
}
// end foreach()
if ($this->type == ALL_ON_ONE_PAGE) {
$exercise_actions = $this->show_button($questionId, $currentQuestion);
echo Display::div($exercise_actions, ['class' => 'exercise_actions']);
}
}
/**
* @param int $questionId
* @param array $attemptList
* @param array $remindList
* @param int $i
* @param int $current_question
* @param array $questions_in_media
* @param bool $last_question_in_media
* @param array $realQuestionList
* @param bool $generateJS
*/
public function renderQuestion(
$questionId,
$attemptList,
$remindList,
$i,
$current_question,
$questions_in_media = [],
$last_question_in_media = false,
$realQuestionList = [],
$generateJS = true
) {
// With this option on the question is loaded via AJAX
//$generateJS = true;
//$this->loadQuestionAJAX = true;
if ($generateJS && $this->loadQuestionAJAX) {
$url = api_get_path(WEB_AJAX_PATH).'exercise.ajax.php?a=get_question&id='.$questionId.'&'.api_get_cidreq();
$params = [
'questionId' => $questionId,
'attemptList' => $attemptList,
'remindList' => $remindList,
'i' => $i,
'current_question' => $current_question,
'questions_in_media' => $questions_in_media,
'last_question_in_media' => $last_question_in_media,
];
$params = json_encode($params);
$script = '<script>
$(function(){
var params = '.$params.';
$.ajax({
type: "GET",
data: params,
url: "'.$url.'",
success: function(return_value) {
$("#ajaxquestiondiv'.$questionId.'").html(return_value);
}
});
});
</script>
<div id="ajaxquestiondiv'.$questionId.'"></div>';
echo $script;
} else {
global $origin;
$question_obj = Question::read($questionId);
$user_choice = isset($attemptList[$questionId]) ? $attemptList[$questionId] : null;
$remind_highlight = null;
// Hides questions when reviewing a ALL_ON_ONE_PAGE exercise
// see #4542 no_remind_highlight class hide with jquery
if ($this->type == ALL_ON_ONE_PAGE && isset($_GET['reminder']) && $_GET['reminder'] == 2) {
$remind_highlight = 'no_remind_highlight';
if (in_array($question_obj->type, Question::question_type_no_review())) {
return null;
}
}
$attributes = ['id' => 'remind_list['.$questionId.']', 'data-question-id' => $questionId];
// Showing the question
$exercise_actions = null;
echo '<a id="questionanchor'.$questionId.'"></a><br />';
echo '<div id="question_div_'.$questionId.'" class="main_question '.$remind_highlight.'" >';
// Shows the question + possible answers
$showTitle = $this->getHideQuestionTitle() == 1 ? false : true;
echo ExerciseLib::showQuestion(
$this,
$question_obj,
false,
$origin,
$i,
$showTitle,
false,
$user_choice
);
// Button save and continue
switch ($this->type) {
case ONE_PER_PAGE:
$exercise_actions .= $this->show_button(
$questionId,
$current_question,
null,
$remindList
);
break;
case ALL_ON_ONE_PAGE:
if (api_is_allowed_to_session_edit()) {
$button = [
Display::button(
'save_now',
get_lang('SaveForNow'),
['type' => 'button', 'class' => 'btn btn-primary', 'data-question' => $questionId]
),
'<span id="save_for_now_'.$questionId.'" class="exercise_save_mini_message"></span>',
];
$exercise_actions .= Display::div(
implode(PHP_EOL, $button),
['class' => 'exercise_save_now_button']
);
}
break;
}
if (!empty($questions_in_media)) {
$count_of_questions_inside_media = count($questions_in_media);
if ($count_of_questions_inside_media > 1 && api_is_allowed_to_session_edit()) {
$button = [
Display::button(
'save_now',
get_lang('SaveForNow'),
['type' => 'button', 'class' => 'btn btn-primary', 'data-question' => $questionId]
),
'<span id="save_for_now_'.$questionId.'" class="exercise_save_mini_message"></span> ',
];
$exercise_actions = Display::div(
implode(PHP_EOL, $button),
['class' => 'exercise_save_now_button']
);
}
if ($last_question_in_media && $this->type == ONE_PER_PAGE) {
$exercise_actions = $this->show_button($questionId, $current_question, $questions_in_media);
}
}
// Checkbox review answers
if ($this->review_answers &&
!in_array($question_obj->type, Question::question_type_no_review())
) {
$remind_question_div = Display::tag(
'label',
Display::input(
'checkbox',
'remind_list['.$questionId.']',
'',
$attributes
).get_lang('ReviewQuestionLater'),
[
'class' => 'checkbox',
'for' => 'remind_list['.$questionId.']',
]
);
$exercise_actions .= Display::div(
$remind_question_div,
['class' => 'exercise_save_now_button']
);
}
echo Display::div(' ', ['class' => 'clear']);
$paginationCounter = null;
if ($this->type == ONE_PER_PAGE) {
if (empty($questions_in_media)) {
$paginationCounter = Display::paginationIndicator(
$current_question,
count($realQuestionList)
);
} else {
if ($last_question_in_media) {
$paginationCounter = Display::paginationIndicator(
$current_question,
count($realQuestionList)
);
}
}
}
echo '<div class="row"><div class="pull-right">'.$paginationCounter.'</div></div>';
echo Display::div($exercise_actions, ['class' => 'form-actions']);
echo '</div>';
}
}
/**
* Returns an array of categories details for the questions of the current
* exercise.
*
* @return array
*/
public function getQuestionWithCategories()
{
$categoryTable = Database::get_course_table(TABLE_QUIZ_QUESTION_CATEGORY);
$categoryRelTable = Database::get_course_table(TABLE_QUIZ_QUESTION_REL_CATEGORY);
$TBL_EXERCICE_QUESTION = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$TBL_QUESTIONS = Database::get_course_table(TABLE_QUIZ_QUESTION);
$sql = "SELECT DISTINCT cat.*
FROM $TBL_EXERCICE_QUESTION e
INNER JOIN $TBL_QUESTIONS q
ON e.question_id = q.iid
INNER JOIN $categoryRelTable catRel
ON (catRel.question_id = e.question_id AND catRel.c_id = e.c_id)
INNER JOIN $categoryTable cat
ON (cat.iid = catRel.category_id)
WHERE
e.c_id = {$this->course_id} AND
e.exercice_id = ".intval($this->iid);
$result = Database::query($sql);
$categoriesInExercise = [];
if (Database::num_rows($result)) {
$categoriesInExercise = Database::store_result($result, 'ASSOC');
}
return $categoriesInExercise;
}
/**
* Calculate the max_score of the quiz, depending of question inside, and quiz advanced option.
*/
public function get_max_score()
{
$outMaxScore = 0;
// list of question's id !!! the array key start at 1 !!!
$questionList = $this->selectQuestionList(true);
if ($this->random > 0 && $this->randomByCat > 0) {
// test is random by category
// get the $numberRandomQuestions best score question of each category
$numberRandomQuestions = $this->random;
$tab_categories_scores = [];
foreach ($questionList as $questionId) {
$question_category_id = TestCategory::getCategoryForQuestion($questionId);
if (!is_array($tab_categories_scores[$question_category_id])) {
$tab_categories_scores[$question_category_id] = [];
}
$tmpobj_question = Question::read($questionId);
if (is_object($tmpobj_question)) {
$tab_categories_scores[$question_category_id][] = $tmpobj_question->weighting;
}
}
// here we've got an array with first key, the category_id, second key, score of question for this cat
foreach ($tab_categories_scores as $tab_scores) {
rsort($tab_scores);
for ($i = 0; $i < min($numberRandomQuestions, count($tab_scores)); $i++) {
$outMaxScore += $tab_scores[$i];
}
}
} else {
// standard test, just add each question score
foreach ($questionList as $questionId) {
$question = Question::read($questionId, $this->course);
$outMaxScore += $question->weighting;
}
}
return $outMaxScore;
}
/**
* @return string
*/
public function get_formated_title()
{
if (api_get_configuration_value('save_titles_as_html')) {
}
return api_html_entity_decode($this->selectTitle());
}
/**
* @param string $title
*
* @return string
*/
public static function get_formated_title_variable($title)
{
return api_html_entity_decode($title);
}
/**
* @return string
*/
public function format_title()
{
return api_htmlentities($this->title);
}
/**
* @param string $title
*
* @return string
*/
public static function format_title_variable($title)
{
return api_htmlentities($title);
}
/**
* @param int $courseId
* @param int $sessionId
*
* @return array exercises
*/
public function getExercisesByCourseSession($courseId, $sessionId)
{
$courseId = (int) $courseId;
$sessionId = (int) $sessionId;
$tbl_quiz = Database::get_course_table(TABLE_QUIZ_TEST);
$sql = "SELECT * FROM $tbl_quiz cq
WHERE
cq.c_id = %s AND
(cq.session_id = %s OR cq.session_id = 0) AND
cq.active = 0
ORDER BY cq.iid";
$sql = sprintf($sql, $courseId, $sessionId);
$result = Database::query($sql);
$rows = [];
while ($row = Database::fetch_array($result, 'ASSOC')) {
$rows[] = $row;
}
return $rows;
}
/**
* Get array of exercise details and user results.
*
* @param int $courseId
* @param int $sessionId
* @param array $quizId
* @param bool $checkOnlyActiveUsers
* @param array $filterDates Limit the results exported to those within this range ('start_date' to 'end_date')
*
* @return array exercises
*/
public function getExerciseAndResult($courseId, $sessionId, $quizId = [], $checkOnlyActiveUsers = false, $filterDates = [])
{
if (empty($quizId)) {
return [];
}
$sessionId = (int) $sessionId;
$courseId = (int) $courseId;
$ids = is_array($quizId) ? $quizId : [$quizId];
$ids = array_map('intval', $ids);
$ids = implode(',', $ids);
$trackExcercises = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$tblQuiz = Database::get_course_table(TABLE_QUIZ_TEST);
$tblUser = Database::get_main_table(TABLE_MAIN_USER);
$condition = '';
$innerJoinUser = '';
if ($checkOnlyActiveUsers) {
$condition .= " AND te.status = '' ";
$innerJoinUser .= " INNER JOIN $tblUser u ON u.user_id = te. exe_user_id";
}
if (!empty($filterDates)) {
if (!empty($filterDates['start_date'])) {
$condition .= " AND te.exe_date >= '".Database::escape_string($filterDates['start_date'])."' ";
}
if (!empty($filterDates['end_date'])) {
$condition .= " AND te.exe_date <= '".Database::escape_string($filterDates['end_date'])."' ";
}
}
if (0 != $sessionId) {
$sql = "SELECT * FROM $trackExcercises te
INNER JOIN $tblQuiz cq ON cq.iid = te.exe_exo_id
$innerJoinUser
WHERE
te.c_id = %s AND
te.session_id = %s AND
cq.iid IN (%s)
$condition
ORDER BY cq.iid";
$sql = sprintf($sql, $courseId, $sessionId, $ids);
} else {
$sql = "SELECT * FROM $trackExcercises te
INNER JOIN $tblQuiz cq ON cq.iid = te.exe_exo_id
$innerJoinUser
WHERE
te.c_id = %s AND
cq.iid IN (%s)
$condition
ORDER BY cq.iid";
$sql = sprintf($sql, $courseId, $ids);
}
$result = Database::query($sql);
$rows = [];
while ($row = Database::fetch_array($result, 'ASSOC')) {
$rows[] = $row;
}
return $rows;
}
/**
* @param $exeId
* @param $exercise_stat_info
* @param $remindList
* @param $currentQuestion
*
* @return int|null
*/
public static function getNextQuestionId(
$exeId,
$exercise_stat_info,
$remindList,
$currentQuestion
) {
$result = Event::get_exercise_results_by_attempt($exeId, 'incomplete');
if (isset($result[$exeId])) {
$result = $result[$exeId];
} else {
return null;
}
$data_tracking = $exercise_stat_info['data_tracking'];
$data_tracking = explode(',', $data_tracking);
// if this is the final question do nothing.
if ($currentQuestion == count($data_tracking)) {
return null;
}
$currentQuestion--;
if (!empty($result['question_list'])) {
$answeredQuestions = [];
foreach ($result['question_list'] as $question) {
if (!empty($question['answer'])) {
$answeredQuestions[] = $question['question_id'];
}
}
// Checking answered questions
$counterAnsweredQuestions = 0;
foreach ($data_tracking as $questionId) {
if (!in_array($questionId, $answeredQuestions)) {
if ($currentQuestion != $counterAnsweredQuestions) {
break;
}
}
$counterAnsweredQuestions++;
}
$counterRemindListQuestions = 0;
// Checking questions saved in the reminder list
if (!empty($remindList)) {
foreach ($data_tracking as $questionId) {
if (in_array($questionId, $remindList)) {
// Skip the current question
if ($currentQuestion != $counterRemindListQuestions) {
break;
}
}
$counterRemindListQuestions++;
}
if ($counterRemindListQuestions < $currentQuestion) {
return null;
}
if (!empty($counterRemindListQuestions)) {
if ($counterRemindListQuestions > $counterAnsweredQuestions) {
return $counterAnsweredQuestions;
} else {
return $counterRemindListQuestions;
}
}
}
return $counterAnsweredQuestions;
}
}
/**
* Gets the position of a questionId in the question list.
*
* @param $questionId
*
* @return int
*/
public function getPositionInCompressedQuestionList($questionId)
{
$questionList = $this->getQuestionListWithMediasCompressed();
$mediaQuestions = $this->getMediaList();
$position = 1;
foreach ($questionList as $id) {
if (isset($mediaQuestions[$id]) && in_array($questionId, $mediaQuestions[$id])) {
$mediaQuestionList = $mediaQuestions[$id];
if (in_array($questionId, $mediaQuestionList)) {
return $position;
} else {
$position++;
}
} else {
if ($id == $questionId) {
return $position;
} else {
$position++;
}
}
}
return 1;
}
/**
* Get the correct answers in all attempts.
*
* @param int $learnPathId
* @param int $learnPathItemId
* @param bool $onlyCorrect
*
* @return array
*/
public function getAnswersInAllAttempts($learnPathId = 0, $learnPathItemId = 0, $onlyCorrect = true)
{
$attempts = Event::getExerciseResultsByUser(
api_get_user_id(),
$this->iid,
api_get_course_int_id(),
api_get_session_id(),
$learnPathId,
$learnPathItemId,
'DESC'
);
$list = [];
foreach ($attempts as $attempt) {
foreach ($attempt['question_list'] as $answers) {
foreach ($answers as $answer) {
$objAnswer = new Answer($answer['question_id']);
if ($onlyCorrect) {
switch ($objAnswer->getQuestionType()) {
case FILL_IN_BLANKS:
case FILL_IN_BLANKS_COMBINATION:
$isCorrect = FillBlanks::isCorrect($answer['answer']);
break;
case MATCHING:
case MATCHING_COMBINATION:
case DRAGGABLE:
case MATCHING_DRAGGABLE_COMBINATION:
case MATCHING_DRAGGABLE:
$isCorrect = Matching::isCorrect(
$answer['position'],
$answer['answer'],
$answer['question_id']
);
break;
case ORAL_EXPRESSION:
$isCorrect = false;
break;
default:
$isCorrect = $objAnswer->isCorrectByAutoId($answer['answer']);
}
if ($isCorrect) {
$list[$answer['question_id']][] = $answer;
}
} else {
$list[$answer['question_id']][] = $answer;
}
}
}
if (false === $onlyCorrect) {
// Only take latest attempt
break;
}
}
return $list;
}
/**
* Get the correct answers in all attempts.
*
* @param int $learnPathId
* @param int $learnPathItemId
*
* @return array
*/
public function getCorrectAnswersInAllAttempts($learnPathId = 0, $learnPathItemId = 0)
{
return $this->getAnswersInAllAttempts($learnPathId, $learnPathItemId);
}
/**
* @return bool
*/
public function showPreviousButton()
{
$allow = api_get_configuration_value('allow_quiz_show_previous_button_setting');
if (false === $allow) {
return true;
}
return $this->showPreviousButton;
}
public function getPreventBackwards()
{
$allow = api_get_configuration_value('quiz_prevent_backwards_move');
if (false === $allow) {
return 0;
}
return (int) $this->preventBackwards;
}
/**
* @return int
*/
public function getExerciseCategoryId()
{
if (empty($this->exerciseCategoryId)) {
return null;
}
return (int) $this->exerciseCategoryId;
}
/**
* @param int $value
*/
public function setExerciseCategoryId($value)
{
if (!empty($value)) {
$this->exerciseCategoryId = (int) $value;
}
}
/**
* Set the value to 1 to hide the question number.
*
* @param int $value
*/
public function setHideQuestionNumber($value = 0)
{
$showHideConfiguration = api_get_configuration_value('quiz_hide_question_number');
if ($showHideConfiguration) {
$this->hideQuestionNumber = (int) $value;
}
}
/**
* Gets the value to hide or show the question number. If it does not exist, it is set to 0.
*
* @return int 1 if the question number must be hidden
*/
public function getHideQuestionNumber()
{
$showHideConfiguration = api_get_configuration_value('quiz_hide_question_number');
if ($showHideConfiguration) {
return (int) $this->hideQuestionNumber;
}
return 0;
}
/**
* Set the value to 1 to hide the attempts table on start page.
*
* @param int $value
*/
public function setHideAttemptsTableOnStartPage($value = 0)
{
$showHideAttemptsTableOnStartPage = api_get_configuration_value('quiz_hide_attempts_table_on_start_page');
if ($showHideAttemptsTableOnStartPage) {
$this->hideAttemptsTableOnStartPage = (int) $value;
}
}
/**
* Gets the value to hide or show the attempts table on start page. If it does not exist, it is set to 0.
*
* @return int 1 if the attempts table must be hidden
*/
public function getHideAttemptsTableOnStartPage()
{
$showHideAttemptsTableOnStartPage = api_get_configuration_value('quiz_hide_attempts_table_on_start_page');
if ($showHideAttemptsTableOnStartPage) {
return (int) $this->hideAttemptsTableOnStartPage;
}
return 0;
}
/**
* @param array $values
*/
public function setPageResultConfiguration($values)
{
$pageConfig = api_get_configuration_value('allow_quiz_results_page_config');
if ($pageConfig) {
$params = [
'hide_expected_answer' => $values['hide_expected_answer'] ?? '',
'hide_question_score' => $values['hide_question_score'] ?? '',
'hide_total_score' => $values['hide_total_score'] ?? '',
'hide_category_table' => $values['hide_category_table'] ?? '',
'hide_correct_answered_questions' => $values['hide_correct_answered_questions'] ?? '',
'hide_comment' => $values['hide_comment'] ?? '',
];
$type = Type::getType('array');
$platform = Database::getManager()->getConnection()->getDatabasePlatform();
$this->pageResultConfiguration = $type->convertToDatabaseValue($params, $platform);
}
}
/**
* @param array $defaults
*/
public function setPageResultConfigurationDefaults(&$defaults)
{
$configuration = $this->getPageResultConfiguration();
if (!empty($configuration) && !empty($defaults)) {
$defaults = array_merge($defaults, $configuration);
}
}
/**
* Sets the value to show or hide the question number in the default settings of the forms.
*
* @param array $defaults
*/
public function setHideQuestionNumberDefaults(&$defaults)
{
$configuration = $this->getHideQuestionNumberConfiguration();
if (!empty($configuration) && !empty($defaults)) {
$defaults = array_merge($defaults, $configuration);
}
}
/**
* Sets the value to show or hide the attempts table on start page in the default settings of the forms.
*
* @param array $defaults
*/
public function setHideAttemptsTableOnStartPageDefaults(&$defaults)
{
$configuration = $this->getHideAttemptsTableOnStartPageConfiguration();
if (!empty($configuration) && !empty($defaults)) {
$defaults = array_merge($defaults, $configuration);
}
}
/**
* @return array
*/
public function getPageResultConfiguration()
{
$pageConfig = api_get_configuration_value('allow_quiz_results_page_config');
if ($pageConfig) {
$type = Type::getType('array');
$platform = Database::getManager()->getConnection()->getDatabasePlatform();
return $type->convertToPHPValue($this->pageResultConfiguration, $platform);
}
return [];
}
/**
* Get the value to show or hide the question number in the default settings of the forms.
*
* @return array
*/
public function getHideQuestionNumberConfiguration()
{
$pageConfig = api_get_configuration_value('quiz_hide_question_number');
if ($pageConfig) {
return ['hide_question_number' => $this->hideQuestionNumber];
}
return [];
}
/**
* Get the value to show or hide the attempts table on start page in the default settings of the forms.
*
* @return array
*/
public function getHideAttemptsTableOnStartPageConfiguration()
{
$pageConfig = api_get_configuration_value('quiz_hide_attempts_table_on_start_page');
if ($pageConfig) {
return ['hide_attempts_table' => $this->hideAttemptsTableOnStartPage];
}
return [];
}
/**
* @param string $attribute
*
* @return mixed|null
*/
public function getPageConfigurationAttribute($attribute)
{
$result = $this->getPageResultConfiguration();
if (!empty($result)) {
return isset($result[$attribute]) ? $result[$attribute] : null;
}
return null;
}
/**
* @param bool $showPreviousButton
*
* @return Exercise
*/
public function setShowPreviousButton($showPreviousButton)
{
$this->showPreviousButton = $showPreviousButton;
return $this;
}
/**
* @param array $notifications
*/
public function setNotifications($notifications)
{
$this->notifications = $notifications;
}
/**
* @return array
*/
public function getNotifications()
{
return $this->notifications;
}
/**
* @return bool
*/
public function showExpectedChoice()
{
return api_get_configuration_value('show_exercise_expected_choice');
}
/**
* @return bool
*/
public function showExpectedChoiceColumn()
{
if (true === $this->forceShowExpectedChoiceColumn) {
return true;
}
if ($this->hideExpectedAnswer) {
return false;
}
if (!in_array($this->results_disabled, [
RESULT_DISABLE_SHOW_ONLY_IN_CORRECT_ANSWER,
])
) {
$hide = (int) $this->getPageConfigurationAttribute('hide_expected_answer');
if (1 === $hide) {
return false;
}
return true;
}
return false;
}
/**
* @param string $class
* @param string $scoreLabel
* @param string $result
* @param array
*
* @return string
*/
public function getQuestionRibbon($class, $scoreLabel, $result, $array)
{
$hide = (int) $this->getPageConfigurationAttribute('hide_question_score');
if (1 === $hide) {
return '';
}
if ($this->showExpectedChoice()) {
$html = null;
$hideLabel = api_get_configuration_value('exercise_hide_label');
$label = '<div class="rib rib-'.$class.'">
<h3>'.$scoreLabel.'</h3>
</div>';
if (!empty($result)) {
$label .= '<h4>'.get_lang('Score').': '.$result.'</h4>';
}
if (true === $hideLabel) {
$answerUsed = (int) $array['used'];
$answerMissing = (int) $array['missing'] - $answerUsed;
for ($i = 1; $i <= $answerUsed; $i++) {
$html .= '<span class="score-img">'.
Display::return_icon('attempt-check.png', null, null, ICON_SIZE_SMALL).
'</span>';
}
for ($i = 1; $i <= $answerMissing; $i++) {
$html .= '<span class="score-img">'.
Display::return_icon('attempt-nocheck.png', null, null, ICON_SIZE_SMALL).
'</span>';
}
$label = '<div class="score-title">'.get_lang('CorrectAnswers').': '.$result.'</div>';
$label .= '<div class="score-limits">';
$label .= $html;
$label .= '</div>';
}
return '<div class="ribbon">
'.$label.'
</div>'
;
} else {
$html = '<div class="ribbon">
<div class="rib rib-'.$class.'">
<h3>'.$scoreLabel.'</h3>
</div>';
if (!empty($result)) {
$html .= '<h4>'.get_lang('Score').': '.$result.'</h4>';
}
$html .= '</div>';
return $html;
}
}
/**
* @return int
*/
public function getAutoLaunch()
{
return $this->autolaunch;
}
/**
* Clean auto launch settings for all exercise in course/course-session.
*/
public function enableAutoLaunch()
{
$table = Database::get_course_table(TABLE_QUIZ_TEST);
$sql = "UPDATE $table SET autolaunch = 1
WHERE iid = ".$this->iid;
Database::query($sql);
}
/**
* Clean auto launch settings for all exercise in course/course-session.
*/
public function cleanCourseLaunchSettings()
{
$table = Database::get_course_table(TABLE_QUIZ_TEST);
$sql = "UPDATE $table SET autolaunch = 0
WHERE c_id = ".$this->course_id." AND session_id = ".$this->sessionId;
Database::query($sql);
}
/**
* Get the title without HTML tags.
*
* @return string
*/
public function getUnformattedTitle()
{
return strip_tags(api_html_entity_decode($this->title));
}
/**
* Get the question IDs from quiz_rel_question for the current quiz,
* using the parameters as the arguments to the SQL's LIMIT clause.
* Because the exercise_id is known, it also comes with a filter on
* the session, so sessions are not specified here.
*
* @param int $start At which question do we want to start the list
* @param int $length Up to how many results we want
*
* @return array A list of question IDs
*/
public function getQuestionForTeacher($start = 0, $length = 10)
{
$start = (int) $start;
if ($start < 0) {
$start = 0;
}
$length = (int) $length;
$quizRelQuestion = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$question = Database::get_course_table(TABLE_QUIZ_QUESTION);
$sql = "SELECT DISTINCT e.question_id
FROM $quizRelQuestion e
INNER JOIN $question q
ON e.question_id = q.iid
WHERE
e.c_id = {$this->course_id} AND
e.exercice_id = {$this->iid}
ORDER BY question_order
LIMIT $start, $length
";
$result = Database::query($sql);
$questionList = [];
while ($object = Database::fetch_object($result)) {
$questionList[] = $object->question_id;
}
return $questionList;
}
/**
* @param int $exerciseId
* @param array $courseInfo
* @param int $sessionId
*
* @return bool
*/
public function generateStats($exerciseId, $courseInfo, $sessionId)
{
$allowStats = api_get_configuration_value('allow_gradebook_stats');
if (!$allowStats) {
return false;
}
if (empty($courseInfo)) {
return false;
}
$courseId = $courseInfo['real_id'];
$sessionId = (int) $sessionId;
$exerciseId = (int) $exerciseId;
$result = $this->read($exerciseId);
if (empty($result)) {
api_not_allowed(true);
}
$statusToFilter = empty($sessionId) ? STUDENT : 0;
$studentList = CourseManager::get_user_list_from_course_code(
$courseInfo['code'],
$sessionId,
null,
null,
$statusToFilter
);
if (empty($studentList)) {
Display::addFlash(Display::return_message(get_lang('NoUsersInCourse')));
header('Location: '.api_get_path(WEB_CODE_PATH).'exercise/exercise.php?'.api_get_cidreq());
exit;
}
$tblStats = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$studentIdList = [];
if (!empty($studentList)) {
$studentIdList = array_column($studentList, 'user_id');
}
if (false == $this->exercise_was_added_in_lp) {
$sql = "SELECT * FROM $tblStats
WHERE
exe_exo_id = $exerciseId AND
orig_lp_id = 0 AND
orig_lp_item_id = 0 AND
status <> 'incomplete' AND
session_id = $sessionId AND
c_id = $courseId
";
} else {
$lpId = null;
if (!empty($this->lpList)) {
// Taking only the first LP
$lpId = $this->getLpBySession($sessionId);
$lpId = $lpId['lp_id'];
}
$sql = "SELECT *
FROM $tblStats
WHERE
exe_exo_id = $exerciseId AND
orig_lp_id = $lpId AND
status <> 'incomplete' AND
session_id = $sessionId AND
c_id = $courseId ";
}
$sql .= ' ORDER BY exe_id DESC';
$studentCount = 0;
$sum = 0;
$bestResult = 0;
$sumResult = 0;
$result = Database::query($sql);
$students = [];
while ($data = Database::fetch_array($result, 'ASSOC')) {
// Only take into account users in the current student list.
if (!empty($studentIdList)) {
if (!in_array($data['exe_user_id'], $studentIdList)) {
continue;
}
}
if (!isset($students[$data['exe_user_id']])) {
if ($data['exe_weighting'] != 0) {
$students[$data['exe_user_id']] = $data['exe_result'];
if ($data['exe_result'] > $bestResult) {
$bestResult = $data['exe_result'];
}
$sumResult += $data['exe_result'];
}
}
}
$count = count($studentList);
$average = $sumResult / $count;
$em = Database::getManager();
$links = AbstractLink::getGradebookLinksFromItem(
$this->iid,
LINK_EXERCISE,
$courseInfo['code'],
$sessionId
);
if (empty($links)) {
$links = AbstractLink::getGradebookLinksFromItem(
$this->iid,
LINK_EXERCISE,
$courseInfo['code'],
$sessionId
);
}
if (!empty($links)) {
$repo = $em->getRepository('ChamiloCoreBundle:GradebookLink');
foreach ($links as $link) {
$linkId = $link['id'];
/** @var GradebookLink $exerciseLink */
$exerciseLink = $repo->find($linkId);
if ($exerciseLink) {
$exerciseLink
->setUserScoreList($students)
->setBestScore($bestResult)
->setAverageScore($average)
->setScoreWeight($this->get_max_score());
$em->persist($exerciseLink);
$em->flush();
}
}
}
}
/**
* Return an HTML table of exercises for on-screen printing, including
* action icons. If no exercise is present and the user can edit the
* course, show a "create test" button.
*
* @param int $categoryId
* @param string $keyword
* @param int $userId
* @param int $courseId
* @param int $sessionId
* @param bool $returnData
* @param int $minCategoriesInExercise
* @param int $filterByResultDisabled
* @param int $filterByAttempt
*
* @return string|SortableTableFromArrayConfig
*/
public static function exerciseGrid(
$categoryId,
$keyword = '',
$userId = 0,
$courseId = 0,
$sessionId = 0,
$returnData = false,
$minCategoriesInExercise = 0,
$filterByResultDisabled = 0,
$filterByAttempt = 0,
$myActions = null,
$returnTable = false,
$isAllowedToEdit = null
) {
//$allowDelete = Exercise::allowAction('delete');
$allowClean = self::allowAction('clean_results');
$TBL_DOCUMENT = Database::get_course_table(TABLE_DOCUMENT);
$TBL_ITEM_PROPERTY = Database::get_course_table(TABLE_ITEM_PROPERTY);
$TBL_EXERCISE_QUESTION = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$TBL_EXERCISES = Database::get_course_table(TABLE_QUIZ_TEST);
$TBL_TRACK_EXERCISES = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$categoryId = (int) $categoryId;
$keyword = Database::escape_string($keyword);
$learnpath_id = isset($_REQUEST['learnpath_id']) ? (int) $_REQUEST['learnpath_id'] : null;
$learnpath_item_id = isset($_REQUEST['learnpath_item_id']) ? (int) $_REQUEST['learnpath_item_id'] : null;
$autoLaunchAvailable = false;
if (api_get_course_setting('enable_exercise_auto_launch') == 1 &&
api_get_configuration_value('allow_exercise_auto_launch')
) {
$autoLaunchAvailable = true;
}
if (!isset($isAllowedToEdit)) {
$isAllowedToEdit = api_is_allowed_to_edit(null, true);
}
$courseInfo = $courseId ? api_get_course_info_by_id($courseId) : api_get_course_info();
$sessionId = $sessionId ? (int) $sessionId : api_get_session_id();
$courseId = $courseInfo['real_id'];
$tableRows = [];
$uploadPath = DIR_HOTPOTATOES; //defined in main_api
$exercisePath = api_get_self();
$origin = api_get_origin();
$userInfo = $userId ? api_get_user_info($userId) : api_get_user_info();
$charset = 'utf-8';
$token = Security::get_token();
$userId = $userId ? (int) $userId : api_get_user_id();
$isDrhOfCourse = CourseManager::isUserSubscribedInCourseAsDrh($userId, $courseInfo);
$documentPath = api_get_path(SYS_COURSE_PATH).$courseInfo['path'].'/document';
$limitTeacherAccess = api_get_configuration_value('limit_exercise_teacher_access');
// Condition for the session
$condition_session = api_get_session_condition($sessionId, true, true, 'e.session_id');
$content = '';
$column = 0;
if ($isAllowedToEdit) {
$column = 1;
}
$table = new SortableTableFromArrayConfig(
[],
$column,
self::PAGINATION_ITEMS_PER_PAGE,
'exercises_cat_'.$categoryId
);
$limit = $table->per_page;
$page = $table->page_nr;
$from = $limit * ($page - 1);
$categoryCondition = '';
if (api_get_configuration_value('allow_exercise_categories')) {
if (!empty($categoryId)) {
$categoryCondition = " AND exercise_category_id = $categoryId ";
} else {
$categoryCondition = ' AND exercise_category_id IS NULL ';
}
}
$keywordCondition = '';
if (!empty($keyword)) {
$keywordCondition = " AND title LIKE '%$keyword%' ";
}
$filterByResultDisabledCondition = '';
$filterByResultDisabled = (int) $filterByResultDisabled;
if (!empty($filterByResultDisabled)) {
$filterByResultDisabledCondition = ' AND e.results_disabled = '.$filterByResultDisabled;
}
$filterByAttemptCondition = '';
$filterByAttempt = (int) $filterByAttempt;
if (!empty($filterByAttempt)) {
$filterByAttemptCondition = ' AND e.max_attempt = '.$filterByAttempt;
}
// Only for administrators
if ($isAllowedToEdit) {
$total_sql = "SELECT count(iid) as count
FROM $TBL_EXERCISES e
WHERE
c_id = $courseId AND
active <> -1
$condition_session
$categoryCondition
$keywordCondition
$filterByResultDisabledCondition
$filterByAttemptCondition
";
$sql = "SELECT * FROM $TBL_EXERCISES e
WHERE
c_id = $courseId AND
active <> -1
$condition_session
$categoryCondition
$keywordCondition
$filterByResultDisabledCondition
$filterByAttemptCondition
ORDER BY title
LIMIT $from , $limit";
} else {
// Only for students
if (empty($sessionId)) {
$condition_session = ' AND ( session_id = 0 OR session_id IS NULL) ';
$total_sql = "SELECT count(DISTINCT(e.iid)) as count
FROM $TBL_EXERCISES e
WHERE
e.c_id = $courseId AND
e.active = 1
$condition_session
$categoryCondition
$keywordCondition
";
$sql = "SELECT DISTINCT e.* FROM $TBL_EXERCISES e
WHERE
e.c_id = $courseId AND
e.active = 1
$condition_session
$categoryCondition
$keywordCondition
ORDER BY title
LIMIT $from , $limit";
} else {
$invisibleSql = "SELECT e.iid
FROM $TBL_EXERCISES e
INNER JOIN $TBL_ITEM_PROPERTY ip
ON (e.iid = ip.ref AND e.c_id = ip.c_id)
WHERE
ip.tool = '".TOOL_QUIZ."' AND
e.c_id = $courseId AND
e.active = 1 AND
ip.visibility = 0 AND
ip.session_id = $sessionId
$categoryCondition
$keywordCondition
";
$result = Database::query($invisibleSql);
$result = Database::store_result($result);
$hiddenFromSessionCondition = ' 1=1 ';
if (!empty($result)) {
$hiddenFromSession = implode("','", array_column($result, 'iid'));
$hiddenFromSessionCondition = " e.iid not in ('$hiddenFromSession')";
}
$condition_session = " AND (
(e.session_id = $sessionId OR e.session_id = 0 OR e.session_id IS NULL) AND
$hiddenFromSessionCondition
)
";
// Only for students
$total_sql = "SELECT count(DISTINCT(e.iid)) as count
FROM $TBL_EXERCISES e
WHERE
e.c_id = $courseId AND
e.active = 1
$condition_session
$categoryCondition
$keywordCondition
";
$sql = "SELECT DISTINCT e.* FROM $TBL_EXERCISES e
WHERE
e.c_id = $courseId AND
e.active = 1
$condition_session
$categoryCondition
$keywordCondition
ORDER BY title
LIMIT $from , $limit";
}
}
$result = Database::query($sql);
$result_total = Database::query($total_sql);
$total_exercises = 0;
if (Database::num_rows($result_total)) {
$result_total = Database::fetch_array($result_total);
$total_exercises = $result_total['count'];
}
//get HotPotatoes files (active and inactive)
if ($isAllowedToEdit) {
$sql = "SELECT * FROM $TBL_DOCUMENT
WHERE
c_id = $courseId AND
path LIKE '".Database::escape_string($uploadPath.'/%/%')."'";
$res = Database::query($sql);
$hp_count = Database::num_rows($res);
} else {
$sql = "SELECT * FROM $TBL_DOCUMENT d
INNER JOIN $TBL_ITEM_PROPERTY ip
ON (d.iid = ip.ref)
WHERE
ip.tool = '".TOOL_DOCUMENT."' AND
d.path LIKE '".Database::escape_string($uploadPath.'/%/%')."' AND
ip.visibility = 1 AND
d.c_id = $courseId AND
ip.c_id = $courseId";
$res = Database::query($sql);
$hp_count = Database::num_rows($res);
}
$total = $total_exercises + $hp_count;
$exerciseList = [];
while ($row = Database::fetch_array($result, 'ASSOC')) {
$exerciseList[] = $row;
}
if (!empty($exerciseList) &&
api_get_setting('exercise_invisible_in_session') === 'true'
) {
if (!empty($sessionId)) {
$changeDefaultVisibility = true;
if (api_get_setting('configure_exercise_visibility_in_course') === 'true') {
$changeDefaultVisibility = false;
if (api_get_course_setting('exercise_invisible_in_session') == 1) {
$changeDefaultVisibility = true;
}
}
if ($changeDefaultVisibility) {
// Check exercise
foreach ($exerciseList as $exercise) {
if ($exercise['session_id'] == 0) {
$visibilityInfo = api_get_item_property_info(
$courseId,
TOOL_QUIZ,
$exercise['iid'],
$sessionId
);
if (empty($visibilityInfo)) {
// Create a record for this
api_item_property_update(
$courseInfo,
TOOL_QUIZ,
$exercise['iid'],
'invisible',
api_get_user_id(),
0,
null,
'',
'',
$sessionId
);
}
}
}
}
}
}
$webPath = api_get_path(WEB_CODE_PATH);
if (!empty($exerciseList)) {
if ($origin !== 'learnpath') {
$visibilitySetting = api_get_configuration_value('show_hidden_exercise_added_to_lp');
//avoid sending empty parameters
$mylpid = empty($learnpath_id) ? '' : '&learnpath_id='.$learnpath_id;
$mylpitemid = empty($learnpath_item_id) ? '' : '&learnpath_item_id='.$learnpath_item_id;
foreach ($exerciseList as $row) {
$currentRow = [];
$my_exercise_id = $row['iid'];
$attempt_text = '';
$actions = '';
$exercise = new Exercise($returnData ? $courseId : 0);
$exercise->read($my_exercise_id, false);
if (empty($exercise->iid)) {
continue;
}
$locked = $exercise->is_gradebook_locked;
// Validation when belongs to a session
$session_img = api_get_session_image($row['session_id'], $userInfo['status']);
$time_limits = false;
if (!empty($row['start_time']) || !empty($row['end_time'])) {
$time_limits = true;
}
$is_actived_time = false;
if ($time_limits) {
// check if start time
$start_time = false;
if (!empty($row['start_time'])) {
$start_time = api_strtotime($row['start_time'], 'UTC');
}
$end_time = false;
if (!empty($row['end_time'])) {
$end_time = api_strtotime($row['end_time'], 'UTC');
}
$now = time();
//If both "clocks" are enable
if ($start_time && $end_time) {
if ($now > $start_time && $end_time > $now) {
$is_actived_time = true;
}
} else {
//we check the start and end
if ($start_time) {
if ($now > $start_time) {
$is_actived_time = true;
}
}
if ($end_time) {
if ($end_time > $now) {
$is_actived_time = true;
}
}
}
}
// Blocking empty start times see BT#2800
global $_custom;
if (isset($_custom['exercises_hidden_when_no_start_date']) &&
$_custom['exercises_hidden_when_no_start_date']
) {
if (empty($row['start_time'])) {
$time_limits = true;
$is_actived_time = false;
}
}
$cut_title = $exercise->getCutTitle();
$alt_title = '';
if ($cut_title != $row['title']) {
$alt_title = ' title = "'.$exercise->getUnformattedTitle().'" ';
}
// Teacher only
if ($isAllowedToEdit) {
$lp_blocked = null;
if ($exercise->exercise_was_added_in_lp == true) {
$lp_blocked = Display::div(
get_lang('AddedToLPCannotBeAccessed'),
['class' => 'lp_content_type_label']
);
}
// Get visibility in base course
$visibility = api_get_item_visibility(
$courseInfo,
TOOL_QUIZ,
$my_exercise_id,
0
);
if (!empty($sessionId)) {
// If we are in a session, the test is invisible
// in the base course, it is included in a LP
// *and* the setting to show it is *not*
// specifically set to true, then hide it.
if ($visibility == 0) {
if (!$visibilitySetting) {
if ($exercise->exercise_was_added_in_lp == true) {
continue;
}
}
}
$visibility = api_get_item_visibility(
$courseInfo,
TOOL_QUIZ,
$my_exercise_id,
$sessionId
);
}
if ($row['active'] == 0 || $visibility == 0) {
$title = Display::tag('font', $cut_title, ['style' => 'color:grey']);
} else {
$title = $cut_title;
}
$overviewUrl = api_get_path(WEB_CODE_PATH).'exercise/overview.php';
$url = Security::remove_XSS(
'<a
'.$alt_title.'
id="tooltip_'.$row['iid'].'"
href="'.$overviewUrl.'?'.api_get_cidreq().$mylpid.$mylpitemid.'&exerciseId='.$row['iid'].'"
>
'.Display::return_icon('quiz.png', $row['title']).'
'.$title.'
</a>');
if (ExerciseLib::isQuizEmbeddable($row)) {
$embeddableIcon = Display::return_icon('om_integration.png', get_lang('ThisQuizCanBeEmbeddable'));
$url .= Display::div($embeddableIcon, ['class' => 'pull-right']);
}
$currentRow['title'] = $url.' '.$session_img.$lp_blocked;
if ($returnData) {
$currentRow['title'] = $exercise->getUnformattedTitle();
}
// Count number exercise - teacher
$sql = "SELECT count(*) count FROM $TBL_EXERCISE_QUESTION
WHERE c_id = $courseId AND exercice_id = $my_exercise_id";
$sqlresult = Database::query($sql);
$rowi = (int) Database::result($sqlresult, 0, 0);
if ($sessionId == $row['session_id']) {
// Questions list
$actions = Display::url(
Display::return_icon('edit.png', get_lang('Edit'), '', ICON_SIZE_SMALL),
'admin.php?'.api_get_cidreq().'&exerciseId='.$row['iid']
);
// Test settings
$settings = Display::url(
Display::return_icon('settings.png', get_lang('Configure'), '', ICON_SIZE_SMALL),
'exercise_admin.php?'.api_get_cidreq().'&exerciseId='.$row['iid']
);
if ($limitTeacherAccess && !api_is_platform_admin()) {
$settings = '';
}
$actions .= $settings;
// Exercise results
$resultsLink = '<a href="exercise_report.php?'.api_get_cidreq().'&exerciseId='.$row['iid'].'">'.
Display::return_icon('test_results.png', get_lang('Results'), '', ICON_SIZE_SMALL).'</a>';
if ($limitTeacherAccess) {
if (api_is_platform_admin()) {
$actions .= $resultsLink;
}
} else {
// Exercise results
$actions .= $resultsLink;
}
// Auto launch
if ($autoLaunchAvailable) {
$autoLaunch = $exercise->getAutoLaunch();
if (empty($autoLaunch)) {
$actions .= Display::url(
Display::return_icon(
'launch_na.png',
get_lang('Enable'),
'',
ICON_SIZE_SMALL
),
'exercise.php?'.api_get_cidreq().'&choice=enable_launch&sec_token='.$token.'&exerciseId='.$row['iid']
);
} else {
$actions .= Display::url(
Display::return_icon(
'launch.png',
get_lang('Disable'),
'',
ICON_SIZE_SMALL
),
'exercise.php?'.api_get_cidreq().'&choice=disable_launch&sec_token='.$token.'&exerciseId='.$row['iid']
);
}
}
// Export
$actions .= Display::url(
Display::return_icon('cd.png', get_lang('CopyExercise')),
'',
[
'onclick' => "javascript:if(!confirm('".addslashes(api_htmlentities(get_lang('AreYouSureToCopy'), ENT_QUOTES, $charset))." ".addslashes($row['title'])."?"."')) return false;",
'href' => 'exercise.php?'.api_get_cidreq().'&choice=copy_exercise&sec_token='.$token.'&exerciseId='.$row['iid'],
]
);
// Link to embed the quiz
$urlEmbed = api_get_path(WEB_CODE_PATH).'exercise/overview.php?'.api_get_cidreq().'&origin=iframe&exerciseId='.$row['iid'];
$actions .= Display::url(
Display::return_icon('new_link.png', get_lang('Embed')),
'',
[
'class' => 'ajax',
'data-title' => get_lang('EmbedExerciseLink'),
'title' => get_lang('EmbedExerciseLink'),
'data-content' => get_lang('CopyUrlToIncludeInIframe').'<br>'.$urlEmbed.'<br><br>'.get_lang('CopyIframeCodeToIncludeExercise').'<br><textarea rows="5" cols="70"><iframe width="840" height="472" src="'.$urlEmbed.'" title="Chamilo exercise"></iframe></textarea>',
'href' => 'javascript:void(0);',
]
);
// Clean exercise
$clean = '';
if (true === $allowClean) {
if (false == $locked) {
$clean = Display::url(
Display::return_icon(
'clean.png',
get_lang('CleanStudentResults'),
'',
ICON_SIZE_SMALL
),
'',
[
'onclick' => "javascript:if(!confirm('".addslashes(
api_htmlentities(
get_lang('AreYouSureToDeleteResults'),
ENT_QUOTES,
$charset
)
)." ".addslashes($row['title'])."?"."')) return false;",
'href' => 'exercise.php?'.api_get_cidreq(
).'&choice=clean_results&sec_token='.$token.'&exerciseId='.$row['iid'],
]
);
} else {
$clean = Display::return_icon(
'clean_na.png',
get_lang('ResourceLockedByGradebook'),
'',
ICON_SIZE_SMALL
);
}
}
$actions .= $clean;
// Visible / invisible
// Check if this exercise was added in a LP
if ($exercise->exercise_was_added_in_lp == true) {
$visibility = Display::return_icon(
'invisible.png',
get_lang('AddedToLPCannotBeAccessed'),
'',
ICON_SIZE_SMALL
);
} else {
if ($row['active'] == 0 || $visibility == 0) {
$visibility = Display::url(
Display::return_icon(
'invisible.png',
get_lang('Activate'),
'',
ICON_SIZE_SMALL
),
'exercise.php?'.api_get_cidreq().'&choice=enable&sec_token='.$token.'&exerciseId='.$row['iid']
);
} else {
// else if not active
$visibility = Display::url(
Display::return_icon(
'visible.png',
get_lang('Deactivate'),
'',
ICON_SIZE_SMALL
),
'exercise.php?'.api_get_cidreq().'&choice=disable&sec_token='.$token.'&exerciseId='.$row['iid']
);
}
}
if ($limitTeacherAccess && !api_is_platform_admin()) {
$visibility = '';
}
$actions .= $visibility;
// Export qti ...
$export = Display::url(
Display::return_icon(
'export_qti2.png',
'IMS/QTI',
'',
ICON_SIZE_SMALL
),
'exercise.php?action=exportqti2&exerciseId='.$row['iid'].'&'.api_get_cidreq()
);
if ($limitTeacherAccess && !api_is_platform_admin()) {
$export = '';
}
$actions .= $export;
} else {
// not session
$actions = Display::return_icon(
'edit_na.png',
get_lang('ExerciseEditionNotAvailableInSession')
);
// Check if this exercise was added in a LP
if ($exercise->exercise_was_added_in_lp == true) {
$visibility = Display::return_icon(
'invisible.png',
get_lang('AddedToLPCannotBeAccessed'),
'',
ICON_SIZE_SMALL
);
} else {
if ($row['active'] == 0 || $visibility == 0) {
$visibility = Display::url(
Display::return_icon(
'invisible.png',
get_lang('Activate'),
'',
ICON_SIZE_SMALL
),
'exercise.php?'.api_get_cidreq().'&choice=enable&sec_token='.$token.'&exerciseId='.$row['iid']
);
} else {
// else if not active
$visibility = Display::url(
Display::return_icon(
'visible.png',
get_lang('Deactivate'),
'',
ICON_SIZE_SMALL
),
'exercise.php?'.api_get_cidreq().'&choice=disable&sec_token='.$token.'&exerciseId='.$row['iid']
);
}
}
if ($limitTeacherAccess && !api_is_platform_admin()) {
$visibility = '';
}
$actions .= $visibility;
$actions .= '<a href="exercise_report.php?'.api_get_cidreq().'&exerciseId='.$row['iid'].'">'.
Display::return_icon('test_results.png', get_lang('Results'), '', ICON_SIZE_SMALL).'</a>';
$actions .= Display::url(
Display::return_icon('cd.gif', get_lang('CopyExercise')),
'',
[
'onclick' => "javascript:if(!confirm('".addslashes(api_htmlentities(get_lang('AreYouSureToCopy'), ENT_QUOTES, $charset))." ".addslashes($row['title'])."?"."')) return false;",
'href' => 'exercise.php?'.api_get_cidreq().'&choice=copy_exercise&sec_token='.$token.'&exerciseId='.$row['iid'],
]
);
}
// Delete
$delete = '';
if ($sessionId == $row['session_id']) {
if ($locked == false) {
$delete = Display::url(
Display::return_icon(
'delete.png',
get_lang('Delete'),
'',
ICON_SIZE_SMALL
),
'',
[
'onclick' => "javascript:if(!confirm('".addslashes(api_htmlentities(get_lang('AreYouSureToDeleteJS'), ENT_QUOTES, $charset))." ".addslashes($exercise->getUnformattedTitle())."?"."')) return false;",
'href' => 'exercise.php?'.api_get_cidreq().'&choice=delete&sec_token='.$token.'&exerciseId='.$row['iid'],
]
);
} else {
$delete = Display::return_icon(
'delete_na.png',
get_lang('ResourceLockedByGradebook'),
'',
ICON_SIZE_SMALL
);
}
}
if ($limitTeacherAccess && !api_is_platform_admin()) {
$delete = '';
}
if (!empty($minCategoriesInExercise)) {
$cats = TestCategory::getListOfCategoriesForTest($exercise);
if (!(count($cats) >= $minCategoriesInExercise)) {
continue;
}
}
$actions .= $delete;
$usersToRemind = self::getUsersInExercise(
$row['iid'],
$row['c_id'],
$row['session_id'],
true
);
if ($usersToRemind > 0) {
$actions .= Display::url(
Display::return_icon('announce.png', get_lang('EmailNotifySubscription')),
'',
[
'href' => '#!',
'onclick' => 'showUserToSendNotificacion(this)',
'data-link' => 'exercise.php?'.api_get_cidreq()
.'&choice=send_reminder&sec_token='.$token.'&exerciseId='.$row['iid'],
]
);
}
// Number of questions
$random_label = null;
if ($row['random'] > 0 || $row['random'] == -1) {
// if random == -1 means use random questions with all questions
$random_number_of_question = $row['random'];
if ($random_number_of_question == -1) {
$random_number_of_question = $rowi;
}
if ($row['random_by_category'] > 0) {
$nbQuestionsTotal = TestCategory::getNumberOfQuestionRandomByCategory(
$my_exercise_id,
$random_number_of_question
);
$number_of_questions = $nbQuestionsTotal.' ';
$number_of_questions .= ($nbQuestionsTotal > 1) ? get_lang('QuestionsLowerCase') : get_lang('QuestionLowerCase');
$number_of_questions .= ' - ';
$number_of_questions .= min(
TestCategory::getNumberMaxQuestionByCat($my_exercise_id), $random_number_of_question
).' '.get_lang('QuestionByCategory');
} else {
$random_label = ' ('.get_lang('Random').') ';
$number_of_questions = $random_number_of_question.' '.$random_label.' / '.$rowi;
// Bug if we set a random value bigger than the real number of questions
if ($random_number_of_question > $rowi) {
$number_of_questions = $rowi.' '.$random_label;
}
}
} else {
$number_of_questions = $rowi;
}
$currentRow['count_questions'] = $number_of_questions;
} else {
// Student only.
$visibility = api_get_item_visibility(
$courseInfo,
TOOL_QUIZ,
$my_exercise_id,
$sessionId
);
if ($visibility == 0) {
continue;
}
$url = '<a '.$alt_title.' href="overview.php?'.api_get_cidreq().$mylpid.$mylpitemid.'&exerciseId='.$row['iid'].'">'.
$cut_title.'</a>';
// Link of the exercise.
$currentRow['title'] = $url.' '.$session_img;
if ($returnData) {
$currentRow['title'] = $exercise->getUnformattedTitle();
}
// This query might be improved later on by ordering by the new "tms" field rather than by exe_id
// Don't remove this marker: note-query-exe-results
$sql = "SELECT * FROM $TBL_TRACK_EXERCISES
WHERE
exe_exo_id = ".$row['iid']." AND
exe_user_id = $userId AND
c_id = ".api_get_course_int_id()." AND
status <> 'incomplete' AND
orig_lp_id = 0 AND
orig_lp_item_id = 0 AND
session_id = '".api_get_session_id()."'
ORDER BY exe_id DESC";
$qryres = Database::query($sql);
$num = Database::num_rows($qryres);
// Hide the results.
$my_result_disabled = $row['results_disabled'];
$attempt_text = '-';
// Time limits are on
if ($time_limits) {
// Exam is ready to be taken
if ($is_actived_time) {
// Show results
if (
in_array(
$my_result_disabled,
[
RESULT_DISABLE_SHOW_SCORE_AND_EXPECTED_ANSWERS,
RESULT_DISABLE_SHOW_SCORE_AND_EXPECTED_ANSWERS_AND_RANKING,
RESULT_DISABLE_SHOW_SCORE_ONLY,
RESULT_DISABLE_RANKING,
]
)
) {
// More than one attempt
if ($num > 0) {
$row_track = Database::fetch_array($qryres);
$attempt_text = get_lang('LatestAttempt').' : ';
$attempt_text .= ExerciseLib::show_score(
$row_track['exe_result'],
$row_track['exe_weighting']
);
} else {
//No attempts
$attempt_text = get_lang('NotAttempted');
}
} else {
$attempt_text = '-';
}
} else {
// Quiz not ready due to time limits
//@todo use the is_visible function
if (!empty($row['start_time']) && !empty($row['end_time'])) {
$today = time();
$start_time = api_strtotime($row['start_time'], 'UTC');
$end_time = api_strtotime($row['end_time'], 'UTC');
if ($today < $start_time) {
$attempt_text = sprintf(
get_lang('ExerciseWillBeActivatedFromXToY'),
api_convert_and_format_date($row['start_time']),
api_convert_and_format_date($row['end_time'])
);
} else {
if ($today > $end_time) {
$attempt_text = sprintf(
get_lang('ExerciseWasActivatedFromXToY'),
api_convert_and_format_date($row['start_time']),
api_convert_and_format_date($row['end_time'])
);
}
}
} else {
//$attempt_text = get_lang('ExamNotAvailableAtThisTime');
if (!empty($row['start_time'])) {
$attempt_text = sprintf(
get_lang('ExerciseAvailableFromX'),
api_convert_and_format_date($row['start_time'])
);
}
if (!empty($row['end_time'])) {
$attempt_text = sprintf(
get_lang('ExerciseAvailableUntilX'),
api_convert_and_format_date($row['end_time'])
);
}
}
}
} else {
// Normal behaviour.
// Show results.
if (
in_array(
$my_result_disabled,
[
RESULT_DISABLE_SHOW_SCORE_AND_EXPECTED_ANSWERS,
RESULT_DISABLE_SHOW_SCORE_AND_EXPECTED_ANSWERS_AND_RANKING,
RESULT_DISABLE_SHOW_SCORE_ONLY,
RESULT_DISABLE_RANKING,
RESULT_DISABLE_SHOW_SCORE_ATTEMPT_SHOW_ANSWERS_LAST_ATTEMPT_NO_FEEDBACK,
]
)
) {
if ($num > 0) {
$row_track = Database::fetch_array($qryres);
$attempt_text = get_lang('LatestAttempt').' : ';
$attempt_text .= ExerciseLib::show_score(
$row_track['exe_result'],
$row_track['exe_weighting']
);
} else {
$attempt_text = get_lang('NotAttempted');
}
}
}
if ($returnData) {
$attempt_text = $num;
}
}
$currentRow['attempt'] = $attempt_text;
if ($isAllowedToEdit) {
$additionalActions = ExerciseLib::getAdditionalTeacherActions($row['iid']);
if (!empty($additionalActions)) {
$actions .= $additionalActions.PHP_EOL;
}
// Replace with custom actions.
if (!empty($myActions) && is_callable($myActions)) {
$actions = $myActions($row);
}
$rowTitle = $currentRow['title'];
$currentRow = [
$row['iid'],
$rowTitle,
$currentRow['count_questions'],
$actions,
];
if ($returnData) {
$currentRow['id'] = $exercise->iid;
$currentRow['url'] = $webPath.'exercise/overview.php?'
.api_get_cidreq_params($courseInfo['code'], $sessionId).'&'
."$mylpid$mylpitemid&exerciseId={$row['iid']}";
$currentRow['name'] = $rowTitle;
}
} else {
$rowTitle = $currentRow['title'];
$currentRow = [
$rowTitle,
$currentRow['attempt'],
];
if ($isDrhOfCourse) {
$currentRow[] = '<a href="exercise_report.php?'.api_get_cidreq().'&exerciseId='.$row['iid'].'">'.
Display::return_icon('test_results.png', get_lang('Results'), '', ICON_SIZE_SMALL).'</a>';
}
if ($returnData) {
$currentRow['id'] = $exercise->iid;
$currentRow['url'] = $webPath.'exercise/overview.php?'
.api_get_cidreq_params($courseInfo['code'], $sessionId).'&'
."$mylpid$mylpitemid&exerciseId={$row['iid']}";
$currentRow['name'] = $rowTitle;
}
}
$tableRows[] = $currentRow;
}
}
}
// end exercise list
// Hotpotatoes results
if ($isAllowedToEdit) {
$sql = "SELECT d.iid, d.path as path, d.comment as comment
FROM $TBL_DOCUMENT d
WHERE
d.c_id = $courseId AND
(d.path LIKE '%htm%') AND
d.path LIKE '".Database::escape_string($uploadPath.'/%/%')."'
LIMIT $from , $limit"; // only .htm or .html files listed
} else {
$sql = "SELECT d.iid, d.path as path, d.comment as comment
FROM $TBL_DOCUMENT d
WHERE
d.c_id = $courseId AND
(d.path LIKE '%htm%') AND
d.path LIKE '".Database::escape_string($uploadPath.'/%/%')."'
LIMIT $from , $limit";
}
$result = Database::query($sql);
$attributes = [];
while ($row = Database::fetch_array($result, 'ASSOC')) {
$attributes[$row['iid']] = $row;
}
$nbrActiveTests = 0;
if (!empty($attributes)) {
foreach ($attributes as $item) {
$id = $item['iid'];
$path = $item['path'];
$title = GetQuizName($path, $documentPath);
if ($title == '') {
$title = basename($path);
}
// prof only
if ($isAllowedToEdit) {
$visibility = api_get_item_visibility(
['real_id' => $courseId],
TOOL_DOCUMENT,
$id,
0
);
if (!empty($sessionId)) {
if (0 == $visibility) {
continue;
}
$visibility = api_get_item_visibility(
['real_id' => $courseId],
TOOL_DOCUMENT,
$id,
$sessionId
);
}
$title =
implode(PHP_EOL, [
Display::return_icon('hotpotatoes_s.png', 'HotPotatoes'),
Display::url(
$title,
'showinframes.php?'.api_get_cidreq().'&'.http_build_query([
'file' => $path,
'uid' => $userId,
]),
['class' => $visibility == 0 ? 'text-muted' : null]
),
]);
$actions = Display::url(
Display::return_icon(
'edit.png',
get_lang('Edit'),
'',
ICON_SIZE_SMALL
),
'adminhp.php?'.api_get_cidreq().'&hotpotatoesName='.$path
);
$actions .= '<a href="hotpotatoes_exercise_report.php?'.api_get_cidreq().'&path='.$path.'">'.
Display::return_icon('test_results.png', get_lang('Results'), '', ICON_SIZE_SMALL).
'</a>';
// if active
if ($visibility != 0) {
$nbrActiveTests = $nbrActiveTests + 1;
$actions .= ' <a href="'.$exercisePath.'?'.api_get_cidreq().'&hpchoice=disable&file='.$path.'">'.
Display::return_icon('visible.png', get_lang('Deactivate'), '', ICON_SIZE_SMALL).'</a>';
} else { // else if not active
$actions .= ' <a href="'.$exercisePath.'?'.api_get_cidreq().'&hpchoice=enable&file='.$path.'">'.
Display::return_icon('invisible.png', get_lang('Activate'), '', ICON_SIZE_SMALL).'</a>';
}
$actions .= '<a href="'.$exercisePath.'?'.api_get_cidreq().'&hpchoice=delete&file='.$path.'" onclick="javascript:if(!confirm(\''.addslashes(api_htmlentities(get_lang('AreYouSureToDeleteJS'), ENT_QUOTES, $charset)).'\')) return false;">'.
Display::return_icon('delete.png', get_lang('Delete'), '', ICON_SIZE_SMALL).'</a>';
$currentRow = [
'',
$title,
'',
$actions,
];
} else {
$visibility = api_get_item_visibility(
['real_id' => $courseId],
TOOL_DOCUMENT,
$id,
$sessionId
);
if (0 == $visibility) {
continue;
}
// Student only
$attempt = ExerciseLib::getLatestHotPotatoResult(
$path,
$userId,
api_get_course_int_id(),
api_get_session_id()
);
$nbrActiveTests = $nbrActiveTests + 1;
$title = Display::url(
$title,
'showinframes.php?'.api_get_cidreq().'&'.http_build_query(
[
'file' => $path,
'cid' => api_get_course_id(),
'uid' => $userId,
]
)
);
if (!empty($attempt)) {
$actions = '<a href="hotpotatoes_exercise_report.php?'.api_get_cidreq().'&path='.$path.'&filter_by_user='.$userId.'">'.Display::return_icon('test_results.png', get_lang('Results'), '', ICON_SIZE_SMALL).'</a>';
$attemptText = get_lang('LatestAttempt').' : ';
$attemptText .= ExerciseLib::show_score(
$attempt['exe_result'],
$attempt['exe_weighting']
).' ';
$attemptText .= $actions;
} else {
// No attempts.
$attemptText = get_lang('NotAttempted').' ';
}
$currentRow = [
$title,
$attemptText,
];
if ($isDrhOfCourse) {
$currentRow[] = '<a href="hotpotatoes_exercise_report.php?'.api_get_cidreq().'&path='.$path.'">'.
Display::return_icon('test_results.png', get_lang('Results'), '', ICON_SIZE_SMALL).'</a>';
}
}
$tableRows[] = $currentRow;
}
}
if ($returnData) {
return $tableRows;
}
if (empty($tableRows) && empty($categoryId)) {
if ($isAllowedToEdit && $origin !== 'learnpath') {
$content .= '<div id="no-data-view">';
$content .= '<h3>'.get_lang('Quiz').'</h3>';
$content .= Display::return_icon('quiz.png', '', [], 64);
$content .= '<div class="controls">';
$content .= Display::url(
'<em class="fa fa-plus"></em> '.get_lang('NewEx'),
'exercise_admin.php?'.api_get_cidreq(),
['class' => 'btn btn-primary']
);
$content .= '</div>';
$content .= '</div>';
}
} else {
if (empty($tableRows)) {
return '';
}
if (true === api_get_configuration_value('allow_exercise_categories') && empty($categoryId)) {
echo Display::page_subheader(get_lang('NoCategory'));
}
$table->setTableData($tableRows);
$table->setTotalNumberOfItems($total);
$table->set_additional_parameters([
'cidReq' => api_get_course_id(),
'id_session' => api_get_session_id(),
'category_id' => $categoryId,
]);
if ($isAllowedToEdit) {
$formActions = [];
$formActions['visible'] = get_lang('Activate');
$formActions['invisible'] = get_lang('Deactivate');
$formActions['delete'] = get_lang('Delete');
$table->set_form_actions($formActions);
}
$i = 0;
if ($isAllowedToEdit) {
$table->set_header($i++, '', false, 'width="18px"');
}
$table->set_header($i++, get_lang('ExerciseName'), false);
if ($isAllowedToEdit) {
$table->set_header($i++, get_lang('QuantityQuestions'), false);
$table->set_header($i++, get_lang('Actions'), false);
} else {
$table->set_header($i++, get_lang('Status'), false);
if ($isDrhOfCourse) {
$table->set_header($i++, get_lang('Actions'), false);
}
}
if ($returnTable) {
return $table;
}
$content .= $table->return_table();
}
return $content;
}
/**
* @return int value in minutes
*/
public function getResultAccess()
{
$extraFieldValue = new ExtraFieldValue('exercise');
$value = $extraFieldValue->get_values_by_handler_and_field_variable(
$this->iid,
'results_available_for_x_minutes'
);
if (!empty($value) && isset($value['value'])) {
return (int) $value['value'];
}
return 0;
}
/**
* @param array $exerciseResultInfo
*
* @return bool
*/
public function getResultAccessTimeDiff($exerciseResultInfo)
{
$value = $this->getResultAccess();
if (!empty($value)) {
$endDate = new DateTime($exerciseResultInfo['exe_date'], new DateTimeZone('UTC'));
$endDate->add(new DateInterval('PT'.$value.'M'));
$now = time();
if ($endDate->getTimestamp() > $now) {
return (int) $endDate->getTimestamp() - $now;
}
}
return 0;
}
/**
* @param array $exerciseResultInfo
*
* @return bool
*/
public function hasResultsAccess($exerciseResultInfo)
{
$diff = $this->getResultAccessTimeDiff($exerciseResultInfo);
if (0 === $diff) {
return false;
}
return true;
}
/**
* @return int
*/
public function getResultsAccess()
{
$extraFieldValue = new ExtraFieldValue('exercise');
$value = $extraFieldValue->get_values_by_handler_and_field_variable(
$this->iid,
'results_available_for_x_minutes'
);
if (!empty($value)) {
return (int) $value;
}
return 0;
}
/**
* Get results of a delineation type question.
* Params described here are only non-typed params.
*
* @param int $questionId
* @param bool $show_results
* @param array $question_result
*/
public function getDelineationResult(Question $objQuestionTmp, $questionId, $show_results, $question_result)
{
$id = $objQuestionTmp->iid;
$questionId = (int) $questionId;
$final_overlap = $question_result['extra']['final_overlap'];
$final_missing = $question_result['extra']['final_missing'];
$final_excess = $question_result['extra']['final_excess'];
$overlap_color = $question_result['extra']['overlap_color'];
$missing_color = $question_result['extra']['missing_color'];
$excess_color = $question_result['extra']['excess_color'];
$threadhold1 = $question_result['extra']['threadhold1'];
$threadhold2 = $question_result['extra']['threadhold2'];
$threadhold3 = $question_result['extra']['threadhold3'];
if ($show_results) {
if ($overlap_color) {
$overlap_color = 'green';
} else {
$overlap_color = 'red';
}
if ($missing_color) {
$missing_color = 'green';
} else {
$missing_color = 'red';
}
if ($excess_color) {
$excess_color = 'green';
} else {
$excess_color = 'red';
}
if (!is_numeric($final_overlap)) {
$final_overlap = 0;
}
if (!is_numeric($final_missing)) {
$final_missing = 0;
}
if (!is_numeric($final_excess)) {
$final_excess = 0;
}
if ($final_excess > 100) {
$final_excess = 100;
}
$table_resume = '
<table class="table table-hover table-striped data_table">
<tr class="row_odd" >
<td> </td>
<td><b>'.get_lang('Requirements').'</b></td>
<td><b>'.get_lang('YourAnswer').'</b></td>
</tr>
<tr class="row_even">
<td><b>'.get_lang('Overlap').'</b></td>
<td>'.get_lang('Min').' '.$threadhold1.'</td>
<td>
<div style="color:'.$overlap_color.'">
'.(($final_overlap < 0) ? 0 : intval($final_overlap)).'
</div>
</td>
</tr>
<tr>
<td><b>'.get_lang('Excess').'</b></td>
<td>'.get_lang('Max').' '.$threadhold2.'</td>
<td>
<div style="color:'.$excess_color.'">
'.(($final_excess < 0) ? 0 : intval($final_excess)).'
</div>
</td>
</tr>
<tr class="row_even">
<td><b>'.get_lang('Missing').'</b></td>
<td>'.get_lang('Max').' '.$threadhold3.'</td>
<td>
<div style="color:'.$missing_color.'">
'.(($final_missing < 0) ? 0 : intval($final_missing)).'
</div>
</td>
</tr>
</table>
';
$answerType = $objQuestionTmp->selectType();
if ($answerType != HOT_SPOT_DELINEATION) {
$item_list = explode('@@', $destination);
$try = $item_list[0];
$lp = $item_list[1];
$destinationid = $item_list[2];
$url = $item_list[3];
$table_resume = '';
} else {
if ($next == 0) {
$try = $try_hotspot;
$lp = $lp_hotspot;
$destinationid = $select_question_hotspot;
$url = $url_hotspot;
} else {
//show if no error
$comment = $answerComment = $objAnswerTmp->selectComment($nbrAnswers);
$answerDestination = $objAnswerTmp->selectDestination($nbrAnswers);
}
}
echo '<h1><div style="color:#333;">'.get_lang('Feedback').'</div></h1>';
if ($answerType == HOT_SPOT_DELINEATION) {
if ($organs_at_risk_hit > 0) {
$message = '<br />'.get_lang('ResultIs').' <b>'.$result_comment.'</b><br />';
$message .= '<p style="color:#DC0A0A;"><b>'.get_lang('OARHit').'</b></p>';
} else {
$message = '<p>'.get_lang('YourDelineation').'</p>';
$message .= $table_resume;
$message .= '<br />'.get_lang('ResultIs').' <b>'.$result_comment.'</b><br />';
}
$message .= '<p>'.$comment.'</p>';
echo $message;
} else {
echo '<p>'.$comment.'</p>';
}
// Showing the score
/*$queryfree = "SELECT marks FROM $TBL_TRACK_ATTEMPT
WHERE exe_id = $id AND question_id = $questionId";
$resfree = Database::query($queryfree);
$questionScore = Database::result($resfree, 0, 'marks');
$totalScore += $questionScore;*/
$relPath = api_get_path(REL_CODE_PATH);
echo '</table></td></tr>';
echo "
<tr>
<td colspan=\"2\">
<div id=\"hotspot-solution\"></div>
<script>
$(function() {
new HotspotQuestion({
questionId: $questionId,
exerciseId: {$this->iid},
exeId: $id,
selector: '#hotspot-solution',
for: 'solution',
relPath: '$relPath'
});
});
</script>
</td>
</tr>
</table>
";
}
}
/**
* Clean exercise session variables.
*/
public static function cleanSessionVariables()
{
Session::erase('objExercise');
Session::erase('exe_id');
Session::erase('calculatedAnswerId');
Session::erase('duration_time_previous');
Session::erase('duration_time');
Session::erase('objQuestion');
Session::erase('objAnswer');
Session::erase('questionList');
Session::erase('categoryList');
Session::erase('exerciseResult');
Session::erase('firstTime');
Session::erase('time_per_question');
Session::erase('question_start');
Session::erase('exerciseResultCoordinates');
Session::erase('hotspot_coord');
Session::erase('hotspot_dest');
Session::erase('hotspot_delineation_result');
}
/**
* Get the first LP found matching the session ID.
*
* @param int $sessionId
*
* @return array
*/
public function getLpBySession($sessionId)
{
if (!empty($this->lpList)) {
$sessionId = (int) $sessionId;
foreach ($this->lpList as $lp) {
if ((int) $lp['session_id'] == $sessionId) {
return $lp;
}
}
return current($this->lpList);
}
return [
'lp_id' => 0,
'max_score' => 0,
'session_id' => 0,
];
}
public static function saveExerciseInLp($safe_item_id, $safe_exe_id)
{
$lp = Session::read('oLP');
$safe_exe_id = (int) $safe_exe_id;
$safe_item_id = (int) $safe_item_id;
if (empty($lp) || empty($safe_exe_id) || empty($safe_item_id)) {
return false;
}
$viewId = $lp->get_view_id();
$course_id = api_get_course_int_id();
$userId = (int) api_get_user_id();
$viewId = (int) $viewId;
$TBL_TRACK_EXERCICES = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES);
$TBL_LP_ITEM_VIEW = Database::get_course_table(TABLE_LP_ITEM_VIEW);
$TBL_LP_ITEM = Database::get_course_table(TABLE_LP_ITEM);
$sql = "SELECT start_date, exe_date, exe_result, exe_weighting, exe_exo_id, exe_duration
FROM $TBL_TRACK_EXERCICES
WHERE exe_id = $safe_exe_id AND exe_user_id = $userId";
$res = Database::query($sql);
$row_dates = Database::fetch_array($res);
if (empty($row_dates)) {
return false;
}
$duration = (int) $row_dates['exe_duration'];
$score = (float) $row_dates['exe_result'];
$max_score = (float) $row_dates['exe_weighting'];
$sql = "UPDATE $TBL_LP_ITEM SET
max_score = '$max_score'
WHERE iid = $safe_item_id";
Database::query($sql);
$sql = "SELECT iid FROM $TBL_LP_ITEM_VIEW
WHERE
c_id = $course_id AND
lp_item_id = $safe_item_id AND
lp_view_id = $viewId
ORDER BY id DESC
LIMIT 1";
$res_last_attempt = Database::query($sql);
if (Database::num_rows($res_last_attempt) && !api_is_invitee()) {
$row_last_attempt = Database::fetch_row($res_last_attempt);
$lp_item_view_id = $row_last_attempt[0];
$exercise = new Exercise($course_id);
$exercise->read($row_dates['exe_exo_id']);
$status = 'completed';
if (!empty($exercise->pass_percentage)) {
$status = 'failed';
$success = ExerciseLib::isSuccessExerciseResult(
$score,
$max_score,
$exercise->pass_percentage
);
if ($success) {
$status = 'passed';
}
}
$sql = "UPDATE $TBL_LP_ITEM_VIEW SET
status = '$status',
score = $score,
total_time = $duration
WHERE iid = $lp_item_view_id";
Database::query($sql);
$sql = "UPDATE $TBL_TRACK_EXERCICES SET
orig_lp_item_view_id = $lp_item_view_id
WHERE exe_id = ".$safe_exe_id;
Database::query($sql);
}
}
/**
* Get the user answers saved in exercise.
*
* @param int $attemptId
*
* @return array
*/
public function getUserAnswersSavedInExercise($attemptId)
{
$exerciseResult = [];
$attemptList = Event::getAllExerciseEventByExeId($attemptId);
foreach ($attemptList as $questionId => $options) {
foreach ($options as $option) {
$question = Question::read($option['question_id']);
if ($question) {
switch ($question->type) {
case FILL_IN_BLANKS:
case FILL_IN_BLANKS_COMBINATION:
$option['answer'] = $this->fill_in_blank_answer_to_string($option['answer']);
if ($option['answer'] === "0") {
$option['answer'] = "there is 0 as answer so we do not want to consider it empty";
}
break;
}
}
if (!empty($option['answer'])) {
$exerciseResult[] = $questionId;
break;
}
}
}
return $exerciseResult;
}
/**
* Get the number of user answers saved in exercise.
*
* @param int $attemptId
*
* @return int
*/
public function countUserAnswersSavedInExercise($attemptId)
{
$answers = $this->getUserAnswersSavedInExercise($attemptId);
return count($answers);
}
public static function allowAction($action)
{
if (api_is_platform_admin()) {
return true;
}
$limitTeacherAccess = api_get_configuration_value('limit_exercise_teacher_access');
$disableClean = api_get_configuration_value('disable_clean_exercise_results_for_teachers');
switch ($action) {
case 'delete':
if (api_is_allowed_to_edit(null, true)) {
if ($limitTeacherAccess) {
return false;
}
return true;
}
break;
case 'clean_results':
if (api_is_allowed_to_edit(null, true)) {
if ($limitTeacherAccess) {
return false;
}
if ($disableClean) {
return false;
}
return true;
}
break;
}
return false;
}
public static function getLpListFromExercise($exerciseId, $courseId)
{
$tableLpItem = Database::get_course_table(TABLE_LP_ITEM);
$tblLp = Database::get_course_table(TABLE_LP_MAIN);
$exerciseId = (int) $exerciseId;
$courseId = (int) $courseId;
$sql = "SELECT
lp.name,
lpi.lp_id,
lpi.max_score,
lp.session_id
FROM $tableLpItem lpi
INNER JOIN $tblLp lp
ON (lpi.lp_id = lp.iid AND lpi.c_id = lp.c_id)
WHERE
lpi.c_id = $courseId AND
lpi.item_type = '".TOOL_QUIZ."' AND
lpi.path = '$exerciseId'";
$result = Database::query($sql);
$lpList = [];
if (Database::num_rows($result) > 0) {
$lpList = Database::store_result($result, 'ASSOC');
}
return $lpList;
}
public function getReminderTable($questionList, $exercise_stat_info, $disableCheckBoxes = false)
{
$learnpath_id = isset($_REQUEST['learnpath_id']) ? (int) $_REQUEST['learnpath_id'] : 0;
$learnpath_item_id = isset($_REQUEST['learnpath_item_id']) ? (int) $_REQUEST['learnpath_item_id'] : 0;
$learnpath_item_view_id = isset($_REQUEST['learnpath_item_view_id']) ? (int) $_REQUEST['learnpath_item_view_id'] : 0;
$categoryId = isset($_REQUEST['category_id']) ? (int) $_REQUEST['category_id'] : 0;
if (empty($exercise_stat_info)) {
return '';
}
$remindList = $exercise_stat_info['questions_to_check'];
$remindList = explode(',', $remindList);
$exeId = $exercise_stat_info['exe_id'];
$exerciseId = $exercise_stat_info['exe_exo_id'];
$exercise_result = $this->getUserAnswersSavedInExercise($exeId);
$content = Display::label(get_lang('QuestionWithNoAnswer'), 'danger');
$content .= '<div class="clear"></div><br />';
$table = '';
$counter = 0;
// Loop over all question to show results for each of them, one by one
foreach ($questionList as $questionId) {
$objQuestionTmp = Question::read($questionId);
$check_id = 'remind_list['.$questionId.']';
$attributes = [
'id' => $check_id,
'onclick' => "save_remind_item(this, '$questionId');",
'data-question-id' => $questionId,
];
if (in_array($questionId, $remindList)) {
$attributes['checked'] = 1;
}
$checkbox = Display::input('checkbox', 'remind_list['.$questionId.']', '', $attributes);
$checkbox = '<div class="pretty p-svg p-curve">
'.$checkbox.'
<div class="state p-primary ">
<svg class="svg svg-icon" viewBox="0 0 20 20">
<path d="M7.629,14.566c0.125,0.125,0.291,0.188,0.456,0.188c0.164,0,0.329-0.062,0.456-0.188l8.219-8.221c0.252-0.252,0.252-0.659,0-0.911c-0.252-0.252-0.659-0.252-0.911,0l-7.764,7.763L4.152,9.267c-0.252-0.251-0.66-0.251-0.911,0c-0.252,0.252-0.252,0.66,0,0.911L7.629,14.566z" style="stroke: white;fill:white;"></path>
</svg>
<label> </label>
</div>
</div>';
$counter++;
$questionTitle = $counter.'. '.strip_tags($objQuestionTmp->selectTitle());
// Check if the question doesn't have an answer.
if (!in_array($questionId, $exercise_result)) {
$questionTitle = Display::label($questionTitle, 'danger');
}
$label_attributes = [];
$label_attributes['for'] = $check_id;
if (false === $disableCheckBoxes) {
$questionTitle = Display::tag('label', $checkbox.$questionTitle, $label_attributes);
}
$table .= Display::div($questionTitle, ['class' => 'exercise_reminder_item ']);
}
$content .= Display::div('', ['id' => 'message']).
Display::div($table, ['class' => 'question-check-test']);
$content .= '<script>
var lp_data = $.param({
"learnpath_id": '.$learnpath_id.',
"learnpath_item_id" : '.$learnpath_item_id.',
"learnpath_item_view_id": '.$learnpath_item_view_id.'
});
function final_submit() {
// Normal inputs.
window.location = "'.api_get_path(WEB_CODE_PATH).'exercise/exercise_result.php?'.api_get_cidreq().'&exe_id='.$exeId.'&" + lp_data;
}
function selectAll() {
$("input[type=checkbox]").each(function () {
$(this).prop("checked", 1);
var question_id = $(this).data("question-id");
var action = "add";
$.ajax({
url: "'.api_get_path(WEB_AJAX_PATH).'exercise.ajax.php?'.api_get_cidreq().'&a=add_question_to_reminder",
data: "question_id="+question_id+"&exe_id='.$exeId.'&action="+action,
success: function(returnValue) {
}
});
});
}
function changeOptionStatus(status)
{
$("input[type=checkbox]").each(function () {
$(this).prop("checked", status);
});
var action = "";
var option = "remove_all";
if (status == 1) {
option = "add_all";
}
$.ajax({
url: "'.api_get_path(WEB_AJAX_PATH).'exercise.ajax.php?'.api_get_cidreq().'&a=add_question_to_reminder",
data: "option="+option+"&exe_id='.$exeId.'&action="+action,
success: function(returnValue) {
}
});
}
function reviewQuestions() {
var isChecked = 1;
$("input[type=checkbox]").each(function () {
if ($(this).prop("checked")) {
isChecked = 2;
return false;
}
});
if (isChecked == 1) {
$("#message").addClass("warning-message");
$("#message").html("'.addslashes(get_lang('SelectAQuestionToReview')).'");
} else {
window.location = "exercise_submit.php?'.api_get_cidreq().'&category_id='.$categoryId.'&exerciseId='.$exerciseId.'&reminder=2&" + lp_data;
}
}
function save_remind_item(obj, question_id) {
var action = "";
if ($(obj).prop("checked")) {
action = "add";
} else {
action = "delete";
}
$.ajax({
url: "'.api_get_path(WEB_AJAX_PATH).'exercise.ajax.php?'.api_get_cidreq().'&a=add_question_to_reminder",
data: "question_id="+question_id+"&exe_id='.$exeId.'&action="+action,
success: function(returnValue) {
}
});
}
</script>';
return $content;
}
public function getRadarsFromUsers($userList, $exercises, $dataSetLabels, $courseId, $sessionId)
{
$dataSet = [];
$labels = [];
$labelsWithId = [];
$cutLabelAtChar = 30;
/** @var Exercise $exercise */
foreach ($exercises as $exercise) {
if (empty($labels)) {
$categoryNameList = TestCategory::getListOfCategoriesNameForTest($exercise->iid);
if (!empty($categoryNameList)) {
$labelsWithId = array_column($categoryNameList, 'title', 'iid');
asort($labelsWithId);
$labels = array_values($labelsWithId);
foreach ($labels as $labelId => $label) {
// Cut if label is too long to maintain chart visibility
$labels[$labelId] = cut($label, $cutLabelAtChar);
}
}
}
foreach ($userList as $userId) {
$results = Event::getExerciseResultsByUser(
$userId,
$exercise->iid,
$courseId,
$sessionId
);
if ($results) {
$firstAttempt = end($results);
$exeId = $firstAttempt['exe_id'];
ob_start();
$stats = ExerciseLib::displayQuestionListByAttempt(
$exercise,
$exeId,
false
);
ob_end_clean();
$categoryList = $stats['category_list'];
$tempResult = [];
foreach ($labelsWithId as $category_id => $title) {
if (isset($categoryList[$category_id])) {
$categoryItem = $categoryList[$category_id];
if ($categoryItem['total'] > 0) {
$tempResult[] = round($categoryItem['score'] / $categoryItem['total'] * 10);
} else {
$tempResult[] = 0;
}
} else {
$tempResult[] = 0;
}
}
$dataSet[] = $tempResult;
}
}
}
return $this->getRadar($labels, $dataSet, $dataSetLabels);
}
public function getAverageRadarsFromUsers($userList, $exercises, $dataSetLabels, $courseId, $sessionId)
{
$dataSet = [];
$labels = [];
$labelsWithId = [];
$cutLabelAtChar = 30;
$tempResult = [];
/** @var Exercise $exercise */
foreach ($exercises as $exercise) {
$exerciseId = $exercise->iid;
if (empty($labels)) {
$categoryNameList = TestCategory::getListOfCategoriesNameForTest($exercise->iid);
if (!empty($categoryNameList)) {
$labelsWithId = array_column($categoryNameList, 'title', 'iid');
asort($labelsWithId);
$labels = array_values($labelsWithId);
foreach ($labels as $labelId => $label) {
// Cut if label is too long to maintain chart visibility
$labels[$labelId] = cut($label, $cutLabelAtChar);
}
}
}
foreach ($userList as $userId) {
$results = Event::getExerciseResultsByUser(
$userId,
$exerciseId,
$courseId,
$sessionId
);
if ($results) {
$firstAttempt = end($results);
$exeId = $firstAttempt['exe_id'];
ob_start();
$stats = ExerciseLib::displayQuestionListByAttempt(
$exercise,
$exeId,
false
);
ob_end_clean();
$categoryList = $stats['category_list'];
foreach ($labelsWithId as $category_id => $title) {
if (isset($categoryList[$category_id])) {
$categoryItem = $categoryList[$category_id];
if (!isset($tempResult[$exerciseId][$category_id])) {
$tempResult[$exerciseId][$category_id] = 0;
}
$tempResult[$exerciseId][$category_id] +=
$categoryItem['score'] / $categoryItem['total'] * 10;
}
}
}
}
}
foreach ($exercises as $exercise) {
$exerciseId = $exercise->iid;
$totalResults = ExerciseLib::getNumberStudentsFinishExercise($exerciseId, $courseId, $sessionId);
$data = [];
foreach ($labelsWithId as $category_id => $title) {
if (isset($tempResult[$exerciseId]) && isset($tempResult[$exerciseId][$category_id])) {
$data[] = round($tempResult[$exerciseId][$category_id] / $totalResults);
} else {
$data[] = 0;
}
}
$dataSet[] = $data;
}
return $this->getRadar($labels, $dataSet, $dataSetLabels);
}
public function getRadar($labels, $dataSet, $dataSetLabels = [])
{
if (empty($labels) || empty($dataSet)) {
return '';
}
$displayLegend = 0;
if (!empty($dataSetLabels)) {
$displayLegend = 1;
}
$labels = json_encode($labels);
$colorList = ChamiloApi::getColorPalette(true, true);
$dataSetToJson = [];
$counter = 0;
foreach ($dataSet as $index => $resultsArray) {
$color = isset($colorList[$counter]) ? $colorList[$counter] : 'rgb('.rand(0, 255).', '.rand(0, 255).', '.rand(0, 255).', 1.0)';
$label = isset($dataSetLabels[$index]) ? $dataSetLabels[$index] : '';
$background = str_replace('1.0', '0.2', $color);
$dataSetToJson[] = [
'fill' => false,
'label' => $label,
'backgroundColor' => $background,
'borderColor' => $color,
'pointBackgroundColor' => $color,
'pointBorderColor' => '#fff',
'pointHoverBackgroundColor' => '#fff',
'pointHoverBorderColor' => $color,
'pointRadius' => 6,
'pointBorderWidth' => 3,
'pointHoverRadius' => 10,
'data' => $resultsArray,
];
$counter++;
}
$resultsToJson = json_encode($dataSetToJson);
return "
<canvas id='categoryRadar' height='200'></canvas>
<script>
var data = {
labels: $labels,
datasets: $resultsToJson
}
var options = {
responsive: true,
scale: {
angleLines: {
display: false
},
ticks: {
beginAtZero: true,
min: 0,
max: 10,
stepSize: 1,
},
pointLabels: {
fontSize: 14,
//fontStyle: 'bold'
},
},
elements: {
line: {
tension: 0,
borderWidth: 3
}
},
legend: {
//position: 'bottom'
display: $displayLegend
},
animation: {
animateScale: true,
animateRotate: true
},
};
var ctx = document.getElementById('categoryRadar').getContext('2d');
var myRadarChart = new Chart(ctx, {
type: 'radar',
data: data,
options: options
});
</script>
";
}
/**
* Returns a list of users based on the id of an exercise, the course and the session.
* If the count is true, it returns only the number of users.
*
* @param int $exerciseId
* @param int $courseId
* @param int $sessionId
* @param false $count
*/
public static function getUsersInExercise(
$exerciseId = 0,
$courseId = 0,
$sessionId = 0,
$count = false,
$toUsers = [],
$withSelectAll = true
) {
$sessionId = empty($sessionId) ? api_get_session_id() : (int) $sessionId;
$courseId = empty($courseId) ? api_get_course_id() : (int) $courseId;
$exerciseId = (int) $exerciseId;
if ((0 == $sessionId && 0 == $courseId) || 0 == $exerciseId) {
return [];
}
$tblCourse = Database::get_main_table(TABLE_MAIN_COURSE);
$tblCourseRelUser = Database::get_main_table(TABLE_MAIN_COURSE_USER);
$tblSessionRelUser = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
$data = [];
$tblQuiz = Database::get_course_table(TABLE_QUIZ_TEST);
$countSelect = " COUNT(*) AS total ";
$sqlToUsers = '';
if (0 == $sessionId) {
// Courses
if (false === $count) {
$countSelect = " cq.title AS quiz_title,
cq.iid AS quiz_id,
cru.c_id AS course_id,
cru.user_id AS user_id,
c.title AS title,
c.code AS 'code',
cq.active AS active,
cq.session_id AS session_id ";
}
$sql = "SELECT $countSelect
FROM $tblCourseRelUser AS cru
INNER JOIN $tblCourse AS c ON ( cru.c_id = c.id )
INNER JOIN $tblQuiz AS cq ON ( cq.c_id = c.id )
WHERE cru.is_tutor IS NULL
AND ( cq.session_id = 0 OR cq.session_id IS NULL)
AND cq.active != -1
AND cq.c_id = $courseId
AND cq.iid = $exerciseId ";
if (!empty($toUsers)) {
$sqlToUsers = ' AND cru.user_id IN ('.implode(',', $toUsers).') ';
}
} else {
//Sessions
if (false === $count) {
$countSelect = " cq.title AS quiz_title,
cq.iid AS quiz_id,
sru.user_id AS user_id,
cq.c_id AS course_id,
sru.session_id AS session_id,
c.title AS title,
c.code AS 'code',
cq.active AS active ";
}
if (!empty($toUsers)) {
$sqlToUsers = ' AND sru.user_id IN ('.implode(',', $toUsers).') ';
}
$sql = " SELECT $countSelect
FROM $tblSessionRelUser AS sru
INNER JOIN $tblQuiz AS cq ON ( sru.session_id = sru.session_id )
INNER JOIN $tblCourse AS c ON ( c.id = cq.c_id )
WHERE cq.active != 1
AND cq.c_id = $courseId
AND sru.session_id = $sessionId
AND cq.iid = $exerciseId ";
}
$sql .= " $sqlToUsers ORDER BY cq.c_id ";
$result = Database::query($sql);
$data = Database::store_result($result);
Database::free_result($result);
if (true === $count) {
return (isset($data[0]) && isset($data[0]['total'])) ? $data[0]['total'] : 0;
}
$usersArray = [];
$return = [];
if ($withSelectAll) {
$return[] = [
'user_id' => 'X',
'value' => 'X',
'user_name' => get_lang('AllStudents'),
];
}
foreach ($data as $index => $item) {
if (isset($item['user_id'])) {
$userId = (int) $item['user_id'];
if (!isset($usersArray[$userId])) {
$usersArray[$userId] = api_get_user_info($userId);
}
$usersArray[$userId]['user_id'] = $userId;
$userData = $usersArray[$userId];
$data[$index]['user_name'] = $userData['complete_name'];
$return[] = $data[$index];
}
}
return $return;
}
/**
* Search the users who are in an exercise to send them an exercise reminder email and to the human resources
* managers, it is necessary the exercise id, the course and the session if it exists.
*
* @param int $exerciseId
* @param int $courseId
* @param int $sessionId
*/
public static function notifyUsersOfTheExercise(
$exerciseId = 0,
$courseId = 0,
$sessionId = 0,
$toUsers = []
) {
$users = self::getUsersInExercise(
$exerciseId,
$courseId,
$sessionId,
false,
$toUsers
);
$totalUsers = count($users);
$usersArray = [];
$courseTitle = '';
$quizTitle = '';
for ($i = 0; $i < $totalUsers; $i++) {
$user = $users[$i];
$userId = (int) $user['user_id'];
if (0 != $userId) {
$quizTitle = $user['quiz_title'];
$courseTitle = $user['title'];
if (!isset($usersArray[$userId])) {
$usersArray[$userId] = api_get_user_info($userId);
}
}
}
$objExerciseTmp = new Exercise();
$objExerciseTmp->read($exerciseId);
$isAddedInLp = !empty($objExerciseTmp->lpList);
$end = $objExerciseTmp->end_time;
$start = $objExerciseTmp->start_time;
$minutes = $objExerciseTmp->expired_time;
$formatDate = DATE_TIME_FORMAT_LONG;
$tblCourseUser = Database::get_main_table(TABLE_MAIN_COURSE_USER);
$tblSession = Database::get_main_table(TABLE_MAIN_SESSION);
$tblSessionUser = Database::get_main_table(TABLE_MAIN_SESSION_USER);
$tblSessionUserRelCourse = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
$teachersName = [];
$teachersPrint = [];
if (0 == $sessionId) {
$sql = "SELECT course_user.user_id AS user_id
FROM $tblCourseUser AS course_user
WHERE course_user.status = 1 AND course_user.c_id ='".$courseId."'";
$result = Database::query($sql);
$data = Database::store_result($result);
Database::free_result($result);
foreach ($data as $teacher) {
$teacherId = (int) $teacher['user_id'];
if (!isset($teachersName[$teacherId])) {
$teachersName[$teacherId] = api_get_user_info($teacherId);
}
$teacherData = $teachersName[$teacherId];
$teachersPrint[] = $teacherData['complete_name'];
}
} else {
// general tutor
$sql = "SELECT sesion.id_coach AS user_id
FROM $tblSession AS sesion
WHERE sesion.id = $sessionId";
$result = Database::query($sql);
$data = Database::store_result($result);
Database::free_result($result);
foreach ($data as $teacher) {
$teacherId = (int) $teacher['user_id'];
if (!isset($teachersName[$teacherId])) {
$teachersName[$teacherId] = api_get_user_info($teacherId);
}
$teacherData = $teachersName[$teacherId];
$teachersPrint[] = $teacherData['complete_name'];
}
// Teacher into sessions course
$sql = "SELECT session_rel_course_rel_user.user_id
FROM $tblSessionUserRelCourse AS session_rel_course_rel_user
WHERE session_rel_course_rel_user.session_id = $sessionId AND
session_rel_course_rel_user.c_id = $courseId AND
session_rel_course_rel_user.status = 2";
$result = Database::query($sql);
$data = Database::store_result($result);
Database::free_result($result);
foreach ($data as $teacher) {
$teacherId = (int) $teacher['user_id'];
if (!isset($teachersName[$teacherId])) {
$teachersName[$teacherId] = api_get_user_info($teacherId);
}
$teacherData = $teachersName[$teacherId];
$teachersPrint[] = $teacherData['complete_name'];
}
}
$teacherName = implode('<br>', $teachersPrint);
if ($isAddedInLp) {
$lpInfo = current($objExerciseTmp->lpList);
$url = api_get_path(WEB_CODE_PATH)."lp/lp_controller.php?".api_get_cidreq().'&'
.http_build_query(['action' => 'view', 'lp_id' => $lpInfo['lp_id']]);
} else {
$url = api_get_path(WEB_CODE_PATH)."exercise/overview.php?".api_get_cidreq()."&exerciseId=$exerciseId";
}
foreach ($usersArray as $userId => $userData) {
$studentName = $userData['complete_name'];
$title = sprintf(get_lang('QuizRemindSubject'), $teacherName);
$content = sprintf(
get_lang('QuizFirstRemindBody'),
$studentName,
$quizTitle,
$courseTitle,
$courseTitle,
$quizTitle
);
if (!empty($minutes)) {
$content .= sprintf(get_lang('QuizRemindDuration'), $minutes);
}
if (!empty($start)) {
// api_get_utc_datetime
$start = api_format_date(($start), $formatDate);
$content .= sprintf(get_lang('QuizRemindStartDate'), $start);
}
if (!empty($end)) {
$end = api_format_date(($end), $formatDate);
$content .= sprintf(get_lang('QuizRemindEndDate'), $end);
}
$content .= sprintf(
get_lang('QuizLastRemindBody'),
$url,
$url,
$teacherName
);
$drhList = UserManager::getDrhListFromUser($userId);
if (!empty($drhList)) {
foreach ($drhList as $drhUser) {
$drhUserData = api_get_user_info($drhUser['id']);
$drhName = $drhUserData['complete_name'];
$contentDHR = sprintf(
get_lang('QuizDhrRemindBody'),
$drhName,
$studentName,
$quizTitle,
$courseTitle,
$studentName,
$courseTitle,
$quizTitle
);
if (!empty($minutes)) {
$contentDHR .= sprintf(get_lang('QuizRemindDuration'), $minutes);
}
if (!empty($start)) {
// api_get_utc_datetime
$start = api_format_date(($start), $formatDate);
$contentDHR .= sprintf(get_lang('QuizRemindStartDate'), $start);
}
if (!empty($end)) {
$end = api_format_date(($end), $formatDate);
$contentDHR .= sprintf(get_lang('QuizRemindEndDate'), $end);
}
MessageManager::send_message(
$drhUser['id'],
$title,
$contentDHR
);
}
}
MessageManager::send_message(
$userData['id'],
$title,
$content
);
}
return $usersArray;
}
/**
* Returns true if the exercise is locked by percentage. an exercise attempt must be passed.
*/
public function isBlockedByPercentage(array $attempt = []): bool
{
if (empty($attempt)) {
return false;
}
$extraFieldValue = new ExtraFieldValue('exercise');
$blockExercise = $extraFieldValue->get_values_by_handler_and_field_variable(
$this->iid,
'blocking_percentage'
);
if (empty($blockExercise['value'])) {
return false;
}
$blockPercentage = (int) $blockExercise['value'];
if (0 === $blockPercentage) {
return false;
}
$resultPercentage = 0;
if (isset($attempt['exe_result']) && isset($attempt['exe_weighting'])) {
$weight = (int) $attempt['exe_weighting'];
$weight = (0 == $weight) ? 1 : $weight;
$resultPercentage = float_format(
($attempt['exe_result'] / $weight) * 100,
1
);
}
if ($resultPercentage <= $blockPercentage) {
return true;
}
return false;
}
/**
* Gets the question list ordered by the question_order setting (drag and drop).
*
* @param bool $adminView Optional.
*
* @return array
*/
public function getQuestionOrderedList($adminView = false)
{
$TBL_QUIZ_QUESTION = Database::get_course_table(TABLE_QUIZ_TEST_QUESTION);
$TBL_QUESTIONS = Database::get_course_table(TABLE_QUIZ_QUESTION);
// Getting question_order to verify that the question
// list is correct and all question_order's were set
$sql = "SELECT DISTINCT count(e.question_order) as count
FROM $TBL_QUIZ_QUESTION e
INNER JOIN $TBL_QUESTIONS q
ON e.question_id = q.iid
WHERE
e.c_id = {$this->course_id} AND
e.exercice_id = ".$this->iid;
$result = Database::query($sql);
$row = Database::fetch_array($result);
$count_question_orders = $row['count'];
// Getting question list from the order (question list drag n drop interface).
$sql = "SELECT DISTINCT e.question_id, e.question_order
FROM $TBL_QUIZ_QUESTION e
INNER JOIN $TBL_QUESTIONS q
ON e.question_id = q.iid
WHERE
e.c_id = {$this->course_id} AND
e.exercice_id = '".$this->iid."'
ORDER BY question_order";
$result = Database::query($sql);
// Fills the array with the question ID for this exercise
// the key of the array is the question position
$temp_question_list = [];
$counter = 1;
$questionList = [];
while ($new_object = Database::fetch_object($result)) {
if (!$adminView) {
// Correct order.
$questionList[$new_object->question_order] = $new_object->question_id;
} else {
$questionList[$counter] = $new_object->question_id;
}
// Just in case we save the order in other array
$temp_question_list[$counter] = $new_object->question_id;
$counter++;
}
if (!empty($temp_question_list)) {
/* If both array don't match it means that question_order was not correctly set
for all questions using the default mysql order */
if (count($temp_question_list) != $count_question_orders || count($temp_question_list) !== count($questionList)) {
$questionList = $temp_question_list;
}
}
return $questionList;
}
/**
* Returns a literal for the given numerical feedback type (usually
* coming from the DB or a constant). The literal is also the string
* used to get the translation, not the translation itself as it is
* more vulnerable to changes.
*/
public static function getFeedbackTypeLiteral(int $feedbackType): string
{
$feedbackType = (int) $feedbackType;
$result = '';
static $arrayFeedbackTypes = [
EXERCISE_FEEDBACK_TYPE_END => 'ExerciseAtTheEndOfTheTest',
EXERCISE_FEEDBACK_TYPE_DIRECT => 'DirectFeedback',
EXERCISE_FEEDBACK_TYPE_EXAM => 'NoFeedback',
EXERCISE_FEEDBACK_TYPE_POPUP => 'ExerciseDirectPopUp',
];
if (array_key_exists($feedbackType, $arrayFeedbackTypes)) {
$result = $arrayFeedbackTypes[$feedbackType];
}
return $result;
}
/**
* Return the text to display, based on the score and the max score.
*
* @param int|float $score
* @param int|float $maxScore
*/
public function getFinishText($score, $maxScore): string
{
if (true !== api_get_configuration_value('exercise_text_when_finished_failure')) {
return $this->getTextWhenFinished();
}
$passPercentage = $this->selectPassPercentage();
if (!empty($passPercentage)) {
$percentage = float_format(
($score / (0 != $maxScore ? $maxScore : 1)) * 100,
1
);
if ($percentage < $passPercentage) {
return $this->getTextWhenFinishedFailure();
}
}
return $this->getTextWhenFinished();
}
/**
* Get number of questions in exercise by user attempt.
*
* @return int
*/
private function countQuestionsInExercise()
{
$lpId = isset($_REQUEST['learnpath_id']) ? (int) $_REQUEST['learnpath_id'] : 0;
$lpItemId = isset($_REQUEST['learnpath_item_id']) ? (int) $_REQUEST['learnpath_item_id'] : 0;
$lpItemViewId = isset($_REQUEST['learnpath_item_view_id']) ? (int) $_REQUEST['learnpath_item_view_id'] : 0;
$trackInfo = $this->get_stat_track_exercise_info($lpId, $lpItemId, $lpItemViewId);
if (!empty($trackInfo)) {
$questionIds = explode(',', $trackInfo['data_tracking']);
return count($questionIds);
}
return $this->getQuestionCount();
}
/**
* Select N values from the questions per category array.
*
* @param array $categoriesAddedInExercise
* @param array $question_list
* @param array $questions_by_category
* @param bool $flatResult
* @param bool $randomizeQuestions
* @param array $questionsByCategoryMandatory
*
* @return array
*/
private function pickQuestionsPerCategory(
$categoriesAddedInExercise,
$question_list,
&$questions_by_category,
$flatResult = true,
$randomizeQuestions = false,
$questionsByCategoryMandatory = []
) {
$addAll = true;
$categoryCountArray = [];
// Getting how many questions will be selected per category.
if (!empty($categoriesAddedInExercise)) {
$addAll = false;
// Parsing question according the category rel exercise settings
foreach ($categoriesAddedInExercise as $category_info) {
$category_id = $category_info['category_id'];
if (isset($questions_by_category[$category_id])) {
// How many question will be picked from this category.
$count = $category_info['count_questions'];
// -1 means all questions
$categoryCountArray[$category_id] = $count;
if (-1 == $count) {
$categoryCountArray[$category_id] = 999;
}
}
}
}
if (!empty($questions_by_category)) {
$temp_question_list = [];
foreach ($questions_by_category as $category_id => &$categoryQuestionList) {
if (isset($categoryCountArray) && !empty($categoryCountArray)) {
$numberOfQuestions = 0;
if (isset($categoryCountArray[$category_id])) {
$numberOfQuestions = $categoryCountArray[$category_id];
}
}
if ($addAll) {
$numberOfQuestions = 999;
}
if (!empty($numberOfQuestions)) {
$mandatoryQuestions = [];
if (isset($questionsByCategoryMandatory[$category_id])) {
$mandatoryQuestions = $questionsByCategoryMandatory[$category_id];
}
$elements = TestCategory::getNElementsFromArray(
$categoryQuestionList,
$numberOfQuestions,
$randomizeQuestions,
$mandatoryQuestions
);
if (!empty($elements)) {
$temp_question_list[$category_id] = $elements;
$categoryQuestionList = $elements;
}
}
}
if (!empty($temp_question_list)) {
if ($flatResult) {
$temp_question_list = array_flatten($temp_question_list);
}
$question_list = $temp_question_list;
}
}
return $question_list;
}
/**
* Changes the exercise id.
*
* @param int $id - exercise id
*/
private function updateId($id)
{
$this->iid = $id;
}
/**
* Sends a notification when a user ends an examn.
*
* @param array $question_list_answers
* @param string $origin
* @param array $user_info
* @param string $url_email
* @param array $teachers
*/
private function sendNotificationForOpenQuestions(
$question_list_answers,
$origin,
$user_info,
$url_email,
$teachers
) {
// Email configuration settings
$courseCode = api_get_course_id();
$courseInfo = api_get_course_info($courseCode);
$sessionId = api_get_session_id();
$sessionData = '';
if (!empty($sessionId)) {
$sessionInfo = api_get_session_info($sessionId);
if (!empty($sessionInfo)) {
$sessionData = '<tr>'
.'<td><em>'.get_lang('SessionName').'</em></td>'
.'<td> <b>'.$sessionInfo['name'].'</b></td>'
.'</tr>';
}
}
$msg = get_lang('OpenQuestionsAttempted').'<br /><br />'
.get_lang('AttemptDetails').' : <br /><br />'
.'<table>'
.'<tr>'
.'<td><em>'.get_lang('CourseName').'</em></td>'
.'<td> <b>#course#</b></td>'
.'</tr>'
.$sessionData
.'<tr>'
.'<td>'.get_lang('TestAttempted').'</td>'
.'<td> #exercise#</td>'
.'</tr>'
.'<tr>'
.'<td>'.get_lang('StudentName').'</td>'
.'<td> #firstName# #lastName#</td>'
.'</tr>'
.'<tr>'
.'<td>'.get_lang('StudentEmail').'</td>'
.'<td> #mail#</td>'
.'</tr>'
.'</table>';
$open_question_list = null;
foreach ($question_list_answers as $item) {
$question = $item['question'];
$answer = $item['answer'];
$answer_type = $item['answer_type'];
if (!empty($question) && !empty($answer) && $answer_type == FREE_ANSWER) {
$open_question_list .=
'<tr>'
.'<td width="220" valign="top" bgcolor="#E5EDF8"> '.get_lang('Question').'</td>'
.'<td width="473" valign="top" bgcolor="#F3F3F3">'.$question.'</td>'
.'</tr>'
.'<tr>'
.'<td width="220" valign="top" bgcolor="#E5EDF8"> '.get_lang('Answer').'</td>'
.'<td valign="top" bgcolor="#F3F3F3">'.$answer.'</td>'
.'</tr>';
}
}
if (!empty($open_question_list)) {
$msg .= '<p><br />'.get_lang('OpenQuestionsAttemptedAre').' :</p>'.
'<table width="730" height="136" border="0" cellpadding="3" cellspacing="3">';
$msg .= $open_question_list;
$msg .= '</table><br />';
$msg = str_replace('#exercise#', $this->exercise, $msg);
$msg = str_replace('#firstName#', $user_info['firstname'], $msg);
$msg = str_replace('#lastName#', $user_info['lastname'], $msg);
$msg = str_replace('#mail#', $user_info['email'], $msg);
$msg = str_replace(
'#course#',
Display::url($courseInfo['title'], $courseInfo['course_public_url'].'?id_session='.$sessionId),
$msg
);
if ($origin != 'learnpath') {
$msg .= '<br /><a href="#url#">'.get_lang('ClickToCommentAndGiveFeedback').'</a>';
}
$msg = str_replace('#url#', $url_email, $msg);
$subject = get_lang('OpenQuestionsAttempted');
if (!empty($teachers)) {
foreach ($teachers as $user_id => $teacher_data) {
MessageManager::send_message_simple(
$user_id,
$subject,
$msg
);
}
}
}
}
/**
* Send notification for oral questions.
*
* @param array $question_list_answers
* @param string $origin
* @param int $exe_id
* @param array $user_info
* @param string $url_email
* @param array $teachers
*/
private function sendNotificationForOralQuestions(
$question_list_answers,
$origin,
$exe_id,
$user_info,
$url_email,
$teachers
) {
// Email configuration settings
$courseCode = api_get_course_id();
$courseInfo = api_get_course_info($courseCode);
$oral_question_list = null;
foreach ($question_list_answers as $item) {
$question = $item['question'];
$file = $item['generated_oral_file'];
$answer = $item['answer'];
if (0 == $answer) {
$answer = '';
}
$answer_type = $item['answer_type'];
if (!empty($question) && (!empty($answer) || !empty($file)) && $answer_type == ORAL_EXPRESSION) {
if (!empty($file)) {
$file = Display::url($file, $file);
}
$oral_question_list .= '<br />
<table width="730" height="136" border="0" cellpadding="3" cellspacing="3">
<tr>
<td width="220" valign="top" bgcolor="#E5EDF8"> '.get_lang('Question').'</td>
<td width="473" valign="top" bgcolor="#F3F3F3">'.$question.'</td>
</tr>
<tr>
<td width="220" valign="top" bgcolor="#E5EDF8"> '.get_lang('Answer').'</td>
<td valign="top" bgcolor="#F3F3F3">'.$answer.$file.'</td>
</tr></table>';
}
}
if (!empty($oral_question_list)) {
$msg = get_lang('OralQuestionsAttempted').'<br /><br />
'.get_lang('AttemptDetails').' : <br /><br />
<table>
<tr>
<td><em>'.get_lang('CourseName').'</em></td>
<td> <b>#course#</b></td>
</tr>
<tr>
<td>'.get_lang('TestAttempted').'</td>
<td> #exercise#</td>
</tr>
<tr>
<td>'.get_lang('StudentName').'</td>
<td> #firstName# #lastName#</td>
</tr>
<tr>
<td>'.get_lang('StudentEmail').'</td>
<td> #mail#</td>
</tr>
</table>';
$msg .= '<br />'.sprintf(get_lang('OralQuestionsAttemptedAreX'), $oral_question_list).'<br />';
$msg1 = str_replace("#exercise#", $this->exercise, $msg);
$msg = str_replace("#firstName#", $user_info['firstname'], $msg1);
$msg1 = str_replace("#lastName#", $user_info['lastname'], $msg);
$msg = str_replace("#mail#", $user_info['email'], $msg1);
$msg = str_replace("#course#", $courseInfo['name'], $msg1);
if (!in_array($origin, ['learnpath', 'embeddable', 'iframe'])) {
$msg .= '<br /><a href="#url#">'.get_lang('ClickToCommentAndGiveFeedback').'</a>';
}
$msg1 = str_replace("#url#", $url_email, $msg);
$mail_content = $msg1;
$subject = get_lang('OralQuestionsAttempted');
if (!empty($teachers)) {
foreach ($teachers as $user_id => $teacher_data) {
MessageManager::send_message_simple(
$user_id,
$subject,
$mail_content
);
}
}
}
}
/**
* Returns an array with the media list.
*
* @param array question list
*
* @example there's 1 question with iid 5 that belongs to the media question with iid = 100
* <code>
* array (size=2)
* 999 =>
* array (size=3)
* 0 => int 7
* 1 => int 6
* 2 => int 3254
* 100 =>
* array (size=1)
* 0 => int 5
* </code>
*/
private function setMediaList($questionList)
{
$mediaList = [];
/*
* Media feature is not activated in 1.11.x
if (!empty($questionList)) {
foreach ($questionList as $questionId) {
$objQuestionTmp = Question::read($questionId, $this->course_id);
// If a media question exists
if (isset($objQuestionTmp->parent_id) && $objQuestionTmp->parent_id != 0) {
$mediaList[$objQuestionTmp->parent_id][] = $objQuestionTmp->iid;
} else {
// Always the last item
$mediaList[999][] = $objQuestionTmp->iid;
}
}
}*/
$this->mediaList = $mediaList;
}
/**
* Returns the part of the form for the disabled results option.
*
* @return HTML_QuickForm_group
*/
private function setResultDisabledGroup(FormValidator $form)
{
$resultDisabledGroup = [];
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('ShowScoreAndRightAnswer'),
RESULT_DISABLE_SHOW_SCORE_AND_EXPECTED_ANSWERS,
['id' => 'result_disabled_0']
);
$warning = sprintf(
get_lang('TheSettingXWillChangeToX'),
get_lang('FeedbackType'),
get_lang('NoFeedback')
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('DoNotShowScoreNorRightAnswer'),
RESULT_DISABLE_NO_SCORE_AND_EXPECTED_ANSWERS,
[
'id' => 'result_disabled_1',
//'onclick' => 'check_results_disabled()'
'onclick' => 'javascript:if(confirm('."'".addslashes($warning)."'".')) { check_results_disabled(); } else { return false;} ',
]
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('OnlyShowScore'),
RESULT_DISABLE_SHOW_SCORE_ONLY,
[
'id' => 'result_disabled_2',
//'onclick' => 'check_results_disabled()'
'onclick' => 'javascript:if(confirm('."'".addslashes($warning)."'".')) { check_results_disabled(); } else { return false;} ',
]
);
if (in_array($this->getFeedbackType(), [EXERCISE_FEEDBACK_TYPE_DIRECT, EXERCISE_FEEDBACK_TYPE_POPUP])) {
return $form->addGroup(
$resultDisabledGroup,
null,
get_lang('ShowResultsToStudents')
);
}
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('ShowScoreEveryAttemptShowAnswersLastAttempt'),
RESULT_DISABLE_SHOW_SCORE_ATTEMPT_SHOW_ANSWERS_LAST_ATTEMPT,
['id' => 'result_disabled_4']
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('DontShowScoreOnlyWhenUserFinishesAllAttemptsButShowFeedbackEachAttempt'),
RESULT_DISABLE_DONT_SHOW_SCORE_ONLY_IF_USER_FINISHES_ATTEMPTS_SHOW_ALWAYS_FEEDBACK,
[
'id' => 'result_disabled_5',
//'onclick' => 'check_results_disabled()'
'onclick' => 'javascript:if(confirm('."'".addslashes($warning)."'".')) { check_results_disabled(); } else { return false;} ',
]
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('ExerciseRankingMode'),
RESULT_DISABLE_RANKING,
['id' => 'result_disabled_6']
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('ExerciseShowOnlyGlobalScoreAndCorrectAnswers'),
RESULT_DISABLE_SHOW_ONLY_IN_CORRECT_ANSWER,
['id' => 'result_disabled_7']
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('ExerciseAutoEvaluationAndRankingMode'),
RESULT_DISABLE_SHOW_SCORE_AND_EXPECTED_ANSWERS_AND_RANKING,
['id' => 'result_disabled_8']
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('ExerciseCategoriesRadarMode'),
RESULT_DISABLE_RADAR,
['id' => 'result_disabled_9']
);
$resultDisabledGroup[] = $form->createElement(
'radio',
'results_disabled',
null,
get_lang('ShowScoreEveryAttemptShowAnswersLastAttemptNoFeedback'),
RESULT_DISABLE_SHOW_SCORE_ATTEMPT_SHOW_ANSWERS_LAST_ATTEMPT_NO_FEEDBACK,
['id' => 'result_disabled_10']
);
return $form->addGroup(
$resultDisabledGroup,
null,
get_lang('ShowResultsToStudents')
);
}
}
Zerion Mini Shell 1.0