AutorÃa | Ultima modificación | Ver Log |
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
/**
* The mod_hvp content user data.
*
* @package mod_hvp
* @since Moodle 2.7
* @copyright 2017 Joubel AS
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
namespace mod_hvp;
defined('MOODLE_INTERNAL') || die();
/**
* Class xapi_result handles xapi results and corresponding db operations.
*
* @package mod_hvp
*/
class xapi_result {
/**
* Handle xapi results endpoint
*/
public static function handle_ajax() {
// Validate token.
if (!self::validate_token()) {
$core = framework::instance();
\H5PCore::ajaxError($core->h5pF->t('Invalid security token.'),
'INVALID_TOKEN');
return;
}
$cm = get_coursemodule_from_id('hvp', required_param('contextId', PARAM_INT));
if (!$cm) {
\H5PCore::ajaxError('No such content');
http_response_code(404);
return;
}
$xapiresult = required_param('xAPIResult', PARAM_RAW);
// Validate.
$context = \context_module::instance($cm->id);
if (!has_capability('mod/hvp:saveresults', $context)) {
\H5PCore::ajaxError(get_string('nopermissiontosaveresult', 'hvp'));
return;
}
$xapijson = json_decode($xapiresult);
if (!$xapijson) {
\H5PCore::ajaxError('Invalid json in xAPI data.');
return;
}
if (!self::validate_xapi_data($xapijson)) {
\H5PCore::ajaxError('Invalid xAPI data.');
return;
}
// Delete any old results.
self::remove_xapi_data($cm->instance);
// Store results.
self::store_xapi_data($cm->instance, $xapijson);
// Successfully inserted xAPI result.
\H5PCore::ajaxSuccess();
}
/**
* Validate xAPI results token
*
* @return bool True if token was valid
*/
private static function validate_token() {
$token = required_param('token', PARAM_ALPHANUM);
return \H5PCore::validToken('xapiresult', $token);
}
/**
* Validate xAPI data
*
* @param object $xapidata xAPI data
*
* @return bool True if valid data
*/
private static function validate_xapi_data($xapidata) {
$xapidata = new \H5PReportXAPIData($xapidata);
return $xapidata->validateData();
}
/**
* Store xAPI result(s)
*
* @param int $contentid Content id
* @param object $xapidata xAPI data
* @param int $parentid Parent id
*/
private static function store_xapi_data($contentid, $xapidata, $parentid = null) {
global $DB, $USER;
$xapidata = new \H5PReportXAPIData($xapidata, $parentid);
$insertedid = $DB->insert_record('hvp_xapi_results', (object) array(
'content_id' => $contentid,
'user_id' => $USER->id,
'parent_id' => $xapidata->getParentID(),
'interaction_type' => $xapidata->getInteractionType(),
'description' => $xapidata->getDescription(),
'correct_responses_pattern' => $xapidata->getCorrectResponsesPattern(),
'response' => $xapidata->getResponse(),
'additionals' => $xapidata->getAdditionals(),
'raw_score' => $xapidata->getScoreRaw(),
'max_score' => $xapidata->getScoreMax(),
));
// Save sub content statements data.
if ($xapidata->isCompound()) {
foreach ($xapidata->getChildren($contentid) as $child) {
self::store_xapi_data($contentid, $child, $insertedid);
}
}
}
/**
* Remove xAPI result(s)
*
* @param int $contentid Content id
*/
private static function remove_xapi_data($contentid) {
global $DB, $USER;
$DB->delete_records('hvp_xapi_results', array(
'content_id' => $contentid,
'user_id' => $USER->id
));
}
}