moodle/moodle
3
0
Fork 0
mirror of https://github.com/moodle/moodle.git synced 2025-08-09 19:06:41 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

MDL-69863 tool_brickfield: Adding the Brickfield toolkit.

Browse source
This commit is contained in:
Mike Churchward 2021-04-23 16:40:34 -04:00 • committed by Eloy Lafuente (stronk7)
parent 49c74619f7
commit 43d29ccbed
279 changed files with 24982 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

204
admin/tool/brickfield/classes/sitedata.php Normal file
View file

@ -0,0 +1,204 @@
<?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;
use tool_brickfield\local\tool\filter;
use tool_brickfield\local\tool\tool;
/**
* Provides the Brickfield Accessibility toolkit site data API.
*
* @package tool_brickfield
* @copyright 2020 onward Brickfield Education Labs Ltd, https://www.brickfield.ie
* @author Mike Churchward (mike@brickfieldlabs.ie)
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class sitedata {
/** @var array An array of SQL parts to build an SQL statement. */
private $sqlparts = ['SELECT' => [], 'FROM' => '', 'WHERE' => '', 'GROUPBY' => '', 'ORDERBY' => ''];
/** @var array An array of SQL parameters. */
private $sqlparams = [];
/** @var array An array of labels to be displayed. */
private $grouplabels = [];
/** @var array An array of the used check group numbers. */
private $groupnumbers = [];
/** @var int The count of group labels. */
private $groupcount = 0;
/**
* Return the total number of courses that have been checked.
* @return int
* @throws \dml_exception
*/
public static function get_total_courses_checked(): int {
global $DB;
return $DB->count_records_select(manager::DB_AREAS, '', [], 'COUNT(DISTINCT courseid)');
}
/**
* Get records of component per course summary data.
* @param local\tool\filter $filter
* @return array
* @throws \coding_exception
* @throws \dml_exception
*/
public static function get_component_data(filter $filter): array {
global $DB;
$data = [];
if ($filter->validate_filters()) {
list($wheresql, $params) = $filter->get_course_sql('', true);
$sql = 'SELECT component, SUM(errorcount) as errorsum, SUM(totalactivities) as total, ' .
'SUM(failedactivities) as failed, SUM(passedactivities) as passed ' .
'FROM {' . manager::DB_CACHEACTS . '} area ' .
(empty($wheresql) ? '' : ('WHERE ' . $wheresql . ' ')) .
'GROUP BY area.component ' .
'ORDER BY area.component ASC';
$data = $DB->get_records_sql($sql, $params);
foreach ($data as $key => $componentsummary) {
$data[$key]->componentlabel = tool::get_module_label($componentsummary->component);
}
}
return $data;
}
/**
* Get records of check group per course summary data.
* @param local\tool\filter $filter
* @return array
* @throws \coding_exception
* @throws \dml_exception
*/
public function get_checkgroup_data(filter $filter): array {
global $DB;
$data = [];
if ($filter->validate_filters()) {
$this->get_base_checkgroup_sql($filter);
$sql = $this->get_select_string() . ' ' .
'FROM ' . $this->sqlparts['FROM'] . ' ' .
(!empty($this->sqlparts['WHERE']) ? 'WHERE ' . $this->sqlparts['WHERE'] . ' ' : '') .
(!empty($this->sqlparts['GROUPBY']) ? 'GROUP BY ' . $this->sqlparts['GROUPBY'] . ' ' : '') .
(!empty($this->sqlparts['ORDERBY']) ? 'ORDER BY ' . $this->sqlparts['ORDERBY'] . ' ' : '');
$data = array_values($DB->get_records_sql($sql, $this->sqlparams,
($filter->page * $filter->perpage), $filter->perpage));
if (empty($data)) {
$data[0] = (object)(array_values($this->grouplabels));
} else {
$data[0] = (object)(array_merge((array)$data[0], $this->grouplabels));
}
$data[0]->groupcount = $this->groupcount;
}
return $data;
}
/**
* Get records of check group per course summary data.
* @param local\tool\filter $filter
* @return array
* @throws \coding_exception
* @throws \dml_exception
*/
public function get_checkgroup_by_course_data(filter $filter): array {
$this->sqlparts['GROUPBY'] = 'courseid';
$this->add_select_item('courseid');
return $this->get_checkgroup_data($filter);
}
/**
* Get records of check group per course summary data.
* @param local\tool\filter $filter
* @return array
* @throws \coding_exception
* @throws \dml_exception
*/
public function get_checkgroup_with_failed_data(filter $filter): array {
$this->add_select_item('SUM(activitiesfailed) as failed');
return $this->get_checkgroup_data($filter);
}
/**
* Load up the base SQL parts.
* @param filter $filter
* @throws \coding_exception
* @throws \dml_exception
*/
private function get_base_checkgroup_sql(filter $filter) {
if ($filter->validate_filters()) {
$this->get_grouplabel_info();
list($this->sqlparts['WHERE'], $this->sqlparams) = $filter->get_course_sql('summ', true);
$this->add_select_item('SUM(activities) as activities');
foreach ($this->groupnumbers as $lab) {
$this->add_select_item("SUM(errorschecktype$lab) as errorsvalue$lab");
$this->add_select_item("SUM(failedchecktype$lab) as failedvalue$lab");
$this->add_select_item("AVG(percentchecktype$lab) as percentvalue$lab");
}
$this->sqlparts['FROM'] = '{' . manager::DB_SUMMARY . '} summ';
}
}
/**
* Load the group label information.
* @throws \coding_exception
* @throws \dml_exception
*/
private function get_grouplabel_info() {
global $DB;
// Don't need to do this more than once.
if (empty($this->grouplabels)) {
// Determine the checkgroups being used by this site.
$labelsql = 'SELECT DISTINCT checkgroup, checkgroup as cg2 FROM {' . manager::DB_CHECKS . '} ' .
'WHERE status = ? ORDER BY checkgroup ASC';
$groupvals = $DB->get_records_sql_menu($labelsql, [1]);
$grouplabels = array_intersect_key(area_base::CHECKGROUP_NAMES, $groupvals);
foreach ($grouplabels as $lab => $label) {
$this->grouplabels['componentlabel' . $lab] = get_string('checktype:' . $label, manager::PLUGINNAME);
$this->groupnumbers[] = $lab;
$this->groupcount++;
}
}
}
/**
* Add a select item to the sqlparts array.
* @param string $item
*/
private function add_select_item(string $item): void {
$this->sqlparts['SELECT'][] = $item;
}
/**
* Assemble and return the select portion of the sql.
* @return string
*/
private function get_select_string(): string {
return 'SELECT ' . implode(', ', $this->sqlparts['SELECT']);
}
}