844 lines
33 KiB
PHP
844 lines
33 KiB
PHP
<?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/>.
|
|
|
|
namespace tool_brickfield;
|
|
|
|
/**
|
|
* Class manager
|
|
* @package tool_brickfield
|
|
* @copyright 2021 Brickfield Education Labs https://www.brickfield.ie
|
|
* @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class manager {
|
|
|
|
/**
|
|
* Defines the waiting for analysis status.
|
|
*/
|
|
const STATUS_WAITING = 0;
|
|
|
|
/**
|
|
* Defined the analysis in progress status.
|
|
*/
|
|
const STATUS_INPROGRESS = -1;
|
|
|
|
/**
|
|
* Defines the analysis has completed status.
|
|
*/
|
|
const STATUS_CHECKED = 1;
|
|
|
|
/**
|
|
* Defines summary error value.
|
|
*/
|
|
const SUMMARY_ERROR = 0;
|
|
|
|
/**
|
|
* Defines summary failed value.
|
|
*/
|
|
const SUMMARY_FAILED = 1;
|
|
|
|
/**
|
|
* Defines summary percent value.
|
|
*/
|
|
const SUMMARY_PERCENT = 2;
|
|
|
|
/**
|
|
* Default bulk record limit.
|
|
*/
|
|
const BULKRECORDLIMIT = 1000;
|
|
|
|
/**
|
|
* Name of this plugin.
|
|
*/
|
|
const PLUGINNAME = 'tool_brickfield';
|
|
|
|
/**
|
|
* Areas table name.
|
|
*/
|
|
const DB_AREAS = self::PLUGINNAME . '_areas';
|
|
|
|
/**
|
|
* Cacheacts table name.
|
|
*/
|
|
const DB_CACHEACTS = self::PLUGINNAME . '_cache_acts';
|
|
|
|
/**
|
|
* Cachecheck table name.
|
|
*/
|
|
const DB_CACHECHECK = self::PLUGINNAME . '_cache_check';
|
|
|
|
/**
|
|
* Checks table name.
|
|
*/
|
|
const DB_CHECKS = self::PLUGINNAME . '_checks';
|
|
|
|
/**
|
|
* Content table name.
|
|
*/
|
|
const DB_CONTENT = self::PLUGINNAME . '_content';
|
|
|
|
/**
|
|
* Errors table name.
|
|
*/
|
|
const DB_ERRORS = self::PLUGINNAME . '_errors';
|
|
|
|
/**
|
|
* Process table name.
|
|
*/
|
|
const DB_PROCESS = self::PLUGINNAME . '_process';
|
|
|
|
/**
|
|
* Results table name.
|
|
*/
|
|
const DB_RESULTS = self::PLUGINNAME . '_results';
|
|
|
|
/**
|
|
* Schedule table name.
|
|
*/
|
|
const DB_SCHEDULE = self::PLUGINNAME . '_schedule';
|
|
|
|
/**
|
|
* Summary table name.
|
|
*/
|
|
const DB_SUMMARY = self::PLUGINNAME . '_summary';
|
|
|
|
/** @var string The URL to find help at. */
|
|
private static $helpurl = 'https://www.brickfield.ie/moodle-help-311';
|
|
|
|
|
|
/** @var array Statically stores the database checks records. */
|
|
static protected $checks;
|
|
|
|
/**
|
|
* Returns the URL used for registration.
|
|
*
|
|
* @return \moodle_url
|
|
*/
|
|
public static function registration_url(): \moodle_url {
|
|
return accessibility::get_plugin_url('registration.php');
|
|
}
|
|
|
|
/**
|
|
* Returns an appropriate message about the current registration state.
|
|
*
|
|
* @return string
|
|
* @throws \coding_exception
|
|
* @throws \dml_exception
|
|
* @throws \moodle_exception
|
|
*/
|
|
public static function registration_message(): string {
|
|
$firstline = get_string('notregistered', self::PLUGINNAME);
|
|
if (has_capability('moodle/site:config', \context_system::instance())) {
|
|
$secondline = \html_writer::link(self::registration_url(), get_string('registernow', self::PLUGINNAME));
|
|
} else {
|
|
$secondline = get_string('contactadmin', self::PLUGINNAME);
|
|
}
|
|
return $firstline . '<br />' . $secondline;
|
|
}
|
|
|
|
/**
|
|
* Get the help page URL.
|
|
* @return string
|
|
* @throws dml_exception
|
|
*/
|
|
public static function get_helpurl(): string {
|
|
return self::$helpurl;
|
|
}
|
|
|
|
/**
|
|
* Return an array of system checks available, and store them statically.
|
|
*
|
|
* @return array
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function get_checks(): array {
|
|
global $DB;
|
|
if (self::$checks === null) {
|
|
self::$checks = $DB->get_records(self::DB_CHECKS, [] , 'id');
|
|
}
|
|
return self::$checks;
|
|
}
|
|
|
|
/**
|
|
* Find all available areas.
|
|
*
|
|
* @return area_base[]
|
|
* @throws \ReflectionException
|
|
*/
|
|
public static function get_all_areas(): array {
|
|
return array_filter(
|
|
array_map(
|
|
function($classname) {
|
|
$reflectionclass = new \ReflectionClass($classname);
|
|
if ($reflectionclass->isAbstract()) {
|
|
return false;
|
|
}
|
|
$instance = new $classname();
|
|
|
|
if ($instance->is_available()) {
|
|
return $instance;
|
|
} else {
|
|
return null;
|
|
}
|
|
},
|
|
array_keys(\core_component::get_component_classes_in_namespace('tool_brickfield', 'local\areas'))
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Calculate contenthash of a given content string
|
|
*
|
|
* @param string|null $content
|
|
* @return string
|
|
*/
|
|
public static function get_contenthash(?string $content = null): string {
|
|
return sha1($content ?? '');
|
|
}
|
|
|
|
/**
|
|
* Does the current area content need to be scheduled for check?
|
|
*
|
|
* It does not need to be scheduled if:
|
|
* - it is the current content
|
|
* OR
|
|
* - there is already schedule
|
|
*
|
|
* @param int $areaid
|
|
* @param string $contenthash
|
|
* @return bool
|
|
* @throws \dml_exception
|
|
*/
|
|
protected static function content_needs_scheduling(int $areaid, string $contenthash): bool {
|
|
global $DB;
|
|
return ! $DB->get_field_sql('SELECT 1 FROM {' . self::DB_CONTENT . '} '.
|
|
'WHERE areaid = ?
|
|
AND (status = 0 OR (iscurrent = 1 AND contenthash = ?))',
|
|
[$areaid, $contenthash], IGNORE_MULTIPLE);
|
|
}
|
|
|
|
/**
|
|
* Schedule an area for analysis if there has been changes.
|
|
*
|
|
* @param \stdClass $arearecord record with the fields from the {tool_brickfield_areas} table
|
|
* as returned by area_base::find_relevant_areas().
|
|
* It also contains the 'content' property with the current area content
|
|
* @throws \dml_exception
|
|
*/
|
|
protected static function schedule_area_if_necessary(\stdClass $arearecord) {
|
|
global $DB;
|
|
|
|
$contenthash = static::get_contenthash($arearecord->content);
|
|
$searchparams = array_diff_key((array)$arearecord, ['content' => 1, 'reftable' => 1, 'refid' => 1]);
|
|
if ($dbrecord = $DB->get_record(self::DB_AREAS, $searchparams)) {
|
|
if ( ! static::content_needs_scheduling($dbrecord->id, $contenthash)) {
|
|
// This is already the latest content record or there is already scheduled record, nothing to do.
|
|
return;
|
|
}
|
|
} else {
|
|
$dbrecord = (object)array_diff_key((array)$arearecord, ['content' => 1]);
|
|
$dbrecord->id = $DB->insert_record(self::DB_AREAS, $dbrecord);
|
|
}
|
|
// Schedule the area for the check. Note that we do not record the contenthash, we will calculate it again
|
|
// during the actual check.
|
|
$DB->insert_record(self::DB_CONTENT,
|
|
(object)['areaid' => $dbrecord->id, 'contenthash' => '', 'timecreated' => time(),
|
|
'status' => self::STATUS_WAITING]);
|
|
}
|
|
|
|
/**
|
|
* Asks all area providers if they have any areas that might have changed as a result of an event and schedules them
|
|
*
|
|
* @param \core\event\base $event
|
|
* @throws \ReflectionException
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function find_new_or_updated_areas(\core\event\base $event) {
|
|
foreach (static::get_all_areas() as $area) {
|
|
if ($records = $area->find_relevant_areas($event)) {
|
|
foreach ($records as $record) {
|
|
static::schedule_area_if_necessary($record);
|
|
}
|
|
$records->close();
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the current content of the area.
|
|
*
|
|
* @param \stdClass $arearecord record from the tool_brickfield_areas table
|
|
* @return array|null array where the first element is the value of the field and the second element
|
|
* is the 'format' for this field if it is present. If the record was not found null is returned.
|
|
* @throws \ddl_exception
|
|
* @throws \ddl_table_missing_exception
|
|
* @throws \dml_exception
|
|
*/
|
|
protected static function get_area_content(\stdClass $arearecord): array {
|
|
global $DB;
|
|
if ($arearecord->type == area_base::TYPE_FIELD) {
|
|
$tablename = $arearecord->tablename;
|
|
$fieldname = $arearecord->fieldorarea;
|
|
$itemid = $arearecord->itemid;
|
|
|
|
if (!$DB->get_manager()->table_exists($tablename)) {
|
|
return [];
|
|
}
|
|
if (!$DB->get_manager()->field_exists($tablename, $fieldname)) {
|
|
return [];
|
|
}
|
|
$fields = $fieldname;
|
|
if ($DB->get_manager()->field_exists($tablename, $fieldname . 'format')) {
|
|
$fields .= ',' . $fieldname . 'format';
|
|
}
|
|
if ($record = $DB->get_record($tablename, ['id' => $itemid], $fields)) {
|
|
return array_values((array)$record);
|
|
}
|
|
}
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Asks all area providers if they have any areas that might have changed per courseid and schedules them.
|
|
*
|
|
* @param int $courseid
|
|
* @throws \ReflectionException
|
|
* @throws \coding_exception
|
|
* @throws \ddl_exception
|
|
* @throws \ddl_table_missing_exception
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function find_new_or_updated_areas_per_course(int $courseid) {
|
|
$totalcount = 0;
|
|
foreach (static::get_all_areas() as $area) {
|
|
if ($records = $area->find_course_areas($courseid)) {
|
|
foreach ($records as $record) {
|
|
$totalcount++;
|
|
static::schedule_area_if_necessary($record);
|
|
}
|
|
$records->close();
|
|
}
|
|
// For a site course request, also process the site level areas.
|
|
if (($courseid == SITEID) && ($records = $area->find_system_areas())) {
|
|
foreach ($records as $record) {
|
|
$totalcount++;
|
|
// Currently, the courseid in the area table is null if there is a category id.
|
|
if (!empty($record->categoryid)) {
|
|
$record->courseid = null;
|
|
}
|
|
static::schedule_area_if_necessary($record);
|
|
}
|
|
$records->close();
|
|
}
|
|
}
|
|
// Need to run for total count of areas.
|
|
static::check_scheduled_areas($totalcount);
|
|
}
|
|
|
|
/**
|
|
* Finds all areas that are waiting to be checked, performs checks. Returns true if there were records processed, false if not.
|
|
* To be called from scheduled task
|
|
*
|
|
* @param int $batch
|
|
* @return bool
|
|
* @throws \coding_exception
|
|
* @throws \ddl_exception
|
|
* @throws \ddl_table_missing_exception
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function check_scheduled_areas(int $batch = 0): bool {
|
|
global $DB;
|
|
|
|
$processingtime = 0;
|
|
$resultstime = 0;
|
|
|
|
$config = get_config(self::PLUGINNAME);
|
|
if ($batch == 0) {
|
|
$batch = $config->batch;
|
|
}
|
|
// Creating insert array for courseid cache reruns.
|
|
$recordsfound = false;
|
|
$batchinserts = [];
|
|
echo("Batch amount is ".$batch.", starttime ".time()."\n");
|
|
$rs = $DB->get_recordset_sql('SELECT a.*, ch.id AS contentid
|
|
FROM {' . self::DB_AREAS. '} a
|
|
JOIN {' . self::DB_CONTENT . '} ch ON ch.areaid = a.id
|
|
WHERE ch.status = ?
|
|
ORDER BY a.id, ch.timecreated, ch.id',
|
|
[self::STATUS_WAITING], 0, $batch);
|
|
|
|
foreach ($rs as $arearecord) {
|
|
$recordsfound = true;
|
|
$DB->set_field(self::DB_CONTENT, 'status', self::STATUS_INPROGRESS, ['id' => $arearecord->contentid]);
|
|
$content = static::get_area_content($arearecord);
|
|
if ($content[0] == null) {
|
|
$content[0] = '';
|
|
}
|
|
accessibility::run_check($content[0], $arearecord->contentid, $processingtime, $resultstime);
|
|
|
|
// Set all content 'iscurrent' fields for this areaid to 0.
|
|
$DB->set_field(self::DB_CONTENT, 'iscurrent', 0, ['areaid' => $arearecord->id]);
|
|
// Update this content record to be the current record.
|
|
$DB->update_record(self::DB_CONTENT,
|
|
(object)['id' => $arearecord->contentid, 'status' => self::STATUS_CHECKED, 'timechecked' => time(),
|
|
'contenthash' => static::get_contenthash($content[0]), 'iscurrent' => 1]);
|
|
|
|
// If full caching has been run, then queue, if not in queue already.
|
|
if (($arearecord->courseid != null) && static::is_okay_to_cache() &&
|
|
!isset($batchinserts[$arearecord->courseid])) {
|
|
$batchinserts[$arearecord->courseid] = ['courseid' => $arearecord->courseid, 'item' => 'cache'];
|
|
}
|
|
}
|
|
|
|
if (count($batchinserts) > 0) {
|
|
$DB->insert_records(self::DB_PROCESS, $batchinserts);
|
|
}
|
|
|
|
mtrace('Total time in htmlchecker: ' . $processingtime . ' secs.');
|
|
mtrace('Total time in results: ' . $resultstime . ' secs.');
|
|
return $recordsfound;
|
|
}
|
|
|
|
/**
|
|
* Return true if analysis hasn't been disabled.
|
|
* @return bool
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function is_okay_to_cache(): bool {
|
|
return (analysis::type_is_byrequest());
|
|
}
|
|
|
|
/**
|
|
* Finds all areas that are waiting to be deleted, performs deletions.
|
|
*
|
|
* @param int $batch limit, can be called from runcli.php
|
|
* To be called from scheduled task
|
|
* @throws \coding_exception
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function check_scheduled_deletions(int $batch = 0) {
|
|
global $DB;
|
|
|
|
$config = get_config(self::PLUGINNAME);
|
|
if ($batch == 0) {
|
|
$batch = $config->batch;
|
|
}
|
|
|
|
// Creating insert array for courseid cache reruns.
|
|
$batchinserts = [];
|
|
|
|
$rs = $DB->get_recordset(self::DB_PROCESS, ['contextid' => -1, 'timecompleted' => 0], '', '*', 0, $batch);
|
|
|
|
foreach ($rs as $record) {
|
|
|
|
if ($record->item == "core_course") {
|
|
$tidyparams = ['courseid' => $record->courseid];
|
|
static::delete_summary_data($record->courseid); // Delete cache too.
|
|
} else if ($record->item == "course_categories") {
|
|
$tidyparams = ['component' => 'core_course', 'categoryid' => $record->innercontextid];
|
|
} else if ($record->item == "course_sections") {
|
|
// Locate course sections, using innercontextid, contextid set to -1 for delete.
|
|
$tidyparams = ['courseid' => $record->courseid, 'component' => 'core_course',
|
|
'tablename' => $record->item, 'itemid' => $record->innercontextid];
|
|
} else if ($record->item == "lesson_pages") {
|
|
// Locate lesson pages, using innercontextid, contextid set to -1 for delete.
|
|
$tidyparams = ['courseid' => $record->courseid, 'component' => 'mod_lesson',
|
|
'tablename' => $record->item, 'itemid' => $record->innercontextid];
|
|
} else if ($record->item == "book_chapters") {
|
|
// Locate book chapters, using innercontextid, contextid set to -1 for delete.
|
|
$tidyparams = ['courseid' => $record->courseid, 'component' => 'mod_book',
|
|
'tablename' => $record->item, 'itemid' => $record->innercontextid];
|
|
} else if ($record->item == "question") {
|
|
// Locate question areas, using innercontextid, contextid set to -1 for delete.
|
|
$tidyparams = [
|
|
'courseid' => $record->courseid, 'component' => 'core_question',
|
|
'tablename' => $record->item, 'itemid' => $record->innercontextid
|
|
];
|
|
} else {
|
|
// Locate specific module instance, using innercontextid, contextid set to -1 for delete.
|
|
$tidyparams = ['courseid' => $record->courseid, 'component' => $record->item,
|
|
'itemid' => $record->innercontextid];
|
|
}
|
|
|
|
$areas = $DB->get_records(self::DB_AREAS, $tidyparams);
|
|
foreach ($areas as $area) {
|
|
static::delete_area_tree($area);
|
|
}
|
|
|
|
$DB->delete_records(self::DB_PROCESS, ['id' => $record->id]);
|
|
|
|
// If full caching has been run, then queue, if not in queue already.
|
|
if ($record->courseid != null && static::is_okay_to_cache() && !isset($batchinserts[$record->courseid])) {
|
|
$batchinserts[$record->courseid] = ['courseid' => $record->courseid, 'item' => 'cache'];
|
|
}
|
|
}
|
|
$rs->close();
|
|
|
|
if (count($batchinserts) > 0) {
|
|
$DB->insert_records(self::DB_PROCESS, $batchinserts);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks all queued course updates, and finds all relevant areas.
|
|
*
|
|
* @param int $batch limit
|
|
* To be called from scheduled task
|
|
* @throws \ReflectionException
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function check_course_updates(int $batch = 0) {
|
|
global $DB;
|
|
|
|
if ($batch == 0) {
|
|
$config = get_config(self::PLUGINNAME);
|
|
$batch = $config->batch;
|
|
}
|
|
|
|
$recs = $DB->get_records(self::DB_PROCESS, ['item' => 'coursererun'], '', 'DISTINCT courseid', 0, $batch);
|
|
|
|
foreach ($recs as $record) {
|
|
static::find_new_or_updated_areas_per_course($record->courseid);
|
|
$DB->delete_records(self::DB_PROCESS, ['courseid' => $record->courseid, 'item' => 'coursererun']);
|
|
static::store_result_summary($record->courseid);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Finds all records for a given content area and performs deletions.
|
|
*
|
|
* To be called from scheduled task
|
|
* @param \stdClass $area
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function delete_area_tree(\stdClass $area) {
|
|
global $DB;
|
|
|
|
$contents = $DB->get_records(self::DB_CONTENT, ['areaid' => $area->id]);
|
|
foreach ($contents as $content) {
|
|
$results = $DB->get_records(self::DB_RESULTS, ['contentid' => $content->id]);
|
|
foreach ($results as $result) {
|
|
$DB->delete_records(self::DB_ERRORS, ['resultid' => $result->id]);
|
|
}
|
|
$DB->delete_records(self::DB_RESULTS, ['contentid' => $content->id]);
|
|
}
|
|
|
|
// Also, delete all child areas, if existing.
|
|
$childparams = ['type' => $area->type, 'reftable' => $area->tablename,
|
|
'refid' => $area->itemid];
|
|
$childareas = $DB->get_records(self::DB_AREAS, $childparams);
|
|
foreach ($childareas as $childarea) {
|
|
static::delete_area_tree($childarea);
|
|
}
|
|
|
|
$DB->delete_records(self::DB_CONTENT, ['areaid' => $area->id]);
|
|
$DB->delete_records(self::DB_AREAS, ['id' => $area->id]);
|
|
}
|
|
|
|
/**
|
|
* Finds all records which are no longer current and performs deletions.
|
|
*
|
|
* To be called from scheduled task.
|
|
*/
|
|
public static function delete_historical_data() {
|
|
global $DB;
|
|
|
|
$config = get_config(self::PLUGINNAME);
|
|
|
|
if ($config->deletehistoricaldata) {
|
|
$contents = $DB->get_records(self::DB_CONTENT, ['iscurrent' => 0, 'status' => self::STATUS_CHECKED]);
|
|
foreach ($contents as $content) {
|
|
$results = $DB->get_records(self::DB_RESULTS, ['contentid' => $content->id]);
|
|
foreach ($results as $result) {
|
|
$DB->delete_records(self::DB_ERRORS, ['resultid' => $result->id]);
|
|
}
|
|
$DB->delete_records(self::DB_RESULTS, ['contentid' => $content->id]);
|
|
$DB->delete_records(self::DB_CONTENT, ['id' => $content->id]);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Finds all summary cache records for a given courseid and performs deletions.
|
|
* To be called from scheduled task.
|
|
*
|
|
* @param int $courseid
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function delete_summary_data(int $courseid) {
|
|
global $DB;
|
|
|
|
if ($courseid == null) {
|
|
mtrace('Attempting to run delete_summary_data with no courseid, returning');
|
|
return;
|
|
}
|
|
|
|
$DB->delete_records(self::DB_SUMMARY, ['courseid' => $courseid]);
|
|
$DB->delete_records(self::DB_CACHECHECK, ['courseid' => $courseid]);
|
|
$DB->delete_records(self::DB_CACHEACTS, ['courseid' => $courseid]);
|
|
}
|
|
|
|
/**
|
|
* Finds all results required to display accessibility report and stores them in the database.
|
|
*
|
|
* To be called from scheduled task.
|
|
* @param int|null $courseid
|
|
* @throws \coding_exception
|
|
* @throws \dml_exception
|
|
*/
|
|
public static function store_result_summary(int $courseid = null) {
|
|
global $DB;
|
|
|
|
if (static::is_okay_to_cache() && ($courseid == null)) {
|
|
mtrace('Attempting to run update cache with no courseid, returning');
|
|
return;
|
|
}
|
|
|
|
$extrasql = !$courseid ? "" : "AND courseid = ?";
|
|
$coursesqlval = !$courseid ? [] : [$courseid];
|
|
|
|
// Count of failed activities and count of errors by check.
|
|
$errorsql = "SELECT areas.courseid, chx.checkgroup,
|
|
COUNT(DISTINCT (".$DB->sql_concat('areas.contextid', 'areas.component').")) AS failed,
|
|
SUM(res.errorcount) AS errors
|
|
FROM {" . self::DB_AREAS . "} areas
|
|
INNER JOIN {" . self::DB_CONTENT . "} ch ON ch.areaid = areas.id
|
|
INNER JOIN {" . self::DB_RESULTS . "} res ON res.contentid = ch.id
|
|
INNER JOIN {" . self::DB_CHECKS . "} chx ON chx.id = res.checkid
|
|
WHERE res.errorcount > ? AND ch.iscurrent = ? ". $extrasql ." GROUP BY courseid, chx.checkgroup";
|
|
|
|
$recordserrored = $DB->get_recordset_sql($errorsql, array_merge([0, 1], $coursesqlval));
|
|
|
|
// Count of failed activities by course.
|
|
$failsql = "SELECT areas.courseid,
|
|
COUNT(DISTINCT (".$DB->sql_concat('areas.contextid', 'areas.component').")) AS failed,
|
|
SUM(res.errorcount) AS errors
|
|
FROM {" . self::DB_AREAS . "} areas
|
|
INNER JOIN {" . self::DB_CONTENT . "} ch ON ch.areaid = areas.id
|
|
INNER JOIN {" . self::DB_RESULTS . "} res ON res.contentid = ch.id
|
|
WHERE res.errorcount > ? AND ch.iscurrent = ? ". $extrasql ." GROUP BY courseid";
|
|
|
|
$recordsfailed = $DB->get_recordset_sql($failsql, array_merge([0, 1], $coursesqlval));
|
|
|
|
$extrasql = !$courseid ? "" : "WHERE courseid = ?";
|
|
// Count of activities per course.
|
|
$countsql = "SELECT courseid, COUNT(DISTINCT (".$DB->sql_concat('areas.contextid', 'areas.component').")) AS activities
|
|
FROM {" . self::DB_AREAS . "} areas ". $extrasql ." GROUP BY areas.courseid";
|
|
|
|
$recordscount = $DB->get_records_sql($countsql, $coursesqlval);
|
|
|
|
$final = [];
|
|
$values = [];
|
|
|
|
foreach ($recordscount as $countrecord) {
|
|
$final[$countrecord->courseid] = array_pad(array(), 8,
|
|
[self::SUMMARY_ERROR => 0, self::SUMMARY_FAILED => 0, self::SUMMARY_PERCENT => 100]
|
|
) + [
|
|
"activitiespassed" => $countrecord->activities,
|
|
"activitiesfailed" => 0,
|
|
"activities" => $countrecord->activities
|
|
];
|
|
}
|
|
|
|
foreach ($recordsfailed as $failedrecord) {
|
|
$final[$failedrecord->courseid]["activitiespassed"] -= $failedrecord->failed;
|
|
$final[$failedrecord->courseid]["activitiesfailed"] += $failedrecord->failed;
|
|
}
|
|
|
|
foreach ($recordserrored as $errorrecord) {
|
|
$final[$errorrecord->courseid][$errorrecord->checkgroup][self::SUMMARY_ERROR] = $errorrecord->errors;
|
|
$final[$errorrecord->courseid][$errorrecord->checkgroup][self::SUMMARY_FAILED] = $errorrecord->failed;
|
|
$final[$errorrecord->courseid][$errorrecord->checkgroup][self::SUMMARY_PERCENT] = round(100 * (1 -
|
|
($final[$errorrecord->courseid][$errorrecord->checkgroup][self::SUMMARY_FAILED]
|
|
/ $final[$errorrecord->courseid]["activities"])));
|
|
}
|
|
|
|
foreach ($recordscount as $course) {
|
|
if (!$course->courseid) {
|
|
continue;
|
|
}
|
|
$element = [
|
|
'courseid' => $course->courseid,
|
|
'status' => self::STATUS_CHECKED,
|
|
'activities' => $final[$course->courseid]["activities"],
|
|
'activitiespassed' => $final[$course->courseid]["activitiespassed"],
|
|
'activitiesfailed' => $final[$course->courseid]["activitiesfailed"],
|
|
'errorschecktype1' => $final[$course->courseid][area_base::CHECKGROUP_FORM][self::SUMMARY_ERROR],
|
|
'errorschecktype2' => $final[$course->courseid][area_base::CHECKGROUP_IMAGE][self::SUMMARY_ERROR],
|
|
'errorschecktype3' => $final[$course->courseid][area_base::CHECKGROUP_LAYOUT][self::SUMMARY_ERROR],
|
|
'errorschecktype4' => $final[$course->courseid][area_base::CHECKGROUP_LINK][self::SUMMARY_ERROR],
|
|
'errorschecktype5' => $final[$course->courseid][area_base::CHECKGROUP_MEDIA][self::SUMMARY_ERROR],
|
|
'errorschecktype6' => $final[$course->courseid][area_base::CHECKGROUP_TABLE][self::SUMMARY_ERROR],
|
|
'errorschecktype7' => $final[$course->courseid][area_base::CHECKGROUP_TEXT][self::SUMMARY_ERROR],
|
|
'failedchecktype1' => $final[$course->courseid][area_base::CHECKGROUP_FORM][self::SUMMARY_FAILED],
|
|
'failedchecktype2' => $final[$course->courseid][area_base::CHECKGROUP_IMAGE][self::SUMMARY_FAILED],
|
|
'failedchecktype3' => $final[$course->courseid][area_base::CHECKGROUP_LAYOUT][self::SUMMARY_FAILED],
|
|
'failedchecktype4' => $final[$course->courseid][area_base::CHECKGROUP_LINK][self::SUMMARY_FAILED],
|
|
'failedchecktype5' => $final[$course->courseid][area_base::CHECKGROUP_MEDIA][self::SUMMARY_FAILED],
|
|
'failedchecktype6' => $final[$course->courseid][area_base::CHECKGROUP_TABLE][self::SUMMARY_FAILED],
|
|
'failedchecktype7' => $final[$course->courseid][area_base::CHECKGROUP_TEXT][self::SUMMARY_FAILED],
|
|
'percentchecktype1' => $final[$course->courseid][area_base::CHECKGROUP_FORM][self::SUMMARY_PERCENT],
|
|
'percentchecktype2' => $final[$course->courseid][area_base::CHECKGROUP_IMAGE][self::SUMMARY_PERCENT],
|
|
'percentchecktype3' => $final[$course->courseid][area_base::CHECKGROUP_LAYOUT][self::SUMMARY_PERCENT],
|
|
'percentchecktype4' => $final[$course->courseid][area_base::CHECKGROUP_LINK][self::SUMMARY_PERCENT],
|
|
'percentchecktype5' => $final[$course->courseid][area_base::CHECKGROUP_MEDIA][self::SUMMARY_PERCENT],
|
|
'percentchecktype6' => $final[$course->courseid][area_base::CHECKGROUP_TABLE][self::SUMMARY_PERCENT],
|
|
'percentchecktype7' => $final[$course->courseid][area_base::CHECKGROUP_TEXT][self::SUMMARY_PERCENT]
|
|
];
|
|
$resultid = $DB->get_field(self::DB_SUMMARY, 'id', ['courseid' => $course->courseid]);
|
|
if ($resultid) {
|
|
$element['id'] = $resultid;
|
|
$DB->update_record(self::DB_SUMMARY, (object)$element);
|
|
continue;
|
|
}
|
|
array_push($values, $element);
|
|
}
|
|
|
|
$DB->insert_records(self::DB_SUMMARY, $values);
|
|
|
|
$extrasql = !$courseid ? "WHERE courseid != ?" : "WHERE courseid = ?";
|
|
$coursesqlval = !$courseid ? [0] : [$courseid];
|
|
// Count of failed errors per check.
|
|
$checkssql = "SELECT area.courseid, ".self::STATUS_CHECKED." AS status, res.checkid,
|
|
COUNT(res.errorcount) as checkcount, SUM(res.errorcount) AS errorcount
|
|
FROM {" . self::DB_AREAS . "} area
|
|
INNER JOIN {" . self::DB_CONTENT . "} ch ON ch.areaid = area.id AND ch.iscurrent = 1
|
|
INNER JOIN {" . self::DB_RESULTS . "} res ON res.contentid = ch.id
|
|
".$extrasql." GROUP BY area.courseid, res.checkid";
|
|
|
|
$checksresult = $DB->get_recordset_sql($checkssql, $coursesqlval);
|
|
|
|
$checkvalues = [];
|
|
foreach ($checksresult as $check) {
|
|
if ($result = $DB->get_record(self::DB_CACHECHECK, ['courseid' => $check->courseid, 'checkid' => $check->checkid])) {
|
|
$check->id = $result->id;
|
|
$DB->update_record(self::DB_CACHECHECK, $check);
|
|
} else {
|
|
array_push($checkvalues, (array)$check);
|
|
}
|
|
}
|
|
$DB->insert_records(self::DB_CACHECHECK, $checkvalues);
|
|
|
|
// Count of failed or passed rate per activity.
|
|
$activitysql = "SELECT courseid, ".self::STATUS_CHECKED." AS status, area.component,
|
|
COUNT(DISTINCT area.contextid) AS totalactivities, 0 AS failedactivities,
|
|
COUNT(DISTINCT area.contextid) AS passedactivities, 0 AS errorcount
|
|
FROM {" . self::DB_AREAS . "} area
|
|
".$extrasql."
|
|
GROUP BY area.courseid, area.component";
|
|
|
|
$activityresults = $DB->get_recordset_sql($activitysql, $coursesqlval);
|
|
|
|
$activityvalues = [];
|
|
|
|
// Count of failed errors per courseid per activity.
|
|
$activityfailedsql = "SELECT area.courseid, area.component, area.contextid, SUM(res.errorcount) AS errorcount
|
|
FROM {" . self::DB_AREAS . "} area
|
|
INNER JOIN {" . self::DB_CONTENT . "} ch ON ch.areaid = area.id AND ch.iscurrent = 1
|
|
INNER JOIN {" . self::DB_RESULTS . "} res ON res.contentid = ch.id
|
|
".$extrasql." AND res.errorcount != 0
|
|
GROUP BY area.courseid, area.component, area.contextid";
|
|
|
|
$activityfailedresults = $DB->get_recordset_sql($activityfailedsql, $coursesqlval);
|
|
|
|
foreach ($activityresults as $activity) {
|
|
$tmpkey = $activity->courseid.$activity->component;
|
|
$activityvalues[$tmpkey] = $activity;
|
|
}
|
|
|
|
foreach ($activityfailedresults as $failed) {
|
|
$tmpkey = $failed->courseid.$failed->component;
|
|
$activityvalues[$tmpkey]->failedactivities ++;
|
|
$activityvalues[$tmpkey]->passedactivities --;
|
|
$activityvalues[$tmpkey]->errorcount += $failed->errorcount;
|
|
}
|
|
|
|
$activityvaluespush = [];
|
|
foreach ($activityvalues as $value) {
|
|
if ($result = $DB->get_record(self::DB_CACHEACTS, ['courseid' => $value->courseid, 'component' => $value->component])) {
|
|
$value->id = $result->id;
|
|
$DB->update_record(self::DB_CACHEACTS, $value);
|
|
} else {
|
|
array_push($activityvaluespush, (array)$value);
|
|
}
|
|
}
|
|
|
|
$DB->insert_records(self::DB_CACHEACTS, $activityvaluespush);
|
|
|
|
$recordserrored->close();
|
|
$recordsfailed->close();
|
|
$checksresult->close();
|
|
$activityresults->close();
|
|
$activityfailedresults->close();
|
|
}
|
|
|
|
/**
|
|
* Get course module summary information for a course.
|
|
*
|
|
* @param int $courseid
|
|
* @return \stdClass[]
|
|
*/
|
|
public static function get_cm_summary_for_course(int $courseid): array {
|
|
global $DB;
|
|
|
|
$sql = "
|
|
SELECT
|
|
area.cmid,
|
|
sum(errorcount) as numerrors,
|
|
count(errorcount) as numchecks
|
|
FROM {" . self::DB_AREAS . "} area
|
|
JOIN {" . self::DB_CONTENT . "} ch ON ch.areaid = area.id AND ch.iscurrent = 1
|
|
JOIN {" . self::DB_RESULTS . "} res ON res.contentid = ch.id
|
|
WHERE area.courseid = :courseid AND component != :component
|
|
GROUP BY cmid";
|
|
|
|
$params = [
|
|
'courseid' => $courseid,
|
|
'component' => 'core_course',
|
|
];
|
|
|
|
return $DB->get_records_sql($sql, $params);
|
|
}
|
|
|
|
/**
|
|
* Get section summary information for a course.
|
|
*
|
|
* @param int $courseid
|
|
* @return stdClass[]
|
|
*/
|
|
public static function get_section_summary_for_course(int $courseid): array {
|
|
global $DB;
|
|
|
|
$sql = "
|
|
SELECT
|
|
sec.section,
|
|
sum(errorcount) AS numerrors,
|
|
count(errorcount) as numchecks
|
|
FROM {" . self::DB_AREAS . "} area
|
|
JOIN {" . self::DB_CONTENT . "} ch ON ch.areaid = area.id AND ch.iscurrent = 1
|
|
JOIN {" . self::DB_RESULTS . "} res ON res.contentid = ch.id
|
|
JOIN {course_sections} sec ON area.itemid = sec.id
|
|
WHERE area.tablename = :tablename AND area.courseid = :courseid
|
|
GROUP BY sec.section";
|
|
|
|
$params = [
|
|
'courseid' => $courseid,
|
|
'tablename' => 'course_sections'
|
|
];
|
|
|
|
return $DB->get_records_sql($sql, $params);
|
|
}
|
|
}
|