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.
523 lines
20 KiB
523 lines
20 KiB
<?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/>.
|
|
|
|
/**
|
|
* Import attendance sessions class.
|
|
*
|
|
* @package mod_attendance
|
|
* @author Chris Wharton <chriswharton@catalyst.net.nz>
|
|
* @copyright 2017 Catalyst IT
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
namespace mod_attendance\import;
|
|
|
|
defined('MOODLE_INTERNAL') || die();
|
|
|
|
use csv_import_reader;
|
|
use mod_attendance_notifyqueue;
|
|
use mod_attendance_structure;
|
|
use stdClass;
|
|
|
|
/**
|
|
* Import attendance sessions.
|
|
*
|
|
* @package mod_attendance
|
|
* @author Chris Wharton <chriswharton@catalyst.net.nz>
|
|
* @copyright 2017 Catalyst IT
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class sessions {
|
|
|
|
/** @var string $error The errors message from reading the xml */
|
|
protected $error = '';
|
|
|
|
/** @var array $sessions The sessions info */
|
|
protected $sessions = array();
|
|
|
|
/** @var array $mappings The mappings info */
|
|
protected $mappings = array();
|
|
|
|
/** @var int The id of the csv import */
|
|
protected $importid = 0;
|
|
|
|
/** @var csv_import_reader|null $importer */
|
|
protected $importer = null;
|
|
|
|
/** @var array $foundheaders */
|
|
protected $foundheaders = array();
|
|
|
|
/** @var bool $useprogressbar Control whether importing should use progress bars or not. */
|
|
protected $useprogressbar = false;
|
|
|
|
/** @var \core\progress\display_if_slow|null $progress The progress bar instance. */
|
|
protected $progress = null;
|
|
|
|
/**
|
|
* Store an error message for display later
|
|
*
|
|
* @param string $msg
|
|
*/
|
|
public function fail($msg) {
|
|
$this->error = $msg;
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Get the CSV import id
|
|
*
|
|
* @return string The import id.
|
|
*/
|
|
public function get_importid() {
|
|
return $this->importid;
|
|
}
|
|
|
|
/**
|
|
* Get the list of headers required for import.
|
|
*
|
|
* @return array The headers (lang strings)
|
|
*/
|
|
public static function list_required_headers() {
|
|
return array(
|
|
get_string('courseshortname', 'attendance'),
|
|
get_string('groups', 'attendance'),
|
|
get_string('sessiondate', 'attendance'),
|
|
get_string('from', 'attendance'),
|
|
get_string('to', 'attendance'),
|
|
get_string('description', 'attendance'),
|
|
get_string('repeaton', 'attendance'),
|
|
get_string('repeatevery', 'attendance'),
|
|
get_string('repeatuntil', 'attendance'),
|
|
get_string('studentscanmark', 'attendance'),
|
|
get_string('passwordgrp', 'attendance'),
|
|
get_string('randompassword', 'attendance'),
|
|
get_string('subnet', 'attendance'),
|
|
get_string('automark', 'attendance'),
|
|
get_string('autoassignstatus', 'attendance'),
|
|
get_string('absenteereport', 'attendance'),
|
|
get_string('preventsharedip', 'attendance'),
|
|
get_string('preventsharediptime', 'attendance'),
|
|
get_string('calendarevent', 'attendance'),
|
|
get_string('includeqrcode', 'attendance'),
|
|
get_string('rotateqrcode', 'attendance'),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get the list of headers found in the import.
|
|
*
|
|
* @return array The found headers (names from import)
|
|
*/
|
|
public function list_found_headers() {
|
|
return $this->foundheaders;
|
|
}
|
|
|
|
/**
|
|
* Read the data from the mapping form.
|
|
*
|
|
* @param array $data The mapping data.
|
|
*/
|
|
protected function read_mapping_data($data) {
|
|
if ($data) {
|
|
return array(
|
|
'course' => $data->header0,
|
|
'groups' => $data->header1,
|
|
'sessiondate' => $data->header2,
|
|
'from' => $data->header3,
|
|
'to' => $data->header4,
|
|
'description' => $data->header5,
|
|
'repeaton' => $data->header6,
|
|
'repeatevery' => $data->header7,
|
|
'repeatuntil' => $data->header8,
|
|
'studentscanmark' => $data->header9,
|
|
'passwordgrp' => $data->header10,
|
|
'randompassword' => $data->header11,
|
|
'subnet' => $data->header12,
|
|
'automark' => $data->header13,
|
|
'autoassignstatus' => $data->header14,
|
|
'absenteereport' => $data->header15,
|
|
'preventsharedip' => $data->header16,
|
|
'preventsharediptime' => $data->header17,
|
|
'calendarevent' => $data->header18,
|
|
'includeqrcode' => $data->header19,
|
|
'rotateqrcode' => $data->header20,
|
|
);
|
|
} else {
|
|
return array(
|
|
'course' => 0,
|
|
'groups' => 1,
|
|
'sessiondate' => 2,
|
|
'from' => 3,
|
|
'to' => 4,
|
|
'description' => 5,
|
|
'repeaton' => 6,
|
|
'repeatevery' => 7,
|
|
'repeatuntil' => 8,
|
|
'studentscanmark' => 9,
|
|
'passwordgrp' => 10,
|
|
'randompassword' => 11,
|
|
'subnet' => 12,
|
|
'automark' => 13,
|
|
'autoassignstatus' => 14,
|
|
'absenteereport' => 15,
|
|
'preventsharedip' => 16,
|
|
'preventsharediptime' => 17,
|
|
'calendarevent' => 18,
|
|
'includeqrcode' => 19,
|
|
'rotateqrcode' => 20
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the a column from the imported data.
|
|
*
|
|
* @param array $row The imported raw row
|
|
* @param int $index The column index we want
|
|
* @return string The column data.
|
|
*/
|
|
protected function get_column_data($row, $index) {
|
|
if ($index < 0) {
|
|
return '';
|
|
}
|
|
return isset($row[$index]) ? $row[$index] : '';
|
|
}
|
|
|
|
/**
|
|
* Constructor - parses the raw text for sanity.
|
|
*
|
|
* @param string $text The raw csv text.
|
|
* @param string $encoding The encoding of the csv file.
|
|
* @param string $delimiter The specified delimiter for the file.
|
|
* @param string $importid The id of the csv import.
|
|
* @param array $mappingdata The mapping data from the import form.
|
|
* @param bool $useprogressbar Whether progress bar should be displayed, to avoid html output on CLI.
|
|
*/
|
|
public function __construct($text = null, $encoding = null, $delimiter = null, $importid = 0,
|
|
$mappingdata = null, $useprogressbar = false) {
|
|
global $CFG;
|
|
|
|
require_once($CFG->libdir . '/csvlib.class.php');
|
|
|
|
$pluginconfig = get_config('attendance');
|
|
|
|
$type = 'sessions';
|
|
|
|
if (! $importid) {
|
|
if ($text === null) {
|
|
return;
|
|
}
|
|
$this->importid = csv_import_reader::get_new_iid($type);
|
|
|
|
$this->importer = new csv_import_reader($this->importid, $type);
|
|
|
|
if (! $this->importer->load_csv_content($text, $encoding, $delimiter)) {
|
|
$this->fail(get_string('invalidimportfile', 'attendance'));
|
|
$this->importer->cleanup();
|
|
return;
|
|
}
|
|
} else {
|
|
$this->importid = $importid;
|
|
|
|
$this->importer = new csv_import_reader($this->importid, $type);
|
|
}
|
|
|
|
if (! $this->importer->init()) {
|
|
$this->fail(get_string('invalidimportfile', 'attendance'));
|
|
$this->importer->cleanup();
|
|
return;
|
|
}
|
|
|
|
$this->foundheaders = $this->importer->get_columns();
|
|
$this->useprogressbar = $useprogressbar;
|
|
$domainid = 1;
|
|
|
|
$sessions = array();
|
|
|
|
while ($row = $this->importer->next()) {
|
|
// This structure mimics what the UI form returns.
|
|
$mapping = $this->read_mapping_data($mappingdata);
|
|
|
|
$session = new stdClass();
|
|
$session->course = $this->get_column_data($row, $mapping['course']);
|
|
if (empty($session->course)) {
|
|
\mod_attendance_notifyqueue::notify_problem(get_string('error:sessioncourseinvalid', 'attendance'));
|
|
continue;
|
|
}
|
|
|
|
// Handle multiple group assignments per session. Expect semicolon separated group names.
|
|
$groups = $this->get_column_data($row, $mapping['groups']);
|
|
if (! empty($groups)) {
|
|
$session->groups = explode(';', $groups);
|
|
$session->sessiontype = \mod_attendance_structure::SESSION_GROUP;
|
|
} else {
|
|
$session->sessiontype = \mod_attendance_structure::SESSION_COMMON;
|
|
}
|
|
|
|
// Expect standardised date format, eg YYYY-MM-DD.
|
|
$sessiondate = strtotime($this->get_column_data($row, $mapping['sessiondate']));
|
|
if ($sessiondate === false) {
|
|
\mod_attendance_notifyqueue::notify_problem(get_string('error:sessiondateinvalid', 'attendance'));
|
|
continue;
|
|
}
|
|
$session->sessiondate = $sessiondate;
|
|
|
|
// Expect standardised time format, eg HH:MM.
|
|
$from = $this->get_column_data($row, $mapping['from']);
|
|
if (empty($from)) {
|
|
\mod_attendance_notifyqueue::notify_problem(get_string('error:sessionstartinvalid', 'attendance'));
|
|
continue;
|
|
}
|
|
$from = explode(':', $from);
|
|
$session->sestime['starthour'] = $from[0];
|
|
$session->sestime['startminute'] = $from[1];
|
|
|
|
$to = $this->get_column_data($row, $mapping['to']);
|
|
if (empty($to)) {
|
|
\mod_attendance_notifyqueue::notify_problem(get_string('error:sessionendinvalid', 'attendance'));
|
|
continue;
|
|
}
|
|
$to = explode(':', $to);
|
|
$session->sestime['endhour'] = $to[0];
|
|
$session->sestime['endminute'] = $to[1];
|
|
|
|
// Wrap the plain text description in html tags.
|
|
$session->sdescription['text'] = '<p>' . $this->get_column_data($row, $mapping['description']) . '</p>';
|
|
$session->sdescription['format'] = FORMAT_HTML;
|
|
$session->sdescription['itemid'] = 0;
|
|
$session->passwordgrp = $this->get_column_data($row, $mapping['passwordgrp']);
|
|
$session->subnet = $this->get_column_data($row, $mapping['subnet']);
|
|
// Set session subnet restriction. Use the default activity level subnet if there isn't one set for this session.
|
|
if (empty($session->subnet)) {
|
|
$session->usedefaultsubnet = '1';
|
|
} else {
|
|
$session->usedefaultsubnet = '';
|
|
}
|
|
|
|
if ($mapping['studentscanmark'] == -1) {
|
|
$session->studentscanmark = $pluginconfig->studentscanmark_default;
|
|
} else {
|
|
$session->studentscanmark = $this->get_column_data($row, $mapping['studentscanmark']);
|
|
}
|
|
if ($mapping['randompassword'] == -1) {
|
|
$session->randompassword = $pluginconfig->randompassword_default;
|
|
} else {
|
|
$session->randompassword = $this->get_column_data($row, $mapping['randompassword']);
|
|
}
|
|
if ($mapping['automark'] == -1) {
|
|
$session->automark = $pluginconfig->automark_default;
|
|
} else {
|
|
$session->automark = $this->get_column_data($row, $mapping['automark']);
|
|
}
|
|
if ($mapping['autoassignstatus'] == -1) {
|
|
$session->autoassignstatus = $pluginconfig->autoassignstatus;
|
|
} else {
|
|
$session->autoassignstatus = $this->get_column_data($row, $mapping['autoassignstatus']);
|
|
}
|
|
if ($mapping['absenteereport'] == -1) {
|
|
$session->absenteereport = $pluginconfig->absenteereport_default;
|
|
} else {
|
|
$session->absenteereport = $this->get_column_data($row, $mapping['absenteereport']);
|
|
}
|
|
if ($mapping['preventsharedip'] == -1) {
|
|
$session->preventsharedip = $pluginconfig->preventsharedip;
|
|
} else {
|
|
$session->preventsharedip = $this->get_column_data($row, $mapping['preventsharedip']);
|
|
}
|
|
if ($mapping['preventsharediptime'] == -1) {
|
|
$session->preventsharediptime = $pluginconfig->preventsharediptime;
|
|
} else {
|
|
$session->preventsharediptime = $this->get_column_data($row, $mapping['preventsharediptime']);
|
|
}
|
|
|
|
if ($mapping['calendarevent'] == -1) {
|
|
$session->calendarevent = $pluginconfig->calendarevent_default;
|
|
} else {
|
|
$session->calendarevent = $this->get_column_data($row, $mapping['calendarevent']);
|
|
}
|
|
|
|
if ($mapping['includeqrcode'] == -1) {
|
|
$session->includeqrcode = $pluginconfig->includeqrcode_default;
|
|
} else {
|
|
$session->includeqrcode = $this->get_column_data($row, $mapping['includeqrcode']);
|
|
|
|
if ($session->includeqrcode == 1 && $session->studentscanmark != 1) {
|
|
\mod_attendance_notifyqueue::notify_problem(get_string('error:qrcode', 'attendance'));
|
|
continue;
|
|
}
|
|
|
|
}
|
|
if ($mapping['rotateqrcode'] == -1) {
|
|
$session->rotateqrcode = $pluginconfig->rotateqrcode_default;
|
|
} else {
|
|
$session->rotateqrcode = $this->get_column_data($row, $mapping['rotateqrcode']);
|
|
}
|
|
|
|
$session->statusset = 0;
|
|
|
|
$sessions[] = $session;
|
|
}
|
|
$this->sessions = $sessions;
|
|
|
|
$this->importer->close();
|
|
if ($this->sessions == null) {
|
|
$this->fail(get_string('invalidimportfile', 'attendance'));
|
|
return;
|
|
} else {
|
|
// We are calling from browser, display progress bar.
|
|
if ($this->useprogressbar === true) {
|
|
$this->progress = new \core\progress\display_if_slow(get_string('processingfile', 'attendance'));
|
|
$this->progress->start_html();
|
|
} else {
|
|
// Avoid html output on CLI scripts.
|
|
$this->progress = new \core\progress\none();
|
|
}
|
|
$this->progress->start_progress('', count($this->sessions));
|
|
raise_memory_limit(MEMORY_EXTRA);
|
|
$this->progress->end_progress();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get parse errors.
|
|
*
|
|
* @return array of errors from parsing the xml.
|
|
*/
|
|
public function get_error() {
|
|
return $this->error;
|
|
}
|
|
|
|
/**
|
|
* Create sessions using the CSV data.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function import() {
|
|
global $DB;
|
|
|
|
// Count of sessions added.
|
|
$okcount = 0;
|
|
|
|
foreach ($this->sessions as $session) {
|
|
$groupids = array();
|
|
// Check course shortname matches.
|
|
if ($DB->record_exists('course', array(
|
|
'shortname' => $session->course
|
|
))) {
|
|
// Get course.
|
|
$course = $DB->get_record('course', array(
|
|
'shortname' => $session->course
|
|
), '*', MUST_EXIST);
|
|
|
|
// Check course has activities.
|
|
if ($DB->record_exists('attendance', array(
|
|
'course' => $course->id
|
|
))) {
|
|
// Translate group names to group IDs. They are unique per course.
|
|
if ($session->sessiontype === \mod_attendance_structure::SESSION_GROUP) {
|
|
foreach ($session->groups as $groupname) {
|
|
$gid = groups_get_group_by_name($course->id, $groupname);
|
|
if ($gid === false) {
|
|
\mod_attendance_notifyqueue::notify_problem(get_string('sessionunknowngroup',
|
|
'attendance', $groupname));
|
|
} else {
|
|
$groupids[] = $gid;
|
|
}
|
|
}
|
|
$session->groups = $groupids;
|
|
}
|
|
|
|
// Get activities in course.
|
|
$activities = $DB->get_recordset('attendance', array(
|
|
'course' => $course->id
|
|
), 'id', 'id');
|
|
|
|
foreach ($activities as $activity) {
|
|
// Build the session data.
|
|
$cm = get_coursemodule_from_instance('attendance', $activity->id, $course->id);
|
|
if (!empty($cm->deletioninprogress)) {
|
|
// Don't do anything if this attendance is in recycle bin.
|
|
continue;
|
|
}
|
|
$att = new mod_attendance_structure($activity, $cm, $course);
|
|
$sessions = attendance_construct_sessions_data_for_add($session, $att);
|
|
|
|
foreach ($sessions as $index => $sess) {
|
|
// Check for duplicate sessions.
|
|
if ($this->session_exists($sess, $att->id)) {
|
|
mod_attendance_notifyqueue::notify_message(get_string('sessionduplicate', 'attendance', (array(
|
|
'course' => $session->course,
|
|
'activity' => $cm->name,
|
|
'date' => construct_session_full_date_time($sess->sessdate, $sess->duration)
|
|
))));
|
|
unset($sessions[$index]);
|
|
} else {
|
|
$okcount ++;
|
|
}
|
|
}
|
|
if (! empty($sessions)) {
|
|
$att->add_sessions($sessions);
|
|
}
|
|
}
|
|
$activities->close();
|
|
} else {
|
|
mod_attendance_notifyqueue::notify_problem(get_string('error:coursehasnoattendance',
|
|
'attendance', $session->course));
|
|
}
|
|
} else {
|
|
mod_attendance_notifyqueue::notify_problem(get_string('error:coursenotfound', 'attendance', $session->course));
|
|
}
|
|
}
|
|
|
|
$message = get_string('sessionsgenerated', 'attendance', $okcount);
|
|
if ($okcount < 1) {
|
|
mod_attendance_notifyqueue::notify_message($message);
|
|
} else {
|
|
mod_attendance_notifyqueue::notify_success($message);
|
|
}
|
|
|
|
// Trigger a sessions imported event.
|
|
$event = \mod_attendance\event\sessions_imported::create(array(
|
|
'objectid' => 0,
|
|
'context' => \context_system::instance(),
|
|
'other' => array(
|
|
'count' => $okcount
|
|
)
|
|
));
|
|
|
|
$event->trigger();
|
|
}
|
|
|
|
/**
|
|
* Check if an identical session exists.
|
|
*
|
|
* @param stdClass $session
|
|
* @param int $attid
|
|
* @return boolean
|
|
*/
|
|
private function session_exists(stdClass $session, $attid) {
|
|
global $DB;
|
|
|
|
$check = ['attendanceid' => $attid,
|
|
'sessdate' => $session->sessdate,
|
|
'duration' => $session->duration,
|
|
'groupid' => $session->groupid];
|
|
if ($DB->record_exists('attendance_sessions', $check)) {
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
}
|
|
|