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.
561 lines
20 KiB
561 lines
20 KiB
<?php
|
|
|
|
global $CFG;
|
|
require_once($CFG->libdir . '/gradelib.php');
|
|
|
|
class attforblock_permissions {
|
|
private $canview;
|
|
private $canviewreports;
|
|
private $cantake;
|
|
private $canchange;
|
|
private $canmanage;
|
|
private $canchangepreferences;
|
|
private $canexport;
|
|
private $canbelisted;
|
|
private $canaccessallgroups;
|
|
|
|
private $context;
|
|
|
|
public function __construct($context) {
|
|
$this->context = $context;
|
|
}
|
|
|
|
public function can_view() {
|
|
if (is_null($this->canview))
|
|
$this->canview = has_capability('mod/attforblock:view', $this->context);
|
|
|
|
return $this->canview;
|
|
}
|
|
|
|
public function can_viewreports() {
|
|
if (is_null($this->canviewreports))
|
|
$this->canviewreports = has_capability('mod/attforblock:viewreports', $this->context);
|
|
|
|
return $this->canviewreports;
|
|
}
|
|
|
|
public function can_take() {
|
|
if (is_null($this->cantake))
|
|
$this->cantake = has_capability('mod/attforblock:takeattendances', $this->context);
|
|
|
|
return $this->cantake;
|
|
}
|
|
|
|
public function can_change() {
|
|
if (is_null($this->canchange))
|
|
$this->canchange = has_capability('mod/attforblock:changeattendances', $this->context);
|
|
|
|
return $this->canchange;
|
|
}
|
|
|
|
public function can_manage() {
|
|
if (is_null($this->canmanage))
|
|
$this->canmanage = has_capability('mod/attforblock:manageattendances', $this->context);
|
|
|
|
return $this->canmanage;
|
|
}
|
|
|
|
public function require_manage_capability() {
|
|
require_capability('mod/attforblock:manageattendances', $this->context);
|
|
}
|
|
|
|
public function can_change_preferences() {
|
|
if (is_null($this->canchangepreferences))
|
|
$this->canchangepreferences = has_capability('mod/attforblock:changepreferences', $this->context);
|
|
|
|
return $this->canchangepreferences;
|
|
}
|
|
|
|
public function can_export() {
|
|
if (is_null($this->canexport))
|
|
$this->canexport = has_capability('mod/attforblock:export', $this->context);
|
|
|
|
return $this->canexport;
|
|
}
|
|
|
|
public function can_be_listed() {
|
|
if (is_null($this->canbelisted))
|
|
$this->canbelisted = has_capability('mod/attforblock:canbelisted', $this->context);
|
|
|
|
return $this->canbelisted;
|
|
}
|
|
|
|
public function can_access_all_groups() {
|
|
if (is_null($this->canaccessallgroups))
|
|
$this->canaccessallgroups = has_capability('moodle/site:accessallgroups', $this->context);
|
|
|
|
return $this->canaccessallgroups;
|
|
}
|
|
}
|
|
|
|
class att_manage_page_params {
|
|
const VIEW_DAYS = 1;
|
|
const VIEW_WEEKS = 2;
|
|
const VIEW_MONTHS = 3;
|
|
const VIEW_ALLTAKEN = 4;
|
|
const VIEW_ALL = 5;
|
|
|
|
const SELECTOR_NONE = 1;
|
|
const SELECTOR_GROUP = 2;
|
|
const SELECTOR_SESS_TYPE = 3;
|
|
|
|
const DEFAULT_VIEW = self::VIEW_WEEKS;
|
|
const DEFAULT_SHOWENDTIME = 0;
|
|
|
|
/** @var int current view mode */
|
|
public $view;
|
|
|
|
/** @var int $view and $curdate specify displaed date range */
|
|
public $curdate;
|
|
|
|
/** @var int start date of displayed date range */
|
|
public $startdate;
|
|
|
|
/** @var int end date of displayed date range */
|
|
public $enddate;
|
|
|
|
/** @var int whether sessions end time will be displayed on manage.php */
|
|
public $showendtime;
|
|
|
|
private $courseid;
|
|
|
|
public function init($courseid) {
|
|
$this->courseid = $courseid;
|
|
$this->init_view();
|
|
$this->init_curdate();
|
|
$this->init_show_endtime();
|
|
$this->init_start_end_date();
|
|
}
|
|
|
|
private function init_view() {
|
|
global $SESSION;
|
|
|
|
if (isset($this->view)) {
|
|
$SESSION->attcurrentattview[$this->courseid] = $this->view;
|
|
}
|
|
elseif (isset($SESSION->attcurrentattview[$this->courseid])) {
|
|
$this->view = $SESSION->attcurrentattview[$this->courseid];
|
|
}
|
|
else {
|
|
$this->view = self::DEFAULT_VIEW;
|
|
}
|
|
}
|
|
|
|
private function init_curdate() {
|
|
global $SESSION;
|
|
|
|
if (isset($this->curdate)) {
|
|
$SESSION->attcurrentattdate[$this->courseid] = $this->curdate;
|
|
}
|
|
elseif (isset($SESSION->attcurrentattdate[$this->courseid])) {
|
|
$this->curdate = $SESSION->attcurrentattdate[$this->courseid];
|
|
}
|
|
else {
|
|
$this->curdate = time();
|
|
}
|
|
}
|
|
|
|
private function init_show_endtime() {
|
|
if (isset($this->show_endtime)) {
|
|
set_user_preference("attforblock_showendtime", $this->show_endtime);
|
|
}
|
|
else {
|
|
$this->showendtime = get_user_preferences("attforblock_showendtime", self::DEFAULT_SHOWENDTIME);
|
|
}
|
|
}
|
|
|
|
private function init_start_end_date() {
|
|
$date = usergetdate($this->curdate);
|
|
$mday = $date['mday'];
|
|
$wday = $date['wday'];
|
|
$mon = $date['mon'];
|
|
$year = $date['year'];
|
|
|
|
switch ($this->view) {
|
|
case self::VIEW_DAYS:
|
|
$this->startdate = make_timestamp($year, $mon, $mday);
|
|
$this->enddate = make_timestamp($year, $mon, $mday + 1);
|
|
break;
|
|
case self::VIEW_WEEKS:
|
|
$this->startdate = make_timestamp($year, $mon, $mday - $wday + 1);
|
|
$this->enddate = make_timestamp($year, $mon, $mday + 7 - $wday + 1) - 1;
|
|
break;
|
|
case self::VIEW_MONTHS:
|
|
$this->startdate = make_timestamp($year, $mon);
|
|
$this->enddate = make_timestamp($year, $mon + 1);
|
|
break;
|
|
case self::VIEW_ALLTAKEN:
|
|
$this->startdate = 1;
|
|
$this->enddate = time();
|
|
break;
|
|
case self::VIEW_ALL:
|
|
$this->startdate = 0;
|
|
$this->enddate = 0;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
class att_sessions_page_params {
|
|
const ACTION_ADD = 1;
|
|
const ACTION_UPDATE = 2;
|
|
const ACTION_DELETE = 3;
|
|
const ACTION_DELETE_SELECTED = 4;
|
|
const ACTION_CHANGE_DURATION = 5;
|
|
|
|
/** @var int view mode of taking attendance page*/
|
|
public $action;
|
|
}
|
|
|
|
class att_take_page_params {
|
|
const SORTED_LIST = 1;
|
|
const SORTED_GRID = 2;
|
|
|
|
const DEFAULT_VIEW_MODE = self::SORTED_LIST;
|
|
|
|
/** @var int view mode of taking attendance page*/
|
|
public $view_mode;
|
|
|
|
public static function create_default() {
|
|
$instance = new att_take_page_params();
|
|
|
|
$instance->view_mode = self::DEFAULT_VIEW_MODE;
|
|
|
|
return $instance;
|
|
}
|
|
|
|
public function init(att_manage_page_params $view_params, $courseid) {
|
|
$this->init_view_mode($view_params->view_mode);
|
|
}
|
|
|
|
private function init_view_mode($view_mode) {
|
|
global $SESSION;
|
|
|
|
if (isset($view_mode)) {
|
|
set_user_preference("attforblock_take_view_mode", $view_mode);
|
|
$this->view_mode = $view_mode;
|
|
}
|
|
else {
|
|
$this->view_mode = get_user_preferences("attforblock_take_view_mode", $this->view_mode);
|
|
}
|
|
}
|
|
}
|
|
|
|
class attforblock {
|
|
const SESSION_COMMON = 0;
|
|
const SESSION_GROUP = 1;
|
|
|
|
const SELECTOR_COMMON = 0;
|
|
const SELECTOR_ALL = -1;
|
|
const SELECTOR_NOT_EXISTS = -2;
|
|
|
|
/** @var stdclass course module record */
|
|
public $cm;
|
|
|
|
/** @var stdclass course record */
|
|
public $course;
|
|
|
|
/** @var stdclass context object */
|
|
public $context;
|
|
|
|
/** @var int attendance instance identifier */
|
|
public $id;
|
|
|
|
/** @var string attendance activity name */
|
|
public $name;
|
|
|
|
/** @var float number (10, 5) unsigned, the maximum grade for attendance */
|
|
public $grade;
|
|
|
|
/** current page parameters */
|
|
public $pageparams;
|
|
|
|
/** @var attforblock_permissions permission of current user for attendance instance*/
|
|
public $perm;
|
|
|
|
private $groupmode;
|
|
|
|
private $sessgroupslist;
|
|
|
|
private $currentgroup;
|
|
|
|
/**
|
|
* Initializes the attendance API instance using the data from DB
|
|
*
|
|
* Makes deep copy of all passed records properties. Replaces integer $course attribute
|
|
* with a full database record (course should not be stored in instances table anyway).
|
|
*
|
|
* @param stdClass $dbrecord Attandance instance data from {attforblock} table
|
|
* @param stdClass $cm Course module record as returned by {@link get_coursemodule_from_id()}
|
|
* @param stdClass $course Course record from {course} table
|
|
* @param stdClass $context The context of the workshop instance
|
|
*/
|
|
public function __construct(stdclass $dbrecord, stdclass $cm, stdclass $course, stdclass $context=NULL, $view_params=NULL) {
|
|
foreach ($dbrecord as $field => $value) {
|
|
if (property_exists('attforblock', $field)) {
|
|
$this->{$field} = $value;
|
|
}
|
|
else {
|
|
throw new coding_exception('The attendance table has field for which there is no property in the attforblock class');
|
|
}
|
|
}
|
|
$this->cm = $cm;
|
|
$this->course = $course;
|
|
if (is_null($context)) {
|
|
$this->context = get_context_instance(CONTEXT_MODULE, $this->cm->id);
|
|
} else {
|
|
$this->context = $context;
|
|
}
|
|
|
|
$this->pageparams = $view_params;
|
|
|
|
$this->perm = new attforblock_permissions($this->context);
|
|
}
|
|
|
|
/**
|
|
* Returns today sessions for this attendance
|
|
*
|
|
* Fetches data from {attendance_sessions}
|
|
*
|
|
* @return array of records or an empty array
|
|
*/
|
|
public function get_today_sessions() {
|
|
global $DB;
|
|
|
|
$today = time(); // because we compare with database, we don't need to use usertime()
|
|
|
|
$sql = "SELECT id, groupid, lasttaken
|
|
FROM {attendance_sessions}
|
|
WHERE :time BETWEEN sessdate AND (sessdate + duration)
|
|
AND courseid = :cid AND attendanceid = :aid";
|
|
$params = array(
|
|
'time' => $today,
|
|
'cid' => $this->course->id,
|
|
'aid' => $this->id);
|
|
|
|
return $DB->get_records_sql($sql, $params);
|
|
}
|
|
|
|
/**
|
|
* Returns count of hidden sessions for this attendance
|
|
*
|
|
* Fetches data from {attendance_sessions}
|
|
*
|
|
* @return count of hidden sessions
|
|
*/
|
|
public function get_hidden_sessions_count() {
|
|
global $DB;
|
|
|
|
$where = "courseid = :cid AND attendanceid = :aid AND sessdate < :csdate";
|
|
$params = array(
|
|
'cid' => $this->course->id,
|
|
'aid' => $this->id,
|
|
'csdate'=> $this->course->startdate);
|
|
|
|
return $DB->count_records_select('attendance_sessions', $where, $params);
|
|
}
|
|
|
|
/**
|
|
* @return moodle_url of manage.php for attendance instance
|
|
*/
|
|
public function url_manage() {
|
|
$params = array('id' => $this->cm->id);
|
|
return new moodle_url('/mod/attforblock/manage.php', $params);
|
|
}
|
|
|
|
/**
|
|
* @return moodle_url of sessions.php for attendance instance
|
|
*/
|
|
public function url_sessions($params=array()) {
|
|
$params = array_merge(array('id' => $this->cm->id), $params);
|
|
return new moodle_url('/mod/attforblock/sessions.php', $params);
|
|
}
|
|
|
|
/**
|
|
* @return moodle_url of report.php for attendance instance
|
|
*/
|
|
public function url_report() {
|
|
$params = array('id' => $this->cm->id);
|
|
return new moodle_url('/mod/attforblock/report.php', $params);
|
|
}
|
|
|
|
/**
|
|
* @return moodle_url of export.php for attendance instance
|
|
*/
|
|
public function url_export() {
|
|
$params = array('id' => $this->cm->id);
|
|
return new moodle_url('/mod/attforblock/export.php', $params);
|
|
}
|
|
|
|
/**
|
|
* @return moodle_url of attsettings.php for attendance instance
|
|
*/
|
|
public function url_settings() {
|
|
$params = array('id' => $this->cm->id);
|
|
return new moodle_url('/mod/attforblock/attsettings.php', $params);
|
|
}
|
|
|
|
/**
|
|
* @return moodle_url of attendances.php for attendance instance
|
|
*/
|
|
public function url_take() {
|
|
$params = array('id' => $this->cm->id);
|
|
return new moodle_url('/mod/attforblock/attendances.php', $params);
|
|
}
|
|
|
|
private function calc_groupmode_sessgroupslist_currentgroup(){
|
|
global $USER, $SESSION;
|
|
|
|
$cm = $this->cm;
|
|
$this->groupmode = groups_get_activity_groupmode($cm);
|
|
|
|
if ($this->groupmode == NOGROUPS)
|
|
return;
|
|
|
|
if ($this->groupmode == VISIBLEGROUPS or $this->perm->can_access_all_groups()) {
|
|
$allowedgroups = groups_get_all_groups($cm->course, 0, $cm->groupingid); // any group in grouping (all if groupings not used)
|
|
// detect changes related to groups and fix active group
|
|
if (!empty($SESSION->activegroup[$cm->course][VISIBLEGROUPS][$cm->groupingid])) {
|
|
if (!array_key_exists($SESSION->activegroup[$cm->course][VISIBLEGROUPS][$cm->groupingid], $allowedgroups)) {
|
|
// active group does not exist anymore
|
|
unset($SESSION->activegroup[$cm->course][VISIBLEGROUPS][$cm->groupingid]);
|
|
}
|
|
}
|
|
if (!empty($SESSION->activegroup[$cm->course]['aag'][$cm->groupingid])) {
|
|
if (!array_key_exists($SESSION->activegroup[$cm->course]['aag'][$cm->groupingid], $allowedgroups)) {
|
|
// active group does not exist anymore
|
|
unset($SESSION->activegroup[$cm->course]['aag'][$cm->groupingid]);
|
|
}
|
|
}
|
|
|
|
} else {
|
|
$allowedgroups = groups_get_all_groups($cm->course, $USER->id, $cm->groupingid); // only assigned groups
|
|
// detect changes related to groups and fix active group
|
|
if (isset($SESSION->activegroup[$cm->course][SEPARATEGROUPS][$cm->groupingid])) {
|
|
if ($SESSION->activegroup[$cm->course][SEPARATEGROUPS][$cm->groupingid] == 0) {
|
|
if ($allowedgroups) {
|
|
// somebody must have assigned at least one group, we can select it now - yay!
|
|
unset($SESSION->activegroup[$cm->course][SEPARATEGROUPS][$cm->groupingid]);
|
|
}
|
|
} else {
|
|
if (!array_key_exists($SESSION->activegroup[$cm->course][SEPARATEGROUPS][$cm->groupingid], $allowedgroups)) {
|
|
// active group not allowed or does not exist anymore
|
|
unset($SESSION->activegroup[$cm->course][SEPARATEGROUPS][$cm->groupingid]);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
$group = optional_param('group', self::SELECTOR_NOT_EXISTS, PARAM_INT);
|
|
if (!array_key_exists('attsessiontype', $SESSION)) {
|
|
$SESSION->attsessiontype = array();
|
|
}
|
|
if ($group > self::SELECTOR_NOT_EXISTS) {
|
|
$SESSION->attsessiontype[$cm->course] = $group;
|
|
} elseif (!array_key_exists($cm->course, $SESSION->attsessiontype)) {
|
|
$SESSION->attsessiontype[$cm->course] = self::SELECTOR_ALL;
|
|
}
|
|
|
|
if ($group == self::SELECTOR_ALL) {
|
|
$this->currentgroup = $group;
|
|
unset($SESSION->activegroup[$cm->course][VISIBLEGROUPS][$cm->groupingid]);
|
|
unset($SESSION->activegroup[$cm->course]['aag'][$cm->groupingid]);
|
|
unset($SESSION->activegroup[$cm->course][SEPARATEGROUPS][$cm->groupingid]);
|
|
} else {
|
|
$this->currentgroup = groups_get_activity_group($cm, true);
|
|
if ($this->currentgroup == 0 and $SESSION->attsessiontype[$cm->course] == self::SELECTOR_ALL) {
|
|
$this->currentgroup = self::SELECTOR_ALL;
|
|
}
|
|
}
|
|
|
|
$this->sessgroupslist = array();
|
|
if ($allowedgroups or $this->groupmode == VISIBLEGROUPS or $this->perm->can_access_all_groups()) {
|
|
$this->sessgroupslist[self::SELECTOR_ALL] = get_string('all', 'attforblock');
|
|
}
|
|
if ($this->groupmode == VISIBLEGROUPS) {
|
|
$this->sessgroupslist[self::SELECTOR_COMMON] = get_string('commonsessions', 'attforblock');
|
|
}
|
|
if ($allowedgroups) {
|
|
foreach ($allowedgroups as $group) {
|
|
$this->sessgroupslist[$group->id] = format_string($group->name);
|
|
}
|
|
}
|
|
}
|
|
|
|
public function get_group_mode() {
|
|
if (is_null($this->groupmode))
|
|
$this->calc_groupmode_sessgroupslist_currentgroup();
|
|
|
|
return $this->groupmode;
|
|
}
|
|
|
|
public function get_sess_groups_list() {
|
|
if (is_null($this->sessgroupslist))
|
|
$this->calc_groupmode_sessgroupslist_currentgroup();
|
|
|
|
return $this->sessgroupslist;
|
|
}
|
|
|
|
public function get_current_group() {
|
|
if (is_null($this->currentgroup))
|
|
$this->calc_groupmode_sessgroupslist_currentgroup();
|
|
|
|
return $this->currentgroup;
|
|
}
|
|
|
|
public function add_session_from_form_data($formdata) {
|
|
global $DB;
|
|
|
|
$duration = $formdata->durtime['hours']*HOURSECS + $formdata->durtime['minutes']*MINSECS;
|
|
|
|
$rec->courseid = $this->course->id;
|
|
$rec->attendanceid = $this->id;
|
|
$rec->sessdate = $formdata->sessiondate;
|
|
$rec->duration = $duration;
|
|
$rec->description = $formdata->sdescription['text'];
|
|
$rec->descriptionformat = $formdata->sdescription['format'];
|
|
$rec->timemodified = time();
|
|
|
|
if ($formdata->sessiontype == self::SESSION_COMMON) {
|
|
$rec->id = $DB->insert_record('attendance_sessions', $rec);
|
|
$description = file_save_draft_area_files($formdata->sdescription['itemid'],
|
|
$this->context->id, 'mod_attforblock', 'session', $rec->id,
|
|
array('subdirs' => false, 'maxfiles' => -1, 'maxbytes' => 0), $formdata->sdescription['text']);
|
|
$DB->set_field('attendance_sessions', 'description', $description, array('id' => $rec->id));
|
|
} else {
|
|
foreach ($formdata->groups as $groupid) {
|
|
$rec->groupid = $groupid;
|
|
$rec->id = $DB->insert_record('attendance_sessions', $rec);
|
|
$description = file_save_draft_area_files($formdata->sdescription['itemid'],
|
|
$this->context->id, 'mod_attforblock', 'session', $rec->id,
|
|
array('subdirs' => false, 'maxfiles' => -1, 'maxbytes' => 0), $formdata->sdescription['text']);
|
|
$DB->set_field('attendance_sessions', 'description', $description, array('id' => $rec->id));
|
|
}
|
|
}
|
|
// TODO: log
|
|
//add_to_log($course->id, 'attendance', 'one session added', 'mod/attforblock/manage.php?id='.$id, $user->lastname.' '.$user->firstname);
|
|
}
|
|
|
|
public function update_session_from_form_data($formdata, $sessionid) {
|
|
global $DB;
|
|
|
|
if (!$sess = $DB->get_record('attendance_sessions', array('id' => $sessionid) )) {
|
|
print_error('No such session in this course');
|
|
}
|
|
|
|
$sess->sessdate = $formdata->sessiondate;
|
|
$sess->duration = $formdata->durtime['hours']*HOURSECS + $formdata->durtime['minutes']*MINSECS;
|
|
$description = file_save_draft_area_files($formdata->sdescription['itemid'],
|
|
$this->context->id, 'mod_attforblock', 'session', $sessionid,
|
|
array('subdirs' => false, 'maxfiles' => -1, 'maxbytes' => 0), $formdata->sdescription['text']);
|
|
$sess->description = $description;
|
|
$sess->descriptionformat = $formdata->sdescription['format'];
|
|
$sess->timemodified = time();
|
|
$DB->update_record('attendance_sessions', $sess);
|
|
// TODO: log
|
|
// add_to_log($course->id, 'attendance', 'Session updated', 'mod/attforblock/manage.php?id='.$id, $user->lastname.' '.$user->firstname);
|
|
}
|
|
}
|
|
|
|
|
|
?>
|
|
|