Moodle release 3.11

Some fields were being hidden based on whether the service was set up
for internal service use or was a service shown on the login page.
These fields refer to OAuth 2 logins and must be configurable for both
kinds of services.

.eslintignore

@@ -1,4 +1,5 @@
 # Generated by "grunt ignorefiles"
+!/.grunt
 */**/yui/src/*/meta/
 */**/build/
 node_modules/
@@ -83,7 +84,6 @@ theme/boost/amd/src/bootstrap/button.js
 theme/boost/amd/src/bootstrap/carousel.js
 theme/boost/amd/src/bootstrap/collapse.js
 theme/boost/amd/src/bootstrap/dropdown.js
-theme/boost/amd/src/bootstrap/index.js
 theme/boost/amd/src/bootstrap/modal.js
 theme/boost/amd/src/bootstrap/popover.js
 theme/boost/amd/src/bootstrap/tools/sanitizer.js
@@ -92,4 +92,5 @@ theme/boost/amd/src/bootstrap/tab.js
 theme/boost/amd/src/bootstrap/toast.js
 theme/boost/amd/src/bootstrap/tooltip.js
 theme/boost/amd/src/bootstrap/util.js
-theme/boost/scss/fontawesome/
+theme/boost/amd/src/index.js
+theme/boost/scss/fontawesome/

.eslintrc

@@ -204,7 +204,7 @@
       }
     },
     {
-      files: ["**/amd/src/*.js", "**/amd/src/**/*.js", "Gruntfile*.js", "babel-plugin-add-module-to-define.js"],
+      files: ["**/amd/src/*.js", "**/amd/src/**/*.js", "Gruntfile.js", ".grunt/*.js", ".grunt/tasks/*.js"],
       // We support es6 now. Woot!
       env: {
         es6: true

.github/workflows/config-template.php

@@ -0,0 +1,71 @@
+<?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/>.
+
+/**
+ * Template configuraton file for github actions CI/CD.
+ *
+ * @package    core
+ * @copyright  2020 onwards Eloy Lafuente (stronk7) {@link https://stronk7.com}
+ * @license    https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+// This cannot be used out from a github actions workflow, so just exit.
+getenv('GITHUB_WORKFLOW') || die; // phpcs:ignore moodle.Files.MoodleInternal.MoodleInternalGlobalState
+
+unset($CFG);
+global $CFG;
+$CFG = new stdClass();
+
+$CFG->dbtype    = getenv('dbtype');
+$CFG->dblibrary = 'native';
+$CFG->dbhost    = '127.0.0.1';
+$CFG->dbname    = 'test';
+$CFG->dbuser    = 'test';
+$CFG->dbpass    = 'test';
+$CFG->prefix    = 'm_';
+$CFG->dboptions = ['dbcollation' => 'utf8mb4_bin'];
+
+$host = 'localhost';
+$CFG->wwwroot   = "http://{$host}";
+$CFG->dataroot  = realpath(dirname(__DIR__)) . '/moodledata';
+$CFG->admin     = 'admin';
+$CFG->directorypermissions = 0777;
+
+// Debug options - possible to be controlled by flag in future.
+$CFG->debug = (E_ALL | E_STRICT); // DEBUG_DEVELOPER.
+$CFG->debugdisplay = 1;
+$CFG->debugstringids = 1; // Add strings=1 to url to get string ids.
+$CFG->perfdebug = 15;
+$CFG->debugpageinfo = 1;
+$CFG->allowthemechangeonurl = 1;
+$CFG->passwordpolicy = 0;
+$CFG->cronclionly = 0;
+$CFG->pathtophp = getenv('pathtophp');
+
+$CFG->phpunit_dataroot  = realpath(dirname(__DIR__)) . '/phpunitdata';
+$CFG->phpunit_prefix = 't_';
+
+define('TEST_EXTERNAL_FILES_HTTP_URL', 'http://localhost:8080');
+define('TEST_EXTERNAL_FILES_HTTPS_URL', 'http://localhost:8080');
+
+define('TEST_SESSION_REDIS_HOST', 'localhost');
+define('TEST_CACHESTORE_REDIS_TESTSERVERS', 'localhost');
+
+// TODO: add others (solr, mongodb, memcached, ldap...).
+
+// Too much for now: define('PHPUNIT_LONGTEST', true); // Only leaves a few tests out and they are run later by CI.
+
+require_once(__DIR__ . '/lib/setup.php');

.github/workflows/push.yml

@@ -0,0 +1,113 @@
+name: Core
+
+on:
+  push:
+    branches-ignore:
+      - master
+      - MOODLE_[0-9]+_STABLE
+    tags-ignore:
+      - v[0-9]+.[0-9]+.[0-9]+*
+
+env:
+  php: 8.0
+
+jobs:
+  Grunt:
+    runs-on: ubuntu-18.04
+
+    steps:
+      - name: Checking out code
+        uses: actions/checkout@v2
+
+      - name: Configuring node & npm
+        shell: bash -l {0}
+        run: nvm install
+
+      - name: Installing node stuff
+        run: npm install
+
+      - name: Running grunt
+        run: npx grunt
+
+      - name: Looking for uncommitted changes
+        # Add all files to the git index and then run diff --cached to see all changes.
+        # This ensures that we get the status of all files, including new files.
+        # We ignore npm-shrinkwrap.json to make the tasks immune to npm changes.
+        run: |
+          git add .
+          git reset -- npm-shrinkwrap.json
+          git diff --cached --exit-code
+
+  PHPUnit:
+    runs-on: ${{ matrix.os }}
+    services:
+      exttests:
+        image: moodlehq/moodle-exttests
+        ports:
+          - 8080:80
+      redis:
+        image: redis
+        ports:
+          - 6379:6379
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-18.04
+            php: 7.3
+            extensions:
+            db: mysqli
+          - os: ubuntu-18.04
+            php: 8.0
+            db: pgsql
+            extensions: xmlrpc-beta
+
+    steps:
+      - name: Setting up DB mysql
+        if: ${{ matrix.db == 'mysqli' }}
+        uses: johanmeiring/mysql-action@tmpfs-patch
+        with:
+          collation server: utf8mb4_bin
+          mysql version: 5.7
+          mysql database: test
+          mysql user: test
+          mysql password: test
+          use tmpfs: true
+
+      - name: Setting up DB pgsql
+        if: ${{ matrix.db == 'pgsql' }}
+        uses: m4nu56/postgresql-action@v1
+        with:
+          postgresql version: 9.6
+          postgresql db: test
+          postgresql user: test
+          postgresql password: test
+
+      - name: Configuring git vars
+        uses: rlespinasse/github-slug-action@v3.x
+
+      - name: Setting up PHP ${{ matrix.php }}
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: ${{ matrix.extensions }}
+          ini-values: max_input_vars=5000
+          coverage: none
+
+      - name: Checking out code from ${{ env.GITHUB_REF_SLUG }}
+        uses: actions/checkout@v2
+
+      - name: Setting up PHPUnit
+        env:
+          dbtype: ${{ matrix.db }}
+        run: |
+          echo "pathtophp=$(which php)" >> $GITHUB_ENV # Inject installed pathtophp to env. The template config needs it.
+          cp .github/workflows/config-template.php config.php
+          mkdir ../moodledata
+          sudo locale-gen en_AU.UTF-8
+          php admin/tool/phpunit/cli/init.php --no-composer-self-update
+
+      - name: Running PHPUnit tests
+        env:
+          dbtype: ${{ matrix.db }}
+        run: vendor/bin/phpunit -v

.gitignore

@@ -46,3 +46,4 @@ composer.phar
 atlassian-ide-plugin.xml
 /node_modules/
 /.vscode/
+moodle-plugin-ci.phar

.grunt/babel-plugin-add-module-to-define.js

@@ -39,7 +39,7 @@ module.exports = ({template, types}) => {
     const fs = require('fs');
     const path = require('path');
     const cwd = process.cwd();
-    const ComponentList = require(path.resolve('GruntfileComponents.js'));
+    const ComponentList = require(path.join(process.cwd(), '.grunt', 'components.js'));
 
     /**
      * Search the list of components that match the given file name

.grunt/components.js

@@ -92,6 +92,16 @@ const fetchComponentData = () => {
     return componentData;
 };
 
+/**
+ * Get the list of component paths.
+ *
+ * @param   {string} relativeTo
+ * @returns {array}
+ */
+const getComponentPaths = (relativeTo = '') => fetchComponentData().pathList.map(componentPath => {
+    return componentPath.replace(relativeTo, '');
+});
+
 /**
  * Get the list of paths to build AMD sources.
  *
@@ -140,6 +150,49 @@ const getThirdPartyLibsList = relativeTo => {
         .sort();
 };
 
+/**
+ * Get the list of thirdparty library paths.
+ *
+ * @returns {array}
+ */
+const getThirdPartyPaths = () => {
+    const DOMParser = require('xmldom').DOMParser;
+    const fs = require('fs');
+    const path = require('path');
+    const xpath = require('xpath');
+
+    const thirdpartyfiles = getThirdPartyLibsList(fs.realpathSync('./'));
+    const libs = ['node_modules/', 'vendor/'];
+
+    const addLibToList = lib => {
+        if (!lib.match('\\*') && fs.statSync(lib).isDirectory()) {
+            // Ensure trailing slash on dirs.
+            lib = lib.replace(/\/?$/, '/');
+        }
+
+        // Look for duplicate paths before adding to array.
+        if (libs.indexOf(lib) === -1) {
+            libs.push(lib);
+        }
+    };
+
+    thirdpartyfiles.forEach(function(file) {
+        const dirname = path.dirname(file);
+
+        const xmlContent = fs.readFileSync(file, 'utf8');
+        const doc = new DOMParser().parseFromString(xmlContent);
+        const nodes = xpath.select("/libraries/library/location/text()", doc);
+
+        nodes.forEach(function(node) {
+            let lib = path.posix.join(dirname, node.toString());
+            addLibToList(lib);
+        });
+    });
+
+    return libs;
+
+};
+
 /**
  * Find the name of the component matching the specified path.
  *
@@ -182,7 +235,9 @@ const getOwningComponentDirectory = checkPath => {
 module.exports = {
     getAmdSrcGlobList,
     getComponentFromPath,
+    getComponentPaths,
     getOwningComponentDirectory,
     getYuiSrcGlobList,
     getThirdPartyLibsList,
+    getThirdPartyPaths,
 };

.grunt/tasks/eslint.js

@@ -0,0 +1,64 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+module.exports = grunt => {
+    const files = grunt.moodleEnv.files;
+
+    // Project configuration.
+    grunt.config.merge({
+        eslint: {
+            // Even though warnings dont stop the build we don't display warnings by default because
+            // at this moment we've got too many core warnings.
+            // To display warnings call: grunt eslint --show-lint-warnings
+            // To fail on warnings call: grunt eslint --max-lint-warnings=0
+            // Also --max-lint-warnings=-1 can be used to display warnings but not fail.
+            options: {
+                quiet: (!grunt.option('show-lint-warnings')) && (typeof grunt.option('max-lint-warnings') === 'undefined'),
+                maxWarnings: ((typeof grunt.option('max-lint-warnings') !== 'undefined') ? grunt.option('max-lint-warnings') : -1)
+            },
+
+            // Check AMD src files.
+            amd: {src: files ? files : grunt.moodleEnv.amdSrc},
+
+            // Check YUI module source files.
+            yui: {src: files ? files : grunt.moodleEnv.yuiSrc},
+        },
+    });
+
+    grunt.loadNpmTasks('grunt-eslint');
+
+    // On watch, we dynamically modify config to build only affected files. This
+    // method is slightly complicated to deal with multiple changed files at once (copied
+    // from the grunt-contrib-watch readme).
+    let changedFiles = Object.create(null);
+    const onChange = grunt.util._.debounce(function() {
+        const files = Object.keys(changedFiles);
+        grunt.config('eslint.amd.src', files);
+        grunt.config('eslint.yui.src', files);
+        changedFiles = Object.create(null);
+    }, 200);
+
+    grunt.event.on('watch', (action, filepath) => {
+        changedFiles[filepath] = action;
+        onChange();
+    });
+};

.grunt/tasks/gherkinlint.js

@@ -0,0 +1,89 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+module.exports = grunt => {
+    /**
+     * Get the list of feature files to pass to the gherkin linter.
+     *
+     * @returns {Array}
+     */
+    const getGherkinLintTargets = () => {
+        if (grunt.moodleEnv.files) {
+            // Specific files were requested. Only check these.
+            return grunt.moodleEnv.files;
+        }
+
+        if (grunt.moodleEnv.inComponent) {
+            return [`${grunt.moodleEnv.runDir}/tests/behat/*.feature`];
+        }
+
+        return ['**/tests/behat/*.feature'];
+    };
+
+    const handler = function() {
+        const done = this.async();
+        const options = grunt.config('gherkinlint.options');
+
+        // Grab the gherkin-lint linter and required scaffolding.
+        const linter = require('gherkin-lint/dist/linter.js');
+        const featureFinder = require('gherkin-lint/dist/feature-finder.js');
+        const configParser = require('gherkin-lint/dist/config-parser.js');
+        const formatter = require('gherkin-lint/dist/formatters/stylish.js');
+
+        // Run the linter.
+        return linter.lint(
+            featureFinder.getFeatureFiles(grunt.file.expand(options.files)),
+            configParser.getConfiguration(configParser.defaultConfigFileName)
+        )
+        .then(results => {
+            // Print the results out uncondtionally.
+            formatter.printResults(results);
+
+            return results;
+        })
+        .then(results => {
+            // Report on the results.
+            // The done function takes a bool whereby a falsey statement causes the task to fail.
+            return results.every(result => result.errors.length === 0);
+        })
+        .then(done); // eslint-disable-line promise/no-callback-in-promise
+    };
+
+    grunt.registerTask('gherkinlint', 'Run gherkinlint against the current directory', handler);
+
+    grunt.config.set('gherkinlint', {
+        options: {
+            files: getGherkinLintTargets(),
+        }
+    });
+
+    grunt.config.merge({
+        watch: {
+            gherkinlint: {
+                files: [grunt.moodleEnv.inComponent ? 'tests/behat/*.feature' : '**/tests/behat/*.feature'],
+                tasks: ['gherkinlint'],
+            },
+        },
+    });
+
+    return handler;
+};

.grunt/tasks/ignorefiles.js

@@ -0,0 +1,59 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+module.exports = grunt => {
+    /**
+     * Generate ignore files (utilising thirdpartylibs.xml data)
+     */
+    const handler = function() {
+        const path = require('path');
+        const ComponentList = require(path.join(process.cwd(), '.grunt', 'components.js'));
+
+        // An array of paths to third party directories.
+        const thirdPartyPaths = ComponentList.getThirdPartyPaths();
+
+        // Generate .eslintignore.
+        const eslintIgnores = [
+            '# Generated by "grunt ignorefiles"',
+            // Do not ignore the .grunt directory.
+            '!/.grunt',
+
+            // Ignore all yui/src meta directories and build directories.
+            '*/**/yui/src/*/meta/',
+            '*/**/build/',
+        ].concat(thirdPartyPaths);
+        grunt.file.write('.eslintignore', eslintIgnores.join('\n') + '\n');
+
+        // Generate .stylelintignore.
+        const stylelintIgnores = [
+            '# Generated by "grunt ignorefiles"',
+            '**/yui/build/*',
+            'theme/boost/style/moodle.css',
+            'theme/classic/style/moodle.css',
+        ].concat(thirdPartyPaths);
+        grunt.file.write('.stylelintignore', stylelintIgnores.join('\n') + '\n');
+    };
+
+    grunt.registerTask('ignorefiles', 'Generate ignore files for linters', handler);
+
+    return handler;
+};

.grunt/tasks/javascript.js

@@ -0,0 +1,141 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+/**
+ * Function to generate the destination for the uglify task
+ * (e.g. build/file.min.js). This function will be passed to
+ * the rename property of files array when building dynamically:
+ * http://gruntjs.com/configuring-tasks#building-the-files-object-dynamically
+ *
+ * @param {String} destPath the current destination
+ * @param {String} srcPath the  matched src path
+ * @return {String} The rewritten destination path.
+ */
+const babelRename = function(destPath, srcPath) {
+    destPath = srcPath.replace('src', 'build');
+    destPath = destPath.replace('.js', '.min.js');
+    return destPath;
+};
+
+module.exports = grunt => {
+    // Load the Shifter tasks.
+    require('./shifter')(grunt);
+
+    // Load ESLint.
+    require('./eslint')(grunt);
+
+    const path = require('path');
+
+    // Register JS tasks.
+    grunt.registerTask('yui', ['eslint:yui', 'shifter']);
+    grunt.registerTask('amd', ['eslint:amd', 'babel']);
+    grunt.registerTask('js', ['amd', 'yui']);
+
+    // Register NPM tasks.
+    grunt.loadNpmTasks('grunt-contrib-uglify');
+    grunt.loadNpmTasks('grunt-contrib-watch');
+
+    // Load the Babel tasks and config.
+    grunt.loadNpmTasks('grunt-babel');
+    grunt.config.merge({
+        babel: {
+            options: {
+                sourceMaps: true,
+                comments: false,
+                plugins: [
+                    'transform-es2015-modules-amd-lazy',
+                    'system-import-transformer',
+                    // This plugin modifies the Babel transpiling for "export default"
+                    // so that if it's used then only the exported value is returned
+                    // by the generated AMD module.
+                    //
+                    // It also adds the Moodle plugin name to the AMD module definition
+                    // so that it can be imported as expected in other modules.
+                    path.resolve('.grunt/babel-plugin-add-module-to-define.js'),
+                    '@babel/plugin-syntax-dynamic-import',
+                    '@babel/plugin-syntax-import-meta',
+                    ['@babel/plugin-proposal-class-properties', {'loose': false}],
+                    '@babel/plugin-proposal-json-strings'
+                ],
+                presets: [
+                    ['minify', {
+                        // This minification plugin needs to be disabled because it breaks the
+                        // source map generation and causes invalid source maps to be output.
+                        simplify: false,
+                        builtIns: false
+                    }],
+                    ['@babel/preset-env', {
+                        targets: {
+                            browsers: [
+                                ">0.25%",
+                                "last 2 versions",
+                                "not ie <= 10",
+                                "not op_mini all",
+                                "not Opera > 0",
+                                "not dead"
+                            ]
+                        },
+                        modules: false,
+                        useBuiltIns: false
+                    }]
+                ]
+            },
+            dist: {
+                files: [{
+                    expand: true,
+                    src: grunt.moodleEnv.files ? grunt.moodleEnv.files : grunt.moodleEnv.amdSrc,
+                    rename: babelRename
+                }]
+            }
+        },
+    });
+
+    grunt.config.merge({
+        watch: {
+            amd: {
+                files: grunt.moodleEnv.inComponent
+                    ? ['amd/src/*.js', 'amd/src/**/*.js']
+                    : ['**/amd/src/**/*.js'],
+                tasks: ['amd']
+            },
+        },
+    });
+
+    // On watch, we dynamically modify config to build only affected files. This
+    // method is slightly complicated to deal with multiple changed files at once (copied
+    // from the grunt-contrib-watch readme).
+    let changedFiles = Object.create(null);
+    const onChange = grunt.util._.debounce(function() {
+        const files = Object.keys(changedFiles);
+        grunt.config('babel.dist.files', [{expand: true, src: files, rename: babelRename}]);
+        changedFiles = Object.create(null);
+    }, 200);
+
+    grunt.event.on('watch', function(action, filepath) {
+        changedFiles[filepath] = action;
+        onChange();
+    });
+
+    return {
+        babelRename,
+    };
+};

.grunt/tasks/sass.js

@@ -0,0 +1,40 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+module.exports = grunt => {
+    grunt.loadNpmTasks('grunt-sass');
+
+    grunt.config.merge({
+        sass: {
+            dist: {
+                files: {
+                    "theme/boost/style/moodle.css": "theme/boost/scss/preset/default.scss",
+                    "theme/classic/style/moodle.css": "theme/classic/scss/classicgrunt.scss"
+                }
+            },
+            options: {
+                implementation: require('node-sass'),
+                includePaths: ["theme/boost/scss/", "theme/classic/scss/"]
+            }
+        },
+    });
+};

.grunt/tasks/shifter.js

@@ -0,0 +1,155 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+/* eslint-env node */
+
+module.exports = grunt => {
+    /**
+     * Shifter task. Is configured with a path to a specific file or a directory,
+     * in the case of a specific file it will work out the right module to be built.
+     *
+     * Note that this task runs the invidiaul shifter jobs async (becase it spawns
+     * so be careful to to call done().
+     */
+    const handler = function() {
+        const done = this.async();
+        const options = grunt.config('shifter.options');
+        const async = require('async');
+        const path = require('path');
+
+        // Run the shifter processes one at a time to avoid confusing output.
+        async.eachSeries(options.paths, function(src, filedone) {
+            var args = [];
+            args.push(path.normalize(process.cwd() + '/node_modules/shifter/bin/shifter'));
+
+            // Always ignore the node_modules directory.
+            args.push('--excludes', 'node_modules');
+
+            // Determine the most appropriate options to run with based upon the current location.
+            if (grunt.file.isMatch('**/yui/**/*.js', src)) {
+                // When passed a JS file, build our containing module (this happen with
+                // watch).
+                grunt.log.debug('Shifter passed a specific JS file');
+                src = path.dirname(path.dirname(src));
+                options.recursive = false;
+            } else if (grunt.file.isMatch('**/yui/src', src)) {
+                // When in a src directory --walk all modules.
+                grunt.log.debug('In a src directory');
+                args.push('--walk');
+                options.recursive = false;
+            } else if (grunt.file.isMatch('**/yui/src/*', src)) {
+                // When in module, only build our module.
+                grunt.log.debug('In a module directory');
+                options.recursive = false;
+            } else if (grunt.file.isMatch('**/yui/src/*/js', src)) {
+                // When in module src, only build our module.
+                grunt.log.debug('In a source directory');
+                src = path.dirname(src);
+                options.recursive = false;
+            }
+
+            if (grunt.option('watch')) {
+                grunt.fail.fatal('The --watch option has been removed, please use `grunt watch` instead');
+            }
+
+            // Add the stderr option if appropriate
+            if (grunt.option('verbose')) {
+                args.push('--lint-stderr');
+            }
+
+            if (grunt.option('no-color')) {
+                args.push('--color=false');
+            }
+
+            var execShifter = function() {
+
+                grunt.log.ok("Running shifter on " + src);
+                grunt.util.spawn({
+                    cmd: "node",
+                    args: args,
+                    opts: {cwd: src, stdio: 'inherit', env: process.env}
+                }, function(error, result, code) {
+                    if (code) {
+                        grunt.fail.fatal('Shifter failed with code: ' + code);
+                    } else {
+                        grunt.log.ok('Shifter build complete.');
+                        filedone();
+                    }
+                });
+            };
+
+            // Actually run shifter.
+            if (!options.recursive) {
+                execShifter();
+            } else {
+                // Check that there are yui modules otherwise shifter ends with exit code 1.
+                if (grunt.file.expand({cwd: src}, '**/yui/src/**/*.js').length > 0) {
+                    args.push('--recursive');
+                    execShifter();
+                } else {
+                    grunt.log.ok('No YUI modules to build.');
+                    filedone();
+                }
+            }
+        }, done);
+    };
+
+    // Register the shifter task.
+    grunt.registerTask('shifter', 'Run Shifter against the current directory', handler);
+
+    // Configure it.
+    grunt.config.set('shifter', {
+        options: {
+            recursive: true,
+            // Shifter takes a relative path.
+            paths: grunt.moodleEnv.files ? grunt.moodleEnv.files : [grunt.moodleEnv.runDir]
+        }
+    });
+
+    grunt.config.merge({
+        watch: {
+            yui: {
+                files: grunt.moodleEnv.inComponent
+                    ? ['yui/src/*.json', 'yui/src/**/*.js']
+                    : ['**/yui/src/**/*.js'],
+                tasks: ['yui']
+            },
+        },
+    });
+
+    // On watch, we dynamically modify config to build only affected files. This
+    // method is slightly complicated to deal with multiple changed files at once (copied
+    // from the grunt-contrib-watch readme).
+    let changedFiles = Object.create(null);
+    const onChange = grunt.util._.debounce(function() {
+        const files = Object.keys(changedFiles);
+        grunt.config('shifter.options.paths', files);
+        changedFiles = Object.create(null);
+    }, 200);
+
+    grunt.event.on('watch', (action, filepath) => {
+        changedFiles[filepath] = action;
+        onChange();
+    });
+
+    return handler;
+};

.grunt/tasks/startup.js

@@ -0,0 +1,48 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+module.exports = grunt => {
+    /**
+     * Generate ignore files (utilising thirdpartylibs.xml data)
+     */
+    const handler = function() {
+        const path = require('path');
+
+        // Are we in a YUI directory?
+        if (path.basename(path.resolve(grunt.moodleEnv.cwd, '../../')) == 'yui') {
+            grunt.task.run('yui');
+        // Are we in an AMD directory?
+        } else if (grunt.moodleEnv.inAMD) {
+            grunt.task.run('amd');
+        } else {
+            // Run them all!.
+            grunt.task.run('css');
+            grunt.task.run('js');
+            grunt.task.run('gherkinlint');
+        }
+    };
+
+    // Register the startup task.
+    grunt.registerTask('startup', 'Run the correct tasks for the current directory', handler);
+
+    return handler;
+};

.grunt/tasks/style.js

@@ -0,0 +1,29 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+module.exports = grunt => {
+    // Load the Style Lint tasks.
+    require('./stylelint')(grunt);
+
+    // Load the SASS tasks.
+    require('./sass')(grunt);
+};

.grunt/tasks/stylelint.js

@@ -0,0 +1,181 @@
+// 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/>.
+/* jshint node: true, browser: false */
+/* eslint-env node */
+
+/**
+ * @copyright  2021 Andrew Nicols
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+module.exports = grunt => {
+
+    const getCssConfigForFiles = files => {
+        return {
+            stylelint: {
+                css: {
+                    // Use a fully-qualified path.
+                    src: files,
+                    options: {
+                        configOverrides: {
+                            rules: {
+                                // These rules have to be disabled in .stylelintrc for scss compat.
+                                "at-rule-no-unknown": true,
+                            }
+                        }
+                    }
+                },
+            },
+        };
+    };
+
+    const getScssConfigForFiles = files => {
+        return {
+            stylelint: {
+                scss: {
+                    options: {syntax: 'scss'},
+                    src: files,
+                },
+            },
+        };
+    };
+
+    /**
+     * Register any stylelint tasks.
+     *
+     * @param {Object} grunt
+     * @param {Array} files
+     * @param {String} fullRunDir
+     */
+    const registerStyleLintTasks = () => {
+        const glob = require('glob');
+
+        // The stylelinters do not handle the case where a configuration was provided but no files were included.
+        // Keep track of whether any files were found.
+        let hasCss = false;
+        let hasScss = false;
+
+        // The stylelint processors do not take a path argument. They always check all provided values.
+        // As a result we must check through each glob and determine if any files match the current directory.
+        const scssFiles = [];
+        const cssFiles = [];
+
+        const requestedFiles = grunt.moodleEnv.files;
+        if (requestedFiles) {
+            // Grunt was called with a files argument.
+            // Check whether each of the requested files matches either the CSS or SCSS source file list.
+
+            requestedFiles.forEach(changedFilePath => {
+                let matchesGlob;
+
+                // Check whether this watched path matches any watched SCSS file.
+                matchesGlob = grunt.moodleEnv.scssSrc.some(watchedPathGlob => {
+                    return glob.sync(watchedPathGlob).indexOf(changedFilePath) !== -1;
+                });
+                if (matchesGlob) {
+                    scssFiles.push(changedFilePath);
+                    hasScss = true;
+                }
+
+                // Check whether this watched path matches any watched CSS file.
+                matchesGlob = grunt.moodleEnv.cssSrc.some(watchedPathGlob => {
+                    return glob.sync(watchedPathGlob).indexOf(changedFilePath) !== -1;
+                });
+                if (matchesGlob) {
+                    cssFiles.push(changedFilePath);
+                    hasCss = true;
+                }
+            });
+        } else {
+            // Grunt was called without a list of files.
+            // The start directory (runDir) may be a child dir of the project.
+            // Check each scssSrc file to see if it's in the start directory.
+            // This means that we can lint just mod/*/styles.css if started in the mod directory.
+
+            grunt.moodleEnv.scssSrc.forEach(path => {
+                if (path.startsWith(grunt.moodleEnv.runDir)) {
+                    scssFiles.push(path);
+                    hasScss = true;
+                }
+            });
+
+            grunt.moodleEnv.cssSrc.forEach(path => {
+                if (path.startsWith(grunt.moodleEnv.runDir)) {
+                    cssFiles.push(path);
+                    hasCss = true;
+                }
+            });
+        }
+
+        // Register the tasks.
+        const scssTasks = ['sass'];
+        if (hasScss) {
+            grunt.config.merge(getScssConfigForFiles(scssFiles));
+            scssTasks.unshift('stylelint:scss');
+        }
+
+        const cssTasks = [];
+        if (hasCss) {
+            grunt.config.merge(getCssConfigForFiles(cssFiles));
+            cssTasks.push('stylelint:css');
+        }
+
+        // The tasks must be registered, even if empty to ensure a consistent command list.
+        // They jsut won't run anything.
+        grunt.registerTask('scss', scssTasks);
+        grunt.registerTask('rawcss', cssTasks);
+    };
+
+    // Register CSS tasks.
+    grunt.loadNpmTasks('grunt-stylelint');
+
+    // Register the style lint tasks.
+    registerStyleLintTasks();
+    grunt.registerTask('css', ['scss', 'rawcss']);
+
+    const getCoreThemeMatches = () => {
+        const scssMatch = 'scss/**/*.scss';
+
+        if (grunt.moodleEnv.inTheme) {
+            return [scssMatch];
+        }
+
+        if (grunt.moodleEnv.runDir.startsWith('theme')) {
+            return [`*/${scssMatch}`];
+        }
+
+        return [`theme/*/${scssMatch}`];
+    };
+
+    // Add the watch configuration for rawcss, and scss.
+    grunt.config.merge({
+        watch: {
+            rawcss: {
+                files: [
+                    '**/*.css',
+                ],
+                excludes: [
+                    '**/moodle.css',
+                    '**/editor.css',
+                ],
+                tasks: ['rawcss']
+            },
+            scss: {
+                files: getCoreThemeMatches(),
+                tasks: ['scss']
+            },
+        },
+    });
+};

