@ -27,28 +27,31 @@ require_once 'aiccItem.class.php';
/**
* Writes an item's new values into the database and returns the operation result
* @param integer Learnpath ID
* @param integer User ID
* @param integer View ID
* @param integer Item ID
* @param double Current score
* @param double Maximum score
* @param double Minimum score
* @param string Lesson status
* @param string Session time
* @param string Suspend data
* @param string Lesson location
* @param array Interactions array
* @param string Core exit SCORM string
* @param int $lp_id Learnpath ID
* @param int $user_id User ID
* @param int $view_id View ID
* @param int $item_id Item ID
* @param float $score Current score
* @param float $max Maximum score
* @param float $min Minimum score
* @param string $status Lesson status
* @param int $time Session time
* @param string $suspend Suspend data
* @param string $location Lesson location
* @param array $interactions Interactions array
* @param string $core_exit Core exit SCORM string
* @param int $lmsFinish Whether the call was issued from SCORM's LMSFinish()
* @param int $userNavigatesAway Whether the user is moving to another item
* @return bool|null|string The resulting JS string
*/
function save_item(
$lp_id,
$user_id,
$view_id,
$item_id,
$score = -1,
$max = -1,
$min = -1,
$score = -1.0 ,
$max = -1.0 ,
$min = -1.0 ,
$status = '',
$time = 0,
$suspend = '',
@ -56,9 +59,13 @@ function save_item(
$interactions = array(),
$core_exit = 'none',
$sessionId = null,
$courseId = null
$courseId = null,
$lmsFinish = 0,
$userNavigatesAway = 0,
$statusSignalReceived = 0
) {
global $debug;
//global $debug;
$debug = 0;
$return = null;
if ($debug > 0) {
@ -66,6 +73,7 @@ function save_item(
error_log("item_id: $item_id");
error_log("lp_id: $lp_id - user_id: - $user_id - view_id: $view_id - item_id: $item_id");
error_log("score: $score - max:$max - min: $min - status:$status - time:$time - suspend: $suspend - location: $location - core_exit: $core_exit");
error_log("finish: $lmsFinish - navigatesAway: $userNavigatesAway");
}
$mylp = learnpath::getLpFromSession(api_get_course_id(), $lp_id, $user_id);
@ -87,7 +95,6 @@ function save_item(
if ($debug > 0) {
error_log("item #$item_id not found in the items array: ".print_r($mylp->items, 1));
}
return false;
}
@ -100,7 +107,6 @@ function save_item(
if ($debug) {
error_log("prereq_check: ".intval($prereq_check));
}
return $return;
} else {
if ($debug > 1) { error_log('Prerequisites are OK'); }
@ -116,7 +122,7 @@ function save_item(
if ($debug > 1) { error_log("Setting min_score: $min"); }
}
// set_score function already saves the status
// set_score function used to save the status, but this is not the case anymore
if (isset($score) & & $score != -1) {
if ($debug > 1) { error_log('Calling set_score('.$score.')', 0); }
if ($debug > 1) { error_log('set_score changes the status to failed/passed if mastery score is provided', 0); }
@ -128,34 +134,180 @@ function save_item(
if ($debug > 1) { error_log("Score not updated"); }
}
$statusIsSet = false;
// Default behaviour.
if (isset($status) & & $status != '' & & $status != 'undefined') {
if ($debug > 1) { error_log('Calling set_status('.$status.')', 0); }
$mylpi->set_status($status);
$statusIsSet = true;
if ($debug > 1) { error_log('Done calling set_status: checking from memory: '.$mylpi->get_status(false), 0); }
} else {
if ($debug > 1) { error_log("Status not updated"); }
}
// Hack to set status to completed for hotpotatoes if score > 80%.
$my_type = $mylpi->get_type();
// Set status to completed for hotpotatoes if score > 80%.
if ($my_type == 'hotpotatoes') {
if ((empty($status) || $status == 'undefined' || $status == 'not attempted') & & $max > 0) {
if (($score/$max) > 0.8) {
$mystatus = 'completed';
if ($debug > 1) { error_log('Calling set_status('.$mystatus.') for hotpotatoes', 0); }
$mylpi->set_status($mystatus);
$statusIsSet = true;
if ($debug > 1) { error_log('Done calling set_status for hotpotatoes - now '.$mylpi->get_status(false), 0); }
}
} elseif ($status == 'completed' & & $max > 0 & & ($score/$max) < 0.8 ) {
$mystatus = 'failed';
if ($debug > 1) { error_log('Calling set_status('.$mystatus.') for hotpotatoes', 0); }
$mylpi->set_status($mystatus);
$statusIsSet = true;
if ($debug > 1) { error_log('Done calling set_status for hotpotatoes - now '.$mylpi->get_status(false), 0); }
}
} elseif ($my_type == 'sco') {
/*
* This is a specific implementation for SCORM 1.2, matching page 26 of SCORM 1.2's RTE
* "Normally the SCO determines its own status and passes it to the LMS.
* 1) If cmi.core.credit is set to “credit” and there is a mastery
* score in the manifest (adlcp:masteryscore), the LMS can change
* the status to either passed or failed depending on the
* student's score compared to the mastery score.
* 2) If there is no mastery score in the manifest
* (adlcp:masteryscore), the LMS cannot override SCO
* determined status.
* 3) If the student is taking the SCO for no-credit, there is no
* change to the lesson_status, with one exception. If the
* lesson_mode is "browse", the lesson_status may change to
* "browsed" even if the cmi.core.credit is set to no-credit.
* "
* Additionally, the LMS behaviour should be:
* If a SCO sets the cmi.core.lesson_status then there is no problem.
* However, the SCORM does not force the SCO to set the cmi.core.lesson_status.
* There is some additional requirements that must be adhered to
* successfully handle these cases:
* Upon initial launch
* the LMS should set the cmi.core.lesson_status to “not attempted”.
* Upon receiving the LMSFinish() call or the user navigates away,
* the LMS should set the cmi.core.lesson_status for the SCO to “completed”.
* After setting the cmi.core.lesson_status to “completed”,
* the LMS should now check to see if a Mastery Score has been
* specified in the cmi.student_data.mastery_score, if supported,
* or the manifest that the SCO is a member of.
* If a Mastery Score is provided and the SCO did set the
* cmi.core.score.raw, the LMS shall compare the cmi.core.score.raw
* to the Mastery Score and set the cmi.core.lesson_status to
* either “passed” or “failed”. If no Mastery Score is provided,
* the LMS will leave the cmi.core.lesson_status as “completed”
*/
$masteryScore = $mylpi->get_mastery_score();
if ($masteryScore == -1 or empty($masteryScore)) {
$masteryScore = false;
}
$credit = $mylpi->get_credit();
/**
* 1) If cmi.core.credit is set to “credit” and there is a mastery
* score in the manifest (adlcp:masteryscore), the LMS can change
* the status to either passed or failed depending on the
* student's score compared to the mastery score.
*/
if ($credit == 'credit' & & $masteryScore & & (isset($score) & & $score != -1) & & !$statusIsSet & & !$statusSignalReceived) {
if ($score >= $masteryScore) {
$mylpi->set_status('passed');
} else {
$mylpi->set_status('failed');
}
$statusIsSet = true;
}
/**
* 2) If there is no mastery score in the manifest
* (adlcp:masteryscore), the LMS cannot override SCO
* determined status.
*/
if (!$statusIsSet & & !$masteryScore & & !$statusSignalReceived) {
if (!empty($status)) {
$mylpi->set_status($status);
$statusIsSet = true;
}
//if no status was set directly, we keep the previous one
}
/**
* 3) If the student is taking the SCO for no-credit, there is no
* change to the lesson_status, with one exception. If the
* lesson_mode is "browse", the lesson_status may change to
* "browsed" even if the cmi.core.credit is set to no-credit.
*/
if (!$statusIsSet & & $credit == 'no-credit' & & !$statusSignalReceived) {
$mode = $mylpi->get_lesson_mode();
if ($mode == 'browse' & & $status == 'browsed') {
$mylpi->set_status($status);
$statusIsSet = true;
}
//if no status was set directly, we keep the previous one
}
/**
* If a SCO sets the cmi.core.lesson_status then there is no problem.
* However, the SCORM does not force the SCO to set the
* cmi.core.lesson_status. There is some additional requirements
* that must be adhered to successfully handle these cases:
*/
if (!$statusIsSet & & empty($status) & & !$statusSignalReceived) {
/**
* Upon initial launch the LMS should set the
* cmi.core.lesson_status to “not attempted”.
*/
// this case should be handled by LMSInitialize() and xajax_switch_item()
/**
* Upon receiving the LMSFinish() call or the user navigates
* away, the LMS should set the cmi.core.lesson_status for the
* SCO to “completed”.
*/
if ($lmsFinish or $userNavigatesAway) {
$myStatus = 'completed';
/**
* After setting the cmi.core.lesson_status to “completed”,
* the LMS should now check to see if a Mastery Score has been
* specified in the cmi.student_data.mastery_score, if supported,
* or the manifest that the SCO is a member of.
* If a Mastery Score is provided and the SCO did set the
* cmi.core.score.raw, the LMS shall compare the cmi.core.score.raw
* to the Mastery Score and set the cmi.core.lesson_status to
* either “passed” or “failed”. If no Mastery Score is provided,
* the LMS will leave the cmi.core.lesson_status as “completed”
*/
if ($masteryScore & & (isset($score) & & $score != -1)) {
if ($score >= $masteryScore) {
$myStatus = 'passed';
} else {
$myStatus = 'failed';
}
}
$mylpi->set_status($myStatus);
$statusIsSet = true;
}
}
// End of type=='sco'
}
// If no previous condition changed the SCO status, proceed with a
// generic behaviour
if (!$statusIsSet & & !$statusSignalReceived) {
// Default behaviour
if (isset($status) & & $status != '' & & $status != 'undefined') {
if ($debug > 1) {
error_log('Calling set_status('.$status.')', 0);
}
$mylpi->set_status($status);
if ($debug > 1) {
error_log('Done calling set_status: checking from memory: '.$mylpi->get_status(false), 0);
}
} else {
if ($debug > 1) {
error_log("Status not updated");
}
}
}
if (isset($time) & & $time != '' & & $time != 'undefined') {
@ -303,7 +455,9 @@ echo save_item(
(!empty($_REQUEST['loc'])?$_REQUEST['loc']:null),
$interactions,
(!empty($_REQUEST['core_exit'])?$_REQUEST['core_exit']:''),
'',
(!empty($_REQUEST['session_id'])?$_REQUEST['session_id']:''),
(!empty($_REQUEST['course_id'])?$_REQUEST['course_id']:'')
(!empty($_REQUEST['course_id'])?$_REQUEST['course_id']:''),
(empty($_REQUEST['finish'])?0:1),
(empty($_REQUEST['userNavigatesAway'])?0:1),
(empty($_REQUEST['statusSignalReceived'])?0:1)
);