Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
<?php
// This file is part of the Query submission plugin
//
// 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\local\areas\core_question;

use core\event\question_created;
use core\event\question_updated;
use tool_brickfield\area_base;

/**
< * Base class for various question-related areas
> * Base class for various question-related areas.
* * This is an abstract class so it will be skipped by manager when it finds all areas * * @package tool_brickfield * @copyright 2020 onward: Brickfield Education Labs, www.brickfield.ie * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ abstract class base extends area_base { /** * Find recordset of the relevant areas.
> *
* @param \core\event\base $event * @return \moodle_recordset|null
< * @throws \coding_exception < * @throws \dml_exception
*/ public function find_relevant_areas(\core\event\base $event): ?\moodle_recordset { global $DB;
<
if (($event instanceof question_created) || ($event instanceof question_updated)) {
< $rs = $DB->get_recordset_sql( < "SELECT {$this->get_type()} AS type,
> $sql = "SELECT {$this->get_type()} AS type,
ctx.id AS contextid, {$this->get_standard_area_fields_sql()}
< t.id AS itemid,
> q.id AS itemid,
{$this->get_course_and_cat_sql($event)}
< t.{$this->get_fieldname()} AS content < FROM {question} t < INNER JOIN {question_categories} qc ON qc.id = t.category < INNER JOIN {context} ctx ON ctx.id = qc.contextid < WHERE (t.id = :refid) < ORDER BY t.id", < [ < 'refid' => $event->objectid, < ]);
> q.{$this->get_fieldname()} AS content > FROM {question} q > INNER JOIN {question_versions} qv > ON qv.questionid = q.id > INNER JOIN {question_bank_entries} qbe > ON qbe.id = qv.questionbankentryid > INNER JOIN {question_categories} qc > ON qc.id = qbe.questioncategoryid > INNER JOIN {context} ctx > ON ctx.id = qc.contextid > WHERE (q.id = :refid) > ORDER BY q.id"; > > $rs = $DB->get_recordset_sql($sql, ['refid' => $event->objectid]);
return $rs; } return null; } /** * Find recordset of the course areas.
> *
* @param int $courseid * @return \moodle_recordset
< * @throws \coding_exception < * @throws \dml_exception
*/ public function find_course_areas(int $courseid): ?\moodle_recordset { global $DB;
<
$coursecontext = \context_course::instance($courseid);
< return $DB->get_recordset_sql( < "SELECT {$this->get_type()} AS type, < ctx.id AS contextid, < {$this->get_standard_area_fields_sql()} < t.id AS itemid, < {$courseid} AS courseid, < null AS categoryid, < t.{$this->get_fieldname()} AS content < FROM {question} t < INNER JOIN {question_categories} qc ON qc.id = t.category < INNER JOIN {context} ctx ON ctx.id = qc.contextid < WHERE (ctx.contextlevel = :ctxcourse AND ctx.id = qc.contextid AND ctx.instanceid = :courseid) OR < (ctx.contextlevel = :module AND {$DB->sql_like('ctx.path', ':coursecontextpath')}) < ORDER BY t.id ASC", < [
> $param = [
'ctxcourse' => CONTEXT_COURSE, 'courseid' => $courseid, 'module' => CONTEXT_MODULE, 'coursecontextpath' => $DB->sql_like_escape($coursecontext->path) . '/%',
< ]);
> ]; > > $sql = "SELECT {$this->get_type()} AS type, > ctx.id AS contextid, > {$this->get_standard_area_fields_sql()} > q.id AS itemid, > {$courseid} AS courseid, > null AS categoryid, > q.{$this->get_fieldname()} AS content > FROM {question} q > INNER JOIN {question_versions} qv > ON qv.questionid = q.id > INNER JOIN {question_bank_entries} qbe > ON qbe.id = qv.questionbankentryid > INNER JOIN {question_categories} qc > ON qc.id = qbe.questioncategoryid > INNER JOIN {context} ctx > ON ctx.id = qc.contextid > WHERE (ctx.contextlevel = :ctxcourse > AND ctx.id = qc.contextid > AND ctx.instanceid = :courseid) > OR (ctx.contextlevel = :module > AND {$DB->sql_like('ctx.path', ':coursecontextpath')}) > ORDER BY q.id ASC"; > > return $DB->get_recordset_sql($sql, $param);
} /** * Return an array of area objects that contain content at the site and system levels only. This would be question content from * question categories at the system context only.
> *
* @return \moodle_recordset
< * @throws \dml_exception
*/ public function find_system_areas(): ?\moodle_recordset { global $DB;
< < $select = 'SELECT ' . $this->get_type() . ' AS type, qc.contextid AS contextid, ' . $this->get_standard_area_fields_sql() . < ' t.id AS itemid, ' . SITEID . ' as courseid, cc.id as categoryid,' . < ' t.'.$this->get_fieldname().' AS content '; < $from = 'FROM {question} t ' . < 'INNER JOIN {question_categories} qc ON qc.id = t.category ' . < 'INNER JOIN {context} ctx ON ctx.id = qc.contextid ' . < 'LEFT JOIN {course_categories} cc ON cc.id = ctx.instanceid AND ctx.contextlevel = :coursecat '; < $where = 'WHERE (ctx.contextlevel = :syscontext) OR (ctx.contextlevel = :coursecat2) '; < $order = 'ORDER BY t.id';
$params = [ 'syscontext' => CONTEXT_SYSTEM, 'coursecat' => CONTEXT_COURSECAT, 'coursecat2' => CONTEXT_COURSECAT, ];
< return $DB->get_recordset_sql($select . $from . $where . $order, $params);
> $sql = "SELECT {$this->get_type()} AS type, > qc.contextid AS contextid, > {$this->get_standard_area_fields_sql()} > q.id AS itemid, > " . SITEID . " as courseid, > cc.id as categoryid, > q.{$this->get_fieldname()} AS content > FROM {question} q > INNER JOIN {question_versions} qv > ON qv.questionid = q.id > INNER JOIN {question_bank_entries} qbe > ON qbe.id = qv.questionbankentryid > INNER JOIN {question_categories} qc > ON qc.id = qbe.questioncategoryid > INNER JOIN {context} ctx > ON ctx.id = qc.contextid > LEFT JOIN {course_categories} cc > ON cc.id = ctx.instanceid > AND ctx.contextlevel = :coursecat > WHERE (ctx.contextlevel = :syscontext) > OR (ctx.contextlevel = :coursecat2) > ORDER BY q.id"; > > return $DB->get_recordset_sql($sql, $params);
} /** * Returns the moodle_url of the page to edit the error.
> *
* @param \stdClass $componentinfo * @return \moodle_url
< * @throws \moodle_exception
*/ public static function get_edit_url(\stdClass $componentinfo): \moodle_url { $questionid = $componentinfo->itemid;
< // Question answers are editable on main question page
> // Question answers are editable on main question page.
// Hence, use refid for these links.
< if ($componentinfo->tablename == 'question_answers') {
> if ($componentinfo->tablename === 'question_answers') {
$questionid = $componentinfo->refid; } // Default to SITEID if courseid is null, i.e. system or category level questions. $thiscourseid = ($componentinfo->courseid !== null) ? $componentinfo->courseid : SITEID;
< return new \moodle_url('/question/question.php', ['courseid' => $thiscourseid, 'id' => $questionid]);
> return new \moodle_url('/question/bank/editquestion/question.php', ['courseid' => $thiscourseid, 'id' => $questionid]);
} /** * Determine the course and category id SQL depending on the specific context associated with question data.
> *
* @param \core\event\base $event * @return string
< * @throws \dml_exception
*/ protected function get_course_and_cat_sql(\core\event\base $event): string {
< global $DB; <
$courseid = 'null'; $catid = 'null';
< $sql = " < SELECT ctx.instanceid, cm.course as courseid, ctx.contextlevel < FROM {question} q < INNER JOIN {question_categories} qc ON qc.id = q.category < INNER JOIN {context} ctx ON ctx.id = qc.contextid < LEFT JOIN {course_modules} cm ON cm.id = ctx.instanceid AND ctx.contextlevel = :coursemodule < WHERE q.id = :refid < "; < $params = [ < 'coursemodule' => CONTEXT_MODULE, < 'refid' => $event->objectid, < ]; < < if ($record = $DB->get_record_sql($sql, $params)) {
> if ($record = self::get_course_and_category(CONTEXT_MODULE, $event->objectid)) {
if ($record->contextlevel == CONTEXT_MODULE) { $courseid = $record->courseid; } else if ($record->contextlevel == CONTEXT_COURSE) { $courseid = $record->instanceid; } else if ($record->contextlevel == CONTEXT_COURSECAT) { $catid = $record->instanceid; } else if ($record->contextlevel == CONTEXT_SYSTEM) { $courseid = 1; } } return " {$courseid} AS courseid, {$catid} AS categoryid, ";
> } } > } > /** > * Get the course and category data for the question. > * > * @param int $coursemodule > * @param int $refid > * @return \stdClass|false > */ > public static function get_course_and_category($coursemodule, $refid) { > global $DB; > > $sql = 'SELECT ctx.instanceid, > cm.course as courseid, > ctx.contextlevel > FROM {question} q > INNER JOIN {question_versions} qv > ON qv.questionid = q.id > INNER JOIN {question_bank_entries} qbe > ON qbe.id = qv.questionbankentryid > INNER JOIN {question_categories} qc > ON qc.id = qbe.questioncategoryid > INNER JOIN {context} ctx > ON ctx.id = qc.contextid > LEFT JOIN {course_modules} cm > ON cm.id = ctx.instanceid > AND ctx.contextlevel = :coursemodule > WHERE q.id = :refid'; > $params = [ > 'coursemodule' => $coursemodule, > 'refid' => $refid > ]; > return $DB->get_record_sql($sql, $params);