.grunt/tasks/watch.js

@@ -0,0 +1,272 @@
+/**
+ * This is a wrapper task to handle the grunt watch command. It attempts to use
+ * Watchman to monitor for file changes, if it's installed, because it's much faster.
+ *
+ * If Watchman isn't installed then it falls back to the grunt-contrib-watch file
+ * watcher for backwards compatibility.
+ */
+
+/* eslint-env node */
+
+module.exports = grunt => {
+    /**
+     * This is a wrapper task to handle the grunt watch command. It attempts to use
+     * Watchman to monitor for file changes, if it's installed, because it's much faster.
+     *
+     * If Watchman isn't installed then it falls back to the grunt-contrib-watch file
+     * watcher for backwards compatibility.
+     */
+    const watchHandler = function() {
+        const async = require('async');
+        const watchTaskDone = this.async();
+        let watchInitialised = false;
+        let watchTaskQueue = {};
+        let processingQueue = false;
+
+        const watchman = require('fb-watchman');
+        const watchmanClient = new watchman.Client();
+
+        // Grab the tasks and files that have been queued up and execute them.
+        var processWatchTaskQueue = function() {
+            if (!Object.keys(watchTaskQueue).length || processingQueue) {
+                // If there is nothing in the queue or we're already processing then wait.
+                return;
+            }
+
+            processingQueue = true;
+
+            // Grab all tasks currently in the queue.
+            var queueToProcess = watchTaskQueue;
+            // Reset the queue.
+            watchTaskQueue = {};
+
+            async.forEachSeries(
+                Object.keys(queueToProcess),
+                function(task, next) {
+                    var files = queueToProcess[task];
+                    var filesOption = '--files=' + files.join(',');
+                    grunt.log.ok('Running task ' + task + ' for files ' + filesOption);
+
+                    // Spawn the task in a child process so that it doesn't kill this one
+                    // if it failed.
+                    grunt.util.spawn(
+                        {
+                            // Spawn with the grunt bin.
+                            grunt: true,
+                            // Run from current working dir and inherit stdio from process.
+                            opts: {
+                                cwd: grunt.moodleEnv.fullRunDir,
+                                stdio: 'inherit'
+                            },
+                            args: [task, filesOption]
+                        },
+                        function(err, res, code) {
+                            if (code !== 0) {
+                                // The grunt task failed.
+                                grunt.log.error(err);
+                            }
+
+                            // Move on to the next task.
+                            next();
+                        }
+                    );
+                },
+                function() {
+                    // No longer processing.
+                    processingQueue = false;
+                    // Once all of the tasks are done then recurse just in case more tasks
+                    // were queued while we were processing.
+                    processWatchTaskQueue();
+                }
+            );
+        };
+
+        const originalWatchConfig = grunt.config.get(['watch']);
+        const watchConfig = Object.keys(originalWatchConfig).reduce(function(carry, key) {
+            if (key == 'options') {
+                return carry;
+            }
+
+            const value = originalWatchConfig[key];
+
+            const taskNames = value.tasks;
+            const files = value.files;
+            let excludes = [];
+            if (value.excludes) {
+                excludes = value.excludes;
+            }
+
+            taskNames.forEach(function(taskName) {
+                carry[taskName] = {
+                    files,
+                    excludes,
+                };
+            });
+
+            return carry;
+        }, {});
+
+        watchmanClient.on('error', function(error) {
+            // We have to add an error handler here and parse the error string because the
+            // example way from the docs to check if Watchman is installed doesn't actually work!!
+            // See: https://github.com/facebook/watchman/issues/509
+            if (error.message.match('Watchman was not found')) {
+                // If watchman isn't installed then we should fallback to the other watch task.
+                grunt.log.ok('It is recommended that you install Watchman for better performance using the "watch" command.');
+
+                // Fallback to the old grunt-contrib-watch task.
+                grunt.renameTask('watch-grunt', 'watch');
+                grunt.task.run(['watch']);
+                // This task is finished.
+                watchTaskDone(0);
+            } else {
+                grunt.log.error(error);
+                // Fatal error.
+                watchTaskDone(1);
+            }
+        });
+
+        watchmanClient.on('subscription', function(resp) {
+            if (resp.subscription !== 'grunt-watch') {
+                return;
+            }
+
+            resp.files.forEach(function(file) {
+                grunt.log.ok('File changed: ' + file.name);
+
+                var fullPath = grunt.moodleEnv.fullRunDir + '/' + file.name;
+                Object.keys(watchConfig).forEach(function(task) {
+
+                    const fileGlobs = watchConfig[task].files;
+                    var match = fileGlobs.some(function(fileGlob) {
+                        return grunt.file.isMatch(`**/${fileGlob}`, fullPath);
+                    });
+
+                    if (match) {
+                        // If we are watching a subdirectory then the file.name will be relative
+                        // to that directory. However the grunt tasks  expect the file paths to be
+                        // relative to the Gruntfile.js location so let's normalise them before
+                        // adding them to the queue.
+                        var relativePath = fullPath.replace(grunt.moodleEnv.gruntFilePath + '/', '');
+                        if (task in watchTaskQueue) {
+                            if (!watchTaskQueue[task].includes(relativePath)) {
+                                watchTaskQueue[task] = watchTaskQueue[task].concat(relativePath);
+                            }
+                        } else {
+                            watchTaskQueue[task] = [relativePath];
+                        }
+                    }
+                });
+            });
+
+            processWatchTaskQueue();
+        });
+
+        process.on('SIGINT', function() {
+            // Let the user know that they may need to manually stop the Watchman daemon if they
+            // no longer want it running.
+            if (watchInitialised) {
+                grunt.log.ok('The Watchman daemon may still be running and may need to be stopped manually.');
+            }
+
+            process.exit();
+        });
+
+        // Initiate the watch on the current directory.
+        watchmanClient.command(['watch-project', grunt.moodleEnv.fullRunDir], function(watchError, watchResponse) {
+            if (watchError) {
+                grunt.log.error('Error initiating watch:', watchError);
+                watchTaskDone(1);
+                return;
+            }
+
+            if ('warning' in watchResponse) {
+                grunt.log.error('warning: ', watchResponse.warning);
+            }
+
+            var watch = watchResponse.watch;
+            var relativePath = watchResponse.relative_path;
+            watchInitialised = true;
+
+            watchmanClient.command(['clock', watch], function(clockError, clockResponse) {
+                if (clockError) {
+                    grunt.log.error('Failed to query clock:', clockError);
+                    watchTaskDone(1);
+                    return;
+                }
+
+                // Generate the expression query used by watchman.
+                // Documentation is limited, but see https://facebook.github.io/watchman/docs/expr/allof.html for examples.
+                // We generate an expression to match any value in the files list of all of our tasks, but excluding
+                // all value in the  excludes list of that task.
+                //
+                // [anyof, [
+                //      [allof, [
+                //          [anyof, [
+                //              ['match', validPath, 'wholename'],
+                //              ['match', validPath, 'wholename'],
+                //          ],
+                //          [not,
+                //              [anyof, [
+                //                  ['match', invalidPath, 'wholename'],
+                //                  ['match', invalidPath, 'wholename'],
+                //              ],
+                //          ],
+                //      ],
+                var matchWholeName = fileGlob => ['match', fileGlob, 'wholename'];
+                var matches = Object.keys(watchConfig).map(function(task) {
+                    const matchAll = [];
+                    matchAll.push(['anyof'].concat(watchConfig[task].files.map(matchWholeName)));
+
+                    if (watchConfig[task].excludes.length) {
+                        matchAll.push(['not', ['anyof'].concat(watchConfig[task].excludes.map(matchWholeName))]);
+                    }
+
+                    return ['allof'].concat(matchAll);
+                });
+
+                matches = ['anyof'].concat(matches);
+
+                var sub = {
+                    expression: matches,
+                    // Which fields we're interested in.
+                    fields: ["name", "size", "type"],
+                    // Add our time constraint.
+                    since: clockResponse.clock
+                };
+
+                if (relativePath) {
+                    /* eslint-disable camelcase */
+                    sub.relative_root = relativePath;
+                }
+
+                watchmanClient.command(['subscribe', watch, 'grunt-watch', sub], function(subscribeError) {
+                    if (subscribeError) {
+                        // Probably an error in the subscription criteria.
+                        grunt.log.error('failed to subscribe: ', subscribeError);
+                        watchTaskDone(1);
+                        return;
+                    }
+
+                    grunt.log.ok('Listening for changes to files in ' + grunt.moodleEnv.fullRunDir);
+                });
+            });
+        });
+    };
+
+    // Rename the grunt-contrib-watch "watch" task because we're going to wrap it.
+    grunt.renameTask('watch', 'watch-grunt');
+
+    // Register the new watch handler.
+    grunt.registerTask('watch', 'Run tasks on file changes', watchHandler);
+
+    grunt.config.merge({
+        watch: {
+            options: {
+                nospawn: true // We need not to spawn so config can be changed dynamically.
+            },
+        },
+    });
+
+    return watchHandler;
+};

.stylelintignore

@@ -84,7 +84,6 @@ theme/boost/amd/src/bootstrap/button.js
 theme/boost/amd/src/bootstrap/carousel.js
 theme/boost/amd/src/bootstrap/collapse.js
 theme/boost/amd/src/bootstrap/dropdown.js
-theme/boost/amd/src/bootstrap/index.js
 theme/boost/amd/src/bootstrap/modal.js
 theme/boost/amd/src/bootstrap/popover.js
 theme/boost/amd/src/bootstrap/tools/sanitizer.js
@@ -93,4 +92,5 @@ theme/boost/amd/src/bootstrap/tab.js
 theme/boost/amd/src/bootstrap/toast.js
 theme/boost/amd/src/bootstrap/tooltip.js
 theme/boost/amd/src/bootstrap/util.js
-theme/boost/scss/fontawesome/
+theme/boost/amd/src/index.js
+theme/boost/scss/fontawesome/

.travis.yml

@@ -16,30 +16,14 @@ services:
     - mysql
     - docker
 
-php:
-    # We only run the highest and lowest supported versions to reduce the load on travis-ci.org.
-    - 7.4
-    - 7.2
-
 addons:
   postgresql: "9.6"
 
-env:
-    # Although we want to run these jobs and see failures as quickly as possible, we also want to get the slowest job to
-    # start first so that the total run time is not too high.
-    #
-    # We only run MySQL on PHP 7.2, so run that first.
-    # CI Tests should be second-highest in priority as these only take <= 60 seconds to run under normal circumstances.
-    # Postgres is significantly is pretty reasonable in its run-time.
-
-    # Run CI Tests without running PHPUnit.
-    - DB=none     TASK=CITEST
-
-    # Run unit tests on Postgres
-    - DB=pgsql    TASK=PHPUNIT
-
-    # Perform an upgrade test too.
-    - DB=pgsql    TASK=UPGRADE
+branches:
+  except:
+    - master
+    - /MOODLE_[0-9]+_STABLE/
+    - /^v[0-9]+\.[0-9]+\.[0-9]+.*/
 
 jobs:
     # Enable fast finish.
@@ -48,12 +32,35 @@ jobs:
     fast_finish: true
 
     include:
-          # Run mysql only on highest - it's just too slow
-        - php: 7.4
+        # First all the lowest php ones (7.3)
+        - php: 7.3
+          env: DB=none     TASK=CITEST
+        - php: 7.3
+          env: DB=none     TASK=GRUNT    NVM_VERSION='lts/carbon'
+
+        - if: env(MOODLE_DATABASE) = "pgsql" OR env(MOODLE_DATABASE) = "all" OR env(MOODLE_DATABASE) IS NOT present
+          php: 7.3
+          env: DB=pgsql    TASK=PHPUNIT
+
+        - if: env(MOODLE_DATABASE) = "mysqli" OR env(MOODLE_DATABASE) = "all"
+          php: 7.3
+          env: DB=mysqli   TASK=PHPUNIT
+
+        # Then, conditionally, all the highest php ones (8.0)
+        - if: env(MOODLE_PHP) = "all"
+          php: 8.0
+          env: DB=none     TASK=CITEST
+        - if: env(MOODLE_PHP) = "all"
+          php: 8.0
+          env: DB=none     TASK=GRUNT    NVM_VERSION='lts/carbon'
+
+        - if: env(MOODLE_PHP) = "all" AND (env(MOODLE_DATABASE) = "pgsql" OR env(MOODLE_DATABASE) = "all" OR env(MOODLE_DATABASE) IS NOT present)
+          php: 8.0
+          env: DB=pgsql    TASK=PHPUNIT
+
+        - if: env(MOODLE_PHP) = "all" AND (env(MOODLE_DATABASE) = "mysqli" OR env(MOODLE_DATABASE) = "all")
+          php: 8.0
           env: DB=mysqli   TASK=PHPUNIT
-          # Run grunt/npm install on highest version too ('node' is an alias for the latest node.js version.)
-        - php: 7.4
-          env: DB=none     TASK=GRUNT   NVM_VERSION='lts/carbon'
 
 cache:
     directories:
@@ -111,9 +118,11 @@ install:
         fi
 
 before_script:
+    - if [[ ${TRAVIS_PHP_VERSION:0:1} -gt 7 ]]; then pecl install xmlrpc-beta; fi
+    - echo 'max_input_vars=5000' >> ~/.phpenv/versions/$(phpenv version-name)/etc/conf.d/travis.ini
     - phpenv config-rm xdebug.ini
     - >
-      if [ "$TASK" = 'PHPUNIT' -o "$TASK" = 'UPGRADE' ];
+      if [ "$TASK" = 'PHPUNIT' ];
       then
         # Copy generic configuration in place.
         cp config-dist.php config.php ;
@@ -180,10 +189,9 @@ before_script:
         sed -i \
           -e "/require_once/i \\define('TEST_CACHESTORE_REDIS_TESTSERVERS', '127.0.0.1');" \
           config.php ;
-        # Redis session tests, but not for PHP 7.2 and up. See MDL-60978 for more info.
-        redissession="define('TEST_SESSION_REDIS_HOST', '127.0.0.1');"
+        # Redis session tests
         sed -i \
-          -e "/require_once/i \\${redissession}" \
+          -e "/require_once/i \\define('TEST_SESSION_REDIS_HOST', '127.0.0.1');" \
           config.php ;
 
         # Initialise PHPUnit for Moodle.
@@ -213,7 +221,7 @@ before_script:
         # We need the official upstream for comparison
         git remote add upstream https://github.com/moodle/moodle.git;
 
-        git fetch upstream MOODLE_310_STABLE;
+        git fetch upstream MOODLE_311_STABLE;
         export GIT_PREVIOUS_COMMIT="`git merge-base FETCH_HEAD $TRAVIS_COMMIT`";
         export GIT_COMMIT="$TRAVIS_COMMIT";
         export UPSTREAM_FETCH_HEAD=`git rev-parse FETCH_HEAD`
@@ -224,32 +232,6 @@ before_script:
         export phpcmd=`which php`;
       fi
 
-    ########################################################################
-    # Upgrade test
-    ########################################################################
-    - >
-      if [ "$TASK" = 'UPGRADE' ];
-      then
-        # We need the official upstream.
-        git remote add upstream https://github.com/moodle/moodle.git;
-
-        # Checkout 30 STABLE branch (the first version compatible with PHP 7.x)
-        git fetch upstream MOODLE_30_STABLE;
-        git checkout MOODLE_30_STABLE;
-
-        # Perform the upgrade
-        php admin/cli/install_database.php --agree-license --adminpass=Password --adminemail=admin@example.com --fullname="Upgrade test" --shortname=Upgrade;
-
-        # Return to the previous commit
-        git checkout -;
-
-        # Perform the upgrade
-        php admin/cli/upgrade.php --non-interactive --allow-unstable ;
-
-        # The local_ci repository can be used to check upgrade savepoints.
-        git clone https://github.com/moodlehq/moodle-local_ci.git local/ci ;
-      fi
-
 script:
     - >
       if [ "$TASK" = 'PHPUNIT' ];
@@ -275,23 +257,6 @@ script:
         git diff --cached --exit-code ;
       fi
 
-    ########################################################################
-    # Upgrade test
-    ########################################################################
-    - >
-      if [ "$TASK" = 'UPGRADE' ];
-      then
-        cp local/ci/check_upgrade_savepoints/check_upgrade_savepoints.php ./check_upgrade_savepoints.php
-        result=`php check_upgrade_savepoints.php`;
-        # Check if there are problems
-        count=`echo "$result" | grep -P "ERROR|WARN" | wc -l` ;
-        if (($count > 0));
-        then
-          echo "$result"
-          exit 1 ;
-        fi
-      fi
-
 after_script:
     - >
       if [ "$TASK" = 'PHPUNIT' ];

Gruntfile.js

@@ -16,147 +16,129 @@
 /* eslint-env node */
 
 /**
+ * Grunt configuration for Moodle.
+ *
  * @copyright  2014 Andrew Nicols
  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
 
-/* eslint-env node */
-
 /**
- * Calculate the cwd, taking into consideration the `root` option (for Windows).
+ * Setup the Grunt Moodle environment.
  *
- * @param {Object} grunt
- * @returns {String} The current directory as best we can determine
+ * @param   {Grunt} grunt
+ * @returns {Object}
  */
