2 // This file is part of Moodle - http://moodle.org/
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 // GNU General Public License for more details.
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
18 * Library of functions and constants for module attendance
20 * @package mod_attendance
21 * @copyright 2011 Artem Andreev <andreev.artem@gmail.com>
22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
26 * Returns the information if the module supports a feature
28 * @see plugin_supports() in lib/moodlelib.php
29 * @param string $feature FEATURE_xx constant for requested feature
30 * @return mixed true if the feature is supported, null if unknown
32 function attendance_supports($feature) {
34 case FEATURE_GRADE_HAS_GRADE
:
38 case FEATURE_GROUPINGS
:
40 case FEATURE_GROUPMEMBERSONLY
:
42 case FEATURE_MOD_INTRO
:
44 case FEATURE_BACKUP_MOODLE2
:
46 // Artem Andreev: AFAIK it's not tested.
47 case FEATURE_COMPLETION_TRACKS_VIEWS
:
54 function att_add_default_statuses($attid) {
57 $statuses = $DB->get_recordset('attendance_statuses', array('attendanceid' => 0), 'id');
58 foreach ($statuses as $st) {
60 $rec->attendanceid
= $attid;
61 $DB->insert_record('attendance_statuses', $rec);
66 function attendance_add_instance($attendance) {
69 $attendance->timemodified
= time();
71 $attendance->id
= $DB->insert_record('attendance', $attendance);
73 att_add_default_statuses($attendance->id
);
75 attendance_grade_item_update($attendance);
77 return $attendance->id
;
81 function attendance_update_instance($attendance) {
84 $attendance->timemodified
= time();
85 $attendance->id
= $attendance->instance
;
87 if (! $DB->update_record('attendance', $attendance)) {
91 attendance_grade_item_update($attendance);
97 function attendance_delete_instance($id) {
100 if (! $attendance = $DB->get_record('attendance', array('id' => $id))) {
104 if ($sessids = array_keys($DB->get_records('attendance_sessions', array('attendanceid' => $id), '', 'id'))) {
105 $DB->delete_records_list('attendance_log', 'sessionid', $sessids);
106 $DB->delete_records('attendance_sessions', array('attendanceid' => $id));
108 $DB->delete_records('attendance_statuses', array('attendanceid' => $id));
110 $DB->delete_records('attendance', array('id' => $id));
112 attendance_grade_item_delete($attendance);
117 function attendance_delete_course($course, $feedback=true
) {
120 $attids = array_keys($DB->get_records('attendance', array('course' => $course->id
), '', 'id'));
121 $sessids = array_keys($DB->get_records_list('attendance_sessions', 'attendanceid', $attids, '', 'id'));
123 $DB->delete_records_list('attendance_log', 'sessionid', $sessids);
126 $DB->delete_records_list('attendance_statuses', 'attendanceid', $attids);
127 $DB->delete_records_list('attendance_sessions', 'attendanceid', $attids);
129 $DB->delete_records('attendance', array('course' => $course->id
));
135 * Called by course/reset.php
136 * @param $mform form passed by reference
138 function attendance_reset_course_form_definition(&$mform) {
139 $mform->addElement('header', 'attendanceheader', get_string('modulename', 'attendance'));
141 $mform->addElement('static', 'description', get_string('description', 'attendance'),
142 get_string('resetdescription', 'attendance'));
143 $mform->addElement('checkbox', 'reset_attendance_log', get_string('deletelogs', 'attendance'));
145 $mform->addElement('checkbox', 'reset_attendance_sessions', get_string('deletesessions', 'attendance'));
146 $mform->disabledIf('reset_attendance_sessions', 'reset_attendance_log', 'notchecked');
148 $mform->addElement('checkbox', 'reset_attendance_statuses', get_string('resetstatuses', 'attendance'));
149 $mform->setAdvanced('reset_attendance_statuses');
150 $mform->disabledIf('reset_attendance_statuses', 'reset_attendance_log', 'notchecked');
154 * Course reset form defaults.
156 function attendance_reset_course_form_defaults($course) {
157 return array('reset_attendance_log' => 0, 'reset_attendance_statuses' => 0, 'reset_attendance_sessions' => 0);
160 function attendance_reset_userdata($data) {
165 $attids = array_keys($DB->get_records('attendance', array('course' => $data->courseid
), '', 'id'));
167 if (!empty($data->reset_attendance_log
)) {
168 $sess = $DB->get_records_list('attendance_sessions', 'attendanceid', $attids, '', 'id');
170 list($sql, $params) = $DB->get_in_or_equal(array_keys($sess));
171 $DB->delete_records_select('attendance_log', "sessionid $sql", $params);
172 list($sql, $params) = $DB->get_in_or_equal($attids);
173 $DB->set_field_select('attendance_sessions', 'lasttaken', 0, "attendanceid $sql", $params);
176 'component' => get_string('modulenameplural', 'attendance'),
177 'item' => get_string('attendancedata', 'attendance'),
183 if (!empty($data->reset_attendance_statuses
)) {
184 $DB->delete_records_list('attendance_statuses', 'attendanceid', $attids);
185 foreach ($attids as $attid) {
186 att_add_default_statuses($attid);
190 'component' => get_string('modulenameplural', 'attendance'),
191 'item' => get_string('sessions', 'attendance'),
196 if (!empty($data->reset_attendance_sessions
)) {
197 $DB->delete_records_list('attendance_sessions', 'attendanceid', $attids);
200 'component' => get_string('modulenameplural', 'attendance'),
201 'item' => get_string('statuses', 'attendance'),
209 * Return a small object with summary information about what a
210 * user has done with a given particular instance of this module
211 * Used for user activity reports.
212 * $return->time = the time they did it
213 * $return->info = a short text description
215 function attendance_user_outline($course, $user, $mod, $attendance) {
217 require_once(dirname(__FILE__
).'/locallib.php');
218 require_once($CFG->libdir
.'/gradelib.php');
220 $grades = grade_get_grades($course->id
, 'mod', 'attendance', $attendance->id
, $user->id
);
222 $result = new stdClass();
223 if (!empty($grades->items
[0]->grades
)) {
224 $grade = reset($grades->items
[0]->grades
);
225 $result->time
= $grade->dategraded
;
229 if (has_capability('mod/attendance:canbelisted', $mod->context
, $user->id
)) {
230 $statuses = attendance_get_statuses($attendance->id
);
231 $grade = attendance_get_user_grade(attendance_get_user_statuses_stat($attendance->id
, $course->startdate
,
232 $user->id
, $mod), $statuses);
233 $maxgrade = attendance_get_user_max_grade(attendance_get_user_taken_sessions_count($attendance->id
, $course->startdate
,
234 $user->id
, $mod), $statuses);
236 $result->info
= $grade.' / '.$maxgrade;
242 * Print a detailed representation of what a user has done with
243 * a given particular instance of this module, for user activity reports.
246 function attendance_user_complete($course, $user, $mod, $attendance) {
249 require_once(dirname(__FILE__
).'/renderhelpers.php');
250 require_once($CFG->libdir
.'/gradelib.php');
252 if (has_capability('mod/attendance:canbelisted', $mod->context
, $user->id
)) {
253 echo construct_full_user_stat_html_table($attendance, $course, $user, $mod);
257 function attendance_update_grades($attendance, $userid=0, $nullifnone=true
) {
258 // We need this function to exist so that quick editing of module name is passed to gradebook.
261 * Create grade item for given attendance
263 * @param object $attendance object with extra cmidnumber
264 * @param mixed optional array/object of grade(s); 'reset' means reset grades in gradebook
265 * @return int 0 if ok, error code otherwise
267 function attendance_grade_item_update($attendance, $grades=null
) {
270 require_once('locallib.php');
272 if (!function_exists('grade_update')) { // Workaround for buggy PHP versions.
273 require_once($CFG->libdir
.'/gradelib.php');
276 if (!isset($attendance->courseid
)) {
277 $attendance->courseid
= $attendance->course
;
279 if (! $course = $DB->get_record('course', array('id' => $attendance->course
))) {
280 error("Course is misconfigured");
283 if (!empty($attendance->cmidnumber
)) {
284 $params = array('itemname' => $attendance->name
, 'idnumber' => $attendance->cmidnumber
);
287 $cm = get_coursemodule_from_instance('attendance', $attendance->id
);
288 $params = array('itemname' => $attendance->name
/*, 'idnumber'=>$attendance->id*/);
291 if ($attendance->grade
> 0) {
292 $params['gradetype'] = GRADE_TYPE_VALUE
;
293 $params['grademax'] = $attendance->grade
;
294 $params['grademin'] = 0;
295 } else if ($attendance->grade
< 0) {
296 $params['gradetype'] = GRADE_TYPE_SCALE
;
297 $params['scaleid'] = -$attendance->grade
;
300 $params['gradetype'] = GRADE_TYPE_NONE
;
303 if ($grades === 'reset') {
304 $params['reset'] = true
;
308 return grade_update('mod/attendance', $attendance->courseid
, 'mod', 'attendance', $attendance->id
, 0, $grades, $params);
312 * Delete grade item for given attendance
314 * @param object $attendance object
315 * @return object attendance
317 function attendance_grade_item_delete($attendance) {
319 require_once($CFG->libdir
.'/gradelib.php');
321 if (!isset($attendance->courseid
)) {
322 $attendance->courseid
= $attendance->course
;
325 return grade_update('mod/attendance', $attendance->courseid
, 'mod', 'attendance',
326 $attendance->id
, 0, null
, array('deleted' => 1));
330 * This function returns if a scale is being used by one attendance
331 * it it has support for grading and scales. Commented code should be
332 * modified if necessary. See book, glossary or journal modules
335 * @param int $attendanceid
336 * @param int $scaleid
337 * @return boolean True if the scale is used by any attendance
339 function attendance_scale_used ($attendanceid, $scaleid) {
344 * Checks if scale is being used by any instance of attendance
346 * This is used to find out if scale used anywhere
348 * @param int $scaleid
349 * @return bool true if the scale is used by any book
351 function attendance_scale_used_anywhere($scaleid) {
356 * Serves the attendance sessions descriptions files.
358 * @param object $course
360 * @param object $context
361 * @param string $filearea
363 * @param bool $forcedownload
364 * @return bool false if file not found, does not return if found - justsend the file
366 function attendance_pluginfile($course, $cm, $context, $filearea, $args, $forcedownload) {
369 if ($context->contextlevel
!= CONTEXT_MODULE
) {
373 require_login($course, false
, $cm);
375 if (!$DB->record_exists('attendance', array('id' => $cm->instance
))) {
379 // Session area is served by pluginfile.php.
380 $fileareas = array('session');
381 if (!in_array($filearea, $fileareas)) {
385 $sessid = (int)array_shift($args);
386 if (!$DB->record_exists('attendance_sessions', array('id' => $sessid))) {
390 $fs = get_file_storage();
391 $relativepath = implode('/', $args);
392 $fullpath = "/$context->id/mod_attendance/$filearea/$sessid/$relativepath";
393 if (!$file = $fs->get_file_by_hash(sha1($fullpath)) or $file->is_directory()) {
396 send_stored_file($file, 0, 0, true
);