You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
454 lines
16 KiB
454 lines
16 KiB
<?PHP
|
|
|
|
/// Library of functions and constants for module attforblock
|
|
|
|
/**
|
|
* Returns the information if the module supports a feature
|
|
*
|
|
* @see plugin_supports() in lib/moodlelib.php
|
|
* @param string $feature FEATURE_xx constant for requested feature
|
|
* @return mixed true if the feature is supported, null if unknown
|
|
*/
|
|
function attforblock_supports($feature) {
|
|
switch($feature) {
|
|
case FEATURE_GRADE_HAS_GRADE: return true;
|
|
case FEATURE_GROUPS: return true;
|
|
// Artem Andreev: AFAIK it's not tested
|
|
// we need implement filtration of groups list by grouping
|
|
case FEATURE_GROUPINGS: return false;
|
|
// Artem Andreev: AFAIK it's not tested
|
|
// harder "All courses" report
|
|
case FEATURE_GROUPMEMBERSONLY: return false;
|
|
case FEATURE_MOD_INTRO: return false;
|
|
case FEATURE_BACKUP_MOODLE2: return true;
|
|
// Artem Andreev: AFAIK it's not tested
|
|
case FEATURE_COMPLETION_TRACKS_VIEWS:
|
|
return false;
|
|
default: return null;
|
|
}
|
|
}
|
|
|
|
function attforblock_add_instance($attforblock) {
|
|
/// Given an object containing all the necessary data,
|
|
/// (defined by the form in mod.html) this function
|
|
/// will create a new instance and return the id number
|
|
/// of the new instance.
|
|
|
|
global $DB;
|
|
|
|
$attforblock->timemodified = time();
|
|
|
|
$attforblock->id = $DB->insert_record('attforblock', $attforblock);
|
|
|
|
$statuses = $DB->get_records('attendance_statuses', array('attendanceid'=> 0), 'id');
|
|
foreach($statuses as $st) {
|
|
$rec = $st;
|
|
$rec->attendanceid = $attforblock->id;
|
|
$DB->insert_record('attendance_statuses', $rec);
|
|
}
|
|
|
|
attforblock_grade_item_update($attforblock);
|
|
// attforblock_update_grades($attforblock);
|
|
return $attforblock->id;
|
|
}
|
|
|
|
|
|
function attforblock_update_instance($attforblock) {
|
|
/// Given an object containing all the necessary data,
|
|
/// (defined by the form in mod.html) this function
|
|
/// will update an existing instance with new data.
|
|
|
|
global $DB;
|
|
|
|
$attforblock->timemodified = time();
|
|
$attforblock->id = $attforblock->instance;
|
|
|
|
if (! $DB->update_record('attforblock', $attforblock)) {
|
|
return false;
|
|
}
|
|
|
|
attforblock_grade_item_update($attforblock);
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
function attforblock_delete_instance($id) {
|
|
global $DB;
|
|
|
|
if (! $attforblock = $DB->get_record('attforblock', array('id'=> $id))) {
|
|
return false;
|
|
}
|
|
|
|
if ($sessids = array_keys($DB->get_records('attendance_sessions', array('attendanceid'=> $id), '', 'id'))) {
|
|
$DB->delete_records_list('attendance_log', 'sessionid', $sessids);
|
|
$DB->delete_records('attendance_sessions', array('attendanceid'=> $id));
|
|
}
|
|
$DB->delete_records('attendance_statuses', array('attendanceid'=> $id));
|
|
|
|
$DB->delete_records('attforblock', array('id'=> $id));
|
|
|
|
attforblock_grade_item_delete($attforblock);
|
|
|
|
return true;
|
|
}
|
|
|
|
function attforblock_delete_course($course, $feedback=true){
|
|
global $DB;
|
|
|
|
$attids = array_keys($DB->get_records('attforblock', array('course'=> $course->id), '', 'id'));
|
|
$sessids = array_keys($DB->get_records_list('attendance_sessions', 'attendanceid', $attids, '', 'id'));
|
|
if ($sessids)
|
|
$DB->delete_records_list('attendance_log', 'sessionid', $sessids);
|
|
if ($attids) {
|
|
$DB->delete_records_list('attendance_statuses', 'attendanceid', $attids);
|
|
$DB->delete_records_list('attendance_sessions', 'attendanceid', $attids);
|
|
}
|
|
$DB->delete_records('attforblock', array('course'=> $course->id));
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Called by course/reset.php
|
|
* @param $mform form passed by reference
|
|
*/
|
|
function attforblock_reset_course_form_definition(&$mform) {
|
|
$mform->addElement('header', 'attendanceheader', get_string('modulename', 'attforblock'));
|
|
|
|
$mform->addElement('static', 'description', get_string('description', 'attforblock'),
|
|
get_string('resetdescription', 'attforblock'));
|
|
$mform->addElement('checkbox', 'reset_attendance_log', get_string('deletelogs','attforblock'));
|
|
|
|
$mform->addElement('checkbox', 'reset_attendance_sessions', get_string('deletesessions','attforblock'));
|
|
$mform->disabledIf('reset_attendance_sessions', 'reset_attendance_log', 'notchecked');
|
|
|
|
$mform->addElement('checkbox', 'reset_attendance_statuses', get_string('resetstatuses','attforblock'));
|
|
$mform->setAdvanced('reset_attendance_statuses');
|
|
$mform->disabledIf('reset_attendance_statuses', 'reset_attendance_log', 'notchecked');
|
|
}
|
|
|
|
/**
|
|
* Course reset form defaults.
|
|
*/
|
|
function attforblock_reset_course_form_defaults($course) {
|
|
return array('reset_attendance_log'=>0, 'reset_attendance_statuses'=>0, 'reset_attendance_sessions'=>0);
|
|
}
|
|
|
|
function attforblock_reset_userdata($data) {
|
|
global $DB;
|
|
|
|
if (!empty($data->reset_attendance_log)) {
|
|
$sess = $DB->get_records('attendance_sessions', array('courseid'=> $data->courseid), '', 'id');
|
|
$slist = implode(',', array_keys($sess));
|
|
$DB->delete_records_select('attendance_log', "sessionid IN ($slist)");
|
|
$DB->set_field('attendance_sessions', 'lasttaken', 0, array('courseid' => $data->courseid));
|
|
}
|
|
if (!empty($data->reset_attendance_statuses)) {
|
|
$DB->delete_records('attendance_statuses', array('courseid'=> $data->courseid));
|
|
$statuses = $DB->get_records('attendance_statuses', array('courseid'=> 0), 'id');
|
|
foreach($statuses as $stat) {
|
|
$rec = $stat;
|
|
$rec->courseid = $data->courseid;
|
|
$DB->insert_record('attendance_statuses', $rec);
|
|
}
|
|
}
|
|
if (!empty($data->reset_attendance_sessions)) {
|
|
$DB->delete_records('attendance_sessions', array('courseid'=> $data->courseid));
|
|
}
|
|
}
|
|
|
|
function attforblock_user_outline($course, $user, $mod, $attforblock) {
|
|
/// Return a small object with summary information about what a
|
|
/// user has done with a given particular instance of this module
|
|
/// Used for user activity reports.
|
|
/// $return->time = the time they did it
|
|
/// $return->info = a short text description
|
|
global $CFG;
|
|
|
|
require_once(dirname(__FILE__).'/locallib.php');
|
|
require_once($CFG->libdir.'/gradelib.php');
|
|
|
|
$grades = grade_get_grades($course->id, 'mod', 'attforblock', $attforblock->id, $user->id);
|
|
|
|
$result = new stdClass();
|
|
if (!empty($grades->items[0]->grades)) {
|
|
$grade = reset($grades->items[0]->grades);
|
|
$result->time = $grade->dategraded;
|
|
}
|
|
else
|
|
$result->time = 0;
|
|
if (has_capability('mod/attforblock:canbelisted', $mod->context, $user->id)) {
|
|
$statuses = get_statuses($attforblock->id);
|
|
$grade = get_user_grade(get_user_statuses_stat($attforblock->id, $course->startdate, $user->id), $statuses);
|
|
$maxgrade = get_user_max_grade(get_user_taken_sessions_count($attforblock->id, $course->startdate, $user->id), $statuses);
|
|
|
|
$result->info = $grade.' / '.$maxgrade;
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
function attforblock_user_complete($course, $user, $mod, $attforblock) {
|
|
/// Print a detailed representation of what a user has done with
|
|
/// a given particular instance of this module, for user activity reports.
|
|
global $CFG;
|
|
|
|
require_once(dirname(__FILE__).'/renderhelpers.php');
|
|
require_once($CFG->libdir.'/gradelib.php');
|
|
|
|
if (has_capability('mod/attforblock:canbelisted', $mod->context, $user->id)) {
|
|
$gradeable = $attforblock->grade > 0;
|
|
$statuses = get_statuses($attforblock->id);
|
|
$userstatusesstat = get_user_statuses_stat($attforblock->id, $course->startdate, $user->id);
|
|
$stat['completed'] = get_user_taken_sessions_count($attforblock->id, $course->startdate, $user->id);
|
|
$stat['statuses'] = $userstatusesstat;
|
|
if ($gradeable) {
|
|
$grade = get_user_grade($userstatusesstat, $statuses);
|
|
$maxgrade = get_user_max_grade(get_user_taken_sessions_count($attforblock->id, $course->startdate, $user->id), $statuses);
|
|
if (!$decimalpoints = grade_get_setting($course->id, 'decimalpoints')) {
|
|
$decimalpoints = $CFG->grade_decimalpoints;
|
|
}
|
|
}
|
|
else {
|
|
$grade = 0;
|
|
$maxgrade = 0;
|
|
$decimalpoints = 0;
|
|
}
|
|
|
|
echo construct_user_data_stat($stat, $statuses,
|
|
$gradeable, $grade, $maxgrade, $decimalpoints);
|
|
}
|
|
|
|
//return true;
|
|
}
|
|
|
|
function attforblock_print_recent_activity($course, $isteacher, $timestart) {
|
|
/// Given a course and a time, this module should find recent activity
|
|
/// that has occurred in attforblock activities and print it out.
|
|
/// Return true if there was output, or false is there was none.
|
|
|
|
return false; // True if anything was printed, otherwise false
|
|
}
|
|
|
|
function attforblock_cron () {
|
|
/// Function to be run periodically according to the moodle cron
|
|
/// This function searches for things that need to be done, such
|
|
/// as sending out mail, toggling flags etc ...
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Return grade for given user or all users.
|
|
*
|
|
* @param int $attforblockid id of attforblock
|
|
* @param int $userid optional user id, 0 means all users
|
|
* @return array array of grades, false if none
|
|
*/
|
|
/*function attforblock_get_user_grades($attforblock, $userid=0) {
|
|
global $CFG, $DB;
|
|
|
|
require_once('_locallib.php');
|
|
|
|
if (! $course = $DB->get_record('course', array('id'=> $attforblock->course))) {
|
|
error("Course is misconfigured");
|
|
}
|
|
|
|
$result = false;
|
|
if ($userid) {
|
|
$result = array();
|
|
$result[$userid]->userid = $userid;
|
|
$result[$userid]->rawgrade = $attforblock->grade * get_percent($userid, $course, $attforblock) / 100;
|
|
} else {
|
|
if ($students = get_course_students($course->id)) {
|
|
$result = array();
|
|
foreach ($students as $student) {
|
|
$result[$student->id]->userid = $student->id;
|
|
$result[$student->id]->rawgrade = $attforblock->grade * get_percent($student->id, $course, $attforblock) / 100;
|
|
}
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}*/
|
|
|
|
/**
|
|
* Update grades by firing grade_updated event
|
|
*
|
|
* @param object $attforblock null means all attforblocks
|
|
* @param int $userid specific user only, 0 mean all
|
|
*/
|
|
/*function attforblock_update_grades($attforblock=null, $userid=0, $nullifnone=true) {
|
|
global $CFG, $DB;
|
|
if (!function_exists('grade_update')) { //workaround for buggy PHP versions
|
|
require_once($CFG->libdir.'/gradelib.php');
|
|
}
|
|
|
|
if ($attforblock != null) {
|
|
if ($grades = attforblock_get_user_grades($attforblock, $userid)) {
|
|
foreach($grades as $k=>$v) {
|
|
if ($v->rawgrade == -1) {
|
|
$grades[$k]->rawgrade = null;
|
|
}
|
|
}
|
|
attforblock_grade_item_update($attforblock, $grades);
|
|
} else {
|
|
attforblock_grade_item_update($attforblock);
|
|
}
|
|
|
|
} else {
|
|
$sql = "SELECT a.*, cm.idnumber as cmidnumber, a.course as courseid
|
|
FROM {attforblock} a, {course_modules} cm, {modules} m
|
|
WHERE m.name='attforblock' AND m.id=cm.module AND cm.instance=a.id";
|
|
if ($rs = $DB->get_records_sql($sql)) {
|
|
foreach ($rs as $attforblock) {
|
|
// if ($attforblock->grade != 0) {
|
|
attforblock_update_grades($attforblock);
|
|
// } else {
|
|
// attforblock_grade_item_update($attforblock);
|
|
// }
|
|
}
|
|
$rs->close($rs);
|
|
}
|
|
}
|
|
}*/
|
|
|
|
/**
|
|
* Create grade item for given attforblock
|
|
*
|
|
* @param object $attforblock object with extra cmidnumber
|
|
* @param mixed optional array/object of grade(s); 'reset' means reset grades in gradebook
|
|
* @return int 0 if ok, error code otherwise
|
|
*/
|
|
function attforblock_grade_item_update($attforblock, $grades=NULL) {
|
|
global $CFG, $DB;
|
|
|
|
require_once('locallib.php');
|
|
|
|
if (!function_exists('grade_update')) { //workaround for buggy PHP versions
|
|
require_once($CFG->libdir.'/gradelib.php');
|
|
}
|
|
|
|
if (!isset($attforblock->courseid)) {
|
|
$attforblock->courseid = $attforblock->course;
|
|
}
|
|
if (! $course = $DB->get_record('course', array('id'=> $attforblock->course))) {
|
|
error("Course is misconfigured");
|
|
}
|
|
//$attforblock->grade = get_maxgrade($course);
|
|
|
|
if(!empty($attforblock->cmidnumber)){
|
|
$params = array('itemname'=>$attforblock->name, 'idnumber'=>$attforblock->cmidnumber);
|
|
}else{
|
|
// MDL-14303
|
|
$cm = get_coursemodule_from_instance('attforblock', $attforblock->id);
|
|
$params = array('itemname'=>$attforblock->name/*, 'idnumber'=>$attforblock->id*/);
|
|
}
|
|
|
|
if ($attforblock->grade > 0) {
|
|
$params['gradetype'] = GRADE_TYPE_VALUE;
|
|
$params['grademax'] = $attforblock->grade;
|
|
$params['grademin'] = 0;
|
|
}
|
|
else if ($attforblock->grade < 0) {
|
|
$params['gradetype'] = GRADE_TYPE_SCALE;
|
|
$params['scaleid'] = -$attforblock->grade;
|
|
|
|
} else {
|
|
$params['gradetype'] = GRADE_TYPE_NONE;
|
|
}
|
|
|
|
if ($grades === 'reset') {
|
|
$params['reset'] = true;
|
|
$grades = NULL;
|
|
}
|
|
|
|
return grade_update('mod/attforblock', $attforblock->courseid, 'mod', 'attforblock', $attforblock->id, 0, $grades, $params);
|
|
}
|
|
|
|
/**
|
|
* Delete grade item for given attforblock
|
|
*
|
|
* @param object $attforblock object
|
|
* @return object attforblock
|
|
*/
|
|
function attforblock_grade_item_delete($attforblock) {
|
|
global $CFG;
|
|
require_once($CFG->libdir.'/gradelib.php');
|
|
|
|
if (!isset($attforblock->courseid)) {
|
|
$attforblock->courseid = $attforblock->course;
|
|
}
|
|
|
|
return grade_update('mod/attforblock', $attforblock->courseid, 'mod', 'attforblock', $attforblock->id, 0, NULL, array('deleted'=>1));
|
|
}
|
|
|
|
function attforblock_get_participants($attforblockid) {
|
|
//Must return an array of user records (all data) who are participants
|
|
//for a given instance of attforblock. Must include every user involved
|
|
//in the instance, independient of his role (student, teacher, admin...)
|
|
//See other modules as example.
|
|
|
|
return false;
|
|
}
|
|
|
|
function attforblock_scale_used ($attforblockid, $scaleid) {
|
|
//This function returns if a scale is being used by one attforblock
|
|
//it it has support for grading and scales. Commented code should be
|
|
//modified if necessary. See forum, glossary or journal modules
|
|
//as reference.
|
|
|
|
$return = false;
|
|
}
|
|
|
|
/**
|
|
* Serves the attendance sessions descriptions files.
|
|
*
|
|
* @param object $course
|
|
* @param object $cm
|
|
* @param object $context
|
|
* @param string $filearea
|
|
* @param array $args
|
|
* @param bool $forcedownload
|
|
* @return bool false if file not found, does not return if found - justsend the file
|
|
*/
|
|
function attforblock_pluginfile($course, $cm, $context, $filearea, $args, $forcedownload) {
|
|
global $CFG, $DB;
|
|
|
|
if ($context->contextlevel != CONTEXT_MODULE) {
|
|
return false;
|
|
}
|
|
|
|
require_login($course, false, $cm);
|
|
|
|
if (!$att = $DB->get_record('attforblock', array('id' => $cm->instance))) {
|
|
return false;
|
|
}
|
|
|
|
// 'session' area is served by pluginfile.php
|
|
$fileareas = array('session');
|
|
if (!in_array($filearea, $fileareas)) {
|
|
return false;
|
|
}
|
|
|
|
$sessid = (int)array_shift($args);
|
|
if (!$sess = $DB->get_record('attendance_sessions', array('id' => $sessid))) {
|
|
return false;
|
|
}
|
|
|
|
$fs = get_file_storage();
|
|
$relativepath = implode('/', $args);
|
|
$fullpath = "/$context->id/mod_attforblock/$filearea/$sessid/$relativepath";
|
|
if (!$file = $fs->get_file_by_hash(sha1($fullpath)) or $file->is_directory()) {
|
|
return false;
|
|
}
|
|
send_stored_file($file, 0, 0, true);
|
|
}
|
|
|
|
//////////////////////////////////////////////////////////////////////////////////////
|
|
/// Any other attforblock functions go here. Each of them must have a name that
|
|
/// starts with attforblock_
|
|
|
|
|
|
?>
|
|
|