-const getCwd = grunt => {
+const setupMoodleEnvironment = grunt => {
     const fs = require('fs');
     const path = require('path');
+    const ComponentList = require(path.join(process.cwd(), '.grunt', 'components.js'));
 
-    let cwd = fs.realpathSync(process.env.PWD || process.cwd());
+    const getAmdConfiguration = () => {
+        // If the cwd is the amd directory in the current component then it will be empty.
+        // If the cwd is a child of the component's AMD directory, the relative directory will not start with ..
+        let inAMD = !path.relative(`${componentDirectory}/amd`, cwd).startsWith('..');
 
-    // Windows users can't run grunt in a subdirectory, so allow them to set
-    // the root by passing --root=path/to/dir.
-    if (grunt.option('root')) {
-        const root = grunt.option('root');
-        if (grunt.file.exists(__dirname, root)) {
-            cwd = fs.realpathSync(path.join(__dirname, root));
-            grunt.log.ok('Setting root to ' + cwd);
+        // Globbing pattern for matching all AMD JS source files.
+        let amdSrc = [];
+        if (inComponent) {
+            amdSrc.push(
+                componentDirectory + "/amd/src/*.js",
+                componentDirectory + "/amd/src/**/*.js"
+            );
         } else {
-            grunt.fail.fatal('Setting root to ' + root + ' failed - path does not exist');
+            amdSrc = ComponentList.getAmdSrcGlobList();
         }
-    }
 
-    return cwd;
-};
-
-/**
- * Register any stylelint tasks.
- *
- * @param {Object} grunt
- * @param {Array} files
- * @param {String} fullRunDir
- */
-const registerStyleLintTasks = (grunt, files, fullRunDir) => {
-    const getCssConfigForFiles = files => {
         return {
-            stylelint: {
-                css: {
-                    // Use a fully-qualified path.
-                    src: files,
-                    options: {
-                        configOverrides: {
-                            rules: {
-                                // These rules have to be disabled in .stylelintrc for scss compat.
-                                "at-rule-no-unknown": true,
-                            }
-                        }
-                    }
-                },
-            },
+            inAMD,
+            amdSrc,
         };
     };
 
-    const getScssConfigForFiles = files => {
+    const getYuiConfiguration = () => {
+        let yuiSrc = [];
+        if (inComponent) {
+            yuiSrc.push(componentDirectory + "/yui/src/**/*.js");
+        } else {
+            yuiSrc = ComponentList.getYuiSrcGlobList(gruntFilePath + '/');
+        }
+
         return {
-            stylelint: {
-                scss: {
-                    options: {syntax: 'scss'},
-                    src: files,
-                },
-            },
+            yuiSrc,
         };
     };
 
-    let hasCss = true;
-    let hasScss = true;
+    const getStyleConfiguration = () => {
+        const ComponentList = require(path.join(process.cwd(), '.grunt', 'components.js'));
+        // Build the cssSrc and scssSrc.
+        // Valid paths are:
+        // [component]/styles.css; and either
+        // [theme/[themename]]/scss/**/*.scss; or
+        // [theme/[themename]]/style/*.css.
+        //
+        // If a theme has scss, then it is assumed that the style directory contains generated content.
+        let cssSrc = [];
+        let scssSrc = [];
 
-    if (files) {
-        // Specific files were passed. Just set them up.
-        grunt.config.merge(getCssConfigForFiles(files));
-        grunt.config.merge(getScssConfigForFiles(files));
-    } else {
-        // The stylelint system does not handle the case where there was no file to lint.
-        // Check whether there are any files to lint in the current directory.
-        const glob = require('glob');
+        const checkComponentDirectory = componentDirectory => {
+            const isTheme = componentDirectory.startsWith('theme/');
+            if (isTheme) {
+                const scssDirectory = `${componentDirectory}/scss`;
 
-        const scssSrc = [];
-        glob.sync(`${fullRunDir}/**/*.scss`).forEach(path => scssSrc.push(path));
+                if (fs.existsSync(scssDirectory)) {
+                    // This theme has an SCSS directory.
+                    // Include all scss files within it recursively, but do not check for css files.
+                    scssSrc.push(`${scssDirectory}/*.scss`);
+                    scssSrc.push(`${scssDirectory}/**/*.scss`);
+                } else {
+                    // This theme has no SCSS directory.
+                    // Only hte CSS files in the top-level directory are checked.
+                    cssSrc.push(`${componentDirectory}/style/*.css`);
+                }
+            } else {
+                // This is not a theme.
+                // All other plugin types are restricted to a single styles.css in their top level.
+                cssSrc.push(`${componentDirectory}/styles.css`);
+            }
+        };
 
-        if (scssSrc.length) {
-            grunt.config.merge(getScssConfigForFiles(scssSrc));
+        if (inComponent) {
+            checkComponentDirectory(componentDirectory);
         } else {
-            hasScss = false;
+            ComponentList.getComponentPaths(`${gruntFilePath}/`).forEach(componentPath => {
+                checkComponentDirectory(componentPath);
+            });
         }
 
-        const cssSrc = [];
-        glob.sync(`${fullRunDir}/**/*.css`).forEach(path => cssSrc.push(path));
+        return {
+            cssSrc,
+            scssSrc,
+        };
+    };
 
-        if (cssSrc.length) {
-            grunt.config.merge(getCssConfigForFiles(cssSrc));
-        } else {
-            hasCss = false;
+    /**
+     * Calculate the cwd, taking into consideration the `root` option (for Windows).
+     *
+     * @param {Object} grunt
+     * @returns {String} The current directory as best we can determine
+     */
+    const getCwd = grunt => {
+        let cwd = fs.realpathSync(process.env.PWD || process.cwd());
+
+        // Windows users can't run grunt in a subdirectory, so allow them to set
+        // the root by passing --root=path/to/dir.
+        if (grunt.option('root')) {
+            const root = grunt.option('root');
+            if (grunt.file.exists(__dirname, root)) {
+                cwd = fs.realpathSync(path.join(__dirname, root));
+                grunt.log.ok('Setting root to ' + cwd);
+            } else {
+                grunt.fail.fatal('Setting root to ' + root + ' failed - path does not exist');
+            }
         }
-    }
 
-    const scssTasks = ['sass'];
-    if (hasScss) {
-        scssTasks.unshift('stylelint:scss');
-    }
-    grunt.registerTask('scss', scssTasks);
-
-    const cssTasks = [];
-    if (hasCss) {
-        cssTasks.push('stylelint:css');
-    }
-    grunt.registerTask('rawcss', cssTasks);
-
-    grunt.registerTask('css', ['scss', 'rawcss']);
-};
-
-/**
- * Grunt configuration.
- *
- * @param {Object} grunt
- */
-module.exports = function(grunt) {
-    const path = require('path');
-    const tasks = {};
-    const async = require('async');
-    const DOMParser = require('xmldom').DOMParser;
-    const xpath = require('xpath');
-    const semver = require('semver');
-    const watchman = require('fb-watchman');
-    const watchmanClient = new watchman.Client();
-    const fs = require('fs');
-    const ComponentList = require(path.resolve('GruntfileComponents.js'));
-    const sass = require('node-sass');
-
-    // Verify the node version is new enough.
-    var expected = semver.validRange(grunt.file.readJSON('package.json').engines.node);
-    var actual = semver.valid(process.version);
-    if (!semver.satisfies(actual, expected)) {
-        grunt.fail.fatal('Node version not satisfied. Require ' + expected + ', version installed: ' + actual);
-    }
+        return cwd;
+    };
 
     // Detect directories:
     // * gruntFilePath          The real path on disk to this Gruntfile.js
@@ -171,8 +153,19 @@ module.exports = function(grunt) {
     const relativeCwd = path.relative(gruntFilePath, cwd);
     const componentDirectory = ComponentList.getOwningComponentDirectory(relativeCwd);
     const inComponent = !!componentDirectory;
+    const inTheme = !!componentDirectory && componentDirectory.startsWith('theme/');
     const runDir = inComponent ? componentDirectory : relativeCwd;
     const fullRunDir = fs.realpathSync(gruntFilePath + path.sep + runDir);
+    const {inAMD, amdSrc} = getAmdConfiguration();
+    const {yuiSrc} = getYuiConfiguration();
+    const {cssSrc, scssSrc} = getStyleConfiguration();
+
+    let files = null;
+    if (grunt.option('files')) {
+        // Accept a comma separated list of files to process.
+        files = grunt.option('files').split(',');
+    }
+
     grunt.log.debug('============================================================================');
     grunt.log.debug(`= Node version:        ${process.versions.node}`);
     grunt.log.debug(`= grunt version:       ${grunt.package.version}`);
@@ -192,667 +185,77 @@ module.exports = function(grunt) {
         grunt.log.ok(`Running tasks for component directory ${componentDirectory}`);
     }
 
-    let files = null;
-    if (grunt.option('files')) {
-        // Accept a comma separated list of files to process.
-        files = grunt.option('files').split(',');
+    return {
+        amdSrc,
+        componentDirectory,
+        cwd,
+        cssSrc,
+        files,
+        fullRunDir,
+        gruntFilePath,
+        inAMD,
+        inComponent,
+        inTheme,
+        relativeCwd,
+        runDir,
+        scssSrc,
+        yuiSrc,
+    };
+};
+
+/**
+ * Verify tha tthe current NodeJS version matches the required version in package.json.
+ *
+ * @param   {Grunt} grunt
+ */
+const verifyNodeVersion = grunt => {
+    const semver = require('semver');
+
+    // Verify the node version is new enough.
+    var expected = semver.validRange(grunt.file.readJSON('package.json').engines.node);
+    var actual = semver.valid(process.version);
+    if (!semver.satisfies(actual, expected)) {
+        grunt.fail.fatal('Node version not satisfied. Require ' + expected + ', version installed: ' + actual);
     }
+};
 
-    // If the cwd is the amd directory in the current component then it will be empty.
-    // If the cwd is a child of the component's AMD directory, the relative directory will not start with ..
-    const inAMD = !path.relative(`${componentDirectory}/amd`, cwd).startsWith('..');
+/**
+ * Grunt configuration.
+ *
+ * @param {Grunt} grunt
+ */
+module.exports = function(grunt) {
+    // Verify that the Node version meets our requirements.
+    verifyNodeVersion(grunt);
 
-    // Globbing pattern for matching all AMD JS source files.
-    let amdSrc = [];
-    if (inComponent) {
-        amdSrc.push(componentDirectory + "/amd/src/*.js");
-        amdSrc.push(componentDirectory + "/amd/src/**/*.js");
-    } else {
-        amdSrc = ComponentList.getAmdSrcGlobList();
-    }
-
-    let yuiSrc = [];
-    if (inComponent) {
-        yuiSrc.push(componentDirectory + "/yui/src/**/*.js");
-    } else {
-        yuiSrc = ComponentList.getYuiSrcGlobList(gruntFilePath + '/');
-    }
+    // Setup the Moodle environemnt within the Grunt object.
+    grunt.moodleEnv = setupMoodleEnvironment(grunt);
 
     /**
-     * Function to generate the destination for the uglify task
-     * (e.g. build/file.min.js). This function will be passed to
-     * the rename property of files array when building dynamically:
-     * http://gruntjs.com/configuring-tasks#building-the-files-object-dynamically
+     * Add the named task.
      *
-     * @param {String} destPath the current destination
-     * @param {String} srcPath the  matched src path
-     * @return {String} The rewritten destination path.
+     * @param   {string} name
+     * @param   {Grunt} grunt
      */
-    var babelRename = function(destPath, srcPath) {
-        destPath = srcPath.replace('src', 'build');
-        destPath = destPath.replace('.js', '.min.js');
-        return destPath;
+    const addTask = (name, grunt) => {
+        const path = require('path');
+        const taskPath = path.resolve(`./.grunt/tasks/${name}.js`);
+
+        grunt.log.debug(`Including tasks for ${name} from ${taskPath}`);
+
+        require(path.resolve(`./.grunt/tasks/${name}.js`))(grunt);
     };
 
-    /**
-     * Find thirdpartylibs.xml and generate an array of paths contained within
-     * them (used to generate ignore files and so on).
-     *
-     * @return {array} The list of thirdparty paths.
-     */
-    var getThirdPartyPathsFromXML = function() {
-        const thirdpartyfiles = ComponentList.getThirdPartyLibsList(gruntFilePath + '/');
-        const libs = ['node_modules/', 'vendor/'];
 
-        thirdpartyfiles.forEach(function(file) {
-            const dirname = path.dirname(file);
+    // Add Moodle task configuration.
+    addTask('gherkinlint', grunt);
+    addTask('ignorefiles', grunt);
 
-            const doc = new DOMParser().parseFromString(grunt.file.read(file));
-            const nodes = xpath.select("/libraries/library/location/text()", doc);
+    addTask('javascript', grunt);
+    addTask('style', grunt);
 
-            nodes.forEach(function(node) {
-                let lib = path.posix.join(dirname, node.toString());
-                if (grunt.file.isDir(lib)) {
-                    // Ensure trailing slash on dirs.
-                    lib = lib.replace(/\/?$/, '/');
-                }
-
-                // Look for duplicate paths before adding to array.
-                if (libs.indexOf(lib) === -1) {
-                    libs.push(lib);
-                }
-            });
-        });
-
-        return libs;
-    };
-
-    /**
-     * Get the list of feature files to pass to the gherkin linter.
-     *
-     * @returns {Array}
-     */
-    const getGherkinLintTargets = () => {
-        if (files) {
-            // Specific files were requested. Only check these.
-            return files;
-        }
-
-        if (inComponent) {
-            return [`${runDir}/tests/behat/*.feature`];
-        }
-
-        return ['**/tests/behat/*.feature'];
-    };
-
-    // Project configuration.
-    grunt.initConfig({
-        eslint: {
-            // Even though warnings dont stop the build we don't display warnings by default because
-            // at this moment we've got too many core warnings.
-            // To display warnings call: grunt eslint --show-lint-warnings
-            // To fail on warnings call: grunt eslint --max-lint-warnings=0
-            // Also --max-lint-warnings=-1 can be used to display warnings but not fail.
-            options: {
-                quiet: (!grunt.option('show-lint-warnings')) && (typeof grunt.option('max-lint-warnings') === 'undefined'),
-                maxWarnings: ((typeof grunt.option('max-lint-warnings') !== 'undefined') ? grunt.option('max-lint-warnings') : -1)
-            },
-            amd: {src: files ? files : amdSrc},
-            // Check YUI module source files.
-            yui: {src: files ? files : yuiSrc},
-        },
-        babel: {
-            options: {
-                sourceMaps: true,
-                comments: false,
-                plugins: [
-                    'transform-es2015-modules-amd-lazy',
-                    'system-import-transformer',
-                    // This plugin modifies the Babel transpiling for "export default"
-                    // so that if it's used then only the exported value is returned
-                    // by the generated AMD module.
-                    //
-                    // It also adds the Moodle plugin name to the AMD module definition
-                    // so that it can be imported as expected in other modules.
-                    path.resolve('babel-plugin-add-module-to-define.js'),
-                    '@babel/plugin-syntax-dynamic-import',
-                    '@babel/plugin-syntax-import-meta',
-                    ['@babel/plugin-proposal-class-properties', {'loose': false}],
-                    '@babel/plugin-proposal-json-strings'
-                ],
-                presets: [
-                    ['minify', {
-                        // This minification plugin needs to be disabled because it breaks the
-                        // source map generation and causes invalid source maps to be output.
-                        simplify: false,
-                        builtIns: false
-                    }],
-                    ['@babel/preset-env', {
-                        targets: {
-                            browsers: [
-                                ">0.25%",
-                                "last 2 versions",
-                                "not ie <= 10",
-                                "not op_mini all",
-                                "not Opera > 0",
-                                "not dead"
-                            ]
-                        },
-                        modules: false,
-                        useBuiltIns: false
-                    }]
-                ]
-            },
-            dist: {
-                files: [{
-                    expand: true,
-                    src: files ? files : amdSrc,
-                    rename: babelRename
-                }]
-            }
-        },
-        sass: {
-            dist: {
-                files: {
-                    "theme/boost/style/moodle.css": "theme/boost/scss/preset/default.scss",
-                    "theme/classic/style/moodle.css": "theme/classic/scss/classicgrunt.scss"
-                }
-            },
-            options: {
-                implementation: sass,
-                includePaths: ["theme/boost/scss/", "theme/classic/scss/"]
-            }
-        },
-        watch: {
-            options: {
-                nospawn: true // We need not to spawn so config can be changed dynamically.
-            },
-            amd: {
-                files: inComponent
-                    ? ['amd/src/*.js', 'amd/src/**/*.js']
-                    : ['**/amd/src/**/*.js'],
-                tasks: ['amd']
-            },
-            boost: {
-                files: [inComponent ? 'scss/**/*.scss' : 'theme/boost/scss/**/*.scss'],
-                tasks: ['scss']
-            },
-            rawcss: {
-                files: [
-                    '**/*.css',
-                ],
-                excludes: [
-                    '**/moodle.css',
-                    '**/editor.css',
-                ],
-                tasks: ['rawcss']
-            },
-            yui: {
-                files: inComponent
-                    ? ['yui/src/*.json', 'yui/src/**/*.js']
-                    : ['**/yui/src/**/*.js'],
-                tasks: ['yui']
-            },
-            gherkinlint: {
-                files: [inComponent ? 'tests/behat/*.feature' : '**/tests/behat/*.feature'],
-                tasks: ['gherkinlint']
-            }
-        },
-        shifter: {
-            options: {
-                recursive: true,
-                // Shifter takes a relative path.
-                paths: files ? files : [runDir]
-            }
-        },
-        gherkinlint: {
-            options: {
-                files: getGherkinLintTargets(),
-            }
-        },
-    });
-
-    /**
-     * Generate ignore files (utilising thirdpartylibs.xml data)
-     */
-    tasks.ignorefiles = function() {
-        // An array of paths to third party directories.
-        const thirdPartyPaths = getThirdPartyPathsFromXML();
-        // Generate .eslintignore.
-        const eslintIgnores = [
-            '# Generated by "grunt ignorefiles"',
-            '*/**/yui/src/*/meta/',
-            '*/**/build/',
-        ].concat(thirdPartyPaths);
-        grunt.file.write('.eslintignore', eslintIgnores.join('\n'));
-
-        // Generate .stylelintignore.
-        const stylelintIgnores = [
-            '# Generated by "grunt ignorefiles"',
-            '**/yui/build/*',
-            'theme/boost/style/moodle.css',
-            'theme/classic/style/moodle.css',
-        ].concat(thirdPartyPaths);
-        grunt.file.write('.stylelintignore', stylelintIgnores.join('\n'));
-    };
-
-    /**
-     * Shifter task. Is configured with a path to a specific file or a directory,
-     * in the case of a specific file it will work out the right module to be built.
-     *
-     * Note that this task runs the invidiaul shifter jobs async (becase it spawns
-     * so be careful to to call done().
-     */
-    tasks.shifter = function() {
-        var done = this.async(),
-            options = grunt.config('shifter.options');
-
-        // Run the shifter processes one at a time to avoid confusing output.
-        async.eachSeries(options.paths, function(src, filedone) {
-            var args = [];
-            args.push(path.normalize(__dirname + '/node_modules/shifter/bin/shifter'));
-
-            // Always ignore the node_modules directory.
-            args.push('--excludes', 'node_modules');
-
-            // Determine the most appropriate options to run with based upon the current location.
-            if (grunt.file.isMatch('**/yui/**/*.js', src)) {
-                // When passed a JS file, build our containing module (this happen with
-                // watch).
-                grunt.log.debug('Shifter passed a specific JS file');
-                src = path.dirname(path.dirname(src));
-                options.recursive = false;
-            } else if (grunt.file.isMatch('**/yui/src', src)) {
-                // When in a src directory --walk all modules.
-                grunt.log.debug('In a src directory');
-                args.push('--walk');
-                options.recursive = false;
-            } else if (grunt.file.isMatch('**/yui/src/*', src)) {
-                // When in module, only build our module.
-                grunt.log.debug('In a module directory');
-                options.recursive = false;
-            } else if (grunt.file.isMatch('**/yui/src/*/js', src)) {
-                // When in module src, only build our module.
-                grunt.log.debug('In a source directory');
-                src = path.dirname(src);
-                options.recursive = false;
-            }
-
-            if (grunt.option('watch')) {
-                grunt.fail.fatal('The --watch option has been removed, please use `grunt watch` instead');
-            }
-
-            // Add the stderr option if appropriate
-            if (grunt.option('verbose')) {
-                args.push('--lint-stderr');
-            }
-
-            if (grunt.option('no-color')) {
-                args.push('--color=false');
-            }
-
-            var execShifter = function() {
-
-                grunt.log.ok("Running shifter on " + src);
-                grunt.util.spawn({
-                    cmd: "node",
-                    args: args,
-                    opts: {cwd: src, stdio: 'inherit', env: process.env}
-                }, function(error, result, code) {
-                    if (code) {
-                        grunt.fail.fatal('Shifter failed with code: ' + code);
-                    } else {
-                        grunt.log.ok('Shifter build complete.');
-                        filedone();
-                    }
-                });
-            };
-
-            // Actually run shifter.
-            if (!options.recursive) {
-                execShifter();
-            } else {
-                // Check that there are yui modules otherwise shifter ends with exit code 1.
-                if (grunt.file.expand({cwd: src}, '**/yui/src/**/*.js').length > 0) {
-                    args.push('--recursive');
-                    execShifter();
-                } else {
-                    grunt.log.ok('No YUI modules to build.');
-                    filedone();
-                }
-            }
-        }, done);
-    };
-
-    tasks.gherkinlint = function() {
-        const done = this.async();
-        const options = grunt.config('gherkinlint.options');
-
-        // Grab the gherkin-lint linter and required scaffolding.
-        const linter = require('gherkin-lint/dist/linter.js');
-        const featureFinder = require('gherkin-lint/dist/feature-finder.js');
-        const configParser = require('gherkin-lint/dist/config-parser.js');
-        const formatter = require('gherkin-lint/dist/formatters/stylish.js');
-
-        // Run the linter.
-        return linter.lint(
-            featureFinder.getFeatureFiles(grunt.file.expand(options.files)),
-            configParser.getConfiguration(configParser.defaultConfigFileName)
-        )
-        .then(results => {
-            // Print the results out uncondtionally.
-            formatter.printResults(results);
-
-            return results;
-        })
-        .then(results => {
-            // Report on the results.
-            // The done function takes a bool whereby a falsey statement causes the task to fail.
-            return results.every(result => result.errors.length === 0);
-        })
-        .then(done); // eslint-disable-line promise/no-callback-in-promise
-    };
-
-    tasks.startup = function() {
-        // Are we in a YUI directory?
-        if (path.basename(path.resolve(cwd, '../../')) == 'yui') {
-            grunt.task.run('yui');
-        // Are we in an AMD directory?
-        } else if (inAMD) {
-            grunt.task.run('amd');
-        } else {
-            // Run them all!.
-            grunt.task.run('css');
-            grunt.task.run('js');
-            grunt.task.run('gherkinlint');
-        }
-    };
-
-    /**
-     * This is a wrapper task to handle the grunt watch command. It attempts to use
-     * Watchman to monitor for file changes, if it's installed, because it's much faster.
-     *
-     * If Watchman isn't installed then it falls back to the grunt-contrib-watch file
-     * watcher for backwards compatibility.
-     */
-    tasks.watch = function() {
-        var watchTaskDone = this.async();
-        var watchInitialised = false;
-        var watchTaskQueue = {};
-        var processingQueue = false;
-
-        // Grab the tasks and files that have been queued up and execute them.
-        var processWatchTaskQueue = function() {
-            if (!Object.keys(watchTaskQueue).length || processingQueue) {
-                // If there is nothing in the queue or we're already processing then wait.
-                return;
-            }
-
-            processingQueue = true;
-
-            // Grab all tasks currently in the queue.
-            var queueToProcess = watchTaskQueue;
-            // Reset the queue.
-            watchTaskQueue = {};
-
-            async.forEachSeries(
-                Object.keys(queueToProcess),
-                function(task, next) {
-                    var files = queueToProcess[task];
-                    var filesOption = '--files=' + files.join(',');
-                    grunt.log.ok('Running task ' + task + ' for files ' + filesOption);
-
-                    // Spawn the task in a child process so that it doesn't kill this one
-                    // if it failed.
-                    grunt.util.spawn(
-                        {
-                            // Spawn with the grunt bin.
-                            grunt: true,
-                            // Run from current working dir and inherit stdio from process.
-                            opts: {
-                                cwd: fullRunDir,
-                                stdio: 'inherit'
-                            },
-                            args: [task, filesOption]
-                        },
-                        function(err, res, code) {
-                            if (code !== 0) {
-                                // The grunt task failed.
-                                grunt.log.error(err);
-                            }
-
-                            // Move on to the next task.
-                            next();
-                        }
-                    );
-                },
-                function() {
-                    // No longer processing.
-                    processingQueue = false;
-                    // Once all of the tasks are done then recurse just in case more tasks
-                    // were queued while we were processing.
-                    processWatchTaskQueue();
-                }
-            );
-        };
-
-        const originalWatchConfig = grunt.config.get(['watch']);
-        const watchConfig = Object.keys(originalWatchConfig).reduce(function(carry, key) {
-            if (key == 'options') {
-                return carry;
-            }
-
-            const value = originalWatchConfig[key];
-
-            const taskNames = value.tasks;
-            const files = value.files;
-            let excludes = [];
-            if (value.excludes) {
-                excludes = value.excludes;
-            }
-
-            taskNames.forEach(function(taskName) {
-                carry[taskName] = {
-                    files,
-                    excludes,
-                };
-            });
-
-            return carry;
-        }, {});
-
-        watchmanClient.on('error', function(error) {
-            // We have to add an error handler here and parse the error string because the
-            // example way from the docs to check if Watchman is installed doesn't actually work!!
-            // See: https://github.com/facebook/watchman/issues/509
-            if (error.message.match('Watchman was not found')) {
-                // If watchman isn't installed then we should fallback to the other watch task.
-                grunt.log.ok('It is recommended that you install Watchman for better performance using the "watch" command.');
-
-                // Fallback to the old grunt-contrib-watch task.
-                grunt.renameTask('watch-grunt', 'watch');
-                grunt.task.run(['watch']);
-                // This task is finished.
-                watchTaskDone(0);
-            } else {
-                grunt.log.error(error);
-                // Fatal error.
-                watchTaskDone(1);
-            }
-        });
-
-        watchmanClient.on('subscription', function(resp) {
-            if (resp.subscription !== 'grunt-watch') {
-                return;
-            }
-
-            resp.files.forEach(function(file) {
-                grunt.log.ok('File changed: ' + file.name);
-
-                var fullPath = fullRunDir + '/' + file.name;
-                Object.keys(watchConfig).forEach(function(task) {
-
-                    const fileGlobs = watchConfig[task].files;
-                    var match = fileGlobs.some(function(fileGlob) {
-                        return grunt.file.isMatch(`**/${fileGlob}`, fullPath);
-                    });
-
-                    if (match) {
-                        // If we are watching a subdirectory then the file.name will be relative
-                        // to that directory. However the grunt tasks  expect the file paths to be
-                        // relative to the Gruntfile.js location so let's normalise them before
-                        // adding them to the queue.
-                        var relativePath = fullPath.replace(gruntFilePath + '/', '');
-                        if (task in watchTaskQueue) {
-                            if (!watchTaskQueue[task].includes(relativePath)) {
-                                watchTaskQueue[task] = watchTaskQueue[task].concat(relativePath);
-                            }
-                        } else {
-                            watchTaskQueue[task] = [relativePath];
-                        }
-                    }
-                });
-            });
-
-            processWatchTaskQueue();
-        });
-
-        process.on('SIGINT', function() {
-            // Let the user know that they may need to manually stop the Watchman daemon if they
-            // no longer want it running.
-            if (watchInitialised) {
-                grunt.log.ok('The Watchman daemon may still be running and may need to be stopped manually.');
-            }
-
-            process.exit();
-        });
-
-        // Initiate the watch on the current directory.
-        watchmanClient.command(['watch-project', fullRunDir], function(watchError, watchResponse) {
-            if (watchError) {
-                grunt.log.error('Error initiating watch:', watchError);
-                watchTaskDone(1);
-                return;
-            }
-
-            if ('warning' in watchResponse) {
-                grunt.log.error('warning: ', watchResponse.warning);
-            }
-
-            var watch = watchResponse.watch;
-            var relativePath = watchResponse.relative_path;
-            watchInitialised = true;
-
-            watchmanClient.command(['clock', watch], function(clockError, clockResponse) {
-                if (clockError) {
-                    grunt.log.error('Failed to query clock:', clockError);
-                    watchTaskDone(1);
-                    return;
-                }
-
-                // Generate the expression query used by watchman.
-                // Documentation is limited, but see https://facebook.github.io/watchman/docs/expr/allof.html for examples.
-                // We generate an expression to match any value in the files list of all of our tasks, but excluding
-                // all value in the  excludes list of that task.
-                //
-                // [anyof, [
-                //      [allof, [
-                //          [anyof, [
-                //              ['match', validPath, 'wholename'],
-                //              ['match', validPath, 'wholename'],
-                //          ],
-                //          [not,
-                //              [anyof, [
-                //                  ['match', invalidPath, 'wholename'],
-                //                  ['match', invalidPath, 'wholename'],
-                //              ],
-                //          ],
-                //      ],
-                var matchWholeName = fileGlob => ['match', fileGlob, 'wholename'];
-                var matches = Object.keys(watchConfig).map(function(task) {
-                    const matchAll = [];
-                    matchAll.push(['anyof'].concat(watchConfig[task].files.map(matchWholeName)));
-
-                    if (watchConfig[task].excludes.length) {
-                        matchAll.push(['not', ['anyof'].concat(watchConfig[task].excludes.map(matchWholeName))]);
-                    }
-
-                    return ['allof'].concat(matchAll);
-                });
-
-                matches = ['anyof'].concat(matches);
-
-                var sub = {
-                    expression: matches,
-                    // Which fields we're interested in.
-                    fields: ["name", "size", "type"],
-                    // Add our time constraint.
-                    since: clockResponse.clock
-                };
-
-                if (relativePath) {
-                    /* eslint-disable camelcase */
-                    sub.relative_root = relativePath;
-                }
-
-                watchmanClient.command(['subscribe', watch, 'grunt-watch', sub], function(subscribeError) {
-                    if (subscribeError) {
-                        // Probably an error in the subscription criteria.
-                        grunt.log.error('failed to subscribe: ', subscribeError);
-                        watchTaskDone(1);
-                        return;
-                    }
-
-                    grunt.log.ok('Listening for changes to files in ' + fullRunDir);
-                });
-            });
-        });
-    };
-
-    // On watch, we dynamically modify config to build only affected files. This
-    // method is slightly complicated to deal with multiple changed files at once (copied
-    // from the grunt-contrib-watch readme).
-    var changedFiles = Object.create(null);
-    var onChange = grunt.util._.debounce(function() {
-        var files = Object.keys(changedFiles);
-        grunt.config('eslint.amd.src', files);
-        grunt.config('eslint.yui.src', files);
-        grunt.config('shifter.options.paths', files);
-        grunt.config('gherkinlint.options.files', files);
-        grunt.config('babel.dist.files', [{expand: true, src: files, rename: babelRename}]);
-        changedFiles = Object.create(null);
-    }, 200);
-
-    grunt.event.on('watch', function(action, filepath) {
-        changedFiles[filepath] = action;
-        onChange();
-    });
-
-    // Register NPM tasks.
-    grunt.loadNpmTasks('grunt-contrib-uglify');
-    grunt.loadNpmTasks('grunt-contrib-watch');
-    grunt.loadNpmTasks('grunt-sass');
-    grunt.loadNpmTasks('grunt-eslint');
-    grunt.loadNpmTasks('grunt-stylelint');
-    grunt.loadNpmTasks('grunt-babel');
-
-    // Rename the grunt-contrib-watch "watch" task because we're going to wrap it.
-    grunt.renameTask('watch', 'watch-grunt');
-
-    // Register JS tasks.
-    grunt.registerTask('shifter', 'Run Shifter against the current directory', tasks.shifter);
-    grunt.registerTask('gherkinlint', 'Run gherkinlint against the current directory', tasks.gherkinlint);
-    grunt.registerTask('ignorefiles', 'Generate ignore files for linters', tasks.ignorefiles);
-    grunt.registerTask('watch', 'Run tasks on file changes', tasks.watch);
-    grunt.registerTask('yui', ['eslint:yui', 'shifter']);
-    grunt.registerTask('amd', ['eslint:amd', 'babel']);
-    grunt.registerTask('js', ['amd', 'yui']);
-
-    // Register CSS tasks.
-    registerStyleLintTasks(grunt, files, fullRunDir);
-
-    // Register the startup task.
-    grunt.registerTask('startup', 'Run the correct tasks for the current directory', tasks.startup);
+    addTask('watch', grunt);
+    addTask('startup', grunt);
 
     // Register the default task.
     grunt.registerTask('default', ['startup']);

TRADEMARK.txt

@@ -2,7 +2,7 @@ MOODLE TRADEMARKS POLICY
 ========================
 
 The word "Moodle" is trademarked in many countries around the world. The word
-was originally an acronym: Modular Object-Oriented Dynamic Learning
+was originally coined as an acronym: Modular Object-Oriented Dynamic Learning
 Environment. The trademark is owned by Martin Dougiamas, Founder and Director
 of Moodle.
 

admin/auth.php

@@ -44,7 +44,9 @@ switch ($action) {
         $key = array_search($auth, $authsenabled);
         if ($key !== false) {
             unset($authsenabled[$key]);
-            set_config('auth', implode(',', $authsenabled));
+            $value = implode(',', $authsenabled);
+            add_to_config_log('auth', $CFG->auth, $value, 'core');
+            set_config('auth', $value);
         }
 
         if ($auth == $CFG->registerauth) {
@@ -59,8 +61,11 @@ switch ($action) {
         if (!in_array($auth, $authsenabled)) {
             $authsenabled[] = $auth;
             $authsenabled = array_unique($authsenabled);
-            set_config('auth', implode(',', $authsenabled));
+            $value = implode(',', $authsenabled);
+            add_to_config_log('auth', $CFG->auth, $value, 'core');
+            set_config('auth', $value);
         }
+
         \core\session\manager::gc(); // Remove stale sessions.
         core_plugin_manager::reset_caches();
         break;
@@ -76,7 +81,9 @@ switch ($action) {
             $fsave = $authsenabled[$key];
             $authsenabled[$key] = $authsenabled[$key + 1];
             $authsenabled[$key + 1] = $fsave;
-            set_config('auth', implode(',', $authsenabled));
+            $value = implode(',', $authsenabled);
+            add_to_config_log('auth', $CFG->auth, $value, 'core');
+            set_config('auth', $value);
         }
         break;
 
@@ -91,7 +98,9 @@ switch ($action) {
             $fsave = $authsenabled[$key];
             $authsenabled[$key] = $authsenabled[$key - 1];
             $authsenabled[$key - 1] = $fsave;
-            set_config('auth', implode(',', $authsenabled));
+            $value = implode(',', $authsenabled);
+            add_to_config_log('auth', $CFG->auth, $value, 'core');
+            set_config('auth', $value);
         }
         break;
 

admin/auth_config.php

@@ -171,8 +171,6 @@ function print_auth_lock_options($auth, $user_fields, $helptext, $retrieveopts,
                 // limit for the setting name is 100.
                 continue;
             }
-        } elseif ($fieldname == 'url') {
-            $fieldname = get_string('webpage');
         } else {
             $fieldname = get_string($fieldname);
         }

admin/classes/task_log_table.php

@@ -124,8 +124,9 @@ class task_log_table extends \table_sql {
             $sort = "ORDER BY $sort";
         }
 
-        $extrafields = get_extra_user_fields(\context_system::instance());
-        $userfields = \user_picture::fields('u', $extrafields, 'userid2', 'user');
+        // TODO Does not support custom user profile fields (MDL-70456).
+        $userfieldsapi = \core_user\fields::for_identity(\context_system::instance(), false)->with_userpic();
+        $userfields = $userfieldsapi->get_sql('u', false, 'user', 'userid2', false)->selects;
 
         $where = '';
         if (!empty($this->sql->where)) {

admin/cli/dashboard_reset.php

@@ -0,0 +1,65 @@
+<?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/>.
+
+/**
+ * CLI script to reset dashboards.
+ *
+ * @package    core
+ * @subpackage cli
+ * @copyright  2021 Brendan Heywood (brendan@catalyst-au.net)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+define('CLI_SCRIPT', true);
+
+require(__DIR__.'/../../config.php');
+require_once($CFG->libdir.'/clilib.php');
+require_once($CFG->dirroot.'/my/lib.php');
+
+list($options, $unrecognized) = cli_get_params([
+    'help'    => false,
+    'execute' => false,
+], [
+    'h' => 'help',
+    'e' => 'execute',
+]);
+
+if ($unrecognized) {
+    $unrecognized = implode("\n  ", $unrecognized);
+    cli_error(get_string('cliunknowoption', 'admin', $unrecognized), 2);
+}
+
+if (!$options['execute']) {
+    $help = <<<EOF
+Resets Moodle dashboards for all users
+
+Options:
+-h, --help          Print out this help
+-e, --execute       Actually run the reset
+
+Example:
+\$ sudo -u www-data /usr/bin/php admin/cli/dashboard_reset.php -e
+
+EOF;
+
+    echo $help;
+    exit(0);
+}
+
+$progressbar = new progress_bar();
+$progressbar->create();
+my_reset_page_for_all_users(MY_PAGE_PRIVATE, 'my-index', $progressbar);
+

admin/cli/fix_orphaned_calendar_events.php

@@ -0,0 +1,138 @@
+<?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/>.
+
+/**
+ * Fix orphaned calendar events that were broken by MDL-67494.
+ *
+ * This script will look for all the calendar events which userids
+ * where broken by a wrong upgrade step, affecting to Moodle 3.9.5
+ * and up.
+ *
+ * It performs checks to both:
+ *    a) Detect if the site was affected (ran the wrong upgrade step).
+ *    b) Look for orphaned calendar events, categorising them as:
+ *       - standard: site / category / course / group / user events
+ *       - subscription: events created via subscriptions.
+ *       - action: normal action events, created to show common important dates.
+ *       - override: user and group override events, particular, that some activities support.
+ *       - custom: other events, not being any of the above, common or particular.
+ * By specifying it (--fix) try to recover as many broken events (missing userid) as
+ * possible. Standard, subscription, action, override events in core are fully supported but
+ * override or custom events should be fixed by each plugin as far as there isn't any standard
+ * API (plugin-wise) to launch a rebuild of the calendar events.
+ *
+ * @package core
+ * @copyright 2021 onwards Simey Lameze <simey@moodle.com>
+ * @license    https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+define('CLI_SCRIPT', true);
+
+require_once(__DIR__ . '/../../config.php');
+require_once($CFG->libdir . "/clilib.php");
+require_once($CFG->libdir . '/db/upgradelib.php');
+
+// Supported options.
+$long = ['fix'  => false, 'help' => false];
+$short = ['f' => 'fix', 'h' => 'help'];
+
+// CLI options.
+[$options, $unrecognized] = cli_get_params($long, $short);
+
+if ($unrecognized) {
+    $unrecognized = implode("\n  ", $unrecognized);
+    cli_error(get_string('cliunknowoption', 'admin', $unrecognized));
+}
+
+if ($options['help']) {
+    $help = <<<EOT
+Fix orphaned calendar events.
+
+  This script detects calendar events that have had their
+  userid lost. By default it will perform various checks
+  and report them, showing the site status in an easy way.
+
+  Also, optionally (--fix), it wil try to recover as many
+  lost userids as possible from different sources. Note that
+  this script aims to process well-know events in core,
+  leaving custom events in 3rd part plugins mostly unmodified
+  because there isn't any consistent way to regenerate them.
+
+  For more details:  https://tracker.moodle.org/browse/MDL-71156
+
+Options:
+  -h, --help    Print out this help.
+  -f, --fix     Fix the orphaned calendar events in the DB.
+                If not specified only check and report problems to STDERR.
+
+Usage:
+  - Only report:    \$ sudo -u www-data /usr/bin/php admin/cli/fix_orphaned_calendar_events.php
+  - Report and fix: \$ sudo -u www-data /usr/bin/php admin/cli/fix_orphaned_calendar_events.php -f
+EOT;
+
+    cli_writeln($help);
+    die;
+}
+
+// Check various usual pre-requisites.
+if (empty($CFG->version)) {
+    cli_error('Database is not yet installed.');
+}
+
+$admin = get_admin();
+if (!$admin) {
+    cli_error('Error: No admin account was found.');
+}
+
+if (moodle_needs_upgrading()) {
+    cli_error('Moodle upgrade pending, script execution suspended.');
+}
+
+// Do everything as admin by default.
+\core\session\manager::set_user($admin);
+
+// Report current site status.
+cli_heading('Checking the site status');
+$needsfix = upgrade_calendar_site_status();
+
+// Report current calendar events status.
+cli_heading('Checking the calendar events status');
+$info = upgrade_calendar_events_status();
+$hasbadevents = $info['total']->bad > 0 || $info['total']->bad != $info['other']->bad;
+$needsfix = $needsfix || $hasbadevents;
+
+// If, selected, fix as many calendar events as possible.
+if ($options['fix']) {
+
+    // If the report has told us that the fix was not needed... ask for confirmation!
+    if (!$needsfix) {
+        cli_writeln("This site DOES NOT NEED to run the calendar events fix.");
+        $input = cli_input('Are you completely sure that you want to run the fix? (y/N)', 'N', ['y', 'Y', 'n', 'N']);
+        if (strtolower($input) != 'y') {
+            exit(0);
+        }
+        cli_writeln("");
+    }
+    cli_heading('Fixing as many as possible calendar events');
+    upgrade_calendar_events_fix_remaining($info);
+    // Report current (after fix) calendar events status.
+    cli_heading('Checking the calendar events status (after fix)');
+    upgrade_calendar_events_status();
+} else if ($needsfix) {
+    // Fix option was not provided but problem events have been found. Notify the user and provide info how to fix these events.
+    cli_writeln("This site NEEDS to run the calendar events fix!");
+    cli_writeln("To fix the calendar events, re-run this script with the --fix option.");
+}

admin/cli/generate_key.php

@@ -0,0 +1,79 @@
+<?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/>.
+
+/**
+ * Generates a secure key for the current server (presuming it does not already exist).
+ *
+ * @package core_admin
+ * @copyright 2020 The Open University
+ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+use \core\encryption;
+
+define('CLI_SCRIPT', true);
+
+require(__DIR__ . '/../../config.php');
+require_once($CFG->libdir . '/clilib.php');
+
+// Get cli options.
+[$options, $unrecognized] = cli_get_params(
+        ['help' => false, 'method' => null],
+        ['h' => 'help']);
+
+if ($unrecognized) {
+    $unrecognized = implode("\n  ", $unrecognized);
+    cli_error(get_string('cliunknowoption', 'admin', $unrecognized));
+}
+
+// TODO: MDL-71421 - Remove the openssl alternative once sodium becomes a requirement in Moodle 4.2.
+
+if ($options['help']) {
+    echo "Generate secure key
+
+This script manually creates a secure key within the secret data root folder (configured in
+config.php as \$CFG->secretdataroot). You must run it using an account with access to write
+to that folder.
+
+In normal use Moodle automatically creates the key; this script is intended when setting up
+a new Moodle system, for cases where the secure folder is not on shared storage and the key
+may be manually installed on multiple servers.
+
+Options:
+-h, --help         Print out this help
+--method <method>  Generate key for specified encryption method instead of default.
+                   * sodium
+                   * openssl-aes-256-ctr
+
+Example:
+php admin/cli/generate_key.php
+";
+    exit;
+}
+
+$method = $options['method'];
+
+if (encryption::key_exists($method)) {
+    echo 'Key already exists: ' . encryption::get_key_file($method) . "\n";
+    exit;
+}
+
+// Creates key with default permissions (no chmod).
+echo "Generating key...\n";
+encryption::create_key($method, false);
+
+echo "\nKey created: " . encryption::get_key_file($method) . "\n\n";
+echo "If the key folder is not shared storage, then key files should be copied to all servers.\n";

admin/cli/install_database.php

@@ -56,6 +56,7 @@ Options:
 --agree-license       Indicates agreement with software license.
 --fullname=STRING     Name of the site
 --shortname=STRING    Name of the site
+--summary=STRING      The summary to be displayed on the front page
 -h, --help            Print out this help
 
 Example:
@@ -96,6 +97,7 @@ list($options, $unrecognized) = cli_get_params(
         'adminemail'        => '',
         'fullname'          => '',
         'shortname'         => '',
+        'summary'           => '',
         'agree-license'     => false,
         'help'              => false
     ),
@@ -104,6 +106,11 @@ list($options, $unrecognized) = cli_get_params(
     )
 );
 
+if ($unrecognized) {
+    $unrecognized = implode("\n  ", $unrecognized);
+    cli_error(get_string('cliunknowoption', 'admin', $unrecognized));
+}
+
 // We show help text even if tables are installed.
 if ($options['help']) {
     echo $help;

admin/cli/mysql_collation.php

@@ -119,7 +119,7 @@ if (!empty($options['collation'])) {
     if ($dbcollation->value !== $collation || $dbcharset->value !== $charset) {
         // Try to convert the DB.
         echo "Converting database to '$collation' for $CFG->wwwroot:\n";
-        $sql = "ALTER DATABASE $CFG->dbname DEFAULT CHARACTER SET $charset DEFAULT COLLATE = $collation";
+        $sql = "ALTER DATABASE `$CFG->dbname` DEFAULT CHARACTER SET $charset DEFAULT COLLATE = $collation";
         try {
             $DB->change_database_structure($sql);
         } catch (exception $e) {
@@ -146,7 +146,7 @@ if (!empty($options['collation'])) {
 
         } else {
             try {
-                $DB->change_database_structure("ALTER TABLE $table->name CONVERT TO CHARACTER SET $charset COLLATE $collation");
+                $DB->change_database_structure("ALTER TABLE `$table->name` CONVERT TO CHARACTER SET $charset COLLATE $collation");
                 echo "CONVERTED\n";
                 $converted++;
             } catch (ddl_exception $e) {
@@ -163,7 +163,7 @@ if (!empty($options['collation'])) {
             }
         }
 
-        $sql = "SHOW FULL COLUMNS FROM $table->name WHERE collation IS NOT NULL";
+        $sql = "SHOW FULL COLUMNS FROM `$table->name` WHERE collation IS NOT NULL";
         $rs2 = $DB->get_recordset_sql($sql);
         foreach ($rs2 as $column) {
             $column = (object)array_change_key_case((array)$column, CASE_LOWER);
@@ -181,7 +181,7 @@ if (!empty($options['collation'])) {
                 $notnull = ($column->null === 'NO') ? 'NOT NULL' : 'NULL';
                 $default = (!is_null($column->default) and $column->default !== '') ? "DEFAULT '$column->default'" : '';
                 // primary, unique and inc are not supported for texts
-                $sql = "ALTER TABLE $table->name
+                $sql = "ALTER TABLE `$table->name`
                         MODIFY COLUMN $column->field $column->type
                         CHARACTER SET $charset
                         COLLATE $collation $notnull $default";
@@ -192,11 +192,11 @@ if (!empty($options['collation'])) {
                 $default = !is_null($column->default) ? "DEFAULT '$column->default'" : '';
 
                 if ($rowformat != '') {
-                    $sql = "ALTER TABLE $table->name $rowformat";
+                    $sql = "ALTER TABLE `$table->name` $rowformat";
                     $DB->change_database_structure($sql);
                 }
 
-                $sql = "ALTER TABLE $table->name
+                $sql = "ALTER TABLE `$table->name`
                         MODIFY COLUMN $column->field $column->type
                         CHARACTER SET $charset
                         COLLATE $collation $notnull $default";
@@ -315,8 +315,8 @@ function mysql_set_row_format($tablename, $charset, $collation, $engine) {
         if ($rs->row_format == 'Compact' || $rs->row_format == 'Redundant') {
             $rowformat = $DB->get_row_format_sql($engine, $collation);
             // Try to convert to compressed format and then try updating the collation again.
-            $DB->change_database_structure("ALTER TABLE $tablename $rowformat");
-            $DB->change_database_structure("ALTER TABLE $tablename CONVERT TO CHARACTER SET $charset COLLATE $collation");
+            $DB->change_database_structure("ALTER TABLE `$tablename` $rowformat");
+            $DB->change_database_structure("ALTER TABLE `$tablename` CONVERT TO CHARACTER SET $charset COLLATE $collation");
         } else {
             // Row format may not be the problem. Can not diagnose problem. Send fail reply.
             return false;

admin/cli/mysql_compressed_rows.php

@@ -158,7 +158,7 @@ if (!empty($options['info'])) {
     }
 
     foreach ($fixtables as $table) {
-        $DB->change_database_structure("ALTER TABLE {$prefix}$table ROW_FORMAT=Compressed");
+        $DB->change_database_structure("ALTER TABLE `{$prefix}$table` ROW_FORMAT=Compressed");
         echo str_pad($prefix . $table, 32, ' ', STR_PAD_RIGHT) . " ... Compressed\n";
     }
 
@@ -189,7 +189,7 @@ if (!empty($options['info'])) {
     echo "SET GLOBAL innodb_file_per_table=1;\n";
     echo "SET GLOBAL innodb_file_format=Barracuda;\n";
     foreach ($fixtables as $table) {
-        echo "ALTER TABLE {$prefix}$table ROW_FORMAT=Compressed;\n";
+        echo "ALTER TABLE `{$prefix}$table` ROW_FORMAT=Compressed;\n";
     }
     echo "\n";
     exit(0);

admin/cli/uninstall_plugins.php

@@ -39,6 +39,8 @@ Options:
     --purge-missing             Uninstall all missing from disk plugins.
     --plugins=<plugin name>     A comma separated list of plugins to be uninstalled. E.g. mod_assign,mod_forum
     --run                       Execute uninstall. If this option is not set, then the script will be run in a dry mode.
+    --showsql                   Show sql queries before they are executed.
+    --showdebugging             Show developer level debugging information.
 
 Examples:
 
@@ -72,6 +74,8 @@ list($options, $unrecognised) = cli_get_params([
     'purge-missing' => false,
     'plugins' => false,
     'run' => false,
+    'showsql' => false,
+    'showdebugging' => false,
 ], [
     'h' => 'help'
 ]);
@@ -86,6 +90,14 @@ if ($options['help']) {
     exit(0);
 }
 
+if ($options['showdebugging']) {
+    set_debugging(DEBUG_DEVELOPER, true);
+}
+
+if ($options['showsql']) {
+    $DB->set_debug(true);
+}
+
 $pluginman = core_plugin_manager::instance();
 $plugininfo = $pluginman->get_plugins();
 

admin/cli/upgrade.php

@@ -135,6 +135,15 @@ if (!$envstatus) {
     exit(1);
 }
 
+// Make sure there are no files left over from previous versions.
+if (upgrade_stale_php_files_present()) {
+    cli_problem(get_string('upgradestalefiles', 'admin'));
+
+    // Stale file info contains HTML elements which aren't suitable for CLI.
+    $upgradestalefilesinfo = get_string('upgradestalefilesinfo', 'admin', get_docs_url('Upgrading'));
+    cli_error(strip_tags($upgradestalefilesinfo));
+}
+
 // Test plugin dependencies.
 $failed = array();
 if (!core_plugin_manager::instance()->all_plugins_ok($version, $failed, $CFG->branch)) {

admin/environment.xml

@@ -2815,6 +2815,7 @@
       <VENDOR name="oracle" version="11.2" />
     </DATABASE>
     <PHP version="7.1.0" level="required">
+      <RESTRICT function="restrict_php_version_80" message="unsupportedphpversion80" />
     </PHP>
     <PCREUNICODE level="optional">
       <FEEDBACK>
@@ -2996,6 +2997,7 @@
       <VENDOR name="oracle" version="11.2" />
     </DATABASE>
     <PHP version="7.2.0" level="required">
+      <RESTRICT function="restrict_php_version_80" message="unsupportedphpversion80" />
     </PHP>
     <PCREUNICODE level="optional">
       <FEEDBACK>
@@ -3177,6 +3179,7 @@
       <VENDOR name="oracle" version="11.2" />
     </DATABASE>
     <PHP version="7.2.0" level="required">
+      <RESTRICT function="restrict_php_version_80" message="unsupportedphpversion80" />
     </PHP>
     <PCREUNICODE level="optional">
       <FEEDBACK>
@@ -3344,4 +3347,188 @@
       </CUSTOM_CHECK>
     </CUSTOM_CHECKS>
   </MOODLE>
+  <MOODLE version="3.11" requires="3.6">
+    <UNICODE level="required">
+      <FEEDBACK>
+        <ON_ERROR message="unicoderequired" />
+      </FEEDBACK>
+    </UNICODE>
+    <DATABASE level="required">
+      <VENDOR name="mariadb" version="10.2.29" />
+      <VENDOR name="mysql" version="5.7" />
+      <VENDOR name="postgres" version="9.6" />
+      <VENDOR name="mssql" version="14.0" />
+      <VENDOR name="oracle" version="11.2" />
+    </DATABASE>
+    <PHP version="7.3.0" level="required">
+    </PHP>
+    <PCREUNICODE level="optional">
+      <FEEDBACK>
+        <ON_CHECK message="pcreunicodewarning" />
+      </FEEDBACK>
+    </PCREUNICODE>
+    <PHP_EXTENSIONS>
+      <PHP_EXTENSION name="iconv" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="iconvrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="mbstring" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="mbstringrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="curl" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="curlrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="openssl" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="opensslrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="tokenizer" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="tokenizerrecommended" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="xmlrpc" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="xmlrpcrecommended" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="soap" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="soaprecommended" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="ctype" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="ctyperequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="zip" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="ziprequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="zlib" level="required">
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="gd" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="gdrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="simplexml" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="simplexmlrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="spl" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="splrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="pcre" level="required">
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="dom" level="required">
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="xml" level="required">
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="xmlreader" level="required">
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="intl" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="intlrequired" />
+        </FEEDBACK>
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="json" level="required">
+      </PHP_EXTENSION>
+      <PHP_EXTENSION name="hash" level="required"/>
+      <PHP_EXTENSION name="fileinfo" level="required"/>
+      <PHP_EXTENSION name="sodium" level="optional"/>
+    </PHP_EXTENSIONS>
+    <PHP_SETTINGS>
+      <PHP_SETTING name="memory_limit" value="96M" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="settingmemorylimit" />
+        </FEEDBACK>
+      </PHP_SETTING>
+      <PHP_SETTING name="file_uploads" value="1" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="settingfileuploads" />
+        </FEEDBACK>
+      </PHP_SETTING>
+      <PHP_SETTING name="opcache.enable" value="1" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="opcacherecommended" />
+        </FEEDBACK>
+      </PHP_SETTING>
+    </PHP_SETTINGS>
+    <CUSTOM_CHECKS>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_database_storage_engine" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="unsupporteddbstorageengine" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="question/engine/upgrade/upgradelib.php" function="quiz_attempts_upgraded" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="quizattemptsupgradedmessage" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_slasharguments" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="slashargumentswarning" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_database_tables_row_format" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="unsupporteddbtablerowformat" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_unoconv_version" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="unoconvwarning" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_libcurl_version" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="libcurlwarning" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_mysql_file_format" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="unsupporteddbfileformat" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_mysql_file_per_table" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="unsupporteddbfilepertable" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_mysql_large_prefix" level="required">
+        <FEEDBACK>
+          <ON_ERROR message="unsupporteddblargeprefix" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_is_https" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="ishttpswarning" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_mysql_incomplete_unicode_support" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="incompleteunicodesupport" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_sixtyfour_bits" level="optional">
+        <FEEDBACK>
+          <ON_CHECK message="sixtyfourbitswarning" />
+        </FEEDBACK>
+      </CUSTOM_CHECK>
+      <CUSTOM_CHECK file="lib/upgradelib.php" function="check_max_input_vars" level="optional">
+      </CUSTOM_CHECK>
+    </CUSTOM_CHECKS>
+  </MOODLE>
 </COMPATIBILITY_MATRIX>

admin/message.php

@@ -119,10 +119,19 @@ if (($form = data_submitted()) && confirm_sesskey()) {
     // Save processors enabled/disabled status.
     foreach ($allprocessors as $processor) {
         $enabled = isset($form->{$processor->name});
+        if ($enabled != $processor->enabled) {
+            add_to_config_log($processor->name, $processor->enabled, $enabled, 'core');
+        }
         \core_message\api::update_processor_status($processor, $enabled);
     }
 
     foreach ($newpreferences as $name => $value) {
+        $old = isset($preferences->$name) ? $preferences->$name : '';
+
+        if ($old != $value) {
+            add_to_config_log($name, $old, $value, 'core');
+        }
+
         set_config($name, $value, 'message');
     }
     $transaction->allow_commit();

admin/oauth2callback.php

@@ -34,11 +34,12 @@ $error = optional_param('error', '', PARAM_RAW);
 if ($error) {
     $message = optional_param('error_description', '', PARAM_RAW);
     if ($message) {
-        print_error($message);
+        $SESSION->loginerrormsg = $message;
+        redirect(new moodle_url(get_login_url()));
     } else {
-        print_error($error);
+        $SESSION->loginerrormsg = $error;
+        redirect(new moodle_url(get_login_url()));
     }
-    die();
 }
 
 // The authorization code generated by the authorization server.
@@ -53,5 +54,6 @@ if (isset($params['sesskey']) and confirm_sesskey($params['sesskey'])) {
     $redirecturl->param('oauth2code', $code);
     redirect($redirecturl);
 } else {
-    print_error('invalidsesskey');
+    $SESSION->loginerrormsg = get_string('invalidsesskey', 'error');
+    redirect(new moodle_url(get_login_url()));
 }

admin/purgecaches.php

@@ -52,8 +52,14 @@ if ($data = $form->get_data()) {
     $message = get_string('purgecachesfinished', 'admin');
 }
 
+// Redirect and/or show notification message confirming cache(s) were purged.
 if (isset($message)) {
-    redirect($returnurl, $message);
+    if (!$PAGE->url->compare($returnurl, URL_MATCH_BASE)) {
+        redirect($returnurl, $message);
+    }
+
+    // We are already on the purge caches page, add the notification.
+    \core\notification::add($message, \core\output\notification::NOTIFY_INFO);
 }
 
 // Otherwise, show a form to actually purge the caches.

admin/roles/assign.php

@@ -271,7 +271,8 @@ if ($roleid) {
     foreach ($assignableroles as $roleid => $notused) {
         $roleusers = '';
         if (0 < $assigncounts[$roleid] && $assigncounts[$roleid] <= MAX_USERS_TO_LIST_PER_ROLE) {
-            $userfields = 'u.id, u.username, ' . get_all_user_name_fields(true, 'u');
+            $userfieldsapi = \core_user\fields::for_name();
+            $userfields = 'u.id, u.username' . $userfieldsapi->get_sql('u')->selects;
             $roleusers = get_role_users($roleid, $context, false, $userfields);
             if (!empty($roleusers)) {
                 $strroleusers = array();

admin/settings/analytics.php

@@ -144,5 +144,20 @@ if ($hassiteconfig && \core_analytics\manager::is_analytics_enabled()) {
         $settings->add(new admin_setting_configduration('analytics/modeltimelimit', new lang_string('modeltimelimit', 'analytics'),
             new lang_string('modeltimelimitinfo', 'analytics'), 20 * MINSECS));
 
+        $options = array(
+            0    => new lang_string('neverdelete', 'analytics'),
+            1000 => new lang_string('numdays', '', 1000),
+            365  => new lang_string('numdays', '', 365),
+            180  => new lang_string('numdays', '', 180),
+            150  => new lang_string('numdays', '', 150),
+            120  => new lang_string('numdays', '', 120),
+            90   => new lang_string('numdays', '', 90),
+            60   => new lang_string('numdays', '', 60),
+            35   => new lang_string('numdays', '', 35));
+        $settings->add(new admin_setting_configselect('analytics/calclifetime',
+            new lang_string('calclifetime', 'analytics'),
+            new lang_string('configlcalclifetime', 'analytics'), 35, $options));
+
+
     }
 }

admin/settings/appearance.php

@@ -269,7 +269,6 @@ preferences,moodle|/user/preferences.php|t/preferences',
     $setting = new admin_setting_configcheckbox('cachejs', new lang_string('cachejs', 'admin'), new lang_string('cachejs_help', 'admin'), 1);
     $setting->set_updatedcallback('js_reset_all_caches');
     $temp->add($setting);
-    $temp->add(new admin_setting_configcheckbox('modchooserdefault', new lang_string('modchooserdefault', 'admin'), new lang_string('configmodchooserdefault', 'admin'), 1));
     $ADMIN->add('appearance', $temp);
 
     // Link to tag management interface.

admin/settings/badges.php

@@ -57,20 +57,14 @@ if (($hassiteconfig || has_any_capability(array(
             new lang_string('badgesalt_desc', 'badges'),
             'badges' . $SITE->timecreated, PARAM_ALPHANUM));
 
-    $backpacks = badges_get_site_backpacks();
-    $choices = array();
-    $defaultchoice = 0;
-    foreach ($backpacks as $backpack) {
-        $choices[$backpack->id] = $backpack->backpackweburl;
-        if ($backpack->backpackweburl == BADGRIO_BACKPACKWEBURL) {
-            $defaultchoice = $backpack->id;
-        }
-    }
-
     $globalsettings->add(new admin_setting_configcheckbox('badges_allowcoursebadges',
             new lang_string('allowcoursebadges', 'badges'),
             new lang_string('allowcoursebadges_desc', 'badges'), 1));
 
+    $globalsettings->add(new admin_setting_configcheckbox('badges_allowexternalbackpack',
+            new lang_string('allowexternalbackpack', 'badges'),
+            new lang_string('allowexternalbackpack_desc', 'badges'), 1));
+
     $ADMIN->add('badges', $globalsettings);
 
     $ADMIN->add('badges',
@@ -97,19 +91,6 @@ if (($hassiteconfig || has_any_capability(array(
             array('moodle/badges:createbadge'), empty($CFG->enablebadges)
         )
     );
-    $backpacksettings = new admin_settingpage('backpacksettings', new lang_string('backpacksettings', 'badges'),
-            array('moodle/badges:manageglobalsettings'), empty($CFG->enablebadges));
-
-    $backpacksettings->add(new admin_setting_configcheckbox('badges_allowexternalbackpack',
-            new lang_string('allowexternalbackpack', 'badges'),
-            new lang_string('allowexternalbackpack_desc', 'badges'), 1));
-
-    $backpacksettings->add(new admin_setting_configselect('badges_site_backpack',
-            new lang_string('sitebackpack', 'badges'),
-            new lang_string('sitebackpack_help', 'badges'),
-            $defaultchoice, $choices));
-
-    $ADMIN->add('badges', $backpacksettings);
 
     $ADMIN->add('badges',
         new admin_externalpage('managebackpacks',

admin/settings/courses.php

@@ -139,6 +139,13 @@ if ($hassiteconfig or has_any_capability($capabilities, $systemcontext)) {
         new lang_string('coursehelpshowgrades'), 1, array(0 => new lang_string('no'), 1 => new lang_string('yes'))));
     $temp->add(new admin_setting_configselect('moodlecourse/showreports', new lang_string('showreports'), '', 0,
         array(0 => new lang_string('no'), 1 => new lang_string('yes'))));
+    $temp->add(new admin_setting_configselect('moodlecourse/showactivitydates',
+        new lang_string('showactivitydates'),
+        new lang_string('showactivitydates_help'), 1, [
+            0 => new lang_string('no'),
+            1 => new lang_string('yes')
+        ]
+    ));
 
     // Files and uploads.
     $temp->add(new admin_setting_heading('filesanduploadshdr', new lang_string('filesanduploads'), ''));
@@ -163,6 +170,15 @@ if ($hassiteconfig or has_any_capability($capabilities, $systemcontext)) {
     $temp->add(new admin_setting_configselect('moodlecourse/enablecompletion', new lang_string('completion', 'completion'),
         new lang_string('enablecompletion_help', 'completion'), 1, array(0 => new lang_string('no'), 1 => new lang_string('yes'))));
 
+    // Display completion conditions.
+    $temp->add(new admin_setting_configselect('moodlecourse/showcompletionconditions',
+        new lang_string('showcompletionconditions', 'completion'),
+        new lang_string('showcompletionconditions_help', 'completion'), 1, [
+            0 => new lang_string('no'),
+            1 => new lang_string('yes')
+        ]
+    ));
+
     // Groups.
     $temp->add(new admin_setting_heading('groups', new lang_string('groups', 'group'), ''));
     $choices = array();
@@ -327,6 +343,11 @@ if ($hassiteconfig or has_any_capability($capabilities, $systemcontext)) {
 
     // Import defaults section.
     $temp->add(new admin_setting_heading('importsettings', new lang_string('importsettings', 'backup'), ''));
+    $temp->add(new admin_setting_configcheckbox_with_lock(
+            'backup/backup_import_permissions',
+            new lang_string('generalpermissions', 'backup'),
+            new lang_string('configgeneralpermissions', 'backup'),
+            array('value' => 0, 'locked' => 0)));
     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_import_activities', new lang_string('generalactivities','backup'), new lang_string('configgeneralactivities','backup'), array('value'=>1, 'locked'=>0)));
     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_import_blocks', new lang_string('generalblocks','backup'), new lang_string('configgeneralblocks','backup'), array('value'=>1, 'locked'=>0)));
     $temp->add(new admin_setting_configcheckbox_with_lock('backup/backup_import_filters', new lang_string('generalfilters','backup'), new lang_string('configgeneralfilters','backup'), array('value'=>1, 'locked'=>0)));
@@ -501,6 +522,9 @@ if ($hassiteconfig or has_any_capability($capabilities, $systemcontext)) {
     $temp->add(new admin_setting_configcheckbox_with_lock('restore/restore_general_role_assignments',
         new lang_string('generalroleassignments', 'backup'),
         new lang_string('configrestoreroleassignments', 'backup'), array('value' => 1, 'locked' => 0)));
+    $temp->add(new admin_setting_configcheckbox_with_lock('restore/restore_general_permissions',
+        new lang_string('generalpermissions', 'backup'),
+        new lang_string('configrestorepermissions', 'backup'), array('value' => 1, 'locked' => 0)));
     $temp->add(new admin_setting_configcheckbox_with_lock('restore/restore_general_activities',
         new lang_string('generalactivities', 'backup'),
         new lang_string('configrestoreactivities', 'backup'), array('value' => 1, 'locked' => 0)));

admin/settings/plugins.php

@@ -401,55 +401,6 @@ if ($hassiteconfig) {
         /** @var \core\plugininfo\repository $plugin */
         $plugin->load_settings($ADMIN, 'repositorysettings', $hassiteconfig);
     }
-
-/// Web services
-    $ADMIN->add('modules', new admin_category('webservicesettings', new lang_string('webservices', 'webservice')));
-
-    /// overview page
-    $temp = new admin_settingpage('webservicesoverview', new lang_string('webservicesoverview', 'webservice'));
-    $temp->add(new admin_setting_webservicesoverview());
-    $ADMIN->add('webservicesettings', $temp);
-    //API documentation
-    $ADMIN->add('webservicesettings', new admin_externalpage('webservicedocumentation', new lang_string('wsdocapi', 'webservice'), "$CFG->wwwroot/$CFG->admin/webservice/documentation.php", 'moodle/site:config', false));
-    /// manage service
-    $temp = new admin_settingpage('externalservices', new lang_string('externalservices', 'webservice'));
-    $temp->add(new admin_setting_heading('manageserviceshelpexplaination', new lang_string('information', 'webservice'), new lang_string('servicehelpexplanation', 'webservice')));
-    $temp->add(new admin_setting_manageexternalservices());
-    $ADMIN->add('webservicesettings', $temp);
-    $ADMIN->add('webservicesettings', new admin_externalpage('externalservice', new lang_string('editaservice', 'webservice'), "$CFG->wwwroot/$CFG->admin/webservice/service.php", 'moodle/site:config', true));
-    $ADMIN->add('webservicesettings', new admin_externalpage('externalservicefunctions', new lang_string('externalservicefunctions', 'webservice'), "$CFG->wwwroot/$CFG->admin/webservice/service_functions.php", 'moodle/site:config', true));
-    $ADMIN->add('webservicesettings', new admin_externalpage('externalserviceusers', new lang_string('externalserviceusers', 'webservice'), "$CFG->wwwroot/$CFG->admin/webservice/service_users.php", 'moodle/site:config', true));
-    $ADMIN->add('webservicesettings', new admin_externalpage('externalserviceusersettings', new lang_string('serviceusersettings', 'webservice'), "$CFG->wwwroot/$CFG->admin/webservice/service_user_settings.php", 'moodle/site:config', true));
-    /// manage protocol page link
-    $temp = new admin_settingpage('webserviceprotocols', new lang_string('manageprotocols', 'webservice'));
-    $temp->add(new admin_setting_managewebserviceprotocols());
-    if (empty($CFG->enablewebservices)) {
-        $temp->add(new admin_setting_heading('webservicesaredisabled', '', new lang_string('disabledwarning', 'webservice')));
-    }
-
-    // We cannot use $OUTPUT this early, doing so means that we lose the ability
-    // to set the page layout on all admin pages.
-    // $wsdoclink = $OUTPUT->doc_link('How_to_get_a_security_key');
-    $url = new moodle_url(get_docs_url('How_to_get_a_security_key'));
-    $wsdoclink = html_writer::tag('a', new lang_string('supplyinfo', 'webservice'), array('href'=>$url));
-    $temp->add(new admin_setting_configcheckbox('enablewsdocumentation', new lang_string('enablewsdocumentation',
-                        'admin'), new lang_string('configenablewsdocumentation', 'admin', $wsdoclink), false));
-    $ADMIN->add('webservicesettings', $temp);
-    /// links to protocol pages
-    $plugins = core_plugin_manager::instance()->get_plugins_of_type('webservice');
-    core_collator::asort_objects_by_property($plugins, 'displayname');
-    foreach ($plugins as $plugin) {
-        /** @var \core\plugininfo\webservice $plugin */
-        $plugin->load_settings($ADMIN, 'webservicesettings', $hassiteconfig);
-    }
-    /// manage token page link
-    $ADMIN->add('webservicesettings', new admin_externalpage('addwebservicetoken', new lang_string('managetokens', 'webservice'), "$CFG->wwwroot/$CFG->admin/webservice/tokens.php", 'moodle/site:config', true));
-    $temp = new admin_settingpage('webservicetokens', new lang_string('managetokens', 'webservice'));
-    $temp->add(new admin_setting_managewebservicetokens());
-    if (empty($CFG->enablewebservices)) {
-        $temp->add(new admin_setting_heading('webservicesaredisabled', '', new lang_string('disabledwarning', 'webservice')));
-    }
-    $ADMIN->add('webservicesettings', $temp);
 }
 
 // Question type settings

admin/settings/server.php

@@ -38,6 +38,8 @@ if ($hassiteconfig) {
         new lang_string('pathtodot_help', 'admin'), ''));
     $temp->add(new admin_setting_configexecutable('pathtogs', new lang_string('pathtogs', 'admin'),
         new lang_string('pathtogs_help', 'admin'), '/usr/bin/gs'));
+    $temp->add(new admin_setting_configexecutable('pathtopdftoppm', new lang_string('pathtopdftoppm', 'admin'),
+        new lang_string('pathtopdftoppm_help', 'admin'), ''));
     $temp->add(new admin_setting_configexecutable('pathtopython', new lang_string('pathtopython', 'admin'),
         new lang_string('pathtopythondesc', 'admin'), ''));
     $ADMIN->add('server', $temp);
@@ -73,6 +75,22 @@ if ($hassiteconfig) {
     $temp->add(new admin_setting_configduration('sessiontimeout', new lang_string('sessiontimeout', 'admin'),
         new lang_string('configsessiontimeout', 'admin'), 8 * 60 * 60));
 
+    $sessiontimeoutwarning = new admin_setting_configduration('sessiontimeoutwarning',
+        new lang_string('sessiontimeoutwarning', 'admin'),
+        new lang_string('configsessiontimeoutwarning', 'admin'), 20 * 60);
+
+    $sessiontimeoutwarning->set_validate_function(function(int $value): string {
+        global $CFG;
+        // Check sessiontimeoutwarning is less than sessiontimeout.
+        if ($CFG->sessiontimeout <= $value) {
+            return get_string('configsessiontimeoutwarningcheck', 'admin');
+        } else {
+            return '';
+        }
+    });
+
+    $temp->add($sessiontimeoutwarning);
+
     $temp->add(new admin_setting_configtext('sessioncookie', new lang_string('sessioncookie', 'admin'),
         new lang_string('configsessioncookie', 'admin'), '', PARAM_ALPHANUM));
     $temp->add(new admin_setting_configtext('sessioncookiepath', new lang_string('sessioncookiepath', 'admin'),
@@ -528,4 +546,67 @@ if ($hassiteconfig) {
             new lang_string('updatenotifybuilds_desc', 'core_admin'), 0));
         $ADMIN->add('server', $temp);
     }
+
+    // Web services.
+    $ADMIN->add('server', new admin_category('webservicesettings', new lang_string('webservices', 'webservice')));
+
+    // Web services > Overview.
+    $temp = new admin_settingpage('webservicesoverview', new lang_string('webservicesoverview', 'webservice'));
+    $temp->add(new admin_setting_webservicesoverview());
+    $ADMIN->add('webservicesettings', $temp);
+
+    // Web services > API documentation.
+    $ADMIN->add('webservicesettings', new admin_externalpage('webservicedocumentation', new lang_string('wsdocapi', 'webservice'),
+        "{$CFG->wwwroot}/{$CFG->admin}/webservice/documentation.php", 'moodle/site:config', false));
+
+    // Web services > External services.
+    $temp = new admin_settingpage('externalservices', new lang_string('externalservices', 'webservice'));
+
+    $temp->add(new admin_setting_heading('manageserviceshelpexplaination', new lang_string('information', 'webservice'),
+        new lang_string('servicehelpexplanation', 'webservice')));
+
+    $temp->add(new admin_setting_manageexternalservices());
+
+    $ADMIN->add('webservicesettings', $temp);
+
+    $ADMIN->add('webservicesettings', new admin_externalpage('externalservice', new lang_string('editaservice', 'webservice'),
+        "{$CFG->wwwroot}/{$CFG->admin}/webservice/service.php", 'moodle/site:config', true));
+
+    $ADMIN->add('webservicesettings', new admin_externalpage('externalservicefunctions',
+        new lang_string('externalservicefunctions', 'webservice'), "{$CFG->wwwroot}/{$CFG->admin}/webservice/service_functions.php",
+        'moodle/site:config', true));
+
+    $ADMIN->add('webservicesettings', new admin_externalpage('externalserviceusers',
+        new lang_string('externalserviceusers', 'webservice'), "{$CFG->wwwroot}/{$CFG->admin}/webservice/service_users.php",
+        'moodle/site:config', true));
+
+    $ADMIN->add('webservicesettings', new admin_externalpage('externalserviceusersettings',
+        new lang_string('serviceusersettings', 'webservice'), "{$CFG->wwwroot}/{$CFG->admin}/webservice/service_user_settings.php",
+        'moodle/site:config', true));
+
+    // Web services > Manage protocols.
+    $temp = new admin_settingpage('webserviceprotocols', new lang_string('manageprotocols', 'webservice'));
+    $temp->add(new admin_setting_managewebserviceprotocols());
+    if (empty($CFG->enablewebservices)) {
+        $temp->add(new admin_setting_heading('webservicesaredisabled', '', new lang_string('disabledwarning', 'webservice')));
+    }
+
+    // We cannot use $OUTPUT->doc_link() this early, we would lose the ability to set the page layout on all admin pages.
+    $url = new moodle_url(get_docs_url('How_to_get_a_security_key'));
+    $wsdoclink = html_writer::link($url, new lang_string('supplyinfo', 'webservice'), ['target' => '_blank']);
+    $temp->add(new admin_setting_configcheckbox('enablewsdocumentation', new lang_string('enablewsdocumentation', 'admin'),
+        new lang_string('configenablewsdocumentation', 'admin', $wsdoclink), false));
+
+    $ADMIN->add('webservicesettings', $temp);
+
+    $plugins = core_plugin_manager::instance()->get_plugins_of_type('webservice');
+    core_collator::asort_objects_by_property($plugins, 'displayname');
+    foreach ($plugins as $plugin) {
+        /** @var \core\plugininfo\webservice $plugin */
+        $plugin->load_settings($ADMIN, 'webservicesettings', $hassiteconfig);
+    }
+
+    // Web services > Manage tokens.
+    $ADMIN->add('webservicesettings', new admin_externalpage('webservicetokens', new lang_string('managetokens', 'webservice'),
+        new moodle_url('/admin/webservice/tokens.php')));
 }

admin/settings/users.php

@@ -87,6 +87,14 @@ if ($hassiteconfig
         $choices['1'] = new lang_string('trackforumsyes');
         $temp->add(new admin_setting_configselect('defaultpreference_trackforums', new lang_string('trackforums'),
             '', 0, $choices));
+
+        $choices = [];
+        $choices[\core_contentbank\content::VISIBILITY_PUBLIC] = new lang_string('visibilitychoicepublic', 'core_contentbank');
+        $choices[\core_contentbank\content::VISIBILITY_UNLISTED] = new lang_string('visibilitychoiceunlisted', 'core_contentbank');
+        $temp->add(new admin_setting_configselect('defaultpreference_core_contentbank_visibility',
+            new lang_string('visibilitypref', 'core_contentbank'),
+            new lang_string('visibilitypref_help', 'core_contentbank'),
+            \core_contentbank\content::VISIBILITY_PUBLIC, $choices));
     }
     $ADMIN->add('accounts', $temp);
 
@@ -188,12 +196,6 @@ if ($hassiteconfig
                              'country' => new lang_string('country'),
                              'moodlenetprofile' => new lang_string('moodlenetprofile', 'user'),
                              'timezone' => new lang_string('timezone'),
-                             'webpage' => new lang_string('webpage'),
-                             'icqnumber' => new lang_string('icqnumber'),
-                             'skypeid' => new lang_string('skypeid'),
-                             'yahooid' => new lang_string('yahooid'),
-                             'aimid' => new lang_string('aimid'),
-                             'msnid' => new lang_string('msnid'),
                              'firstaccess' => new lang_string('firstaccess'),
                              'lastaccess' => new lang_string('lastaccess'),
                              'lastip' => new lang_string('lastip'),
@@ -206,21 +208,39 @@ if ($hassiteconfig
         // with moodle/site:viewuseridentity).
         // Options include fields from the user table that might be helpful to
         // distinguish when adding or listing users ('I want to add the John
-        // Smith from Science faculty').
-        // Custom user profile fields are not currently supported.
+        // Smith from Science faculty') and any custom profile fields.
         $temp->add(new admin_setting_configmulticheckbox('showuseridentity',
                 new lang_string('showuseridentity', 'admin'),
-                new lang_string('showuseridentity_desc', 'admin'), array('email' => 1), array(
-                    'username'    => new lang_string('username'),
-                    'idnumber'    => new lang_string('idnumber'),
-                    'email'       => new lang_string('email'),
-                    'phone1'      => new lang_string('phone1'),
-                    'phone2'      => new lang_string('phone2'),
-                    'department'  => new lang_string('department'),
-                    'institution' => new lang_string('institution'),
-                    'city'        => new lang_string('city'),
-                    'country'     => new lang_string('country'),
-                )));
+                new lang_string('showuseridentity_desc', 'admin'), ['email' => 1],
+                function() {
+                    global $CFG;
+                    require_once($CFG->dirroot.'/user/profile/lib.php');
+
+                    // Basic fields available in user table.
+                    $fields = [
+                        'username'    => new lang_string('username'),
+                        'idnumber'    => new lang_string('idnumber'),
+                        'email'       => new lang_string('email'),
+                        'phone1'      => new lang_string('phone1'),
+                        'phone2'      => new lang_string('phone2'),
+                        'department'  => new lang_string('department'),
+                        'institution' => new lang_string('institution'),
+                        'city'        => new lang_string('city'),
+                        'country'     => new lang_string('country'),
+                    ];
+
+                    // Custom profile fields.
+                    $profilefields = profile_get_custom_fields();
+                    foreach ($profilefields as $field) {
+                        // Only reasonable-length text fields can be used as identity fields.
+                        if ($field->param2 > 255 || $field->datatype != 'text') {
+                            continue;
+                        }
+                        $fields['profile_field_' . $field->shortname] = $field->name . ' *';
+                    }
+
+                    return $fields;
+                }));
         $setting = new admin_setting_configtext('fullnamedisplay', new lang_string('fullnamedisplay', 'admin'),
             new lang_string('configfullnamedisplay', 'admin'), 'language', PARAM_TEXT, 50);
         $setting->set_force_ltr(true);

admin/tasklogs.php

@@ -32,6 +32,7 @@ $result = optional_param('result', null, PARAM_INT);
 
 $pageurl = new \moodle_url('/admin/tasklogs.php');
 $pageurl->param('filter', $filter);
+$pageurl->param('result', $result);
 
 $PAGE->set_url($pageurl);
 $PAGE->set_context(context_system::instance());

admin/templates/setting_encryptedpassword.mustache

@@ -0,0 +1,64 @@
+{{!
+    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/>.
+}}
+{{!
+    @template core_admin/admin_setting_encryptedpassword
+
+    Admin encrypted password template.
+
+    Context variables required for this template:
+    * name - form element name
+    * set - whether it is set or empty
+    * id - element id
+
+    Example context (json):
+    {
+        "name": "test",
+        "id": "test0",
+        "set": true
+    }
+}}
+<div class="core_admin_encryptedpassword" data-encryptedpasswordid="{{ id }}"
+        {{#novalue}}data-novalue="y"{{/novalue}}>
+    {{#set}}
+        <span>{{# str }} encryptedpassword_set, admin {{/ str }}</span>
+    {{/set}}
+    {{^set}}
+        <a href="#" title="{{# str }} encryptedpassword_edit, admin {{/ str }}">
+            <span>{{# str }} novalueclicktoset, form {{/ str }}</span>
+            {{# pix }} t/passwordunmask-edit, core, {{# str }} passwordunmaskedithint, form {{/ str }}{{/ pix }}
+        </a>
+    {{/set}}
+    <input style="display: none" type="password" name="{{name}}" disabled>
+    {{!
+        Using buttons instead of links here allows them to be connected to the label, so the button
+        works if you click the label.
+    }}
+    {{#set}}
+        <button type="button" id="{{id}}" title="{{# str }} encryptedpassword_edit, admin {{/ str }}" class="btn btn-link" data-editbutton>
+            {{# pix }} t/passwordunmask-edit, core, {{/ pix }}
+        </button>
+    {{/set}}
+    <button type="button" style="display: none" title="{{# str }} cancel {{/ str }}" class="btn btn-link" data-cancelbutton>
+        <i class="icon fa fa-times"></i>
+    </button>
+</div>
+
+{{#js}}
+require(['core_form/encryptedpassword'], function(encryptedpassword) {
+    new encryptedpassword.EncryptedPassword("{{ id }}");
+});
+{{/js}}

admin/tests/behat/behat_admin.php

@@ -89,7 +89,7 @@ class behat_admin extends behat_base {
     }
 
     /**
-     * Sets the specified site settings. A table with | config | value | (optional)plugin | is expected.
+     * Sets the specified site settings. A table with | config | value | (optional)plugin | (optional)encrypted | is expected.
      *
      * @Given /^the following config values are set as admin:$/
      * @param TableNode $table
@@ -103,11 +103,20 @@ class behat_admin extends behat_base {
         foreach ($data as $config => $value) {
             // Default plugin value is null.
             $plugin = null;
+            $encrypted = false;
 
             if (is_array($value)) {
                 $plugin = $value[1];
+                if (array_key_exists(2, $value)) {
+                    $encrypted = $value[2] === 'encrypted';
+                }
                 $value = $value[0];
             }
+
+            if ($encrypted) {
+                $value = \core\encryption::encrypt($value);
+            }
+
             set_config($config, $value, $plugin);
         }
     }

admin/tests/behat/browse_users.feature

@@ -0,0 +1,50 @@
+@core @core_admin
+Feature: An administrator can browse user accounts
+  In order to find the user accounts I am looking for
+  As an admin
+  I can browse users and see their basic information
+
+  Background:
+    Given the following "custom profile fields" exist:
+      | datatype | shortname | name           |
+      | text     | frog      | Favourite frog |
+    And the following "users" exist:
+      | username | firstname | lastname | email           | department | profile_field_frog | firstnamephonetic |
+      | user1    | User      | One      | one@example.com | Attack     | Kermit             | Yewzer            |
+      | user2    | User      | Two      | two@example.com | Defence    | Tree               | Yoozare           |
+    And I log in as "admin"
+
+  Scenario: User accounts display default fields
+    When I navigate to "Users > Accounts > Browse list of users" in site administration
+    # Name field always present, email field is default for showidentity.
+    Then the following should exist in the "users" table:
+      | First name / Surname | Email address   |
+      | User One             | one@example.com |
+      | User Two             | two@example.com |
+    # Should not see other identity fields or non-default name fields.
+    And I should not see "Department" in the "table" "css_element"
+    And I should not see "Attack"
+    And I should not see "Favourite frog" in the "table" "css_element"
+    And I should not see "Kermit"
+    And I should not see "First name - phonetic" in the "table" "css_element"
+    And I should not see "Yoozare"
+
+  Scenario: User accounts with extra name fields
+    Given the following config values are set as admin:
+      | alternativefullnameformat | firstnamephonetic lastname |
+    When I navigate to "Users > Accounts > Browse list of users" in site administration
+    Then the following should exist in the "users" table:
+      | First name - phonetic / Surname | Email address   |
+      | Yewzer One                      | one@example.com |
+      | Yoozare Two                     | two@example.com |
+
+  Scenario: User accounts with specified identity fields
+    Given the following config values are set as admin:
+      | showuseridentity | department,profile_field_frog |
+    When I navigate to "Users > Accounts > Browse list of users" in site administration
+    Then the following should exist in the "users" table:
+      | First name / Surname | Favourite frog  | Department |
+      | User One             | Kermit          | Attack     |
+      | User Two             | Tree            | Defence    |
+    And I should not see "Email address" in the "table" "css_element"
+    And I should not see "one@example.com"

admin/tests/behat/filter_users.feature

@@ -5,12 +5,16 @@ Feature: An administrator can filter user accounts by role, cohort and other pro
   I need to filter the users account list using different filter
 
   Background:
-    Given the following "users" exist:
-      | username | firstname | lastname | email | auth | confirmed | lastip | institution | department |
-      | user1 | User | One | one@example.com | manual | 0 | 127.0.1.1       | moodle      | red        |
-      | user2 | User | Two | two@example.com | ldap | 1 | 0.0.0.0           | moodle      | blue       |
-      | user3 | User | Three | three@example.com | manual | 1 | 0.0.0.0 |                 |            |
-      | user4 | User | Four | four@example.com | ldap | 0 | 127.0.1.2 |                   |            |
+    Given the following "custom profile fields" exist:
+      | datatype | shortname | name           |
+      | text     | frog      | Favourite frog |
+      | text     | undead    | Type of undead |
+    And the following "users" exist:
+      | username | firstname | lastname | email | auth | confirmed | lastip | institution | department | profile_field_frog | profile_field_undead |
+      | user1 | User | One | one@example.com | manual | 0 | 127.0.1.1       | moodle      | red        | Kermit             |                      |
+      | user2 | User | Two | two@example.com | ldap | 1 | 0.0.0.0           | moodle      | blue       | Mr Toad            | Zombie               |
+      | user3 | User | Three | three@example.com | manual | 1 | 0.0.0.0 |                 |            |                    |                      |
+      | user4 | User | Four | four@example.com | ldap | 0 | 127.0.1.2 |                   |            |                    |                      |
     And the following "cohorts" exist:
       | name | idnumber |
       | Cohort 1 | CH1 |
@@ -116,3 +120,20 @@ Feature: An administrator can filter user accounts by role, cohort and other pro
     And I press "Add filter"
     And I should see "User One"
     And I should not see "User Two"
+
+  Scenario: Filter users by custom profile field (specific or any)
+    When I set the field "id_profile_fld" to "Favourite frog"
+    And I set the field "id_profile" to "Kermit"
+    And I press "Add filter"
+    Then I should see "User One"
+    And I should not see "User Two"
+    And I should not see "User Three"
+    And I should not see "User Four"
+    And I press "Remove all filters"
+    And I set the field "id_profile_fld" to "any field"
+    And I set the field "id_profile" to "Zombie"
+    And I press "Add filter"
+    And I should see "User Two"
+    And I should not see "User One"
+    And I should not see "User Three"
+    And I should not see "User Four"

admin/tests/behat/manage_tokens.feature

@@ -1,27 +1,76 @@
 @core @core_admin
-Feature: Manage tokens
-  In order to manage webservice usage
+Feature: Manage external services tokens
+  In order to manage external service usage
   As an admin
-  I need to be able to create and delete tokens
+  I need to be able to create, filter and delete tokens
 
   Background:
     Given the following "users" exist:
-    | username  | password  | firstname | lastname |
-    | testuser  | testuser  | Joe | Bloggs |
-    | testuser2 | testuser2 | TestFirstname | TestLastname |
+      | username  | password  | firstname     | lastname    |
+      | user1     | user1     | Firstname1    | Lastname1   |
+      | user2     | user2     | Firstname2    | Lastname2   |
+      | user3     | user3     | Firstname3    | Lastname3   |
+      | user4     | user4     | Firstname4    | Lastname4   |
     And I change window size to "small"
-    And I log in as "admin"
-    And I am on site homepage
 
   @javascript
-  Scenario: Add & delete a token
-    Given I navigate to "Plugins > Web services > Manage tokens" in site administration
-    And I follow "Add"
-    And I set the field "User" to "Joe Bloggs"
+  Scenario: Add a token to user identified by name and then delete that token
+    Given I log in as "admin"
+    And I am on site homepage
+    And I navigate to "Server > Web services > Manage tokens" in site administration
+    And I press "Create token"
+    And I set the field "User" to "Firstname1 Lastname1"
+    And I set the field "Service" to "Moodle mobile web service"
     And I set the field "IP restriction" to "127.0.0.1"
     When I press "Save changes"
-    Then I should see "Joe Bloggs"
-    And I should see "127.0.0.1"
-    And I follow "Delete"
+    Then I should see "Moodle mobile web service" in the "Firstname1 Lastname1" "table_row"
+    And I should see "127.0.0.1" in the "Firstname1 Lastname1" "table_row"
+    And I click on "Delete" "link" in the "Firstname1 Lastname1" "table_row"
+    And I should see "Do you really want to delete this web service token for Firstname1 Lastname1 on the service Moodle mobile web service?"
     And I press "Delete"
-    And I should not see "Joe Bloggs"
+    And "Firstname1 Lastname1" "table_row" should not exist
+
+  @javascript
+  Scenario: Tokens can be filtered by user and by service
+    Given the following "core_webservice > Service" exists:
+      | name      | Site information              |
+      | shortname | siteinfo                      |
+      | enabled   | 1                             |
+    And the following "core_webservice > Service function" exists:
+      | service   | siteinfo                      |
+      | functions | core_webservice_get_site_info |
+    And the following "core_webservice > Tokens" exist:
+      | user      | service                       |
+      | user2     | siteinfo                      |
+      | user3     | moodle_mobile_app             |
+      | user4     | siteinfo                      |
+    When I log in as "admin"
+    And I navigate to "Server > Web services > Manage tokens" in site administration
+
+    # All created tokens are shown by default.
+    And "Firstname1 Lastname1" "table_row" should not exist
+    And I should see "Site information" in the "Firstname2 Lastname2" "table_row"
+    And I should see "Moodle mobile web service" in the "Firstname3 Lastname3" "table_row"
+    And I should see "Site information" in the "Firstname4 Lastname4" "table_row"
+
+    # Filter tokens by user (note we can select the user by the identity field here).
+    When I click on "Tokens filter" "link"
+    And I set the field "User" to "user2@example.com"
+    And I press "Show only matching tokens"
+    Then "Firstname3 Lastname3" "table_row" should not exist
+    And "Firstname4 Lastname4" "table_row" should not exist
+    And I should see "Site information" in the "Firstname2 Lastname2" "table_row"
+
+    # Reset the filter.
+    And I press "Show all tokens"
+    And I should see "Site information" in the "Firstname2 Lastname2" "table_row"
+    And I should see "Moodle mobile web service" in the "Firstname3 Lastname3" "table_row"
+    And I should see "Site information" in the "Firstname4 Lastname4" "table_row"
+
+    # Filter tokens by service.
+    And I click on "Tokens filter" "link"
+    And I set the field "Service" to "Site information"
+    And I press "Show only matching tokens"
+    And I should see "Site information" in the "Firstname2 Lastname2" "table_row"
+    And I should see "Site information" in the "Firstname4 Lastname4" "table_row"
+    And "Firstname3 Lastname3" "table_row" should not exist

admin/tests/behat/webservice_users.feature

@@ -0,0 +1,31 @@
+@core @core_admin
+Feature: Web service user settings
+  In order to configure authorised users for a web service
+  As an admin
+  I need to use the page that lets you do that
+
+  Background:
+    # Include a custom profile field so we can check it gets displayed
+    Given the following "custom profile fields" exist:
+      | datatype | shortname | name           | param2 |
+      | text     | frog      | Favourite frog | 100    |
+    And the following config values are set as admin:
+      | showuseridentity | email,profile_field_frog |
+    And the following "users" exist:
+      | username | firstname | lastname | email         | profile_field_frog |
+      | user1    | User      | One      | 1@example.org | Kermit             |
+    And the following "core_webservice > Service" exists:
+      | name            | Silly service |
+      | shortname       | silly         |
+      | restrictedusers | 1             |
+      | enabled         | 1             |
+
+  Scenario: Add a user to a web service
+    When I log in as "admin"
+    And I navigate to "Server > Web services > External services" in site administration
+    And I click on "Authorised users" "link" in the "Silly service" "table_row"
+    And I set the field "Not authorised users" to "User One"
+    And I press "Add"
+    Then I should see "User One" in the ".alloweduserlist" "css_element"
+    And I should see "1@example.org" in the ".alloweduserlist" "css_element"
+    And I should see "Kermit" in the ".alloweduserlist" "css_element"

admin/tool/analytics/version.php

@@ -24,6 +24,6 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$plugin->version   = 2020110900; // The current plugin version (Date: YYYYMMDDXX).
-$plugin->requires  = 2020110300; // Requires this Moodle version.
+$plugin->version   = 2021051700; // The current plugin version (Date: YYYYMMDDXX).
+$plugin->requires  = 2021051100; // Requires this Moodle version.
 $plugin->component = 'tool_analytics'; // Full name of the plugin (used for diagnostics).

admin/tool/availabilityconditions/version.php

@@ -24,6 +24,6 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$plugin->version = 2020110900;
-$plugin->requires = 2020110300;
+$plugin->version = 2021051700;
+$plugin->requires = 2021051100;
 $plugin->component = 'tool_availabilityconditions';

admin/tool/behat/cli/run.php

@@ -45,7 +45,7 @@ list($options, $unrecognised) = cli_get_params(
     array(
         'stop-on-failure' => 0,
         'verbose'  => false,
-        'replace'  => false,
+        'replace'  => '',
         'help'     => false,
         'tags'     => '',
         'profile'  => '',
@@ -70,7 +70,7 @@ $help = "
 Behat utilities to run behat tests in parallel
 
 Usage:
-  php run.php [--BEHAT_OPTION=\"value\"] [--feature=\"value\"] [--replace] [--fromrun=value --torun=value] [--help]
+  php run.php [--BEHAT_OPTION=\"value\"] [--feature=\"value\"] [--replace=\"{run}\"] [--fromrun=value --torun=value] [--help]
 
 Options:
 --BEHAT_OPTION     Any combination of behat option specified in http://behat.readthedocs.org/en/v2.5/guides/6.cli.html
@@ -144,9 +144,10 @@ $extraopts = $unrecognised;
 if ($options['profile']) {
     $profile = $options['profile'];
 
-    // If profile passed is not set, then exit.
+    // If profile passed is not set, then exit (note we skip if the 'replace' option is found within the 'profile' value).
     if (!isset($CFG->behat_config[$profile]) && !isset($CFG->behat_profiles[$profile]) &&
-        !(isset($options['replace']) && (strpos($options['profile'], $options['replace']) >= 0 ))) {
+            !($options['replace'] && (strpos($profile, (string) $options['replace']) !== false))) {
+
         echo "Invalid profile passed: " . $profile . PHP_EOL;
         exit(1);
     }

admin/tool/behat/lang/en/tool_behat.php

@@ -46,6 +46,7 @@ $string['stepsdefinitionstype'] = 'Type';
 $string['theninfo'] = 'Then. Checkings to ensure the outcomes are the expected ones';
 $string['unknownexceptioninfo'] = 'There was a problem with Selenium or your browser. Please ensure you are using the latest version of Selenium. Error:';
 $string['viewsteps'] = 'Filter';
+$string['warndirrootconfigfound'] = 'A configuration file was found at {$a}. This file is not automatically updated and may become stale. We recommend removing this file.';
 $string['wheninfo'] = 'When. Action that provokes an event';
 $string['wrongbehatsetup'] = 'Something is wrong with the behat setup and so step definitions cannot be listed: <b>{$a->errormsg}</b><br/><br/>Please check:<ul>
 <li>$CFG->behat_dataroot, $CFG->behat_prefix and $CFG->behat_wwwroot are set in config.php with different values from $CFG->dataroot, $CFG->prefix and $CFG->wwwroot.</li>

admin/tool/behat/tests/behat/data_generators.feature

@@ -156,7 +156,7 @@ Feature: Set up contextual data for tests
     And I log in as "user5"
     And I should see "You are logged in as"
     And I am on "Course 1" course homepage
-    And I should see "You can not enrol yourself in this course."
+    And I should see "You cannot enrol yourself in this course."
 
   Scenario: Add modules
     Given the following "courses" exist:

admin/tool/behat/tests/behat/datetime_strings.feature

@@ -21,5 +21,5 @@ Feature: Transform date time string arguments
     And I log in as "teacher1"
     And I am on "Course 1" course homepage
     And I follow "Test assignment name"
-    And I should see "##yesterday##l, j F Y##"
+    And I should see "##yesterday##%d %B %Y##"
     And I log out

admin/tool/behat/tests/behat/edit_permissions.feature

@@ -6,14 +6,18 @@ Feature: Edit capabilities
 
   Background:
     Given the following "users" exist:
-      | username | firstname | lastname | email |
-      | teacher1 | Teacher | 1 | teacher1@example.com |
+      | username | firstname | lastname  |
+      | teacher1 | Teacher   | 1         |
+      | tutor    | Teaching  | Assistant |
+      | student  | Student   | One       |
     And the following "courses" exist:
-      | fullname | shortname | category |
-      | Course 1 | C1 | 0 |
+      | fullname | shortname |
+      | Course 1 | C1        |
     And the following "course enrolments" exist:
-      | user | course | role |
-      | teacher1 | C1 | editingteacher |
+      | user     | course | role           |
+      | teacher1 | C1     | editingteacher |
+      | tutor    | C1     | teacher        |
+      | student  | C1     | student        |
 
   Scenario: Default system capabilities modification
     Given I log in as "admin"
@@ -45,10 +49,14 @@ Feature: Edit capabilities
 
   Scenario: Module capabilities overrides
     Given I log in as "teacher1"
+    And the following "activity" exists:
+      | activity | forum                |
+      | course   | C1                   |
+      | idnumber | 00001                |
+      | name     | I'm the name         |
+      | intro    | I'm the introduction |
+      | section  | 1                    |
     And I am on "Course 1" course homepage with editing mode on
-    And I add a "Forum" to section "1" and I fill the form with:
-      | Forum name | I'm the name |
-      | Description | I'm the introduction |
     And I follow "I'm the name"
     And I navigate to "Permissions" in current page administration
     And I override the system permissions of "Student" role with:
@@ -60,3 +68,25 @@ Feature: Edit capabilities
     Then "mod/forum:deleteanypost" capability has "Prohibit" permission
     And "mod/forum:editanypost" capability has "Prevent" permission
     And "mod/forum:addquestion" capability has "Allow" permission
+
+  @javascript
+  Scenario: Edit permissions escapes role names correctly
+    When I am on the "C1" "Course" page logged in as "admin"
+    And I navigate to "Edit settings" in current page administration
+    And I set the following fields to these values:
+      | Your word for 'Teacher'             | Teacher >= editing  |
+      | Your word for 'Non-editing teacher' | Teacher < "editing" |
+      | Your word for 'Student'             | Studier & 'learner' |
+    And I press "Save and display"
+    And I navigate to course participants
+    Then I should see "Teacher >= editing (Teacher)" in the "Teacher 1" "table_row"
+    And I should see "Teacher < \"editing\" (Non-editing teacher)" in the "Teaching Assistant" "table_row"
+    And I should see "Studier & 'learner' (Student)" in the "Student One" "table_row"
+    And I navigate to "Users > Permissions" in current page administration
+    And I should see "Teacher >= editing" in the "mod/forum:replypost" "table_row"
+    And I should see "Teacher < \"editing\"" in the "mod/forum:replypost" "table_row"
+    And I should see "Studier & 'learner'" in the "mod/forum:replypost" "table_row"
+    And I follow "Prohibit"
+    And "Teacher >= editing" "button" in the "Prohibit role" "dialogue" should be visible
+    And "Teacher < \"editing\"" "button" in the "Prohibit role" "dialogue" should be visible
+    And "Studier & 'learner'" "button" in the "Prohibit role" "dialogue" should be visible

admin/tool/behat/tests/behat/get_and_set_fields.feature

@@ -115,15 +115,24 @@ Feature: Verify that all form fields values can be get and set
       | Wiki name | Test this one baby |
       | Default format | HTML |
     And I press "Cancel"
-    And I am on "Course 1" course homepage
     # Radio - Checking "I set the field" and "the field matches value".
-    And I add a "Choice" to section "1" and I fill the form with:
-      | Choice name | Test choice name |
-      | Description | Test choice description |
-      | Allow choice to be updated | Yes |
-      | Option 1 | one |
-      | Option 2 | two |
-      | Option 3 | three |
+    And the following "activity" exists:
+      | activity         | choice                       |
+      | course           | C1                           |
+      | idnumber         | choice1                      |
+      | intro            | Test choice description      |
+      | name             | Test choice name             |
+      | choice1          | Option 1, Option 2, Option 3 |
+      | section          | 1                            |
+      | allowupdate      | 1                            |
+    And I am on "Course 1" course homepage
+    And I follow "Test choice name"
+    And I navigate to "Edit settings" in current page administration
+    And I set the field "Option 1" to "one"
+    And I set the field "Option 2" to "two"
+    And I set the field "Option 3" to "three"
+    And I press "Save and return to course"
+    And I am on "Course 1" course homepage
     And I follow "Test choice name"
     And I set the field "one" to "1"
     And I press "Save my choice"

admin/tool/behat/tests/behat/inplaceeditable.feature

@@ -0,0 +1,30 @@
+@tool_behat
+Feature: Verify that the inplace editable field works as expected
+  In order to use behat step definitions
+  As a test write
+  I need to ensure that the inplace editable works in forms
+
+  Background:
+    Given the following "course" exists:
+      | fullname  | Course 1 |
+      | shortname | C1       |
+    And the following "activities" exist:
+      | activity | course | name                | idnumber |
+      | forum    | C1     | My first forum      | forum1   |
+      | assign   | C1     | My first assignment | assign1  |
+      | quiz     | C1     | My first quiz       | quiz1    |
+    And I log in as "admin"
+    And I am on "Course 1" course homepage with editing mode on
+
+  @javascript
+  Scenario: Using an inplace editable updates the name of an activity
+    When I set the field "Edit title" in the "My first assignment" "activity" to "Coursework submission"
+    Then I should see "Coursework submission"
+    And I should not see "My first assignment"
+    But I should see "My first forum"
+    And I should see "My first quiz"
+    And I set the field "Edit title" in the "Coursework submission" "activity" to "My first assignment"
+    And I should not see "Coursework submission"
+    But I should see "My first assignment"
+    And I should see "My first forum"
+    And I should see "My first quiz"

admin/tool/behat/tests/behat/keyboard.feature

@@ -0,0 +1,52 @@
+@tool_behat
+Feature: Verify that keyboard steps work as expected
+  In order to use behat step definitions
+  As a test writer
+  I need to verify that the keyboard steps work as expected
+
+  @javascript
+  Scenario: Typing keys into a field causes them to be input
+    Given the following "users" exist:
+      | username | email                        | firstname | lastname | password    |
+      | saffronr | saffron.rutledge@example.com | Saffron   | Rutledge | flowerpower |
+    Given I click on "Log in" "link"
+    And I click on "Username" "field"
+    When I type "saffronr"
+    And I press the tab key
+    And I type "flowerpower"
+    And I press enter
+    Then I should see "You are logged in as Saffron Rutledge"
+
+  @javascript
+  Scenario: Using tab changes focus to the next or previous field
+    Given I click on "Log in" "link"
+    And I click on "Username" "field"
+    And the focused element is "Username" "field"
+    When I press the tab key
+    Then the focused element is "Password" "field"
+
+    And I press the shift tab key
+    And the focused element is "Username" "field"
+
+  @javascript
+  Scenario: Using the arrow keys allows me to navigate through menus
+    Given the following "users" exist:
+      | username | email                        | firstname | lastname |
+      | saffronr | saffron.rutledge@example.com | Saffron   | Rutledge |
+    And I log in as "saffronr"
+    And I click on "Saffron Rutledge" "link" in the ".usermenu" "css_element"
+    When I press the up key
+    Then the focused element is "Log out" "link"
+
+  @javascript
+  Scenario: The escape key can be used to close a dialogue
+    Given the following "course" exists:
+     | fullname  | C1|
+     | shortname | C1 |
+    And I log in as "admin"
+    And I am on "C1" course homepage
+    And I navigate to course participants
+    And I press "Enrol users"
+    And "Enrol users" "dialogue" should be visible
+    When I press the escape key
+    Then "Enrol users" "dialogue" should not be visible

admin/tool/behat/tests/behat/manipulate_forms.feature

@@ -14,8 +14,6 @@ Feature: Forms manipulation
     Then the field "First name" matches value "Field value"
     And the "Select a country" select box should contain "Japan"
     And the field "New password" matches value "TestPass"
-    And I take focus off "Update profile" "button"
-    And I press "Update profile"
 
   @javascript
   Scenario: Expand all fieldsets and advanced elements

admin/tool/behat/tests/manager_util_test.php

@@ -149,7 +149,7 @@ class tool_behat_manager_util_testcase extends advanced_testcase {
     public function test_get_config_file_contents_with_single_run() {
 
         $mockbuilder = $this->getMockBuilder('behat_config_util');
-        $mockbuilder->setMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
+        $mockbuilder->onlyMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
 
         $behatconfigutil = $mockbuilder->getMock();
 
@@ -188,7 +188,7 @@ class tool_behat_manager_util_testcase extends advanced_testcase {
     public function test_get_config_file_contents_with_single_run_no_theme() {
 
         $mockbuilder = $this->getMockBuilder('behat_config_util');
-        $mockbuilder->setMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
+        $mockbuilder->onlyMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
 
         $behatconfigutil = $mockbuilder->getMock();
 
@@ -242,7 +242,7 @@ class tool_behat_manager_util_testcase extends advanced_testcase {
     public function test_get_config_file_contents_with_parallel_run() {
 
         $mockbuilder = $this->getMockBuilder('behat_config_util');
-        $mockbuilder->setMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
+        $mockbuilder->onlyMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
 
         $behatconfigutil = $mockbuilder->getMock();
 
@@ -345,7 +345,7 @@ class tool_behat_manager_util_testcase extends advanced_testcase {
     public function test_get_config_file_contents_with_parallel_run_optimize_tags() {
 
         $mockbuilder = $this->getMockBuilder('behat_config_util');
-        $mockbuilder->setMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
+        $mockbuilder->onlyMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
 
         $behatconfigutil = $mockbuilder->getMock();
 
@@ -489,7 +489,7 @@ class tool_behat_manager_util_testcase extends advanced_testcase {
     public function test_get_config_file_contents_with_blacklisted_tags() {
 
         $mockbuilder = $this->getMockBuilder('behat_config_util');
-        $mockbuilder->setMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_blacklisted_tests_for_theme',
+        $mockbuilder->onlyMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_blacklisted_tests_for_theme',
             'get_default_theme', 'get_theme_config'));
 
         $behatconfigutil = $mockbuilder->getMock();
@@ -553,7 +553,7 @@ class tool_behat_manager_util_testcase extends advanced_testcase {
     public function test_get_config_file_contents_with_blacklisted_features_contexts() {
 
         $mockbuilder = $this->getMockBuilder('behat_config_util');
-        $mockbuilder->setMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_blacklisted_tests_for_theme',
+        $mockbuilder->onlyMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_blacklisted_tests_for_theme',
             'get_default_theme', 'get_theme_config'));
 
         $behatconfigutil = $mockbuilder->getMock();
@@ -632,7 +632,7 @@ class tool_behat_manager_util_testcase extends advanced_testcase {
     public function test_core_features_to_include_in_specified_theme() {
 
         $mockbuilder = $this->getMockBuilder('behat_config_util');
-        $mockbuilder->setMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
+        $mockbuilder->onlyMethods(array('get_theme_test_directory', 'get_list_of_themes', 'get_default_theme', 'get_theme_config'));
 
         $behatconfigutil = $mockbuilder->getMock();
 

admin/tool/behat/version.php

@@ -24,6 +24,6 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$plugin->version   = 2020110900;   // The current plugin version (Date: YYYYMMDDXX)
-$plugin->requires  = 2020110300;   // Requires this Moodle version
+$plugin->version   = 2021051700;   // The current plugin version (Date: YYYYMMDDXX).
+$plugin->requires  = 2021051100;   // Requires this Moodle version.
 $plugin->component = 'tool_behat'; // Full name of the plugin (used for diagnostics)

admin/tool/brickfield/LICENSE_QUAIL.txt

@@ -0,0 +1,219 @@
+PLEASE NOTE:
+
+There are included libraries in the directory quail/common/services which might have different (but compatible) licenses than the one covered in this file. Current licenses include:
+    *The current BSD:
+        *services/readability/php-text-statistics
+    *The MIT License:
+        *common/css.php The function parseSelector is from the PHPQuery project:
+            *http://code.google.com/p/phpquery
+
+GNU GENERAL PUBLIC LICENSE
+
+Version 3, 29 June 2007
+
+Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+Preamble
+
+The GNU General Public License is a free, copyleft license for software and other kinds of works.
+
+The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.
+
+To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.
+
+For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.
+
+Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.
+
+Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.
+
+The precise terms and conditions for copying, distribution and modification follow.
+TERMS AND CONDITIONS
+0. Definitions.
+
+ÒThis LicenseÓ refers to version 3 of the GNU General Public License.
+
+ÒCopyrightÓ also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.
+
+ÒThe ProgramÓ refers to any copyrightable work licensed under this License. Each licensee is addressed as ÒyouÓ. ÒLicenseesÓ and ÒrecipientsÓ may be individuals or organizations.
+
+To ÒmodifyÓ a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a Òmodified versionÓ of the earlier work or a work Òbased onÓ the earlier work.
+
+A Òcovered workÓ means either the unmodified Program or a work based on the Program.
+
+To ÒpropagateÓ a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.
+
+To ÒconveyÓ a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.
+
+An interactive user interface displays ÒAppropriate Legal NoticesÓ to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.
+1. Source Code.
+
+The Òsource codeÓ for a work means the preferred form of the work for making modifications to it. ÒObject codeÓ means any non-source form of a work.
+
+A ÒStandard InterfaceÓ means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.
+
+The ÒSystem LibrariesÓ of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A ÒMajor ComponentÓ, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.
+
+The ÒCorresponding SourceÓ for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same work.
+2. Basic Permissions.
+
+All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
+3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.
+
+When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.
+4. Conveying Verbatim Copies.
+
+You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.
+5. Conveying Modified Source Versions.
+
+You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:
+
+    * a) The work must carry prominent notices stating that you modified it, and giving a relevant date.
+    * b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to Òkeep intact all noticesÓ.
+    * c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.
+    * d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.
+
+A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an ÒaggregateÓ if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.
+6. Conveying Non-Source Forms.
+
+You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:
+
+    * a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.
+    * b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.
+    * c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.
+    * d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.
+    * e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.
+
+A ÒUser ProductÓ is either (1) a Òconsumer productÓ, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, Ònormally usedÓ refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.
+
+ÒInstallation InformationÓ for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).
+
+The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.
+
+Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.
+7. Additional Terms.
+
+ÒAdditional permissionsÓ are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:
+
+    * a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or
+    * b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or
+    * c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or
+    * d) Limiting the use for publicity purposes of names of licensors or authors of the material; or
+    * e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or
+    * f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.
+
+All other non-permissive additional terms are considered Òfurther restrictionsÓ within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.
+8. Termination.
+
+You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).
+
+However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.
+
+Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.
+9. Acceptance Not Required for Having Copies.
+
+You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.
+10. Automatic Licensing of Downstream Recipients.
+
+Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.
+
+An Òentity transactionÓ is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.
+11. Patents.
+
+A ÒcontributorÓ is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's Òcontributor versionÓ.
+
+A contributor's Òessential patent claimsÓ are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, ÒcontrolÓ includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.
+
+In the following three paragraphs, a Òpatent licenseÓ is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To ÒgrantÓ such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. ÒKnowingly relyingÓ means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.
+
+A patent license is ÒdiscriminatoryÓ if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.
+12. No Surrender of Others' Freedom.
+
+If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.
+13. Use with the GNU Affero General Public License.
+
+Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.
+14. Revised Versions of this License.
+
+The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License Òor any later versionÓ applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.
+
+Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.
+15. Disclaimer of Warranty.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM ÒAS ISÓ WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+16. Limitation of Liability.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+17. Interpretation of Sections 15 and 16.
+
+If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
+
+END OF TERMS AND CONDITIONS FOR QUAIL LIBRARY
+
+
+THE FOLLOWING LICENSE COVERS PORTIONS OF THE FILE LOCATED AT common/css.php, NAMELY THE FUNCTION parseSelector:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

admin/tool/brickfield/README.md

@@ -0,0 +1,23 @@
+# Brickfield accessibility tool plugin #
+
+Copyright (C) 2021 [Brickfield Education Labs](https://www.brickfield.ie/)
+
+The Accessibility admin tool plugin provides a simple means of checking content for any accessibility issues.
+
+Created by an enthusiastic team from Brickfield Education Labs, including:
+* Karen Holland
+* Gavin Henrick
+* Mike Churchward
+* Renée Mackey
+* Laia Joana Canet
+* Jay Churchward
+* Paul Ffrench
+* Holly Lynn
+* Michael Pound
+* Max Larkin
+
+with a little help from our friends.
+
+Portions of the htmlchecker files were derived from the ["Quail PHP Accessibility Library"](https://code.google.com/archive/p/quail-lib/).
+The Quail library (Copyright (C) 2009 Kevin Miller) is licensed under [GNU GPL v3](http://www.gnu.org/licenses/gpl.html).
+See the LICENSE_QUAIL.txt file in this directory for original Quail license information.

admin/tool/brickfield/classes/accessibility.php

@@ -0,0 +1,576 @@
+<?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 context_system;
+use moodle_exception;
+use moodle_url;
+use stdClass;
+use tool_brickfield\local\tool\filter;
+
+/**
+ * Provides the Brickfield Accessibility toolkit 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 accessibility {
+
+    /** @var string The component sub path */
+    private static $pluginpath = 'tool/brickfield';
+
+    /** @var string Supported format of topics */
+    const TOOL_BRICKFIELD_FORMAT_TOPIC = 'topics';
+
+    /** @var string Supported format of weeks */
+    const TOOL_BRICKFIELD_FORMAT_WEEKLY = 'weeks';
+
+    /**
+     * Return the state of the site enable condition.
+     * @return bool
+     */
+    public static function is_accessibility_enabled(): bool {
+        global $CFG;
+
+        if (isset($CFG->enableaccessibilitytools)) {
+            return $CFG->enableaccessibilitytools;
+        }
+
+        // Enabled by default.
+        return true;
+    }
+
+    /**
+     * Throw an error if the toolkit is not enabled.
+     * @return bool
+     * @throws moodle_exception
+     */
+    public static function require_accessibility_enabled(): bool {
+        if (!static::is_accessibility_enabled()) {
+            throw new moodle_exception('accessibilitydisabled', manager::PLUGINNAME);
+        }
+        return true;
+    }
+
+    /**
+     * Get a URL for a page within the plugin.
+     *
+     * This takes into account the value of the admin config value.
+     *
+     * @param   string $url The URL within the plugin
+     * @return  moodle_url
+     */
+    public static function get_plugin_url(string $url = ''): moodle_url {
+        $url = ($url == '') ? 'index.php' : $url;
+        $pluginpath = self::$pluginpath;
+        return new moodle_url("/admin/{$pluginpath}/{$url}");
+    }
+
+    /**
+     * Get a file path for a file within the plugin.
+     *
+     * This takes into account the value of the admin config value.
+     *
+     * @param   string $path The path within the plugin
+     * @return  string
+     */
+    public static function get_file_path(string $path): string {
+        global $CFG;
+
+        return implode(DIRECTORY_SEPARATOR, [$CFG->dirroot, $CFG->admin, self::$pluginpath, $path, ]);
+    }
+
+    /**
+     * Get the canonicalised name of a capability.
+     *
+     * @param   string $capability
+     * @return  string
+     */
+    public static function get_capability_name(string $capability): string {
+        return self::$pluginpath . ':' . $capability;
+    }
+
+    /**
+     * Get the relevant title.
+     * @param filter $filter
+     * @param int $countdata
+     * @return string
+     * @throws \coding_exception
+     * @throws \dml_exception
+     * @throws \moodle_exception
+     */
+    public static function get_title(filter $filter, int $countdata): string {
+        global $DB;
+
+        $tmp = new \stdClass();
+        $tmp->count = $countdata;
+        $langstr = 'title' . $filter->tab . 'partial';
+
+        if ($filter->courseid != 0) {
+            $thiscourse = get_fast_modinfo($filter->courseid)->get_course();
+            $tmp->name = $thiscourse->fullname;
+        } else {
+            $langstr = 'title' . $filter->tab . 'all';
+        }
+        return get_string($langstr, manager::PLUGINNAME, $tmp);
+    }
+
+    /**
+     * Function to be run periodically according to the scheduled task.
+     * Return true if a process was completed. False if no process executed.
+     * Finds all unprocessed courses for bulk batch processing and completes them.
+     * @param int $batch
+     * @return bool
+     * @throws \ReflectionException
+     * @throws \coding_exception
+     * @throws \ddl_exception
+     * @throws \ddl_table_missing_exception
+     * @throws \dml_exception
+     */
+    public static function bulk_process_courses_cron(int $batch = 0): bool {
+        global $PAGE;
+
+        // Run a registration check.
+        if (!(new registration())->validate()) {
+            return false;
+        }
+
+        if (analysis::is_enabled()) {
+            $PAGE->set_context(context_system::instance());
+            mtrace("Starting cron for bulk_process_courses");
+            // Do regular processing. True if full deployment type isn't selected as well.
+            static::bulk_processing($batch);
+            mtrace("Ending cron for bulk_process_courses");
+            return true;
+        } else {
+            mtrace('Content analysis is currently disabled in settings.');
+            return false;
+        }
+    }
+
+    /**
+     * Bulk processing.
+     * @param int $batch
+     * @return bool
+     */
+    protected static function bulk_processing(int $batch = 0): bool {
+        manager::check_course_updates();
+        mtrace("check_course_updates completed at " . time());
+        $recordsprocessed = manager::check_scheduled_areas($batch);
+        mtrace("check_scheduled_areas completed at " . time());
+        manager::check_scheduled_deletions();
+        mtrace("check_scheduled_deletions completed at " . time());
+        manager::delete_historical_data();
+        mtrace("delete_historical_data completed at " . time());
+        return $recordsprocessed;
+    }
+
+    /**
+     * Function to be run periodically according to the scheduled task.
+     * Finds all unprocessed courses for cache processing and completes them.
+     */
+    public static function bulk_process_caches_cron() {
+        global $DB;
+
+        // Run a registration check.
+        if (!(new registration())->validate()) {
+            return;
+        }
+
+        if (analysis::is_enabled()) {
+            mtrace("Starting cron for bulk_process_caches");
+            // Monitor ongoing caching requests.
+            $fields = 'DISTINCT courseid';
+            $reruns = $DB->get_records(manager::DB_PROCESS, ['item' => 'cache'], '', $fields);
+            foreach ($reruns as $rerun) {
+                mtrace("Running rerun caching for Courseid " . $rerun->courseid);
+                manager::store_result_summary($rerun->courseid);
+                mtrace("rerun cache completed at " . time());
+                $DB->delete_records(manager::DB_PROCESS, ['courseid' => $rerun->courseid, 'item' => 'cache']);
+            }
+            mtrace("Ending cron for bulk_process_caches at " . time());
+        } else {
+            mtrace('Content analysis is currently disabled in settings.');
+        }
+    }
+
+    /**
+     * This function runs the checks on the html item
+     *
+     * @param string $html The html string to be analysed; might be NULL.
+     * @param int $contentid The content area ID
+     * @param int $processingtime
+     * @param int $resultstime
+     */
+    public static function run_check(string $html, int $contentid, int &$processingtime, int &$resultstime) {
+        global $DB;
+
+        // Change the limit if 10,000 is not appropriate.
+        $bulkrecordlimit = manager::BULKRECORDLIMIT;
+        $bulkrecordcount = 0;
+
+        $checkids = static::checkids();
+        $checknameids = array_flip($checkids);
+
+        $testname = 'brickfield';
+
+        $stime = time();
+
+        // Swapping in new library.
+        $htmlchecker = new local\htmlchecker\brickfield_accessibility($html, $testname, 'string');
+        $htmlchecker->run_check();
+        $tests = $htmlchecker->guideline->get_tests();
+        $report = $htmlchecker->get_report();
+        $processingtime += (time() - $stime);
+
+        $records = [];
+        foreach ($tests as $test) {
+            $records[$test]['count'] = 0;
+            $records[$test]['errors'] = [];
+        }
+
+        foreach ($report['report'] as $a) {
+            if (!isset($a['type'])) {
+                continue;
+            }
+            $type = $a['type'];
+            $records[$type]['errors'][] = $a;
+            if (!isset($records[$type]['count'])) {
+                $records[$type]['count'] = 0;
+            }
+            $records[$type]['count']++;
+        }
+
+        $stime = time();
+        $returnchecks = [];
+        $errors = [];
+
+        // Build up records for inserting.
+        foreach ($records as $key => $rec) {
+            $recordres = new stdClass();
+            // Handling if checkid is unknown.
+            $checkid = (isset($checknameids[$key])) ? $checknameids[$key] : 0;
+            $recordres->contentid = $contentid;
+            $recordres->checkid = $checkid;
+            $recordres->errorcount = $rec['count'];
+
+            // Build error inserts if needed.
+            if ($rec['count'] > 0) {
+                foreach ($rec['errors'] as $tmp) {
+                    $error = new stdClass();
+                    $error->resultid = 0;
+                    $error->linenumber = $tmp['lineNo'];
+                    $error->htmlcode = $tmp['html'];
+                    $error->errordescription = $tmp['title'];
+                    // Add contentid and checkid so that we can query for the results record id later.
+                    $error->contentid = $contentid;
+                    $error->checkid = $checkid;
+                    $errors[] = $error;
+                }
+            }
+            $returnchecks[] = $recordres;
+            $bulkrecordcount++;
+
+            // If we've hit the bulk limit, write the results records and reset.
+            if ($bulkrecordcount > $bulkrecordlimit) {
+                $DB->insert_records(manager::DB_RESULTS, $returnchecks);
+                $bulkrecordcount = 0;
+                $returnchecks = [];
+                // Get the results id value for each error record and write the errors.
+                foreach ($errors as $key2 => $error) {
+                    $errors[$key2]->resultid = $DB->get_field(manager::DB_RESULTS, 'id',
+                        ['contentid' => $error->contentid, 'checkid' => $error->checkid]);
+                    unset($errors[$key2]->contentid);
+                    unset($errors[$key2]->checkid);
+                }
+                $DB->insert_records(manager::DB_ERRORS, $errors);
+                $errors = [];
+            }
+        }
+
+        // Write any leftover records.
+        if ($bulkrecordcount > 0) {
+            $DB->insert_records(manager::DB_RESULTS, $returnchecks);
+            // Get the results id value for each error record and write the errors.
+            foreach ($errors as $key => $error) {
+                $errors[$key]->resultid = $DB->get_field(manager::DB_RESULTS, 'id',
+                    ['contentid' => $error->contentid, 'checkid' => $error->checkid]);
+                unset($errors[$key]->contentid);
+                unset($errors[$key]->checkid);
+            }
+            $DB->insert_records(manager::DB_ERRORS, $errors);
+        }
+
+        $resultstime += (time() - $stime);
+    }
+
+    /**
+     * This function runs one specified check on the html item
+     *
+     * @param string $html The html string to be analysed; might be NULL.
+     * @param int $contentid The content area ID
+     * @param int $errid The error ID
+     * @param string $check The check name to run
+     * @param int $processingtime
+     * @param int $resultstime
+     * @throws \coding_exception
+     * @throws \dml_exception
+     */
+    public static function run_one_check(
+        string $html = null,
+        int $contentid,
+        int $errid,
+        string $check,
+        int &$processingtime,
+        int &$resultstime
+    ) {
+        global $DB;
+
+        $stime = time();
+
+        $checkdata = $DB->get_record(manager::DB_CHECKS, ['shortname' => $check], 'id,shortname,severity');
+
+        $testname = 'brickfield';
+
+        // Swapping in new library.
+        $htmlchecker = new local\htmlchecker\brickfield_accessibility($html, $testname, 'string');
+        $htmlchecker->run_check();
+        $report = $htmlchecker->get_test($check);
+        $processingtime += (time() - $stime);
+
+        $record = [];
+        $record['count'] = 0;
+        $record['errors'] = [];
+
+        foreach ($report as $a) {
+            $a->html = $a->get_html();
+            $record['errors'][] = $a;
+            $record['count']++;
+        }
+
+        // Build up record for inserting.
+        $recordres = new stdClass();
+        // Handling if checkid is unknown.
+        $checkid = (isset($checkdata->id)) ? $checkdata->id : 0;
+        $recordres->contentid = $contentid;
+        $recordres->checkid = $checkid;
+        $recordres->errorcount = $record['count'];
+        if ($exists = $DB->get_record(manager::DB_RESULTS, ['contentid' => $contentid, 'checkid' => $checkid])) {
+            $resultid = $exists->id;
+            $DB->set_field(manager::DB_RESULTS, 'errorcount', $record['count'], ['id' => $resultid]);
+            // Remove old error records for specific resultid, if existing.
+            $DB->delete_records(manager::DB_ERRORS, ['id' => $errid]);
+        } else {
+            $resultid = $DB->insert_record(manager::DB_RESULTS, $recordres);
+        }
+        $errors = [];
+
+        // Build error inserts if needed.
+        if ($record['count'] > 0) {
+            // Reporting all found errors for this check, so need to ignore existing other error records.
+            foreach ($record['errors'] as $tmp) {
+                // Confirm if error is reported separately.
+                if ($DB->record_exists_select(manager::DB_ERRORS,
+                    'resultid = ? AND ' . $DB->sql_compare_text('htmlcode', 255) . ' = ' . $DB->sql_compare_text('?', 255),
+                    [$resultid, html_entity_decode($tmp->html)])) {
+                    continue;
+                }
+                $error = new stdClass();
+                $error->resultid = $resultid;
+                $error->linenumber = $tmp->line;
+                $error->htmlcode = html_entity_decode($tmp->html);
+                $errors[] = $error;
+            }
+
+            $DB->insert_records(manager::DB_ERRORS, $errors);
+        }
+
+        $resultstime += (time() - $stime);
+    }
+
+    /**
+     * Returns all of the id's and shortnames of all of the checks.
+     * @param int $status
+     * @return array
+     * @throws \dml_exception
+     */
+    public static function checkids(int $status = 1): array {
+        global $DB;
+
+        $checks = $DB->get_records_menu(manager::DB_CHECKS, ['status' => $status], 'id ASC', 'id,shortname');
+        return $checks;
+    }
+
+    /**
+     * Returns an array of translations from htmlchecker of all of the checks, and their descriptions.
+     * @return array
+     * @throws \dml_exception
+     */
+    public static function get_translations(): array {
+        global $DB;
+
+        $htmlchecker = new local\htmlchecker\brickfield_accessibility('test', 'brickfield', 'string');
+        $htmlchecker->run_check();
+        ksort($htmlchecker->guideline->translations);
+
+        // Need to limit to active checks.
+        $activechecks = $DB->get_fieldset_select(manager::DB_CHECKS, 'shortname', 'status = :status', ['status' => 1]);
+
+        $translations = [];
+        foreach ($htmlchecker->guideline->translations as $key => $trans) {
+            if (in_array($key, $activechecks)) {
+                $translations[$key] = $trans;
+            }
+        }
+
+        return $translations;
+    }
+
+    /**
+     * Returns an array of all of the course id's for a given category.
+     * @param int $categoryid
+     * @return array|null
+     * @throws \dml_exception
+     */
+    public static function get_category_courseids(int $categoryid): ?array {
+        global $DB;
+
+        if (!$DB->record_exists('course_categories', ['id' => $categoryid])) {
+            return null;
+        }
+
+        $sql = "SELECT {course}.id
+              FROM {course}, {course_categories}
+             WHERE {course}.category = {course_categories}.id
+               AND (
+                " . $DB->sql_like('path', ':categoryid1') . "
+             OR " . $DB->sql_like('path', ':categoryid2') . "
+        )";
+        $params = ['categoryid1' => "%/$categoryid/%", 'categoryid2' => "%/$categoryid"];
+        $courseids = $DB->get_fieldset_sql($sql, $params);
+
+        return $courseids;
+    }
+
+    /**
+     * Get summary data for this site.
+     * @param int $id
+     * @return \stdClass
+     * @throws \dml_exception
+     */
+    public static function get_summary_data(int $id): \stdClass {
+        global $CFG, $DB;
+
+        $components = $DB->get_records(manager::DB_AREAS);
+
+        $summarydata = new \stdClass();
+        $summarydata->siteurl = (substr($CFG->wwwroot, -1) !== '/') ? $CFG->wwwroot . '/' : $CFG->wwwroot;
+        $summarydata->moodlerelease = (preg_match('/^(\d+\.\d.*?)[. ]/', $CFG->release, $matches)) ? $matches[1] : $CFG->release;
+        $summarydata->numcourses = $DB->count_records('course') - 1;
+        $summarydata->numusers = $DB->count_records('user', array('deleted' => 0));
+        $summarydata->numfiles = $DB->count_records('files');
+        $summarydata->numfactivities = $DB->count_records('course_modules');
+        $summarydata->mobileservice = (int)$CFG->enablemobilewebservice === 1 ? true : false;
+        $summarydata->usersmobileregistered = $DB->count_records('user_devices');
+        $summarydata->contenttyperesults = static::get_contenttyperesults($id, $components);
+        $summarydata->contenttypeerrors = static::get_contenttypeerrors();
+        $summarydata->percheckerrors = static::get_percheckerrors();
+        return $summarydata;
+    }
+
+    /**
+     * Get content type results.
+     * @param int $id
+     * @param array $components
+     * @return \stdClass
+     */
+    private static function get_contenttyperesults(int $id, array $components): \stdClass {
+        $contenttyperesults = new \stdClass();
+        $contenttyperesults->id = $id;
+        $datacomponents = array();
+        foreach ($components as $component) {
+            $datacomponents[$component->component][] = $component;
+        }
+        $contenttyperesults->contenttype = new \stdClass();
+        foreach ($datacomponents as $key => $component) {
+            $contenttyperesults->contenttype->$key = count($component);
+        }
+        $contenttyperesults->summarydatastorage = static::get_summary_data_storage();
+        $contenttyperesults->datachecked = time(); // Correct??
+        return $contenttyperesults;
+    }
+
+
+    /**
+     * Get per check errors.
+     * @return stdClass
+     * @throws dml_exception
+     */
+    private static function get_percheckerrors(): stdClass {
+        global $DB;
+
+        $sql = 'SELECT ' . $DB->sql_concat_join("'_'", ['courseid', 'checkid']) . ' as tmpid,
+                       ca.courseid, ca.status, ca.checkid, ch.shortname, ca.checkcount, ca.errorcount
+                  FROM {' . manager::DB_CACHECHECK . '} ca
+            INNER JOIN {' . manager::DB_CHECKS . '} ch on ch.id = ca.checkid
+              ORDER BY courseid, checkid ASC';
+
+        $combo = $DB->get_records_sql($sql);
+
+        return (object) [
+            'percheckerrors' => $combo,
+        ];
+    }
+
+    /**
+     * Get content type errors.
+     * @return stdClass
+     * @throws dml_exception
+     */
+    private static function get_contenttypeerrors(): stdClass {
+        global $DB;
+
+        $fields = 'courseid, status, activities, activitiespassed, activitiesfailed,
+                    errorschecktype1, errorschecktype2, errorschecktype3, errorschecktype4,
+                    errorschecktype5, errorschecktype6, errorschecktype7,
+                    failedchecktype1, failedchecktype2, failedchecktype3, failedchecktype4,
+                    failedchecktype5, failedchecktype6, failedchecktype7,
+                    percentchecktype1, percentchecktype2, percentchecktype3, percentchecktype4,
+                    percentchecktype5, percentchecktype6, percentchecktype7';
+        $combo = $DB->get_records(manager::DB_SUMMARY, null, 'courseid ASC', $fields);
+
+        return (object) [
+            'typeerrors' => $combo,
+        ];
+    }
+
+    /**
+     * Get summary data storage.
+     * @return array
+     * @throws dml_exception
+     */
+    private static function get_summary_data_storage(): array {
+        global $DB;
+
+        $fields = $DB->sql_concat_join("''", ['component', 'courseid']) . ' as tmpid,
+                 courseid, component, errorcount, totalactivities, failedactivities, passedactivities';
+        $combo = $DB->get_records(manager::DB_CACHEACTS, null, 'courseid, component ASC', $fields);
+        return $combo;
+    }
+}

admin/tool/brickfield/classes/analysis.php

@@ -0,0 +1,95 @@
+<?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\task\process_analysis_requests;
+
+/**
+ * Analysis and deployment class.
+ *
+ * @package tool_brickfield
+ * @copyright  2020 Brickfield Education Labs https://www.brickfield.ie
+ * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class analysis {
+
+    /**
+     * Indicates that analysis of content has been enabled.
+     */
+    const ANALYSISDISABLED = '0';
+
+    /**
+     * Indicates that analysis is enabled and using request method.
+     */
+    const ANALYSISBYREQUEST = '1';
+
+    /**
+     * Return the type of analysis being used (currently only request).
+     *
+     * @return false|mixed|object|string|null
+     * @throws \dml_exception
+     */
+    public static function get_type() {
+        // Moodle caches these calls, so it's not expensive.
+        return get_config(manager::PLUGINNAME, 'analysistype');
+    }
+
+    /**
+     * Return true is analysis has been enabled.
+     *
+     * @return bool
+     * @throws \dml_exception
+     */
+    public static function is_enabled(): bool {
+        $analysistype = static::get_type();
+        return ($analysistype !== false) && ($analysistype !== self::ANALYSISDISABLED);
+    }
+
+    /**
+     * Return true if analysis is by request method.
+     *
+     * @return bool
+     * @throws \dml_exception
+     */
+    public static function type_is_byrequest(): bool {
+        return static::get_type() === self::ANALYSISBYREQUEST;
+    }
+
+    /**
+     * Return true if the course has been analyzed.
+     *
+     * @param int $courseid
+     * @return bool
+     * @throws \dml_exception
+     */
+    public static function is_course_analyzed(int $courseid): bool {
+        return scheduler::is_course_analyzed($courseid);
+    }
+
+    /**
+     * Return a redirect message with the earliest time expected for analysis to complete.
+     * @return \lang_string|string
+     * @throws \coding_exception
+     */
+    public static function redirect_message() {
+        $epoch = new process_analysis_requests;
+        $time = userdate($epoch->get_next_scheduled_time(), get_string('strftimetime', 'core_langconfig'));
+        $message = get_string('confirmationmessage', manager::PLUGINNAME, $time);
+
+        return $message;
+    }
+}

admin/tool/brickfield/classes/area_base.php

@@ -0,0 +1,219 @@
+<?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;
+
+/**
+ * Area base class.
+ *
+ * @package    tool_brickfield
+ * @copyright  2020 Brickfield Education Labs https://www.brickfield.ie
+ */
+abstract class area_base {
+
+    /**
+     * Defines the unknown for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_UNKNOWN = 0;
+
+    /**
+     * Defines the form for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_FORM = 1;
+
+    /**
+     * Defines the image for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_IMAGE = 2;
+
+    /**
+     * Defines the layout for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_LAYOUT = 3;
+
+    /**
+     * Defines the link for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_LINK = 4;
+
+    /**
+     * Defines the media for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_MEDIA = 5;
+
+    /**
+     * Defines the table for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_TABLE = 6;
+
+    /**
+     * Defines the text for the 'checkgroup' field in the tool_brickfield_checks table.
+     */
+    const CHECKGROUP_TEXT = 7;
+
+    /** @var string[] Array for quick access of string names for 'checkgroups'. */
+    const CHECKGROUP_NAMES = [
+        self::CHECKGROUP_UNKNOWN => 'unknown',
+        self::CHECKGROUP_FORM => 'form',
+        self::CHECKGROUP_IMAGE => 'image',
+        self::CHECKGROUP_LAYOUT => 'layout',
+        self::CHECKGROUP_LINK => 'link',
+        self::CHECKGROUP_MEDIA => 'media',
+        self::CHECKGROUP_TABLE => 'table',
+        self::CHECKGROUP_TEXT => 'text'
+    ];
+
+    /**
+     * Defines field value.
+     */
+    const TYPE_FIELD = 0;
+
+    /**
+     * Defines file value.
+     */
+    const TYPE_FILE = 1;
+
+    /**
+     * Return the name for the specified checkgroup value, or 'unknown' if no valid name for the value. Preferably, use this rather
+     * than direct access to CHECKGROUP_NAMES, since it checks value boundaries.
+     * @param int $checkgroupvalue
+     * @return string
+     */
+    final public static function checkgroup_name(int $checkgroupvalue): string {
+        if (($checkgroupvalue < 0) || ($checkgroupvalue >= count(self::CHECKGROUP_NAMES))) {
+            return self::CHECKGROUP_NAMES[self::CHECKGROUP_UNKNOWN];
+        } else {
+            return self::CHECKGROUP_NAMES[$checkgroupvalue];
+        }
+    }
+
+    /**
+     * Return the value for the specified checkgroup name, or the unknown value if no valid value for the name.
+     * @param string $checkgroupname
+     * @return int
+     */
+    final public static function checkgroup_value(string $checkgroupname): int {
+        $value = array_search($checkgroupname, self::CHECKGROUP_NAMES);
+        return ($value !== false) ? $value : self::CHECKGROUP_UNKNOWN;
+    }
+
+    /**
+     * Return the defined content type.
+     * @return int
+     */
+    protected function get_type(): int {
+        return self::TYPE_FIELD;
+    }
+
+    /**
+     * Return the component from the full class name.
+     * @return mixed|string
+     */
+    public function get_component(): string {
+        $parts = preg_split('|\\\\|', get_class($this));
+        return $parts[3];
+    }
+
+    /**
+     * Check if the system plugin is avaliable.
+     * @return bool
+     */
+    public function is_available(): bool {
+        list($type, $plugin) = \core_component::normalize_component($this->get_component());
+        if ($type === 'core') {
+            // We assume that all core components are defined corretly.
+            return true;
+        }
+        // Some contrib plugins may not be installed.
+        return ($dir = \core_component::get_component_directory($this->get_component()))
+            && file_exists($dir . '/version.php');
+    }
+
+    /**
+     * Return the name of the database table where information is stored
+     * @return string
+     */
+    abstract public function get_tablename(): string;
+
+    /**
+     * Return the name of the reference data table name.
+     * @return string
+     */
+    public function get_ref_tablename(): string {
+        return '';
+    }
+
+    /**
+     * Return the name of the field in the table that has the content
+     * @return string
+     */
+    abstract public function get_fieldname(): string;
+
+    /**
+     * Return a recordset of the relevant areas for the component/module.
+     * @param \core\event\base $event
+     * @return \moodle_recordset|null
+     */
+    abstract public function find_relevant_areas(\core\event\base $event): ?\moodle_recordset;
+
+    /**
+     * Return a recordset of the course areas for the course id.
+     * @param int $courseid
+     * @return \moodle_recordset|null
+     */
+    abstract public function find_course_areas(int $courseid): ?\moodle_recordset;
+
+    /**
+     * Return an array of area objects that contain content at the site and system levels only. Override this where necessary.
+     * @return \moodle_recordset|null
+     */
+    public function find_system_areas(): ?\moodle_recordset {
+        return null;
+    }
+
+    /**
+     * The standard Moodle parameter DML parameter substitution doesn't work on all versions of MySQL or Postgres, so we need to use
+     * inline function substitution to ensure that the left side is a string.
+     * @return string
+     */
+    public function get_standard_area_fields_sql(): string {
+        return '\'' . $this->get_component() . '\' AS component,
+            \'' . $this->get_tablename() . '\' AS tablename,
+            \'' . $this->get_fieldname() . '\' AS fieldorarea, ';
+    }
+
+    /**
+     * The standard Moodle parameter DML parameter substitution doesn't work on all versions of MySQL or Postgres, so we need to use
+     * inline function substitution to ensure that the left side is a string.
+     * @return string
+     */
+    public function get_reftable_field_sql(): string {
+        return '\'' . $this->get_ref_tablename() . '\' AS reftable, ';
+    }
+
+    /**
+     * Processes any sql filtering data. Implement in extensions.
+     *
+     * @return null
+     * @throws \coding_exception
+     * @throws \dml_exception
+     */
+    public function get_courseid_filtering() {
+        $this->filter = '';
+        $this->filterparams = [];
+        return null;
+    }
+}

admin/tool/brickfield/classes/brickfieldconnect.php

@@ -0,0 +1,258 @@
+<?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;
+
+defined('MOODLE_INTERNAL') || die;
+
+// The curl class is in filelib.
+global $CFG;
+require_once("{$CFG->libdir}/filelib.php");
+
+use curl;
+use moodle_url;
+
+/**
+ * Class brickfieldconnect. Contains all function to connect to Brickfield external services.
+ *
+ * @package     tool_brickfield
+ * @author      2020 Onwards Mike Churchward <mike@brickfieldlabs.ie>
+ * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL
+ */
+class brickfieldconnect extends curl {
+
+    /** @var string The base api uri. */
+    private static $baseapiuri = 'https://api.mybrickfield.ie/moodle/';
+
+    /** @var array Endpoint details for setting and checking a site registration */
+    const ACTION_CHECK_REGISTRATION = [
+        'endpoint' => 'checkRegister',
+        'method' => 'get',
+    ];
+
+    /** @var array Endpoint details for sending site summary data */
+    const ACTION_SEND_SUMMARY = [
+        'endpoint' => 'summary',
+        'method' => 'post',
+    ];
+
+    /**
+     * Object method to test whether site is already registered.
+     * @return bool
+     */
+    public function is_registered(): bool {
+        return !empty($this->get_registration_id_for_credentials());
+    }
+
+    /**
+     * Update registration of this site.
+     * @param   string $apikey The API key to use for the registration attempt
+     * @param   string $secretkey The secret key to use
+     * @return  bool
+     */
+    public function update_registration(string $apikey, string $secretkey): bool {
+        $registrationid = $this->get_registration_id_for_credentials($apikey, $secretkey);
+        if (empty($registrationid)) {
+            return false;
+        }
+
+        (new registration())->set_siteid($registrationid);
+        return true;
+    }
+
+    /**
+     * Send the summary data to Brickfield.
+     * @return bool
+     * @throws \dml_exception
+     */
+    public function send_summary(): bool {
+        // Run a registration check.
+        if (!(new registration())->validate()) {
+            return false;
+        }
+
+        $headers = $this->get_common_headers();
+
+        // Sanity-check $headers 'id' value.
+        if (!isset($headers['id'])) {
+            return false;
+        }
+
+        $this->set_headers($headers);
+        $summary = accessibility::get_summary_data($headers['id']);
+        $body = json_encode($summary, JSON_UNESCAPED_SLASHES);
+        $result = json_decode($this->call(self::ACTION_SEND_SUMMARY, $body));
+        if (is_object($result) && ((int)$result->statusCode === 200)) {
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    /**
+     * Get the URL required for the command.
+     *
+     * @param   array $command The command to call, for example see self::ACTION_REGISTER
+     * @return  string The complete URL
+     */
+    protected function get_url_for_command(array $command): string {
+        return $this->get_baseapiuri() . $command['endpoint'];
+    }
+
+    /**
+     * Call the specified command.
+     *
+     * @param array $command The command to call, for example see self::ACTION_REGISTER
+     * @param array|string $params The params provided to the call
+     * @return  string The response body
+     */
+    protected function call(array $command, $params = ''): string {
+        $url = $this->get_url_for_command($command);
+        if ($command['method'] === 'get') {
+            return $this->get($url, $params);
+        }
+
+        if ($command['method'] === 'post') {
+            return $this->post($url, $params);
+        }
+
+        return '';
+    }
+
+    /**
+     * Get the common headers used for all calls to the Brickfields endpoints.
+     *
+     * @return  array
+     */
+    protected function get_common_headers(): array {
+        $headers = [
+            'Cache-Control' => 'no-cache',
+            'Content-Type' => 'application/json',
+            'siteurl' => static::get_siteurl(),
+        ];
+
+        if (static::has_registration_key()) {
+            $registration = new registration();
+            $headers['secret'] = $registration->get_api_key();
+            $headers['userhash'] = $registration->get_secret_key();
+            $headers['id'] = $registration->get_siteid();
+        }
+
+        return $headers;
+    }
+
+    /**
+     * Set headers on the request from the specified list of headers.
+     *
+     * @param   array $headers An array of header name => value
+     */
+    protected function set_headers(array $headers) {
+        foreach ($headers as $key => $value) {
+            $this->setHeader("{$key}: {$value}");
+        }
+    }
+
+    /**
+     * Whether the site currently has a registration key stored.
+     *
+     * @return  bool
+     */
+    protected function has_registration_key(): bool {
+        $registration = new registration();
+        $localkey = $registration->get_api_key();
+        $localhash = $registration->get_secret_key();
+        $localid = $registration->get_siteid();
+
+        if (!$localhash || !$localkey || !$localid) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Get a normalised URL for the site.
+     *
+     * @return  string
+     */
+    protected function get_siteurl(): string {
+        return (new moodle_url('/'))->out(false);
+    }
+
+    /**
+     * Get the registration ID for the given set of credentials.
+     * @param   null|string $apikey The API key to use for the registration attempt
+     * @param   null|string $secretkey The secret key to use
+     * @return  null|string The registration ID if registration was successful, or null if not
+     */
+    protected function get_registration_id_for_credentials(string $apikey = null, string $secretkey = null): string {
+        $headers = $this->get_common_headers();
+        if ($apikey || $secretkey) {
+            $headers['secret'] = $apikey;
+            $headers['userhash'] = $secretkey;
+        } else if (!$this->has_registration_key()) {
+            return '';
+        }
+
+        $this->set_headers($headers);
+        $response = $this->call(self::ACTION_CHECK_REGISTRATION);
+
+        if ((int)$this->info['http_code'] !== 200) {
+            // The response was unsuccessful.
+            return '';
+        }
+
+        $result = json_decode($response);
+        if (!$result) {
+            // The response could not be decoded.
+            return '';
+        }
+
+        if ((int)$result->statusCode !== 200) {
+            // The data from the response suggests a failure.
+            return '';
+        }
+
+        // Decode the actual result.
+        $registrationdata = json_decode($result->body);
+        if (empty($registrationdata) || !is_array($registrationdata)) {
+            // Unable to decode the body of the response.
+            return '';
+        }
+
+        if (!property_exists($registrationdata[0], 'id') || !property_exists($registrationdata[0]->id, 'N')) {
+            // Unable to find a valid id in the response.
+            return '';
+        }
+
+        return $registrationdata[0]->id->N;
+    }
+
+    /**
+     * Get the check registration API URI.
+     * @return string
+     * @throws dml_exception
+     */
+    protected function get_baseapiuri(): string {
+        $baseapiuri = get_config(manager::PLUGINNAME, 'baseapiuri');
+        if (!empty($baseapiuri)) {
+            return $baseapiuri;
+        } else {
+            set_config('baseapiuri', self::$baseapiuri, manager::PLUGINNAME);
+            return self::$baseapiuri;
+        }
+    }
+}

admin/tool/brickfield/classes/event/analysis_requested.php

@@ -0,0 +1,54 @@
+<?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\event;
+
+use tool_brickfield\manager;
+
+/**
+ * Class analysis_requested
+ *
+ * @package tool_brickfield
+ * @copyright 2020 onward Brickfield Education Labs, https://www.brickfield.ie
+ * @author Mike Churchward <mike@brickfieldlabs.ie>
+ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL
+ */
+class analysis_requested extends \core\event\base {
+
+    /**
+     * Init function.
+     */
+    protected function init() {
+        $this->data['crud'] = 'c';
+        $this->data['edulevel'] = self::LEVEL_OTHER;
+    }
+
+    /**
+     * Get name.
+     * @return \lang_string|string
+     */
+    public static function get_name() {
+        return get_string('eventanalysis_requested', manager::PLUGINNAME);
+    }
+
+    /**
+     * Get description.
+     * @return \lang_string|string|null
+     */
+    public function get_description() {
+        return get_string('eventanalysis_requesteddesc', manager::PLUGINNAME, $this->other['course']);
+    }
+}

admin/tool/brickfield/classes/event/report_downloaded.php

@@ -0,0 +1,54 @@
+<?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\event;
+
+use tool_brickfield\manager;
+
+/**
+ * Class report_downloaded
+ *
+ * @package tool_brickfield
+ * @copyright 2020 onward Brickfield Education Labs, https://www.brickfield.ie
+ * @author Mike Churchward <mike@brickfieldlabs.ie>
+ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL
+ */
+class report_downloaded extends \core\event\base {
+
+    /**
+     * Init function.
+     */
+    protected function init() {
+        $this->data['crud'] = 'r';
+        $this->data['edulevel'] = self::LEVEL_OTHER;
+    }
+
+    /**
+     * Get name.
+     * @return \lang_string|string
+     */
+    public static function get_name() {
+        return get_string('eventreport_downloaded', manager::PLUGINNAME);
+    }
+
+    /**
+     * Get description.
+     * @return \lang_string|string|null
+     */
+    public function get_description() {
+        return get_string('eventreport_downloadeddesc', manager::PLUGINNAME, $this->courseid);
+    }
+}

admin/tool/brickfield/classes/event/report_viewed.php

@@ -0,0 +1,54 @@
+<?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\event;
+
+use tool_brickfield\manager;
+
+/**
+ * Class report_viewed
+ *
+ * @package tool_brickfield
+ * @copyright 2020 onward Brickfield Education Labs, https://www.brickfield.ie
+ * @author Mike Churchward <mike@brickfieldlabs.ie>
+ * @license http://www.gnu.org/copyleft/gpl.html GNU GPL
+ */
+class report_viewed extends \core\event\base {
+
+    /**
+     * Init function.
+     */
+    protected function init() {
+        $this->data['crud'] = 'r';
+        $this->data['edulevel'] = self::LEVEL_OTHER;
+    }
+
+    /**
+     * Get name.
+     * @return \lang_string|string
+     */
+    public static function get_name() {
+        return get_string('eventreport_viewed', manager::PLUGINNAME);
+    }
+
+    /**
+     * Get description.
+     * @return \lang_string|string|null
+     */
+    public function get_description() {
+        return get_string('eventreport_vieweddesc', manager::PLUGINNAME, (object)$this->other);
+    }
+}

admin/tool/brickfield/classes/eventobservers.php

@@ -0,0 +1,438 @@
+<?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 core\event\base;
+use stdClass;
+
+/**
+ * Observer class containing methods monitoring various events.
+ *
+ * @package    tool_brickfield
+ * @copyright  2020 Brickfield Education Labs https://www.brickfield.ie
+ * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ *
+ */
+class eventobservers {
+
+    /**
+     * For course events to be handled, the accessibility tool needs to be enabled, and if a courseid is specified, the course
+     * has to have been added to the scheduler.
+     * @param int $courseid
+     * @return bool
+     * @throws \dml_exception
+     */
+    private static function course_event_should_be_handled(int $courseid): bool {
+        return accessibility::is_accessibility_enabled() && analysis::is_enabled() &&
+            (empty($courseid) || (isset($courseid) && scheduler::is_course_in_schedule($courseid)));
+    }
+
+    /**
+     * Content area altered event observer.
+     * @param base $event The area altered event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    private static function area_altered(base $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            manager::find_new_or_updated_areas($event);
+        }
+    }
+
+    /**
+     * Course event observers.
+     * These observer monitors course created / restored / updated events,
+     * then its HTML content is processed with accessibility checking.
+     */
+
+    /**
+     * Course created event observer.
+     * @param \core\event\course_created $event The course created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_created(\core\event\course_created $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            // Need to trigger rerun check for automatically created forum...
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->item = 'coursererun';
+            static::observer_insert($data);
+            static::course_altered($event);
+        }
+    }
+
+    /**
+     * Course deleted event observer.
+     * @param \core\event\course_deleted $event The course deleted event.
+     * @throws \dml_exception
+     */
+    public static function course_deleted(\core\event\course_deleted $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->contextid = -1;
+            $data->item = 'core_course';
+            static::observer_insert($data);
+        }
+    }
+
+    /**
+     * Course restored event observer.
+     * @param \core\event\course_restored $event The course restored event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_restored(\core\event\course_restored $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->item = 'coursererun';
+            static::observer_insert($data);
+            static::course_altered($event);
+        }
+    }
+
+    /**
+     * Course update event observer.
+     * @param \core\event\course_updated $event The course updated event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_updated(\core\event\course_updated $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::course_altered($event);
+        }
+    }
+
+    /**
+     * Course update event observer. This is called on both course_created and course_updated, so use the base class as a type hint.
+     * @param base $event The course updated event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_altered(base $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            // Need to rerun caching of allowed courseid, from category white/blacklist.
+            $data = new stdClass();
+            $data->courseid = $data->contextid = $event->courseid;
+            $data->contextid = -1;
+            $data->item = 'category';
+            static::observer_insert($data);
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * Course section created event observer.
+     * @param \core\event\course_section_created $event The course section created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_section_created(\core\event\course_section_created $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * Course section deleted event observer.
+     * @param \core\event\course_section_deleted $event The course section deleted event.
+     * @throws \dml_exception
+     */
+    public static function course_section_deleted(\core\event\course_section_deleted $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->contextid = -1;
+            $data->innercontextid = $event->objectid;
+            $data->item = 'course_sections';
+            static::observer_insert($data);
+        }
+    }
+
+    /**
+     * Course section update event observer.
+     * @param \core\event\course_section_updated $event The course section updated event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_section_updated(\core\event\course_section_updated $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * Course module event observers.
+     * These observer monitors course module created / restored / updated events,
+     * then its HTML content is processed with accessibility checking.
+     */
+
+    /**
+     * Course module created event observer.
+     * @param \core\event\course_module_created $event The course module created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_module_created(\core\event\course_module_created $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * Course module deleted event observer.
+     * @param \core\event\course_module_deleted $event The course module deleted event.
+     * @throws \dml_exception
+     */
+    public static function course_module_deleted(\core\event\course_module_deleted $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->contextid = -1;
+            $data->innercontextid = $event->other['instanceid'];
+            $data->item = 'mod_' . $event->other['modulename'];
+            static::observer_insert($data);
+        }
+    }
+
+    /**
+     * Course module restored event observer.
+     * @param \core\event\course_module_restored $event The course module restored event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_module_restored(\core\event\course_module_restored $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * Course module updated event observer.
+     * @param \core\event\course_module_updated $event The course module updated event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_module_updated(\core\event\course_module_updated $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * course_category created event observer.
+     * @param \core\event\course_category_created $event The course_category created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_category_created(\core\event\course_category_created $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * course_category deleted event observer.
+     * @param \core\event\course_category_deleted $event The course_category deleted event.
+     * @throws \dml_exception
+     */
+    public static function course_category_deleted(\core\event\course_category_deleted $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            $data = new stdClass();
+            $data->contextid = $data->courseid = -1;
+            $data->innercontextid = $event->objectid;
+            $data->item = 'course_categories';
+            static::observer_insert($data);
+        }
+    }
+
+    /**
+     * course_category update event observer.
+     * @param \core\event\course_category_updated $event The course_category updated event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function course_category_updated(\core\event\course_category_updated $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * mod_lesson_page created event observer.
+     * @param \mod_lesson\event\page_created $event The mod_lesson page created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function mod_lesson_page_created(\mod_lesson\event\page_created $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * mod_lesson_page deleted event observer.
+     * @param \mod_lesson\event\page_deleted $event The mod_lesson page deleted event.
+     * @throws \dml_exception
+     */
+    public static function mod_lesson_page_deleted(\mod_lesson\event\page_deleted $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->contextid = -1;
+            $data->innercontextid = $event->objectid;
+            $data->item = 'lesson_pages';
+            static::observer_insert($data);
+        }
+    }
+
+    /**
+     * mod_lesson_page updated event observer.
+     * @param \mod_lesson\event\page_updated $event The mod_lesson page updated event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function mod_lesson_page_updated(\mod_lesson\event\page_updated $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * core_question created observer
+     * @param \core\event\question_created $event The core_question created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function core_question_created(\core\event\question_created $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            manager::find_new_or_updated_areas($event);
+        }
+    }
+
+    /**
+     * core_question updated observer
+     * @param \core\event\question_updated $event The core_question created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function core_question_updated(\core\event\question_updated $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            manager::find_new_or_updated_areas($event);
+        }
+    }
+
+    /**
+     * core_question deleted observer
+     * @param \core\event\question_deleted $event The core_question deleted event.
+     * @throws \dml_exception
+     */
+    public static function core_question_deleted(\core\event\question_deleted $event) {
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($event->courseid)) {
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->contextid = -1;
+            $data->innercontextid = $event->objectid;
+            $data->item = $event->objecttable;
+            static::observer_insert($data);
+        }
+    }
+
+    /**
+     * Book chapter created event observer.
+     * @param \mod_book\event\chapter_created $event The book chapter created event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function book_chapter_created(\mod_book\event\chapter_created $event) {
+        // If this feature has been disabled, do nothing.
+        if (accessibility::is_accessibility_enabled()) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * Book chapter deleted event observer.
+     * @param \mod_book\event\chapter_deleted $event The book chapter deleted event.
+     * @throws \dml_exception
+     */
+    public static function book_chapter_deleted(\mod_book\event\chapter_deleted $event) {
+        // If this feature has been disabled, do nothing.
+        if (accessibility::is_accessibility_enabled()) {
+            $data = new stdClass();
+            $data->courseid = $event->courseid;
+            $data->contextid = -1;
+            $data->innercontextid = $event->objectid;
+            $data->item = 'book_chapters';
+            static::observer_insert($data);
+        }
+    }
+
+    /**
+     * Book chapter update event observer.
+     * @param \mod_book\event\chapter_updated $event The book chapter updated event.
+     * @throws \ReflectionException
+     * @throws \dml_exception
+     */
+    public static function book_chapter_updated(\mod_book\event\chapter_updated $event) {
+        // If this feature has been disabled, do nothing.
+        if (accessibility::is_accessibility_enabled()) {
+            static::area_altered($event);
+        }
+    }
+
+    /**
+     * Add an observer record if appropriate.
+     * @param stdClass $data
+     * @throws \dml_exception
+     */
+    private static function observer_insert(stdClass $data) {
+        global $DB;
+
+        // Handle if this feature is enabled and this course is in the schedule.
+        if (static::course_event_should_be_handled($data->courseid)) {
+            $data->timecreated = time();
+            $data->timecompleted = 0;
+
+            $DB->insert_record(manager::DB_PROCESS, $data);
+        }
+    }
+}

admin/tool/brickfield/classes/form/registration_form.php

@@ -0,0 +1,149 @@
+<?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/>.
+
+/**
+ * Class registration_form
+ *
+ * @package    tool_brickfield
+ * @copyright  2021 Brickfield Education Labs https://www.brickfield.ie
+ * @author  2020 JM Tomas <jmtomas@tresipunt.com>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL
+ */
+
+namespace tool_brickfield\form;
+defined('MOODLE_INTERNAL') || die();
+
+use coding_exception;
+use dml_exception;
+use html_writer;
+use moodle_exception;
+use moodleform;
+use stdClass;
+use tool_brickfield\manager;
+use tool_brickfield\registration;
+
+global $CFG;
+require_once($CFG->libdir . '/formslib.php');
+
+/**
+ * Class registration_form
+ *
+ * @package    tool_brickfield
+ * @author  2020 JM Tomas <jmtomas@tresipunt.com>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL
+ */
+class registration_form  extends moodleform {
+
+    /**
+     * Form definition.
+     * @throws moodle_exception
+     */
+    public function definition() {
+        $mform = & $this->_form;
+        $required = get_string('required');
+        $info = $this->get_defaultinfo();
+        $registration = new registration();
+        $key = $registration->get_api_key();
+        $hash = $registration->get_secret_key();
+
+        $mform->addElement('header', 'activationheader', get_string('activationheader', manager::PLUGINNAME));
+        $mform->addElement('text', 'key', get_string('secretkey', manager::PLUGINNAME));
+        $mform->setType('key', PARAM_TEXT);
+        $mform->setDefault('key', !empty($key) ? $key : '');
+        $mform->addHelpButton('key', 'secretkey', manager::PLUGINNAME);
+
+        $mform->addElement('text', 'hash', get_string('sitehash', manager::PLUGINNAME));
+        $mform->setType('hash', PARAM_TEXT);
+        $mform->setDefault('hash', !empty($hash) ? $hash : '');
+        $mform->addHelpButton('hash', 'sitehash', manager::PLUGINNAME);
+
+        $mform->addElement('header', 'moreinfo', get_string('moreinfo', manager::PLUGINNAME));
+        $mform->addElement('static', 'siteinfosummary', '',
+            get_string('sendfollowinginfo', manager::PLUGINNAME, $info->moreinfostring));
+
+        $mform->addElement('hidden', 'lang', $info->languagecode);
+        $mform->setType('lang', PARAM_TEXT);
+        $mform->addElement('hidden', 'countrycode', $info->country);
+        $mform->setType('countrycode', PARAM_TEXT);
+        $mform->addElement('hidden', 'url', $info->url);
+        $mform->setType('url', PARAM_URL);
+
+        $this->add_action_buttons(false, get_string('activate', manager::PLUGINNAME, '#'));
+    }
+
+    /**
+     * Get default data for registration form
+     *
+     * @throws moodle_exception
+     * @return stdClass
+     */
+    protected function get_defaultinfo(): stdClass {
+        global $CFG;
+        $admin = get_admin();
+        $site = get_site();
+        $data = new stdClass();
+        $data->name = $site->fullname;
+        $data->url = $CFG->wwwroot;
+        $data->language = get_string('thislanguage', 'langconfig');
+        $data->languagecode = $admin->lang ?: $CFG->lang;
+        $data->country = $admin->country ?: $CFG->country;
+        $data->email = $admin->email;
+        $data->moreinfo = self::get_moreinfo();
+        $data->moreinfostring = self::get_moreinfostring($data->moreinfo);
+        return $data;
+    }
+
+    /**
+     * Get more information.
+     * @return array
+     * @throws dml_exception
+     */
+    private static function get_moreinfo(): array {
+        global $CFG, $DB;
+        $moreinfo = array();
+        $moodlerelease = $CFG->release;
+        if (preg_match('/^(\d+\.\d.*?)[. ]/', $moodlerelease, $matches)) {
+            $moodlerelease = $matches[1];
+        }
+        $moreinfo['release'] = $moodlerelease;
+        $moreinfo['numcourses'] = $DB->count_records('course') - 1;
+        $moreinfo['numusers'] = $DB->count_records('user', array('deleted' => 0));
+        $moreinfo['numfiles'] = $DB->count_records('files');
+        $moreinfo['numfactivities'] = $DB->count_records('course_modules');
+        $moreinfo['mobileservice'] = empty($CFG->enablemobilewebservice) ? 0 : $CFG->enablemobilewebservice;
+        $moreinfo['usersmobileregistered'] = $DB->count_records('user_devices');
+        $moreinfo['contentyperesults'] = '';
+        $moreinfo['contenttypeerrors'] = '';
+        $moreinfo['percheckerrors'] = '';
+        return $moreinfo;
+    }
+
+    /**
+     * Get HTML list for more information.
+     *
+     * @param array $moreinfo
+     * @return string
+     * @throws coding_exception
+     */
+    private static function get_moreinfostring(array $moreinfo): string {
+        $html = html_writer::start_tag('ul');
+        foreach ($moreinfo as $key => $value) {
+            $html .= html_writer::tag('li', get_string($key, manager::PLUGINNAME, $value));
+        }
+        $html .= html_writer::end_tag('ul');
+        return $html;
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/base.php

@@ -0,0 +1,118 @@
+<?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_course;
+
+use core\event\course_created;
+use core\event\course_updated;
+use core\event\course_restored;
+use tool_brickfield\area_base;
+
+/**
+ * Base class for various course-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 {
+        if ($event instanceof course_created) {
+            return $this->find_fields_in_course_table(['courseid' => $event->courseid]);
+        } else if ($event instanceof course_restored) {
+            return $this->find_fields_in_course_table(['courseid' => $event->courseid]);
+        } else if ($event instanceof course_updated) {
+            return $this->find_fields_in_course_table(['courseid' => $event->courseid]);
+        }
+        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 {
+        return $this->find_fields_in_course_table(['courseid' => $courseid]);
+    }
+
+    /**
+     * Return an array of area objects that contain content at the site and system levels only.
+     * @return mixed
+     */
+    public function find_system_areas(): ?\moodle_recordset {
+        return null;
+    }
+
+    /**
+     * Helper method that can be used by the classes that define a field in the 'course' table
+     *
+     * @param array $params
+     * @return \moodle_recordset
+     * @throws \coding_exception
+     * @throws \dml_exception
+     */
+    protected function find_fields_in_course_table(array $params = []): \moodle_recordset {
+        global $DB;
+        $where = [];
+
+        if (!empty($params['courseid'])) {
+            $where[] = 't.id = :courseid';
+        }
+
+        $rs = $DB->get_recordset_sql('SELECT
+          ' . $this->get_type() . ' AS type,
+          ctx.id AS contextid,
+          ' . $this->get_standard_area_fields_sql() . '
+          t.id AS itemid,
+          t.id AS courseid,
+          t.'.$this->get_fieldname().' AS content
+        FROM {'.$this->get_tablename().'} t
+        JOIN {context} ctx ON ctx.instanceid = t.id AND ctx.contextlevel = :pctxlevelcourse '.
+            ($where ? 'WHERE ' . join(' AND ', $where) : '') . '
+        ORDER BY t.id',
+            ['pctxlevelcourse' => CONTEXT_COURSE] + $params);
+
+        return $rs;
+    }
+
+    /**
+     * Returns the moodle_url of the page to edit the error.
+     * @param \stdClass $componentinfo
+     * @return \moodle_url
+     */
+    public static function get_edit_url(\stdClass $componentinfo): \moodle_url {
+        if ($componentinfo->tablename == 'course_sections') {
+            return new \moodle_url('/course/editsection.php', ['id' => $componentinfo->itemid, 'sr' => '']);
+        } else if ($componentinfo->tablename == 'course_categories') {
+            return new \moodle_url('/course/editcategory.php', ['id' => $componentinfo->itemid]);
+        } else {
+            return new \moodle_url('/course/edit.php', ['id' => $componentinfo->courseid]);
+        }
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/category_base.php

@@ -0,0 +1,92 @@
+<?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\local\areas\core_course;
+
+use core\event\course_category_created;
+use core\event\course_category_updated;
+use tool_brickfield\area_base;
+
+/**
+ * Base class for all areas that represent a field from the course_categories table (such as 'intro' or 'name')
+ *
+ * @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 category_base extends area_base {
+
+    /**
+     * Find recordset of the relevant areas.
+     * @param \core\event\base $event
+     * @return \moodle_recordset|null
+     * @throws \dml_exception
+     */
+    public function find_relevant_areas(\core\event\base $event): ?\moodle_recordset {
+        if ($event instanceof course_category_updated || $event instanceof course_category_created) {
+            return $this->find_fields_in_course_categories_table(['itemid' => $event->objectid]);
+        }
+        return null;
+    }
+
+    /**
+     * Find recordset of the course areas.
+     * @param int $courseid
+     * @return \moodle_recordset|null
+     */
+    public function find_course_areas(int $courseid): ?\moodle_recordset {
+        return null;
+    }
+
+    /**
+     * Return an array of area objects that contain content at the site and system levels only. All category content is considered
+     * system level.
+     * @return mixed
+     */
+    public function find_system_areas(): ?\moodle_recordset {
+        return $this->find_fields_in_course_categories_table();
+    }
+
+    /**
+     * Helper method that can be used by the classes that define a field in the respective module table
+     *
+     * @param array $params
+     * @return \moodle_recordset
+     * @throws \dml_exception
+     */
+    protected function find_fields_in_course_categories_table(array $params = []): \moodle_recordset {
+        global $DB;
+        $where = [];
+        if (!empty($params['itemid'])) {
+            $where[] = 't.id = :itemid';
+        }
+
+        $rs = $DB->get_recordset_sql('SELECT
+          ' . $this->get_type() . ' AS type,
+          ctx.id AS contextid,
+          ' . $this->get_standard_area_fields_sql() . '
+          t.id AS itemid,
+          t.id AS categoryid,
+          t.'.$this->get_fieldname().' AS content
+        FROM {'.$this->get_tablename().'} t
+        JOIN {context} ctx ON ctx.instanceid = t.id AND ctx.contextlevel = :pctxlevelcategory '.
+            ($where ? 'WHERE ' . join(' AND ', $where) : '') . '
+        ORDER BY t.id',
+            ['pctxlevelcategory' => CONTEXT_COURSECAT] + $params);
+
+        return $rs;
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/category_description.php

@@ -0,0 +1,43 @@
+<?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_course;
+
+/**
+ * Category description observer.
+ *
+ * @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
+ */
+class category_description extends category_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'course_categories';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'description';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/category_name.php

@@ -0,0 +1,43 @@
+<?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_course;
+
+/**
+ * Category name observer.
+ *
+ * @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
+ */
+class category_name extends category_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'course_categories';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'name';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/fullname.php

@@ -0,0 +1,43 @@
+<?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_course;
+
+/**
+ * Course full name observer.
+ *
+ * @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
+ */
+class fullname extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'course';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'fullname';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/sectionname.php

@@ -0,0 +1,126 @@
+<?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_course;
+
+use core\event\course_section_created;
+use core\event\course_section_updated;
+use tool_brickfield\area_base;
+
+/**
+ * Course section name observer.
+ *
+ * @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
+ */
+class sectionname extends area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'course_sections';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'name';
+    }
+
+    /**
+     * Get table name reference.
+     * @return string
+     */
+    public function get_ref_tablename(): string {
+        return 'course';
+    }
+
+    /**
+     * 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 {
+        if ($event instanceof course_section_created) {
+            return $this->find_fields_in_course_sections_table(['courseid' => $event->courseid, 'sectionid' => $event->objectid]);
+        } else if ($event instanceof course_section_updated) {
+            return $this->find_fields_in_course_sections_table(['courseid' => $event->courseid, 'sectionid' => $event->objectid]);
+        }
+        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 {
+        return $this->find_fields_in_course_sections_table(['courseid' => $courseid]);
+    }
+
+    /**
+     * Helper method that can be used by the classes that define a field in the 'course_sections' table
+     *
+     * @param array $params
+     * @return \moodle_recordset
+     * @throws \coding_exception
+     * @throws \dml_exception
+     */
+    protected function find_fields_in_course_sections_table(array $params = []): \moodle_recordset {
+        global $DB;
+        $where = [];
+        if (!empty($params['courseid'])) {
+            $where[] = 't.course = :courseid';
+        }
+        if (!empty($params['sectionid'])) {
+            $where[] = 't.id = :sectionid';
+        }
+
+        // Filter against approved / non-approved course category listings.
+        $this->filterfieldname = 'co.id';
+        $this->get_courseid_filtering();
+        if ($this->filter != '') {
+            $params = $params + $this->filterparams;
+        }
+
+        $rs = $DB->get_recordset_sql('SELECT
+            ' . $this->get_type() . ' AS type,
+            ctx.id AS contextid,
+            ' . $this->get_standard_area_fields_sql() . '
+            t.id AS itemid,
+            ' . $this->get_reftable_field_sql() . '
+            t.course AS refid,
+            t.course AS courseid,
+            t.'.$this->get_fieldname().' AS content
+        FROM {'.$this->get_tablename().'} t
+        JOIN {course} co ON co.id = t.course
+        JOIN {context} ctx ON ctx.instanceid = co.id AND ctx.contextlevel = :pctxlevelcourse '.
+            ($where ? 'WHERE ' . join(' AND ', $where) : '') . $this->filter . '
+        ORDER BY t.course',
+            ['pctxlevelcourse' => CONTEXT_COURSE] + $params);
+
+        return $rs;
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/sectionsummary.php

@@ -0,0 +1,126 @@
+<?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_course;
+
+use core\event\course_section_created;
+use core\event\course_section_updated;
+use tool_brickfield\area_base;
+
+/**
+ * Course section summary observer.
+ *
+ * @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
+ */
+class sectionsummary extends area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'course_sections';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'summary';
+    }
+
+    /**
+     * Get table name reference.
+     * @return string
+     */
+    public function get_ref_tablename(): string {
+        return 'course';
+    }
+
+    /**
+     * 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 {
+        if ($event instanceof course_section_created) {
+            return $this->find_fields_in_course_sections_table(['courseid' => $event->courseid, 'sectionid' => $event->objectid]);
+        } else if ($event instanceof course_section_updated) {
+            return $this->find_fields_in_course_sections_table(['courseid' => $event->courseid, 'sectionid' => $event->objectid]);
+        }
+        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 {
+        return $this->find_fields_in_course_sections_table(['courseid' => $courseid]);
+    }
+
+    /**
+     * Helper method that can be used by the classes that define a field in the 'course_sections' table
+     *
+     * @param array $params
+     * @return \moodle_recordset
+     * @throws \coding_exception
+     * @throws \dml_exception
+     */
+    protected function find_fields_in_course_sections_table(array $params = []): \moodle_recordset {
+        global $DB;
+        $where = [];
+        if (!empty($params['courseid'])) {
+            $where[] = 't.course = :courseid';
+        }
+        if (!empty($params['sectionid'])) {
+            $where[] = 't.id = :sectionid';
+        }
+
+        // Filter against approved / non-approved course category listings.
+        $this->filterfieldname = 'co.id';
+        $this->get_courseid_filtering();
+        if ($this->filter != '') {
+            $params = $params + $this->filterparams;
+        }
+
+        $rs = $DB->get_recordset_sql('SELECT
+            ' . $this->get_type() . ' AS type,
+            ctx.id AS contextid,
+            ' . $this->get_standard_area_fields_sql() . '
+            t.id AS itemid,
+            ' . $this->get_reftable_field_sql() . '
+            t.course AS refid,
+            t.course AS courseid,
+            t.'.$this->get_fieldname().' AS content
+        FROM {'.$this->get_tablename().'} t
+        JOIN {course} co ON co.id = t.course
+        JOIN {context} ctx ON ctx.instanceid = co.id AND ctx.contextlevel = :pctxlevelcourse '.
+            ($where ? 'WHERE ' . join(' AND ', $where) : '') . $this->filter . '
+        ORDER BY t.section',
+            ['pctxlevelcourse' => CONTEXT_COURSE] + $params);
+
+        return $rs;
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/shortname.php

@@ -0,0 +1,43 @@
+<?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_course;
+
+/**
+ * Course shortname observer.
+ *
+ * @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
+ */
+class shortname extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'course';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'shortname';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_course/summary.php

@@ -0,0 +1,43 @@
+<?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_course;
+
+/**
+ * Course summary observer.
+ *
+ * @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
+ */
+class summary extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'course';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'summary';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_question/answerbase.php

@@ -0,0 +1,135 @@
+<?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;
+
+/**
+ * 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 answerbase extends base {
+
+    /**
+     * Get table name reference.
+     * @return string
+     */
+    public function get_ref_tablename(): string {
+        return 'question';
+    }
+
+    /**
+     * 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,
+                ctx.id AS contextid,
+                {$this->get_standard_area_fields_sql()}
+                a.id AS itemid,
+                {$this->get_reftable_field_sql()}
+                t.id AS refid,
+                {$this->get_course_and_cat_sql($event)}
+                a.{$this->get_fieldname()} AS content
+            FROM {question} t
+            INNER JOIN {question_answers} a ON a.question = t.id
+            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 a.id",
+                [
+                    'refid' => $event->objectid,
+                ]);
+            return $rs;
+        }
+        return null;
+    }
+
+    /**
+     * 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, or course category context.
+     * @return mixed
+     * @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() .
+            ' a.id AS itemid, ' . $this->get_reftable_field_sql() . 't.id AS refid, '.
+            SITEID . ' as courseid, cc.id as categoryid, a.'.$this->get_fieldname().' AS content ';
+        $from = 'FROM {question} t ' .
+            'INNER JOIN {question_answers} a ON a.question = t.id ' .
+            '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 a.id';
+        $params = [
+            'syscontext' => CONTEXT_SYSTEM,
+            'coursecat' => CONTEXT_COURSECAT,
+            'coursecat2' => CONTEXT_COURSECAT,
+        ];
+
+        return $DB->get_recordset_sql($select . $from . $where . $order, $params);
+    }
+
+    /**
+     * 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()}
+                a.id AS itemid,
+                {$this->get_reftable_field_sql()}
+                t.id AS refid,
+                {$courseid} AS courseid,
+                a.{$this->get_fieldname()} AS content
+            FROM {question} t
+            INNER JOIN {question_answers} a ON a.question = t.id
+            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 a.id",
+            ['ctxcourse' => CONTEXT_COURSE,
+             'courseid' => $courseid,
+             'module' => CONTEXT_MODULE,
+             'coursecontextpath' => $DB->sql_like_escape($coursecontext->path) . '/%',
+            ]);
+    }
+}

admin/tool/brickfield/classes/local/areas/core_question/base.php

@@ -0,0 +1,185 @@
+<?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
+ *
+ * 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,
+                ctx.id AS contextid,
+                {$this->get_standard_area_fields_sql()}
+                t.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,
+                ]);
+            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",
+            [
+                'ctxcourse' => CONTEXT_COURSE,
+                'courseid' => $courseid,
+                'module' => CONTEXT_MODULE,
+                'coursecontextpath' => $DB->sql_like_escape($coursecontext->path) . '/%',
+            ]);
+    }
+
+    /**
+     * 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);
+    }
+
+    /**
+     * 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
+        // Hence, use refid for these links.
+        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]);
+    }
+
+    /**
+     * 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->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,
+        ";
+    }
+}

admin/tool/brickfield/classes/local/areas/core_question/generalfeedback.php

@@ -0,0 +1,43 @@
+<?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;
+
+/**
+ * Question generalfeedback observer.
+ *
+ * @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
+ */
+class generalfeedback extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'question';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'generalfeedback';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_question/questionanswers.php

@@ -0,0 +1,43 @@
+<?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;
+
+/**
+ * Question answers observer.
+ *
+ * @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
+ */
+class questionanswers extends answerbase {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'question_answers';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'answer';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_question/questionfeedback.php

@@ -0,0 +1,43 @@
+<?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;
+
+/**
+ * Question feedback observer.
+ *
+ * @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
+ */
+class questionfeedback extends answerbase {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'question_answers';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'feedback';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_question/questionname.php

@@ -0,0 +1,43 @@
+<?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;
+
+/**
+ * Question name observer.
+ *
+ * @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
+ */
+class questionname extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'question';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'name';
+    }
+}

admin/tool/brickfield/classes/local/areas/core_question/questiontext.php

@@ -0,0 +1,43 @@
+<?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;
+
+/**
+ * Question text observer.
+ *
+ * @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
+ */
+class questiontext extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'question';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'questiontext';
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_assign/intro.php

@@ -0,0 +1,45 @@
+<?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\local\areas\mod_assign;
+
+use tool_brickfield\local\areas\module_area_base;
+
+/**
+ * Assignment intro observer.
+ *
+ * @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
+ */
+class intro extends module_area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'assign';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'intro';
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_assign/name.php

@@ -0,0 +1,45 @@
+<?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\local\areas\mod_assign;
+
+use tool_brickfield\local\areas\module_area_base;
+
+/**
+ * Assignment name observer.
+ *
+ * @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
+ */
+class name extends module_area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'assign';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'name';
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_book/base.php

@@ -0,0 +1,42 @@
+<?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\local\areas\mod_book;
+
+use tool_brickfield\local\areas\module_area_base;
+
+/**
+ * Book base observer.
+ *
+ * @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 module_area_base {
+    /**
+     * Returns the moodle_url of the page to edit the error.
+     * @param \stdClass $componentinfo
+     * @return \moodle_url
+     */
+    public static function get_edit_url(\stdClass $componentinfo): \moodle_url {
+        if (!empty($componentinfo->refid)) {
+            return new \moodle_url('/mod/book/edit.php',
+                ['cmid' => $componentinfo->cmid, 'id' => $componentinfo->itemid, 'sesskey' => sesskey()]);
+        } else {
+            return parent::get_edit_url($componentinfo);
+        }
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_book/chaptercontent.php

@@ -0,0 +1,128 @@
+<?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\local\areas\mod_book;
+
+use tool_brickfield\area_base;
+
+/**
+ * Book chapter content observer.
+ *
+ * @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
+ */
+class chaptercontent extends area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'book_chapters';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'content';
+    }
+
+    /**
+     * Get table name reference.
+     * @return string
+     */
+    public function get_ref_tablename(): string {
+        return 'book';
+    }
+
+    /**
+     * 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 {
+        if ($event->eventname == '\mod_book\event\chapter_updated' || $event->eventname == '\mod_book\event\chapter_created') {
+            return $this->find_areas(['contextid' => $event->contextid, 'objectid' => $event->objectid]);
+        }
+        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 {
+        return $this->find_areas(['courseid' => $courseid]);
+    }
+
+    /**
+     * Find recordset of areas.
+     * @param array $params
+     * @return \moodle_recordset
+     * @throws \coding_exception
+     * @throws \dml_exception
+     */
+    protected function find_areas(array $params = []): \moodle_recordset {
+        global $DB;
+
+        $where = [];
+        if (!empty($params['contextid'])) {
+            $where[] = 'ctx.id = :contextid';
+            $where[] = 'co.id = :objectid';
+        }
+        if (!empty($params['courseid'])) {
+            $where[] = 'cm.course = :courseid';
+        }
+
+        // Filter against approved / non-approved course category listings.
+        $this->filterfieldname = 'cm.course';
+        $this->get_courseid_filtering();
+        if ($this->filter != '') {
+            $params = $params + $this->filterparams;
+        }
+
+        $rs = $DB->get_recordset_sql('SELECT
+          ' . $this->get_type() . ' AS type,
+          ctx.id AS contextid,
+          ' . $this->get_standard_area_fields_sql() . '
+          co.id AS itemid,
+          ' . $this->get_reftable_field_sql() . '
+          t.id AS refid,
+          cm.id AS cmid,
+          cm.course AS courseid,
+          co.'.$this->get_fieldname().' AS content
+        FROM {book} t
+        JOIN {course_modules} cm ON cm.instance = t.id
+        JOIN {modules} m ON m.id = cm.module AND m.name = :preftablename2
+        JOIN {context} ctx ON ctx.instanceid = cm.id AND ctx.contextlevel = :pctxlevelmodule
+        JOIN {'.$this->get_tablename().'} co ON co.bookid = t.id ' .
+        ($where ? 'WHERE ' . join(' AND ', $where) : '') . $this->filter . '
+        ORDER BY t.id, co.id',
+            ['pctxlevelmodule' => CONTEXT_MODULE,
+                'preftablename2' => $this->get_ref_tablename(),
+            ] + $params);
+
+        return $rs;
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_book/chaptertitle.php

@@ -0,0 +1,128 @@
+<?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\local\areas\mod_book;
+
+use tool_brickfield\area_base;
+
+/**
+ * Book chapter title observer.
+ *
+ * @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
+ */
+class chaptertitle extends area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'book_chapters';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'title';
+    }
+
+    /**
+     * Get table name reference.
+     * @return string
+     */
+    public function get_ref_tablename(): string {
+        return 'book';
+    }
+
+    /**
+     * 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 {
+        if ($event->eventname == '\mod_book\event\chapter_updated' || $event->eventname == '\mod_book\event\chapter_created') {
+            return $this->find_areas(['contextid' => $event->contextid, 'objectid' => $event->objectid]);
+        }
+        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 {
+        return $this->find_areas(['courseid' => $courseid]);
+    }
+
+    /**
+     * Find recordset of areas.
+     * @param array $params
+     * @return \moodle_recordset
+     * @throws \coding_exception
+     * @throws \dml_exception
+     */
+    protected function find_areas(array $params = []): \moodle_recordset {
+        global $DB;
+
+        $where = [];
+        if (!empty($params['contextid'])) {
+            $where[] = 'ctx.id = :contextid';
+            $where[] = 'co.id = :objectid';
+        }
+        if (!empty($params['courseid'])) {
+            $where[] = 'cm.course = :courseid';
+        }
+
+        // Filter against approved / non-approved course category listings.
+        $this->filterfieldname = 'cm.course';
+        $this->get_courseid_filtering();
+        if ($this->filter != '') {
+            $params = $params + $this->filterparams;
+        }
+
+        $rs = $DB->get_recordset_sql('SELECT
+          ' . $this->get_type() . ' AS type,
+          ctx.id AS contextid,
+          ' . $this->get_standard_area_fields_sql() . '
+          co.id AS itemid,
+          ' . $this->get_reftable_field_sql() . '
+          t.id AS refid,
+          cm.id AS cmid,
+          cm.course AS courseid,
+          co.'.$this->get_fieldname().' AS content
+        FROM {book} t
+        JOIN {course_modules} cm ON cm.instance = t.id
+        JOIN {modules} m ON m.id = cm.module AND m.name = :preftablename2
+        JOIN {context} ctx ON ctx.instanceid = cm.id AND ctx.contextlevel = :pctxlevelmodule
+        JOIN {'.$this->get_tablename().'} co ON co.bookid = t.id ' .
+        ($where ? 'WHERE ' . join(' AND ', $where) : '') . $this->filter . '
+        ORDER BY t.id, co.id',
+            ['pctxlevelmodule' => CONTEXT_MODULE,
+                'preftablename2' => $this->get_ref_tablename(),
+            ] + $params);
+
+        return $rs;
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_book/intro.php

@@ -0,0 +1,45 @@
+<?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\local\areas\mod_book;
+
+use tool_brickfield\local\areas\module_area_base;
+
+/**
+ * Book intro observer.
+ *
+ * @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
+ */
+class intro extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'book';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'intro';
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_book/name.php

@@ -0,0 +1,45 @@
+<?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\local\areas\mod_book;
+
+use tool_brickfield\local\areas\module_area_base;
+
+/**
+ * Book name observer.
+ *
+ * @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
+ */
+class name extends base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'book';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'name';
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_chat/intro.php

@@ -0,0 +1,45 @@
+<?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\local\areas\mod_chat;
+
+use tool_brickfield\local\areas\module_area_base;
+
+/**
+ * Chat intro observer.
+ *
+ * @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
+ */
+class intro extends module_area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'chat';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'intro';
+    }
+}

admin/tool/brickfield/classes/local/areas/mod_chat/name.php

@@ -0,0 +1,45 @@
+<?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\local\areas\mod_chat;
+
+use tool_brickfield\local\areas\module_area_base;
+
+/**
+ * Chat name observer.
+ *
+ * @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
+ */
+class name extends module_area_base {
+
+    /**
+     * Get table name.
+     * @return string
+     */
+    public function get_tablename(): string {
+        return 'chat';
+    }
+
+    /**
+     * Get field name.
+     * @return string
+     */
+    public function get_fieldname(): string {
+        return 'name';
+    }
+}