/**
* Update the flag state of a question attempt.
*
* @param int $qubaid the question usage id.
* @param int $questionid the question id.
* @param int $qaid the question_attempt id.
* @param int $slot the slot number within the usage.
* @param string $checksum checksum, as computed by {@link get_toggle_checksum()}
* corresponding to the last three arguments and the users username.
* @param bool $newstate the new state of the flag. true = flagged.
* @return array (success infos and fail infos)
* @since Moodle 3.1
*/
public static function update_flag($qubaid, $questionid, $qaid, $slot, $checksum, $newstate)
{
global $CFG, $DB;
$params = self::validate_parameters(self::update_flag_parameters(), array('qubaid' => $qubaid, 'questionid' => $questionid, 'qaid' => $qaid, 'slot' => $slot, 'checksum' => $checksum, 'newstate' => $newstate));
$warnings = array();
self::validate_context(context_system::instance());
// The checksum will be checked to provide security flagging other users questions.
question_flags::update_flag($params['qubaid'], $params['questionid'], $params['qaid'], $params['slot'], $params['checksum'], $params['newstate']);
$result = array();
$result['status'] = true;
$result['warnings'] = $warnings;
return $result;
}
/**
* Update the flag state of a question attempt.
*
* @param int $qubaid the question usage id.
* @param int $questionid the question id.
* @param int $qaid the question_attempt id.
* @param int $slot the slot number within the usage.
* @param string $checksum checksum, as computed by {@link get_toggle_checksum()}
* corresponding to the last three arguments and the users username.
* @param bool $newstate the new state of the flag. true = flagged.
* @return array (success infos and fail infos)
* @since Moodle 3.1
*/
public static function update_flag($qubaid, $questionid, $qaid, $slot, $checksum, $newstate)
{
global $CFG, $DB;
$params = self::validate_parameters(self::update_flag_parameters(), array('qubaid' => $qubaid, 'questionid' => $questionid, 'qaid' => $qaid, 'slot' => $slot, 'checksum' => $checksum, 'newstate' => $newstate));
$warnings = array();
// Check user is logged in.
require_login(null, false, null, false, true);
// The checksum will be checked to provide security flagging other users questions.
question_flags::update_flag($params['qubaid'], $params['questionid'], $params['qaid'], $params['slot'], $params['checksum'], $params['newstate']);
$result = array();
$result['status'] = true;
$result['warnings'] = $warnings;
return $result;
}
// 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/>.
/**
* Used by ajax calls to toggle the flagged state of a question in an attempt.
*
* @package moodlecore
* @subpackage questionengine
* @copyright 2009 The Open University
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
define('AJAX_SCRIPT', true);
require_once '../config.php';
require_once $CFG->dirroot . '/question/engine/lib.php';
// Parameters
$qaid = required_param('qaid', PARAM_INT);
$qubaid = required_param('qubaid', PARAM_INT);
$questionid = required_param('qid', PARAM_INT);
$slot = required_param('slot', PARAM_INT);
$newstate = required_param('newstate', PARAM_BOOL);
$checksum = required_param('checksum', PARAM_ALPHANUM);
// Check user is logged in.
require_login();
require_sesskey();
// Check that the requested session really exists
question_flags::update_flag($qubaid, $questionid, $qaid, $slot, $checksum, $newstate);
echo 'OK';
